How to parse a DocumentFragment with with the Java standard DOM API

Question

This is how I can parse a well-formed XML document in Java:

DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
DocumentBuilder builder = factory.newDocumentBuilder();

// text contains the XML content
Document doc = builder.parse(new InputSource(new StringReader(text)));

An example for text is this:

<a>
  <b/>
</a>

How can I parse a DocumentFragment? For example, this:

<a>
  <b/>
</a>
<a>
  <b/>
</a>

NOTE: I want to use org.w3c.dom and no other libraries/technologies, if possible.

Lukas Eder · Accepted Answer · 2011-08-11T15:30:29.557

6

I just thought of a silly solution. I could wrap the fragment in a dummy element like this:

<dummy><a>
  <b/>
</a>
<a>
  <b/>
</a></dummy>

And then programmatically filter out that dummy element again, like this:

String wrapped = "<dummy>" + text + "</dummy>";
Document parsed = builder.parse(new InputSource(new StringReader(wrapped)));
DocumentFragment fragment = parsed.createDocumentFragment();

// Here, the document element is the <dummy/> element.
NodeList children = parsed.getDocumentElement().getChildNodes();

// Move dummy's children over to the document fragment
while (children.getLength() > 0) {
    fragment.appendChild(children.item(0));
}

But that's a bit lame, let's see if there is any other solution.

edited Aug 11 '11 at 15:30

answered Aug 11 '11 at 13:12

Lukas Eder

211,314
129
689
1,509

Exactly what I was going to suggest - you beat me to it. – Eli Acherkan Aug 11 '11 at 13:18
XML parsers in other platforms support a DocumentFragment so you needn't add a hack – Phlip Dec 31 '19 at 18:05
@Phlip: What are those "other platforms", and how would that have helped me back when I asked / answered this question? – Lukas Eder Jan 01 '20 at 17:05
Gnome's libxml2 (which Python and Ruby use) permit fragments. But I admit I'm not helping you so much as trying to help the community... – Phlip Jan 01 '20 at 22:42
1

@Phlip: This is a quite Java specific question about *"the Java standard DOM API"*, so I'm not convinced this helps the community... – Lukas Eder Jan 02 '20 at 10:46

score 0 · Answer 2 · answered Mar 28 '14 at 18:01

0

Further expanding on the answers already given:

public static DocumentFragment stringToFragment(Document document, String source) throws Exception
{
    source = "<dummy>" + source + "</dummy>";
    Node node = stringToDom(source).getDocumentElement();
    node = document.importNode(node, true);
    DocumentFragment fragment = document.createDocumentFragment();
    NodeList children = node.getChildNodes();
    while (children.getLength() > 0)
    {
        fragment.appendChild(children.item(0));
    }
    return fragment;
}

answered Mar 28 '14 at 18:01

craigrs84

3,048
1
27
34

1

All you need is a stringToDom() now. – MGM Jul 17 '20 at 18:11
I think an answer https://stackoverflow.com/a/1509229/16673 shows how this can be implemented – Suma Apr 29 '21 at 06:49

score -2 · Answer 3 · answered Aug 11 '11 at 17:41

-2

I would suggest not using the DOM API. It's slow and ugly.

Use streaming StAX instead. It's built into JDK 1.6+. You can fetch one element at a time, and it won't choke if you're missing a root element.

http://en.wikipedia.org/wiki/StAX

http://download.oracle.com/javase/6/docs/api/javax/xml/stream/XMLStreamReader.html

answered Aug 11 '11 at 17:41

ccleve

15,239
27
91
157

Thanks. I don't have a choice but to use DOM, as I'm working on a big legacy system. Generally, it's neither slow nor ugly, IMO... Unless you can prove slowness to me with benchmarks? – Lukas Eder Aug 11 '11 at 17:43
2

I suppose slow is a relative term. DOM is fine for smaller documents. For large ones it consumes too much memory, and that's what slows things down. – ccleve Apr 20 '12 at 19:48
1

@ccleve A minimal example using StAX (Java 1.7, Xerces as implementation) will show that it _will_ choke to death if the xml is not well formed (missing a root element). Using `` will result in an `XMLStreamException` stating _"The markup in the document following the root element must be well-formed"_. My intention was to use StAX to assemble a `DocumentFragment` object. Do you have an example of using StAX in this manner? It would be nice to create `DocumentFragment`s without having to implement a parser or wrap things in dummy tags. – Rob Hall Mar 07 '14 at 17:57

How to parse a DocumentFragment with with the Java standard DOM API

3 Answers3