Reading XML using Groovy's DOMCategory

Information

Java has in-built support for DOM processing of XML using classes representing the various parts of XML documents, e.g. Document, Element, NodeList, Attr etc. For more information about these classes, refer to the respective JavaDocs. Some of the key classes are:

DOM class	JavaDocs
Element	1.4 5
NodeList	1.4 5

Groovy syntax benefits can be applied when using these classes resulting in code which is similar to but more compact than the Java equivalent. In addition, Groovy supports the following built-in helper method for these classes.

DOM class	Method	Description/Equivalent longhand
NodeList	.iterator()	same as for loop, enables closures, e.g. findAll, every, etc.

In addition, the DOMCategory class provides numerous additional helper methods and syntax shortcuts:

DOM class	Method	Description/Equivalent longhand
Element	.'child'	.getElementsByTagName('child')
Element	.child	.getElementsByTagName('child')
Element	.''*	.getElementsByTagName('')*
Element	.'@attr'	.getAttribute('attr')
Element	.text()	.firstChild.nodeValue (or textContent if you are using Xerces)
Element	.name()	.nodeName
Element	.parent()	.parentNode
Element	.children()	.childNodes (potentially including whitespace textnodes etc.)
NodeList	.size()	.length
NodeList	[n]	.item(n)
NodeList	.text()	.collect{ it.text() }
NodeList	.child	flattened version of .getElementsByTagName('child') for each node in the NodeList

All these methods return either Element or NodeList classes or String values for attributes. There are no new classes to know about, just some improved syntax.

Example

This example assumes the following class is already on your CLASSPATH:

XmlExamples.groovy

Here is an example of using Groovy's DOMCategory: