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() {