{"id":329557,"date":"2024-05-27T07:58:31","date_gmt":"2024-05-27T07:58:31","guid":{"rendered":"https:\/\/www.baeldung.com\/java-convert-org-w3c-dom-document-to-string"},"modified":"2024-05-27T07:58:31","modified_gmt":"2024-05-27T07:58:31","slug":"how-to-convert-org-w3c-dom-document-to-string-in-java","status":"publish","type":"post","link":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/2024\/05\/27\/how-to-convert-org-w3c-dom-document-to-string-in-java\/","title":{"rendered":"How to Convert org.w3c.dom.Document to String in Java"},"content":{"rendered":"

<\/p>\n

\"start<\/p>\n

1. Overview<\/strong><\/h2>\n
<\/div>\n

When handling XML in Java, we\u2019ll often have an instance of a org.w3c.dom.Document<\/a>\u00a0<\/em>that we need to convert to a String<\/em>. Typically we might want to do this for a number of reasons, such as serialization, logging, and working with HTTP requests or responses.<\/strong><\/p>\n

In this quick tutorial, we\u2019ll see how to convert a Document<\/em> to a String<\/em>. To learn more about working with XML in Java, check out our comprehensive series on XML<\/a>.<\/p>\n

2. Creating a Simple Document<\/strong><\/h2>\n
<\/div>\n

Throughout this tutorial, the focus of our examples will be a simple XML document describing some fruit:<\/p>\n

<fruit>\r\n    <name>Apple<\/name>\r\n    <color>Red<\/color>\r\n    <weight unit="grams">150<\/weight>\r\n    <sweetness>7<\/sweetness>\r\n<\/fruit><\/code><\/pre>\n
Let’s go ahead and create an XML Document<\/em> object from that string:<\/p>\n
private static final String FRUIT_XML = "<fruit><name>Apple<\/name><color>Red<\/color><weight unit=\\"grams\\">150<\/weight><sweetness>7<\/sweetness><\/fruit>"; \r\npublic static Document getDocument() throws SAXException, IOException, ParserConfigurationException {\r\n    DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();\r\n    Document document = factory.newDocumentBuilder()\r\n      .parse(new InputSource(new StringReader(FRUIT_XML)));\r\n    return document;\r\n}<\/code><\/pre>\n
As we can see we create a factory for building a new Document,<\/em> and then we call the parse<\/em> method with the content of the given input source. In this case, our input source is a StringReader<\/em> object containing our Fruit XML string payload.<\/p>\n
3. Conversion Using XML Transformation APIs<\/strong><\/h2>\n
<\/div>\n
The javax.xml.transform<\/em><\/a> package contains a set of generic APIs for performing transformations from a source to a result<\/strong>. In our case, the source is the XML document and the result is the output string:<\/p>\n
public static String toString(Document document) throws TransformerException {\r\n    TransformerFactory transformerFactory = TransformerFactory.newInstance();\r\n    Transformer transformer = transformerFactory.newTransformer();\r\n    StringWriter stringWriter = new StringWriter();\r\n    transformer.transform(new DOMSource(document), new StreamResult(stringWriter));\r\n    return stringWriter.toString();\r\n}<\/code><\/pre>\n
Let\u2019s walk through the key parts of our toString<\/em> method:<\/p>\n
First, we start by creating our TransformerFactory<\/em>. We\u2019ll use this factory to create the transformer,\u00a0<\/b>and in this example, the transformer will simply use the platform’s default.<\/p>\n
Now, we can specify the source and result of the transformation. Here, we\u2019ll use our Document<\/em> to construct a DOM source and a StringWriter<\/em> to hold the result.<\/p>\n
Finally, we call toString\u00a0<\/em>on our StringWriter<\/em> object, which returns the character stream’s current value as a string.<\/strong><\/p>\n
4. Unit Testing<\/h2>\n
<\/div>\n
Now we have a simple way to convert XML documents to strings, let’s go ahead and test it works properly:<\/p>\n
@Test\r\npublic void givenXMLDocument_thenConvertToStringSuccessfully() throws Exception {\r\n    Document document = XmlDocumentToString.getDocument();\r\n    String expectedDeclartion = "<?xml version=\\"1.0\\" encoding=\\"UTF-8\\" standalone=\\"no\\"?>";\r\n    assertEquals(expectedDeclartion + XmlDocumentToString.FRUIT_XML, XmlDocumentToString.toString(document));\r\n}<\/code><\/pre>\n
Note that our conversion adds the standard XML declaration to the start of the string by default. In our test, we simply check that the converted string matches the original fruit XML,<\/strong>\u00a0including the standard declaration.<\/p>\n
5. Customizing the Output<\/strong><\/h2>\n
<\/div>\n
Now, let’s take a look at our output. By default, our transformer doesn’t apply any kind of output formatting:<\/p>\n
<?xml version="1.0" encoding="UTF-8" standalone="no"?><fruit><name>Apple<\/name><color>Red<\/color><weight unit="grams">150<\/weight><sweetness>7<\/sweetness><\/fruit><\/code><\/pre>\n
Obviously, it doesn’t take long for our XML documents to become difficult to read using this one-line formatting, especially for large documents. Fortunately, the Transformer<\/em> interface provides a variety of output properties to help us.\u00a0<\/em><\/p>\n
Let\u2019s refactor our transformation code a little bit using some of these output properties:<\/p>\n
public static String toStringWithOptions(Document document) throws TransformerException {\r\n    Transformer transformer = getTransformer();\r\n    transformer.setOutputProperty(OutputKeys.OMIT_XML_DECLARATION, "yes");\r\n    transformer.setOutputProperty(OutputKeys.INDENT, "yes");\r\n    transformer.setOutputProperty("{http:\/\/xml.apache.org\/xslt}indent-amount", "4");\r\n    StringWriter stringWriter = new StringWriter();\r\n    transformer.transform(new DOMSource(document), new StreamResult(stringWriter));\r\n    return stringWriter.toString();\r\n}\r\nprivate static Transformer getTransformer() throws TransformerConfigurationException {\r\n    TransformerFactory transformerFactory = TransformerFactory.newInstance();\r\n    return transformerFactory.newTransformer();\r\n}<\/code><\/pre>\n
Sometimes, we might want to exclude the XML declaration. We can configure our transformer to do this by setting the OutputKeys.OMIT_XML_DECLARATION<\/em> property.<\/p>\n
Now, to apply some indentation, we can use two properties: OutputKeys.INDENT<\/em> and the indent-amount property to specify the amount of indentation. This will indent the output correctly, as by default,\u00a0the indentation uses zero spaces.<\/p>\n
With the above properties set, we get a much nicer-looking output:<\/p>\n
<fruit>\r\n    <name>Apple<\/name>\r\n    <color>Red<\/color>\r\n    <weight unit="grams">150<\/weight>\r\n    <sweetness>7<\/sweetness>\r\n<\/fruit><\/code><\/pre>\n
6. Conclusion<\/strong><\/h2>\n
<\/div>\n
In this short article, we learned how to create an XML Document from a Java String<\/em> object, and then we saw how to convert this Document back into a String<\/em> using the javax.xml.transform<\/em><\/a> package.<\/p>\n
In addition to this, we also saw several ways we can customize the output of the XML, which can be useful when logging the XML to the console.<\/p>\n
As always, the full source code of the article is available\u00a0over on GitHub<\/a>.<\/p>\n
\"\"<\/p>\n
<\/a> <\/a> <\/a> <\/a> <\/a> <\/a> <\/a> <\/div>\n\n
\\\"IT\u96fb\u8166\u88dc\u7fd2
\u7acb\u523b\u8a3b\u518a\u53ca\u5831\u540d\u96fb\u8166\u88dc\u7fd2\u8ab2\u7a0b\u5427!<\/figcaption><\/figure>\r\n<\/br>Find A Teacher Form:\r\n<\/br>https:\/\/docs.google.com\/forms\/d\/1vREBnX5n262umf4wU5U2pyTwvk9O-JrAgblA-wH9GFQ\/viewform?edit_requested=true#responses\r\n<\/br><\/br>Email:\r\n<\/br>public1989two@gmail.com






\r\nwww.itsec.hk<\/a>
\r\nwww.itsec.vip<\/a>
\r\nwww.itseceu.uk<\/a>
<\/p>","protected":false},"excerpt":{"rendered":"
\"start<\/p>\n
Learn how to create an XML Document from a Java String object and convert it back into a String using the javax.xml.transform package.<\/p>\n
<\/a>\u00a0<\/a>\u00a0<\/a>\u00a0<\/a>\u00a0<\/a>\u00a0<\/a>\u00a0<\/a>\u00a0<\/div>\n<\/div>","protected":false},"author":881,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"slim_seo":{"title":"How to Convert org.w3c.dom.Document to String in Java - ITTeacherITFreelance.hk","description":"Learn how to create an XML Document from a Java String object and convert it back into a String using the javax.xml.transform package. \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0"},"footnotes":""},"categories":[6,1307],"tags":[10800],"_links":{"self":[{"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/posts\/329557"}],"collection":[{"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/users\/881"}],"replies":[{"embeddable":true,"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/comments?post=329557"}],"version-history":[{"count":1,"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/posts\/329557\/revisions"}],"predecessor-version":[{"id":329558,"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/posts\/329557\/revisions\/329558"}],"wp:attachment":[{"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/media?parent=329557"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/categories?post=329557"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/itteacheritfreelance.hk\/wordpress\/index.php\/wp-json\/wp\/v2\/tags?post=329557"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}