This is an automated email from the ASF dual-hosted git repository. garydgregory pushed a commit to branch main in repository https://gitbox.apache.org/repos/asf/commons-xml.git
commit f4e023d8588b6cfd90f56a85be5870691e1cbd8c Author: Gary Gregory <[email protected]> AuthorDate: Fri Aug 28 14:50:38 2026 -0400 Javadoc: "hardened" -> "secure/securing" wording to match new class and method names. Rename test methods. --- .../apache/commons/xml/SecureDocumentBuilderFactory.java | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/src/main/java/org/apache/commons/xml/SecureDocumentBuilderFactory.java b/src/main/java/org/apache/commons/xml/SecureDocumentBuilderFactory.java index 1f2e129..7623b46 100644 --- a/src/main/java/org/apache/commons/xml/SecureDocumentBuilderFactory.java +++ b/src/main/java/org/apache/commons/xml/SecureDocumentBuilderFactory.java @@ -132,10 +132,10 @@ public static DocumentBuilderFactory newDefaultInstance() { } /** - * Returns a new, hardened, namespace-aware {@link DocumentBuilderFactory} of the system-default implementation, enabling namespace awareness on + * Returns a new, secure, namespace-aware {@link DocumentBuilderFactory} of the system-default implementation, enabling namespace awareness on * {@link #newDefaultInstance()}, the behavior {@code DocumentBuilderFactory.newDefaultNSInstance()} (Java 13 or later) is specified to have. * - * @return A hardened, namespace-aware factory. + * @return A secure, namespace-aware factory. * @throws IllegalStateException Thrown if a required secure setting cannot be applied to the underlying implementation. * @throws FactoryConfigurationError Thrown if the running platform provides neither {@code newDefaultInstance()} nor the JDK's built-in implementation * (for example Android). @@ -174,10 +174,10 @@ public static DocumentBuilderFactory newInstance(final String factoryClassName, } /** - * Returns a new, hardened, namespace-aware {@link DocumentBuilderFactory}, enabling namespace awareness on {@link #newInstance()}, the behavior + * Returns a new, secure, namespace-aware {@link DocumentBuilderFactory}, enabling namespace awareness on {@link #newInstance()}, the behavior * {@code DocumentBuilderFactory.newNSInstance()} (Java 13 or later) is specified to have. * - * @return A hardened, namespace-aware factory. + * @return A secure, namespace-aware factory. * @throws IllegalStateException Thrown if a required secure setting cannot be applied to the underlying implementation. * @throws FactoryConfigurationError Thrown from a factory in case of a {@link java.util.ServiceConfigurationError service configuration error} or if the * implementation is not available or cannot be instantiated. @@ -187,7 +187,7 @@ public static DocumentBuilderFactory newNSInstance() { } /** - * Returns the hardened, namespace-aware factory the Source-rewriting wrappers parse with. + * Returns the secure, namespace-aware factory the Source-rewriting wrappers parse with. * <p> * While {@code overrideDefaultParser} is {@code false} the factory is the JDK's "default parser" factory, determined the way the JDK itself determines it: the built-in * implementation, unless the {@value #DOM_FACTORY_ID} system property is set — that property is the JDK's own mechanism for @@ -195,7 +195,7 @@ public static DocumentBuilderFactory newNSInstance() { * </p> * * @param overrideDefaultParser whether {@value SecureSAXParserFactory#OVERRIDE_DEFAULT_PARSER} on the originating factory asks to override the JDK's default parser. - * @return A hardened, namespace-aware factory. + * @return A secure, namespace-aware factory. * @throws IllegalStateException Thrown if a required secure setting cannot be applied to the underlying implementation. * @throws FactoryConfigurationError Thrown from a factory in case of a {@link java.util.ServiceConfigurationError service configuration error} or if the * implementation is not available or cannot be instantiated. @@ -205,13 +205,13 @@ static DocumentBuilderFactory newNSInstance(final boolean overrideDefaultParser) } /** - * Returns a new, hardened, namespace-aware {@link DocumentBuilderFactory} of the given implementation class, enabling namespace awareness on + * Returns a new, secure, namespace-aware {@link DocumentBuilderFactory} of the given implementation class, enabling namespace awareness on * {@link #newInstance(String, ClassLoader)}, the behavior {@code DocumentBuilderFactory.newNSInstance(String, ClassLoader)} (Java 13 or later) is specified * to have. * * @param factoryClassName The fully qualified class name of the {@link DocumentBuilderFactory} implementation. * @param classLoader The class loader used to load the factory class; {@code null} means the current thread's context class loader. - * @return A hardened, namespace-aware factory. + * @return A secure, namespace-aware factory. * @throws IllegalStateException Thrown if a required secure setting cannot be applied to the underlying implementation. * @throws FactoryConfigurationError Thrown if {@code factoryClassName} is {@code null} or the factory class cannot be loaded or instantiated. */
