JarCastingsimter-json [中文]
Json extension tools for JSR-353 (Java API for JSON Processing).
JsonObject and JsonArray are design to be a immutable object. Once created, it can not be changed. But sometimes we need to modify or extend it. This is the target of this extension tools.
Installation
<dependency>
<groupId>tech.simter</groupId>
<artifactId>simter-json</artifactId>
<version>1.0.0</version>
</dependency>
Requirement
- Java 8+
- At lease one JSR-353 provider (Java API for JSON Processing)
e.g. Genson, Jackson, Glassfish
Usage: JSR-353 base code
Create a standard JsonObject
JsonObject jsonObject = Json.createObjectBuilder()
.add("str", "a")
.add("num", 1)
.add("bool", false)
.addNull("k")
.build();
Create a standard JsonArray
JsonArray jsonArray = Json.createArrayBuilder()
.add(10)
.add(1.1)
.add(true)
.addNull()
.build();
Usage: This extensions code
Extend a JsonObject
JsonObject extended = JsonUtils.toBuilder(jsonObject)
.add("newKey", "newValue")
.build();
Extend a JsonArray
JsonArray extended = JsonUtils.toBuilder(jsonArray)
.add("newItem")
.build();
Merge multiple JsonObject or JsonObjectBuilder
JsonObject merged = JsonUtils.merge(jsonObject1, jsonObject2, ...).build();
// or
JsonObjectBuilder merged = JsonUtils.merge(jsonObjectBuilder1, jsonObjectBuilder2, ...);
Merge multiple JsonArray or JsonArrayBuilder
JsonArray merged = JsonUtils.merge(jsonArray1, jsonArray2, ...).build();
// or
JsonArrayBuilder merged = JsonUtils.merge(jsonArrayBuilder1, jsonArrayBuilder2, ...);
Build
mvn clean package
Deploy
First take a look at simter-parent deploy config.
Deploy to LAN Nexus Repository
mvn clean deploy -P lan
Deploy to Sonatype Repository
mvn clean deploy -P sonatype
After deployed, login into https://oss.sonatype.org. Through Staging Repositories, search this package, then close and release it. After couple hours, it will be synced to Maven Central Repository.
Deploy to Bintray Repository
mvn clean deploy -P bintray
Will deploy to https://api.bintray.com/maven/simter/maven/tech.simter:simter-json/;publish=1. So first create a package https://bintray.com/simter/maven/tech.simter:simter-json on Bintray. After deployed, check it from https://jcenter.bintray.com/tech/simter/simter-json.
