https://github.com/fluentxml4j/fluentxml4j

A fluent API for XML parsing, serialization, XPath querying and transformation in Java.
https://github.com/fluentxml4j/fluentxml4j

dom fluent fluentxml4j java java8 lambda parsing query serialization transformations xml xml-parsing xpath

Last synced: 5 days ago
JSON representation

A fluent API for XML parsing, serialization, XPath querying and transformation in Java.

• Host: GitHub
• URL: https://github.com/fluentxml4j/fluentxml4j
• Owner: fluentxml4j
• License: apache-2.0
• Created: 2017-03-14T16:55:11.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2022-02-04T07:44:48.000Z (over 2 years ago)
• Last Synced: 2024-09-24T20:50:06.120Z (9 days ago)
• Topics: dom, fluent, fluentxml4j, java, java8, lambda, parsing, query, serialization, transformations, xml, xml-parsing, xpath
• Language: Java
• Homepage:
• Size: 306 KB
• Stars: 15
• Watchers: 2
• Forks: 4
• Open Issues: 18
• Metadata Files:
  • Readme: readme.md
  • License: license

Awesome Lists containing this project

README

        
# FluentXML4J - a fluent API for XML in Java

[![Build Status](https://github.com/fluentxml4j/fluentxml4j/workflows/build/badge.svg)](https://github.com/fluentxml4j/fluentxml4j/actions) [![Code Coverage](https://codecov.io/gh/fluentxml4j/fluentxml4j/branch/master/graph/badge.svg)](https://codecov.io/gh/fluentxml4j/fluentxml4j) [![Maven Central](https://img.shields.io/maven-central/v/com.github.fluentxml4j/fluentxml4j-core.svg)](https://search.maven.org/#search%7Cga%7C1%7Cfluentxml4j-core) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0.txt)

#### XML parsing, serialization XPath querying and transformation without boilerplate code

## Features

* Simple, fluent API but full flexibility

* Parse from java.io inputs to org.w3c.dom.Document

* Serialize org.w3c.dom.Document to any java.io output

* Transform from java.io, SAX, StAX, JAXB input to any of them

  with XSLT and custom filters support

* Query org.w3c.dom.Document via XPath for String, Boolean, Number, org.w3c.dom.Element or Node,

  get the results as collections or process with the Java 8 Streaming API

* Validate document against schemas

* No (required) dependencies

## Requirements

FluentXML4J uses the builtin JDK XML parser and XPath API, but Java 8 is required because of streaming API and Optional support.

## Maven Dependency

```

  com.github.fluentxml4j

  fluentxml4j-core

  2.2.1

```

## Examples

### Parsing

```

Document doc = parse(getClass().getResourceAsStream("example.xml"))

    .document();

```

[More parsing examples...](doc/examples/parsing-examples.md)

### Serialization

```

serialize(document).to(System.err);

```

[More serialization examples...](doc/examples/serialization-examples.md)

### Transformation

```

Document resultDoc = transform(inputDoc)

        .withStylesheet(xsltInputStream)

        .toDocument();

```

[More transformation examples...](doc/examples/transformation-examples.md)

### XPath Querying

```

List elements = from(doc)

    .selectElements("//*")

    .asList();

```

[More xpath examples...](doc/examples/xpath-examples.md)

## Similar and related Projects

* [xmltool](http://code.mycila.com/xmltool) - another fluent API for XML

* [dom4j](https://dom4j.github.io/) - alternative DOM implementation

* [jdom](http://www.jdom.org/) - alternative DOM implementation

* [XMLDog](https://code.google.com/archive/p/jlibs/wikis/XMLDog.wiki) - a XML stream sniffer

## Contributing

FluentXML4J is an open source project, and contributions are welcome! Feel free to raise an issue or submit a pull request.

## License

Copyright (c) 2017 by [Cornelius Buschka](https://github.com/cbuschka).

[Apache License, Version 2.0](license)