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 21:54:40 UTC

(commons-xml) 06/36: Javadoc: Use "secure" terminology.

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 5a9088eb5fa6d6ec290058abb38d7896948111bf
Author: Gary Gregory <ga...@gmail.com>
AuthorDate: Fri Aug 28 17:39:59 2026 -0400

    Javadoc: Use "secure" terminology.
---
 src/test/java/org/apache/commons/xml/AttackTestSupport.java | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/test/java/org/apache/commons/xml/AttackTestSupport.java b/src/test/java/org/apache/commons/xml/AttackTestSupport.java
index b9b3574..8e465d5 100644
--- a/src/test/java/org/apache/commons/xml/AttackTestSupport.java
+++ b/src/test/java/org/apache/commons/xml/AttackTestSupport.java
@@ -61,7 +61,7 @@
  * <p>The secure-side helpers come in three flavors, distinguished by their suffix:</p>
  *
  * <ul>
- *   <li>{@code assert*Blocks(...)} runs the payload through a secure factory from {@link org.apache.commons.xml} and asserts the parse throws. Used when the hardening
+ *   <li>{@code assert*Blocks(...)} runs the payload through a secure factory from {@link org.apache.commons.xml} and asserts the parse throws. Used when the secure
  *       layer is expected to reject the attack outright.</li>
  *   <li>{@code assert*DoesNotLeak(...)} runs the payload through a secure factory and asserts the parse completes without throwing and without producing the
  *       {@link #LEAKED_MARKER} string. Used when the secure contract guarantees the parse succeeds but never resolves the external resource (for example,
@@ -595,7 +595,7 @@ static void assertTemplatesCompiles(final Source xslt) {
     /**
      * Asserts a secure Templates compile-and-transform completes without throwing and without leaked content.
      *
-     * <p>{@link TransformerFactory#newTemplates(Source)} via {@link SecureTransformerFactory#newInstance()} followed by transform; use this when the hardening
+     * <p>{@link TransformerFactory#newTemplates(Source)} via {@link SecureTransformerFactory#newInstance()} followed by transform; use this when the secure
      * contract guarantees the compile and transform succeed but never resolve the external resource.</p>
      */
     static void assertTemplatesDoesNotLeak(final Source xslt) {
@@ -624,7 +624,7 @@ static void assertTransformerBlocksOrDoesNotLeak(final String payload) {
     /**
      * Asserts a secure identity Transformer completes without throwing and without leaked content.
      *
-     * <p>{@link Transformer#transform(Source, javax.xml.transform.Result)} via {@link SecureTransformerFactory#newInstance()}; use this when the hardening
+     * <p>{@link Transformer#transform(Source, javax.xml.transform.Result)} via {@link SecureTransformerFactory#newInstance()}; use this when the secure
      * contract guarantees the transform succeeds but never resolves the external resource.</p>
      */
     static void assertTransformerDoesNotLeak(final String payload) {
@@ -927,7 +927,7 @@ private static boolean probeDomResolvesInternalEntities() {
         }
     }
 
-    /** Builds a raw {@link XMLReader} from a deliberately permissive {@link SAXParserFactory} and hardens it via {@link SecureSAXParserFactory#secure(XMLReader)}. */
+    /** Builds a raw {@link XMLReader} from a deliberately permissive {@link SAXParserFactory} and secures it via {@link SecureSAXParserFactory#secure(XMLReader)}. */
     private static XMLReader rawSecureXMLReader() throws Exception {
         final SAXParserFactory factory = SAXParserFactory.newInstance();
         if (!IS_ANDROID) {