docs: faq for javax.xml.parsers.FactoryConfigurationError:

Author: fugerit79

fj-doc-guide/src/main/docs/asciidoc/chapters/07_011-xml-apis.adoc

@@ -0,0 +1,33 @@
+
+[#doc-faq-xml-apis]
+=== Exception javax.xml.parsers.FactoryConfigurationError: Provider org.apache.xerces.jaxp.DocumentBuilderFactoryImpl not found
+
+If you are receiving the exception :
+
+[source,txt]
+----
+javax.xml.parsers.FactoryConfigurationError: Provider org.apache.xerces.jaxp.DocumentBuilderFactoryImpl not found
+	at javax.xml.parsers.DocumentBuilderFactory.newInstance(Unknown Source)
+	at org.fugerit.java.core.xml.dom.DOMIO.newSafeDocumentBuilderFactory(DOMIO.java:64)
+	at org.fugerit.java.core.xml.dom.DOMIO.newSafeDocumentBuilderFactory(DOMIO.java:89)
+	at org.fugerit.java.core.xml.dom.DOMIO.loadDOMDoc(DOMIO.java:162)
+	at org.fugerit.java.core.xml.dom.DOMIO.loadDOMDoc(DOMIO.java:199)
+	at org.fugerit.java.core.cfg.xml.GenericListCatalogConfig.load(GenericListCatalogConfig.java:287)
+----
+
+It is usually possible to fix it by adding to your modules the exclusion :
+
+[source,xml]
+----
+<dependency>
+    <groupId>org.fugerit.java</groupId>
+    <artifactId>fj-doc-mod-fop</artifactId>
+    <exclusions>
+        <exclusion>
+            <artifactId>xml-apis</artifactId>
+            <groupId>xml-apis</groupId>
+        </exclusion>
+    </exclusions>
+</dependency>
+----
+

fj-doc-guide/src/main/docs/asciidoc/index.adoc

@@ -55,6 +55,7 @@ include::chapters/07_007_java-runtime-version-dependency-handling.adoc[]
 include::chapters/07_008-reducing-fj-doc-mod-fop-pdf-size.adoc[]
 include::chapters/07_009-extending-handler-capabilities.adoc[]
 include::chapters/07_010-pdf-ua-accessibility.adoc[]
+include::chapters/07_011-xml-apis.adoc[]
 
 include::chapters/08_doc-optmization.adoc[]
 include::chapters/08_1_eager-startup.adoc[]