https://github.com/smooks/smooks-json-cartridge

Smooks JSON Cartridge
https://github.com/smooks/smooks-json-cartridge

json json-to-xml smooks-cartridge

Last synced: about 2 months ago
JSON representation

Smooks JSON Cartridge

• Host: GitHub
• URL: https://github.com/smooks/smooks-json-cartridge
• Owner: smooks
• License: other
• Created: 2020-03-15T18:57:24.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2024-05-06T22:46:24.000Z (9 months ago)
• Last Synced: 2024-05-20T12:14:36.123Z (9 months ago)
• Topics: json, json-to-xml, smooks-cartridge
• Language: Java
• Homepage: https://www.smooks.org
• Size: 153 KB
• Stars: 1
• Watchers: 2
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.adoc
  • License: LICENSE

Awesome Lists containing this project

README

        
= Smooks JSON Cartridge

image:https://img.shields.io/maven-central/v/org.smooks.cartridges/smooks-json-cartridge[Maven Central]

image:https://img.shields.io/nexus/s/org.smooks.cartridges/smooks-json-cartridge?server=https%3A%2F%2Foss.sonatype.org[Sonatype Nexus (Snapshots)]

image:https://github.com/smooks/smooks-json-cartridge/workflows/CI/badge.svg[Build Status]

// tag::smooks-json-cartridge[]

Processing JSON with Smooks requires a JSON reader to be configured:

.smooks-config.xml

[source,xml]

----

  

  

      

----

The XML element name of the root element, the element name of document and the element name of array elements can be configured with the following configuration options:

* `+rootName+`: The name of the root element. Default: `+json+`.

* `+arrayElementName+`: The name of a sequence element. Default: `+element+`.

JSON allows characters in the key name that aren't allowed in XML element name. To workaround that problem the reader offers multiple solutions. The JSON reader can search and replace whitespaces, illegal characters and the number in key names that start with a number. It is also possible to replace one key name with a completely different name. The following example demonstrates all these features:

.smooks-config.xml

[source,xml]

----

  

  

      

          

            someKey  

              

          

      

----

* `+keyWhitspaceReplacement+`: The replacement character for whitespaces in a json map key. By default this not defined, so that the reader doesn't search for white spaces.

* `+keyPrefixOnNumeric+`: The prefix character to add if the JSON node name starts with a number. By default this is not defined, so that the reader doesn't search for element names that start with a number.

* `+illegalElementNameCharReplacement+`: If illegal characters are encountered in a JSON element name then they are replaced with this value.

The following options can also be configured on the JSON reader:

* `+nullValueReplacement+`: The replacement string for JSON NULL values.

Default is an empty string.

* `+encoding+`: The default encoding of any JSON message InputStream

processed by this Reader. Default of 'UTF-8'. 

NOTE: You shouldn't need this configuration parameter and *it will be removed in a future release*. Instead, you should manage the JSON stream Source character encoding by supplying a `+java.io.Reader+` to the `+Smooks.filterSource()+` method.

== Java API

Smooks is programmatically configured to read a JSON configuration using the link:/javadoc/v1.7.1/smooks/org/milyn/json/JSONReaderConfigurator.html[JSONReaderConfigurator]

class.

[source,java]

----

Smooks smooks = new Smooks();  

smooks.setReaderConfig(new JSONReaderConfigurator()  

        .setRootName("root")  

        .setArrayElementName("e"));  

// Use Smooks as normal...

...

----

== Maven Coordinates

.pom.xml

[source,xml]

----

    org.smooks.cartridges

    smooks-json-cartridge

    2.0.1

    

----

== XML Namespace

....

xmlns:json="https://www.smooks.org/xsd/smooks/json-1.3.xsd"

....

// end::smooks-json-cartridge[]