JDOM2 Features

JDOM2 Features

Apart from the details described below, it is important not to forget that JDOM2 is delivered with a completely different package name: - all JDOM2 classes are now in the org.jdom2.* package hierarchy.

This change is guaranteed to break all compatibility with JDOM1. The decision was made to do it this way so that:

1. changes to the API are possible
2. JDOM users will need to re-visit their code to change the import statements (at least) and at that time they can take advantage of other JDOM2 features
3. it is possible to simultaneously run both JDOM and JDOM2 in the same Java VM if necessary.

In addition to this obvious change, there are a lot of other changes.

• Generics
• Namespaces In Scope
• Collections (and Iterators)
• XPath Upgrade
• Extended Filter Interface
• Content.CType
• AttributeType Enumeration
• SAX Parsing Updates
• StAX Support
• Attribute is Content
• Outputter Updates
• End-of-line Sequence
• JDOMConstants
• Element.sort*(Comparator<...>)

In addition to the major extensions and features above a number of other notable changes have been made too.

Reflection

There were a number of places in JDOM where reflection and introspection was used to determine what features were available. This sort of logic was required to support Java 1.2 while still also making certain Java 1.4 functionality possible. These places have been stripped and replaced with cleaner direct access to code functionality, which now effectively precludes support for previous versions of Java, but that's what JDOM2 is all about.

JDOMFactory

This interface has been slightly extended to include methods for handling Attributes with the new AttributeType enum. Additionally, there is now a setRoot() factory method.