https://github.com/atomgraph/json2xml
Streaming generic JSON to XML converter. Uses XSLT 3.0 XML representation.
https://github.com/atomgraph/json2xml
converter docker-image json json2xml streaming transformation xml xslt xslt-3
Last synced: 2 months ago
JSON representation
Streaming generic JSON to XML converter. Uses XSLT 3.0 XML representation.
- Host: GitHub
- URL: https://github.com/atomgraph/json2xml
- Owner: AtomGraph
- License: apache-2.0
- Created: 2019-03-26T22:01:50.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-08-31T19:08:57.000Z (about 2 years ago)
- Last Synced: 2025-07-25T17:59:48.131Z (2 months ago)
- Topics: converter, docker-image, json, json2xml, streaming, transformation, xml, xslt, xslt-3
- Language: Java
- Homepage: https://hub.docker.com/r/atomgraph/json2xml
- Size: 45.9 KB
- Stars: 21
- Watchers: 5
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# JSON2XML
Streaming JSON to XML converter
Reads any JSON data and produces [XML Representation of JSON](https://www.w3.org/TR/xslt-30/#json-to-xml-mapping) specified in XSLT 3.0.
JSON2XML enables JSON transformation with XSLT even without having an XSLT 3.0 processor. You can simply pre-process the data by having JSON2XML before the transformation, and pipeline it into an XSLT 2.0 stylesheet, for example. That way your stylesheet stays forward compatible with XSLT 3.0, as the XML representation is exactly the same.
## Invalid characters
The JSON input might contain characters (for example, form feed `\f`) which would be invalid in the XML output. The [`json-to-xml()` function](https://www.w3.org/TR/xslt-30/#func-json-to-xml) specifies character escape rules that apply in this case.
JSON2XML currently implements only the default escape rule:
> Any characters or codepoints that are not valid XML characters (for example, unpaired surrogates) are passed to the fallback function as described below; in the absence of a fallback function, they are replaced by the Unicode `REPLACEMENT CHARACTER (xFFFD)`.
## Build
mvn clean install
That should produce an executable JAR file `target/json2xml-jar-with-dependencies.jar` in which dependency libraries will be included.
## Maven
Each version is released to the Maven central repository as [`com.atomgraph.etl.json/json2xml`](https://central.sonatype.com/artifact/com.atomgraph.etl.json/json2xml)
## Usage
The JSON data is read from `stdin`, UTF-8 encoding is expected. The resulting XML data is written to `stdout`.
JSON2XML is available as a `.jar` as well as a Docker image [atomgraph/json2xml](https://hub.docker.com/r/atomgraph/json2xml) (recommended).
## Example
JSON data in `city-distances.json`:
```json
{
"desc" : "Distances between several cities, in kilometers.",
"updated" : "2014-02-04T18:50:45",
"uptodate": true,
"author" : null,
"cities" : {
"Brussels": [
{"to": "London", "distance": 322},
{"to": "Paris", "distance": 265},
{"to": "Amsterdam", "distance": 173}
],
"London": [
{"to": "Brussels", "distance": 322},
{"to": "Paris", "distance": 344},
{"to": "Amsterdam", "distance": 358}
],
"Paris": [
{"to": "Brussels", "distance": 265},
{"to": "London", "distance": 344},
{"to": "Amsterdam", "distance": 431}
],
"Amsterdam": [
{"to": "Brussels", "distance": 173},
{"to": "London", "distance": 358},
{"to": "Paris", "distance": 431}
]
}
}
```
Java execution from shell:
cat city-distances.json | java -jar json2xml-jar-with-dependencies.jar > city-distances.xml
Alternatively, Docker execution from shell:
cat city-distances.json | docker run --rm -i -a stdin -a stdout -a stderr atomgraph/json2xml > city-distances.xml
Note that you need to [bind](https://docs.docker.com/engine/reference/commandline/run/#attach-to-stdinstdoutstderr--a) `stdin`/`stdout`/`stderr` when running JSON2XML as a Docker container.
Output in `city-distances.xml` (indented for clarity):
```xml
Distances between several cities, in kilometers.
2014-02-04T18:50:45
true
London
322
Paris
265
Amsterdam
173
Brussels
322
Paris
344
Amsterdam
358
Brussels
265
London
344
Amsterdam
431
Brussels
173
London
358
Paris
431
```
## Dependencies
* [javax.json](https://mvnrepository.com/artifact/org.glassfish/javax.json)