The functionality of Document in a parser implementation

Question

Recently I was studying about parsers including the design patterns used to built one. The example I have chosen is javax.xml.parsers and org.w3c.dom packages.

Looks like factory and builder patterns used to design the parser structure in these packages. DocumentBuilderFactory is to return an immediate factory to build DocumentBuilder. DocumentBuilder, then, uses its parse() method to parse an xml file; but the return type is Document in this case: Document doc = builder.parse(in);

But, what I didn't get here is Document is an interface which contains plenty of methods to manipulate XML attributes. It also extends Node interface. We can still call its operations: doc.hasAttributes() or doc.getChildNodes() etc.

I spent an hour on this, but still couldn't get the logic behind this architecture:

1) Where are those Document's methods implemented?

2) Why is it better to return interface type object (Document) to represent the DOM object after parsing?

Andreas Dolk · Accepted Answer · 2010-12-10 22:47:59Z

2

Document, Node, Element and all of the other types are interfaces. There are a couple of libraries around that provide an implementation for those interfaces - one prominent example is Apache Xerces. From their front page:

Xerces2 also provides a complete implementation of the Document Object Model Level 3 Core and Load/Save W3C Recommendations and provides a complete implementation of the XML Inclusions (XInclude) W3C Recommendation.

If you exactly need to know which implementation of DOM is actually used, start a debugger or dump the class name of your Document object to the console/log.

edited Dec 10, 2010 at 22:47

answered Dec 10, 2010 at 8:02

Andreas Dolk

115k20 gold badges185 silver badges275 bronze badges

Sign up to request clarification or add additional context in comments.

Comments

Istao · Accepted Answer · 2010-12-10 08:10:26Z

0

You have, on the DocumentBuilderFactory javadoc, the policy to get the real class DocumentBuilderFactory, and all the rest, at public static DocumentBuilderFactory newInstance().

answered Dec 10, 2010 at 8:10

Istao

7,5956 gold badges35 silver badges39 bronze badges

Collectives™ on Stack Overflow

The functionality of Document in a parser implementation

2 Answers 2

Comments

Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

2 Answers 2

Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Related