Need help with jOOX?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

jOOQ
448 Stars 39 Forks Apache License 2.0 233 Commits 51 Opened issues

Description

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.

Services available

!
?

Need anything else?

Contributors list

Overview

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.

Dependencies

  • java.sql
  • java.xml
  • java.xml.bind

Download

For use with Java 9+

  org.jooq
  joox
  1.6.2

For use with Java 6+

  org.jooq
  joox-java-6
  1.6.2

Simple example

// 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");

Examples

For the following examples, we're going to operate on this XML document modelling a library with books and dvds:

XML document

  
    
      
        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>

Java code accessing that document

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:

Navigation methods

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]");

Manipulation methods

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));

Similar tools

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:

  • https://github.com/chrsan/css-selectors

Other platform ports:

  • A PHP-port of jQuery: http://fluentdom.github.com/
  • Another PHP-port of jQuery: http://code.google.com/p/phpquery/

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.