commons-xml

A lightweight and efficient Java library for XML processing and manipulation. This library provides comprehensive utilities for parsing, creating, validating, and transforming XML documents with a focus on simplicity and performance.

Features

• XML Parsing: Easy-to-use utilities for parsing XML documents from files, resources, or strings
• XML Creation: Programmatic XML document creation with fluent API
• XPath Support: Advanced XPath expression support with namespace handling
• Schema Validation: Validate XML documents against XSD schemas
• DOM Manipulation: Comprehensive DOM utilities for working with XML elements and attributes
• Namespace Support: Built-in namespace context management for complex XML documents

Requirements

• Java 8 or higher (supports Java 8, 11, 17, and 21)
• Maven 3.6 or higher

Installation

Maven

<dependency>
<groupId>com.dataliquid</groupId>
<artifactId>commons-xml</artifactId>
<version>1.2.0</version>
</dependency>

Gradle

implementation 'com.dataliquid:commons-xml:1.2.0'

Quick Start

Here's a simple example demonstrating XML document creation and manipulation:

importcom.dataliquid.commons.xml.DomUtils;
importorg.w3c.dom.Document;
importorg.w3c.dom.Element;
publicclassExample {
publicstaticvoidmain(String[] args) {
// Create an empty XML document using DomUtilsDocumentdocument = DomUtils.createDocument();
// Create the root elementElementrootElement = DomUtils.createElement(document, "root");
DomUtils.appendChild(document, rootElement);
// Add a child elementElementchildElement = DomUtils.createElement(document, "child");
DomUtils.setTextContent(childElement, "Hello, World!");
DomUtils.appendChild(rootElement, childElement);
// Represent the document as xml string using DomUtilsStringxml = DomUtils.asXml(document);
System.out.println("XML: " + xml);
}
}

For more detailed examples including XPath queries, namespace handling, and schema validation, see EXAMPLES.md.

Building from Source

To build the project from source:

git clone https://github.com/dataliquid/commons-xml.git
cd commons-xml
mvn clean install

Running Tests

mvn test

Contributing

We welcome contributions to the commons-xml project! If you have found a bug, want to propose an improvement, or add a new feature, please follow these steps:

1. Fork the repository
2. Create a new branch for your changes: git checkout -b feature/my-feature
3. Make your changes and add tests
4. Run tests to ensure everything works: mvn test
5. Commit your changes: git commit -m 'Add my feature'
6. Push to your fork: git push origin feature/my-feature
7. Create a Pull Request

Please ensure your code follows the existing code style and includes appropriate tests.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.