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 61ce23ff5e82fee515005aeb9d178d841abdef9c Author: Gary Gregory <[email protected]> AuthorDate: Fri Aug 28 14:05:15 2026 -0400 Javadoc: "hardened" -> "secured" wording to match new class and method names. --- .../commons/xml/SecureDocumentBuilderFactory.java | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/src/main/java/org/apache/commons/xml/SecureDocumentBuilderFactory.java b/src/main/java/org/apache/commons/xml/SecureDocumentBuilderFactory.java index a5742bd..985255c 100644 --- a/src/main/java/org/apache/commons/xml/SecureDocumentBuilderFactory.java +++ b/src/main/java/org/apache/commons/xml/SecureDocumentBuilderFactory.java @@ -31,7 +31,7 @@ import org.xml.sax.EntityResolver; /** - * Creates new, hardened {@link DocumentBuilderFactory} instances. + * Creates new, secure {@link DocumentBuilderFactory} instances. * <p> * Beyond the three universal guarantees on {@link org.apache.commons.xml}, XInclude resolution is denied by default. When * {@link DocumentBuilderFactory#setXIncludeAware(boolean) setXIncludeAware(true)} is called on the returned factory, the parser will process @@ -41,7 +41,7 @@ * </p> * <p> * Not a {@link DocumentBuilderFactory} itself, so none of the JAXP static factory methods is inherited: a caller cannot reach a non-hardened factory through this class - * by calling an inherited method such as {@code newDefaultInstance()}. The hardened factories are instances of a nested, non-public wrapper class. + * by calling an inherited method such as {@code newDefaultInstance()}. The secure factories are instances of a nested, non-public wrapper class. * </p> * * @see org.apache.commons.xml @@ -74,7 +74,7 @@ public final class SecureDocumentBuilderFactory { * </ul> * * @param factory The factory to harden. - * @return A new hardened factory or the original factory, as-is, if it is a known Android factory. + * @return A new secure factory or the original factory, as-is, if it is a known Android factory. * @throws SecureException Thrown if a (non-Andoid) factory cannot support the secure processing feature {@link XMLConstants#FEATURE_SECURE_PROCESSING}. */ static DocumentBuilderFactory secure(final DocumentBuilderFactory factory) { @@ -102,13 +102,13 @@ private static DocumentBuilderFactory makeNSAware(final DocumentBuilderFactory f } /** - * Returns a new, hardened {@link DocumentBuilderFactory} of the system-default implementation. + * Returns a new, secure {@link DocumentBuilderFactory} of the system-default implementation. * <p> * Obtained as by {@code DocumentBuilderFactory.newDefaultInstance()} where the platform provides it (Java 9 or later), and * by instantiating the JDK's built-in implementation directly on Java 8. * </p> * - * @return A hardened factory. + * @return A secure factory. * @throws IllegalStateException Thrown if a required hardening 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). @@ -145,9 +145,9 @@ public static DocumentBuilderFactory newDefaultNSInstance() { } /** - * Returns a new, hardened {@link DocumentBuilderFactory}. + * Returns a new, secure {@link DocumentBuilderFactory}. * - * @return A hardened factory. + * @return A secure factory. * @throws IllegalStateException Thrown if a required hardening setting cannot be applied to the underlying implementation. * @throws IllegalStateException Thrown if a (non-Andoid) factory cannot support the secure processing feature * {@link XMLConstants#FEATURE_SECURE_PROCESSING}. @@ -159,11 +159,11 @@ public static DocumentBuilderFactory newInstance() { } /** - * Returns a new, hardened {@link DocumentBuilderFactory} of the given implementation class. + * Returns a new, secure {@link DocumentBuilderFactory} of the given implementation class. * * @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 factory. + * @return A secure factory. * @throws IllegalStateException Thrown if a required hardening setting cannot be applied to the underlying implementation. * @throws IllegalStateException Thrown if a (non-Andoid) factory cannot support the secure processing feature * {@link XMLConstants#FEATURE_SECURE_PROCESSING}.
