jOOX - The Power of jQuery Applied to W3C DOM Like JDBC, DOM is a powerful, yet very verbose low-level API to manipulate XML. The HTML DOM an be manipulated with the popular jQuery product, in JavaScript. Why don't we have jQuery in Java? jOOX is jQuery's XML parts, applied to Java.
jOOX stands for jOOX Object Oriented XML. It is a simple wrapper for the org.w3c.dom package, to allow for fluent XML document creation and manipulation where DOM is required but too verbose. jOOX only wraps the underlying document and can be used to enhance DOM, not as an alternative.
jOOX's fluency is inspired by jRTF, a very nice fluent API for the creation of RTF documents in Java.
jOOX's API itself is inspired by jQuery, an excellent !JavaScript library for efficient DOM manipulation of HTML and XML.
jOOX's name is inspired by jOOQ, a fluent API for SQL building and execution.
For use with Java 9+
org.jooq joox 1.6.2
For use with Java 6+
org.jooq joox-java-6 1.6.2
// Find the order at index 4 and add an element "paid" $(document).find("orders").children().eq(4).append("true");// Find those orders that are paid and flag them as "settled" $(document).find("orders").children().find("paid").after("true");
// Add a complex element $(document).find("orders").append( $("order", $("date", "2011-08-14"), $("amount", "155"), $("paid", "false"), $("settled", "false")).attr("id", "13");
For the following examples, we're going to operate on this XML document modelling a library with books and dvds:
1984 George Orwell Animal Farm George Orwell O Alquimista Paulo Coelho Brida Paulo Coelho<dvds> <dvd id="5"> <name>Once Upon a Time in the West</name> <directors> <director>Sergio Leone</director> </directors> <actors> <actor>Charles Bronson</actor> <actor>Jason Robards</actor> <actor>Claudia Cardinale</actor> </actors> </dvd> </dvds>
Like many fluent API's jOOX relies on static methods. Since Java 5 and static imports, using jOOX is very simple. Just import
import static org.joox.JOOX.*;
Using the above static import wrapping DOM objects with jOOX is very simple:
All navigation methods will return a new wrapper containing references to resulting DOM elements:
// Parse the document from a file Document document = $(xmlFile).document();// Wrap the document with the jOOX API Match x1 = $(document);
// This will get all books (wrapped DOM Elements) Match x2 = $(document).find("book");
// This will get all even or odd books Match x3 = $(document).find("book").filter(even()); Match x4 = $(document).find("book").filter(odd());
// This will get all book ID's List ids = $(document).find("book").ids();
// This will get all books with ID = 1 or ID = 2 Match x5 = $(document).find("book").filter(ids(1, 2));
// Or, use css-selector syntax: Match x6 = $(document).find("book#1, book#2");
// This will use XPath to find books with ID = 1 or ID = 2 Match x7 = $(document).xpath("//book[@id = 1 or @id = 2]");
All jOOX manipulations are executed on the underlying DOM document:
// This will add a new book $(document).find("books").append("Harry Potter");// But so does this $(document).find("book").filter(ids(5)).after("");
// This will remove book ID = 1 $(document).find("book").filter(ids(1)).remove();
// Or this $(document).find("book").remove(ids(1));
Inspiration might be taken from similar products, such as
The original: http://jquery.com
A Java-port of jQuery: http://jsoup.org/
Another Java-port: http://jodd.org/doc/jerry/index.html
A GWT-port of jQuery: http://code.google.com/p/gwtquery/
Unfortunately, all of the above projects focus on HTML, not on arbitrary XML. Besides, jsoup completely rebuilt a proprietary parser / DOM structure, which is incompatible with the org.w3c.dom package.
jOOX uses css-selectors for parsing css selector expressions:
Other platform ports: