Merge pull request 'xml-2 版本初始化提交' (#47) from xml-2 into main

Reviewed-on: https://src.isharkfly.com/iSharkFly-Docs/java-tutorials/pulls/47

Author: honeymoose

xml-2/README.md

@@ -4,12 +4,15 @@ This module contains articles about eXtensible Markup Language (XML)
 
 ### Relevant Articles:
 
-- [Pretty-Print XML in Java](https://www.baeldung.com/java-pretty-print-xml)
-- [Validate an XML File Against an XSD File](https://www.baeldung.com/java-validate-xml-xsd)
-- [Converting JSON to XML in Java](https://www.baeldung.com/java-convert-json-to-xml)
-- [Convert an XML Object to a String in Java](https://www.baeldung.com/java-convert-xml-object-string)
 - [Convert String Containing XML to org.w3c.dom.Document](https://www.baeldung.com/java-convert-string-xml-dom)
 - [How to Parse XML to HashMap in Java](https://www.baeldung.com/java-xml-read-into-hashmap)
 - [Convert an XML File to CSV File](https://www.baeldung.com/java-convert-xml-csv)
 - [Invalid Characters in XML](https://www.baeldung.com/java-xml-invalid-characters)
+- [How to Convert XML to PDF](https://www.baeldung.com/java-xml-pdf-conversion)
+- [How to Convert org.w3c.dom.Document to String in Java](https://www.baeldung.com/java-convert-org-w3c-dom-document-string)
+- [Introduction to JiBX](https://www.baeldung.com/jibx)
+- [Write an org.w3.dom.Document to a File](https://www.baeldung.com/java-write-xml-document-file)
+- [Modifying an XML Attribute in Java](https://www.baeldung.com/java-modify-xml-attribute)
+- [Convert XML to HTML in Java](https://www.baeldung.com/java-convert-xml-to-html)
+
 - - More articles: [[prev -->]](../xml)

xml-2/pom.xml

@@ -0,0 +1,36 @@
+package com.isharkfly.xml;
+
+import org.w3c.dom.Document;
+
+import javax.xml.transform.*;
+import javax.xml.transform.dom.DOMSource;
+import javax.xml.transform.stream.StreamResult;
+import java.io.File;
+import java.io.FileWriter;
+import java.io.IOException;
+
+public class XMLDocumentWriter {
+    
+    public void write(Document document, String fileName, boolean excludeDeclaration, boolean prettyPrint) {
+        try(FileWriter writer = new FileWriter(new File(fileName))) {
+            TransformerFactory transformerFactory = TransformerFactory.newInstance();
+            Transformer transformer = transformerFactory.newTransformer();
+            if(excludeDeclaration) {
+                transformer.setOutputProperty(OutputKeys.OMIT_XML_DECLARATION, "yes");
+            }
+            if(prettyPrint) {
+                transformer.setOutputProperty(OutputKeys.INDENT, "yes");
+                transformer.setOutputProperty("{http://xml.apache.org/xslt}indent-amount", "2");
+            }
+            DOMSource source = new DOMSource(document);
+            StreamResult result = new StreamResult(writer);
+            transformer.transform(source, result);
+        } catch (IOException e) {
+            throw new IllegalArgumentException(e);
+        } catch (TransformerConfigurationException e) {
+            throw new IllegalStateException(e);
+        } catch (TransformerException e) {
+            throw new IllegalArgumentException(e);
+        }
+    }
+}

xml-2/src/main/java/com/baeldung/xml/prettyprint/XmlPrettyPrinter.java

@@ -0,0 +1,49 @@
+package com.isharkfly.xml.attribute;
+
+import org.dom4j.*;
+import org.dom4j.io.DocumentSource;
+import org.dom4j.io.SAXReader;
+import org.xml.sax.SAXException;
+
+import javax.xml.XMLConstants;
+import javax.xml.transform.OutputKeys;
+import javax.xml.transform.Transformer;
+import javax.xml.transform.TransformerException;
+import javax.xml.transform.TransformerFactory;
+import javax.xml.transform.stream.StreamResult;
+import java.io.StringWriter;
+import java.io.Writer;
+import java.util.List;
+
+public class Dom4jTransformer {
+    private final Document input;
+
+    public Dom4jTransformer(String resourcePath) throws DocumentException, SAXException {
+        // 1- Build the doc from the XML file
+        SAXReader xmlReader = new SAXReader();
+        xmlReader.setFeature("http://apache.org/xml/features/disallow-doctype-decl", true);
+        xmlReader.setFeature("http://xml.org/sax/features/external-general-entities", false);
+        xmlReader.setFeature("http://xml.org/sax/features/external-parameter-entities", false);
+        this.input = xmlReader.read(resourcePath);
+    }
+
+    public String modifyAttribute(String attribute, String oldValue, String newValue) throws TransformerException, TransformerException {
+        // 2- Locate the node(s) with xpath, we can use index and iterator too.
+        String expr = String.format("//*[contains(@%s, '%s')]", attribute, oldValue);
+        XPath xpath = DocumentHelper.createXPath(expr);
+        List<Node> nodes = xpath.selectNodes(input);
+        // 3- Make the change on the selected nodes
+        for (int i = 0; i < nodes.size(); i++) {
+            Element element = (Element) nodes.get(i);
+            element.addAttribute(attribute, newValue);
+        }
+        // 4- Save the result to a new XML doc
+        TransformerFactory factory = TransformerFactory.newInstance();
+        factory.setFeature(XMLConstants.FEATURE_SECURE_PROCESSING, true);
+        Transformer xformer = factory.newTransformer();
+        xformer.setOutputProperty(OutputKeys.INDENT, "yes");
+        Writer output = new StringWriter();
+        xformer.transform(new DocumentSource(input), new StreamResult(output));
+        return output.toString();
+    }
+}

xml-2/src/main/java/com/baeldung/xml/validation/XmlErrorHandler.java

@@ -0,0 +1,60 @@
+package com.isharkfly.xml.attribute;
+
+import org.w3c.dom.Document;
+import org.w3c.dom.Element;
+import org.w3c.dom.NodeList;
+import org.xml.sax.SAXException;
+
+import javax.xml.XMLConstants;
+import javax.xml.parsers.DocumentBuilderFactory;
+import javax.xml.parsers.ParserConfigurationException;
+import javax.xml.transform.*;
+import javax.xml.transform.dom.DOMSource;
+import javax.xml.transform.stream.StreamResult;
+import javax.xml.xpath.XPath;
+import javax.xml.xpath.XPathConstants;
+import javax.xml.xpath.XPathExpressionException;
+import javax.xml.xpath.XPathFactory;
+import java.io.IOException;
+import java.io.StringWriter;
+import java.io.Writer;
+
+public class JaxpTransformer {
+
+    private Document input;
+
+    public JaxpTransformer(String resourcePath) throws SAXException, IOException, ParserConfigurationException {
+        // 1- Build the doc from the XML file
+        DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
+        factory.setFeature(XMLConstants.FEATURE_SECURE_PROCESSING, true);
+        factory.setFeature("http://apache.org/xml/features/disallow-doctype-decl", true);
+        this.input = factory.newDocumentBuilder()
+            .parse(resourcePath);
+    }
+
+    public String modifyAttribute(String attribute, String oldValue, String newValue)
+            throws XPathExpressionException, TransformerFactoryConfigurationError, TransformerException, TransformerConfigurationException {
+        // 2- Locate the node(s) with xpath
+        XPath xpath = XPathFactory.newInstance()
+            .newXPath();
+        NodeList nodes = (NodeList) xpath.evaluate(String.format("//*[contains(@%s, '%s')]", attribute, oldValue), this.input, XPathConstants.NODESET);
+        // 3- Make the change on the selected nodes
+        for (int i = 0; i < nodes.getLength(); i++) {
+            Element value = (Element) nodes.item(i);
+            value.setAttribute(attribute, newValue);
+        }
+        // Stream api syntax
+        // IntStream
+        // .range(0, nodes.getLength())
+        // .mapToObj(i -> (Element) nodes.item(i))
+        // .forEach(value -> value.setAttribute(attribute, newValue));
+        // 4- Save the result to a new XML doc
+        TransformerFactory factory = TransformerFactory.newInstance();
+        factory.setFeature(XMLConstants.FEATURE_SECURE_PROCESSING, true);
+        Transformer xformer = factory.newTransformer();
+        xformer.setOutputProperty(OutputKeys.INDENT, "yes");
+        Writer output = new StringWriter();
+        xformer.transform(new DOMSource(this.input), new StreamResult(output));
+        return output.toString();
+    }
+}

xml-2/src/main/java/com/baeldung/xml/validation/XmlValidator.java

@@ -0,0 +1,38 @@
+package com.isharkfly.xml.attribute;
+
+import org.joox.JOOX;
+import org.joox.Match;
+import org.w3c.dom.Document;
+import org.xml.sax.SAXException;
+
+import javax.xml.parsers.DocumentBuilder;
+import javax.xml.transform.TransformerFactoryConfigurationError;
+import java.io.IOException;
+
+import static org.joox.JOOX.$;
+
+public class JooxTransformer {
+
+    private final Document input;
+
+    public JooxTransformer(String resourcePath) throws SAXException, IOException {
+        // 1- Build the doc from the XML file
+        DocumentBuilder builder = JOOX.builder();
+        input = builder.parse(resourcePath);
+    }
+
+    public String modifyAttribute(String attribute, String oldValue, String newValue) throws TransformerFactoryConfigurationError {
+        // 2- Select the document
+        Match $ = $(input);
+        // 3 - Find node to modify
+        String expr = String.format("//*[contains(@%s, '%s')]", attribute, oldValue);
+        $
+            // .find("to") or with xpath
+            .xpath(expr)
+            .get()
+            .stream()
+            .forEach(e -> e.setAttribute(attribute, newValue));
+        // 4- Return result as String
+        return $.toString();
+    }
+}