You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by gg...@apache.org on 2026/08/28 18:44:03 UTC

(commons-xml) 14/17: Javadoc: "hardening" -> "secure/securing" wording to match new class and method names.

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 5f3bdf062de9bdb5eec7f4ec54682d72935f6284
Author: Gary Gregory <ga...@gmail.com>
AuthorDate: Fri Aug 28 14:37:04 2026 -0400

    Javadoc: "hardening" -> "secure/securing" wording to match new class and
    method names.
    
    Rename test methods.
---
 .../java/org/apache/commons/xml/SecureXMLInputFactory.java     | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/main/java/org/apache/commons/xml/SecureXMLInputFactory.java b/src/main/java/org/apache/commons/xml/SecureXMLInputFactory.java
index 90b6edb..01639ea 100644
--- a/src/main/java/org/apache/commons/xml/SecureXMLInputFactory.java
+++ b/src/main/java/org/apache/commons/xml/SecureXMLInputFactory.java
@@ -62,7 +62,7 @@ public final class SecureXMLInputFactory {
             MethodType.methodType(XMLInputFactory.class));
 
     /**
-     * Capability-driven hardening for any {@link XMLInputFactory} (StAX) on the classpath.
+     * Capability-driven secure for any {@link XMLInputFactory} (StAX) on the classpath.
      *
      * <p>One recipe covers both the JDK Zephyr and Woodstox: the wrapper installs a non-removable {@link FallbackIgnoreXMLResolver} floor on
      * every entity-resolution hook, leaving the standard {@code SUPPORT_DTD} / {@code IS_SUPPORTING_EXTERNAL_ENTITIES} defaults untouched; see the wrapper's
@@ -84,7 +84,7 @@ static XMLInputFactory secure(final XMLInputFactory factory) {
      * </p>
      *
      * @return A secure factory.
-     * @throws IllegalStateException     Thrown if a required hardening setting cannot be applied to the underlying implementation.
+     * @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 newDefaultFactory()} nor the JDK's built-in implementation
      *                                   (for example Android).
      */
@@ -114,7 +114,7 @@ public static XMLInputFactory newDefaultFactory() {
      * Returns a new, secure {@link XMLInputFactory}, as by {@link XMLInputFactory#newFactory()}.
      *
      * @return A secure factory.
-     * @throws IllegalStateException     Thrown if a required hardening setting cannot be applied to the underlying implementation.
+     * @throws IllegalStateException     Thrown if a required secure setting cannot be applied to the underlying implementation.
      * @throws FactoryConfigurationError Thrown if an instance of this factory cannot be loaded.
      */
     public static XMLInputFactory newFactory() {
@@ -128,7 +128,7 @@ public static XMLInputFactory newFactory() {
      * @param factoryId   The name of the factory to find; a system property or service id to look up, not the class name of the implementation.
      * @param classLoader The class loader used in the lookup; {@code null} means the current thread's context class loader.
      * @return A secure factory.
-     * @throws IllegalStateException     Thrown if a required hardening setting cannot be applied to the underlying implementation.
+     * @throws IllegalStateException     Thrown if a required secure setting cannot be applied to the underlying implementation.
      * @throws FactoryConfigurationError Thrown in case of a service configuration error or if the implementation is not available or cannot be instantiated.
      * @throws NullPointerException      Thrown if {@code factoryId} is {@code null}.
      */
@@ -140,7 +140,7 @@ public static XMLInputFactory newFactory(final String factoryId, final ClassLoad
      * Returns a new, secure {@link XMLInputFactory}.
      *
      * @return A secure factory.
-     * @throws IllegalStateException     Thrown if a required hardening setting cannot be applied to the underlying implementation.
+     * @throws IllegalStateException     Thrown if a required secure setting cannot be applied to the underlying implementation.
      * @throws FactoryConfigurationError Thrown if an instance of this factory cannot be loaded.
      */
     public static XMLInputFactory newInstance() {