json-merge

A light weight library to merge two json objects into a single json object.

License	The Apache License, Version 2.0
Categories	Ant Build Tools JSON Data
GroupId	com.github.hemantsonu20
ArtifactId	json-merge
Last Version	1.0.2
Release Date	Sep 1, 2020
Type	jar
Description	json-merge A light weight library to merge two json objects into a single json object.
Source Code Management	https://github.com/hemantsonu20/json-merge

Download json-merge

Filename	Size
json-merge-1.0.2.pom
json-merge-1.0.2.jar	4 KB
json-merge-1.0.2-sources.jar	4 KB
json-merge-1.0.2-javadoc.jar	29 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.hemantsonu20/json-merge/ -->
<dependency>
    <groupId>com.github.hemantsonu20</groupId>
    <artifactId>json-merge</artifactId>
    <version>1.0.2</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.hemantsonu20/json-merge/
implementation 'com.github.hemantsonu20:json-merge:1.0.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.hemantsonu20/json-merge/
implementation ("com.github.hemantsonu20:json-merge:1.0.2")

Apache Buildr

'com.github.hemantsonu20:json-merge:jar:1.0.2'

Apache Ivy

<dependency org="com.github.hemantsonu20" name="json-merge" rev="1.0.2">
  <artifact name="json-merge" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.hemantsonu20', module='json-merge', version='1.0.2')
)

Scala SBT

libraryDependencies += "com.github.hemantsonu20" % "json-merge" % "1.0.2"

Leiningen

[com.github.hemantsonu20/json-merge "1.0.2"]

Dependencies

compile (1)

Group / Artifact	Type	Version
com.fasterxml.jackson.core : jackson-databind	jar	2.11.2

test (1)

Group / Artifact	Type	Version
org.junit.jupiter : junit-jupiter	jar	5.6.2

Project Modules

There are no modules declared in this project.

json-merge

A light weight library to merge two json objects into a single json object.

Overview

This library merges two json of any nested level into a single json following below logic.

• When keys are different, both keys with there values will be copied at same level.

• When keys are same at some level, following table denotes what value will be used.

  Src / Target	JSON Value	JSON Array	JSON Object
  JSON Value1	Src	Src	Src
  JSON Array	Src2	Merge	Src
  JSON Object	Src	Src	Merge3

  ¹ Json Value denotes boolean, number or string value in json.
  ² Src denotes Src value will be copied.
  ³ Merge denotes both Src and Target values will be merged.

Maven Artifact

To use this library add below to your dependencies in pom.xml.

<dependency>
  <groupId>com.github.hemantsonu20</groupId>
  <artifactId>json-merge</artifactId>
  <version>1.0.2</version>
</dependency>

Usage

This library exposes below method. It accepts source and target json and returns the merged json.

public static String merge(String srcJsonStr, String targetJsonStr);

Method Usage

String srcJsonStr = "{\"name\":\"json-merge\"}";
String targetJsonStr = "{\"age\":18}";
String output = JsonMerge.merge(srcJsonStr, targetJsonStr);
// {"name":"json-merge","age":18}

Examples

Example 1

Source Json

{
  "name": "json-merge-src"
}

Target Json

{
  "name": "json-merge-target"
}

Output

{
  "name": "json-merge-src"
}

Example 2

Source Json

{
  "level1": {
    "key1": "SrcValue1"
  }
}

Target Json

{
  "level1": {
    "key1": "targetValue1",
    "level2": {
      "key2": "value2"
    }
  }
}

Output Json

{
  "level1": {
    "key1": "SrcValue1",
    "level2": {
      "key2": "value2"
    }
  }
}

For more examples see, test json files.
Each test json file contains a json array of three json objects, first is src, second is target and third is output json.

Documentation

• Javadoc Releases are available at javadoc.io. (See javadoc badge above)
• Javadoc for latest code available via github pages here.

Contributing

See Contributing Guidelines

License

Apache License Version 2.0

Versions

Version
1.0.2 Sep 1, 2020
1.0.1 Aug 24, 2020
1.0.0 Aug 23, 2020