Contribution:

jdom

Headline

XML processing with Java's JDOM API

Characteristics

See Contribution:dom for a general motivation for exercising in-memory XML processing. The present implementation simply exercises yet another DOM-like API.

Illustration

The data model is implemented as xml files (sampleCompany.xml) that conform to a schema (Company.xsd).

Feature:Parsing is implemented by loading a Technology:JDOM Document object:

    public static Document parseCompany(String file) throws IOException, JDOMException {
        return new SAXBuilder().build(new File(file));
    }

Feature:Total and Feature:Cut are implemented using methods of Technology:JDOM's Document class:

    public static double total(Document doc) {

        // Aggregate salaries
        double total = 0;

        // Iterate over all salary elements
        Iterator<?> iterator = doc.getDescendants(new ElementFilter("salary"));
        while (iterator.hasNext()) {
            Element elem = (Element)iterator.next();
            Double salary = Double.valueOf(elem.getText());
            total += salary;
        }

        return total;
    }

    public static void cut(Document doc) {

        // Iterate over all salary elements
        Iterator<?> iterator = doc.getDescendants(new ElementFilter("salary"));

        // Snapshot these elements before modification
        List<Element> elems = new LinkedList<Element>();
        while (iterator.hasNext())
            elems.add((Element)iterator.next());

        // Iterate over salary elements and cut salaries
        for (Element elem : elems) {
            Double salary = Double.valueOf(elem.getText());
            elem.setText(Double.toString(salary/2));
        }
    }

Test cases are implemented for all Namespace:Features.

Relationships

For DOM-like implementations of in-memory XML processing see Contribution:dom, Contribution:jdom and Contribution:xom.
For a query-based implementation of in-memory XML processing see Contribution:xpathAPI.
For push-based XML processing see Contribution:sax.
For Object/XML mapping see Contribution:jaxbChoice (XSD with choice for different subunits), Contribution:jaxbComposition (XSD with object composition), Contribution:jaxbExtension (XSD with type extension) and Contribution:jaxbSubstitution (XSD with substitution groups).
Contribution:jdomHttp uses HTTP-based access to the input data instead of going through the file system.

Architecture

The contribution follows a standardized structure:

inputs contains input files for tests
src/main/java contains the following packages:
- org.softlang.company.features for implementations of Functional requirements.
src/test/java contains the following packages:
- org.softlang.company.tests for Technology:JUnit test cases for Namespace:Features.