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/26 17:53:18 UTC

(commons-xml) 02/06: Javadoc: DocumentBuilderHardener.harden()

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 30049f6eb566f2ca20ec9b77602256a68a289b4a
Author: Gary Gregory <ga...@gmail.com>
AuthorDate: Wed Aug 26 13:49:22 2026 -0400

    Javadoc: DocumentBuilderHardener.harden()
---
 src/main/java/org/apache/commons/xml/HardeningTransformerFactory.java | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/main/java/org/apache/commons/xml/HardeningTransformerFactory.java b/src/main/java/org/apache/commons/xml/HardeningTransformerFactory.java
index 2b9745c..948c5b9 100644
--- a/src/main/java/org/apache/commons/xml/HardeningTransformerFactory.java
+++ b/src/main/java/org/apache/commons/xml/HardeningTransformerFactory.java
@@ -21,6 +21,7 @@
 import java.util.Objects;
 import java.util.function.Supplier;
 
+import javax.xml.XMLConstants;
 import javax.xml.parsers.DocumentBuilderFactory;
 import javax.xml.parsers.FactoryConfigurationError;
 import javax.xml.parsers.ParserConfigurationException;
@@ -84,6 +85,7 @@ final class HardeningTransformerFactory extends SAXTransformerFactory {
      * @throws TransformerConfigurationException if the source cannot be parsed.
      * @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.
+     * @throws HardeningException Thrown if a (non-Andoid) factory cannot support the secure processing feature {@link XMLConstants#FEATURE_SECURE_PROCESSING}.
      */
     private static Source hardenSourceToDom(final Source source) throws TransformerConfigurationException {
         if (source instanceof StreamSource || source instanceof SAXSource && ((SAXSource) source).getXMLReader() == null) {