net.obvj.confectory.merger

Class JSONObjectConfigurationMerger

java.lang.Object

net.obvj.confectory.merger.AbstractConfigurationMerger<net.minidev.json.JSONObject>

net.obvj.confectory.merger.JSONObjectConfigurationMerger

All Implemented Interfaces:

ConfigurationMerger<net.minidev.json.JSONObject>

public class JSONObjectConfigurationMerger
extends AbstractConfigurationMerger<net.minidev.json.JSONObject>

A specialized ConfigurationMerger that combines two Configuration objects of type JSONObject (json-smart implementation) into a single one.

The resulting JSON document from the merge operation shall contain all exclusive objects from source documents and in case of In case of key collisions (i.e., the same key appears in both documents), the following rules will be applied:

• for simple values, such as strings, numbers and boolean values, the value from the highest-precedence Configuration will be selected;
• if the value is a JSON object in both JSON sources, the two objects will be merged recursively; if the types are not compatible (e.g.: JSON object in one side and simple value or array in the other), then a copy of the object from the highest-precedence Configuration will be selected as fallback;
• if the value is a JSON array in both JSON sources, then all elements from both two arrays will be copied distinctively (i.e., repeated elements will not be copied to the resulting JSON document); if the types are not compatible (e.g.: JSON array in one side and simple value or complex object in the other), then a copy of the object from the highest-precedence Configuration will be selected as fallback

A special solution for merging arrays of distinct objects with a specific key can be created using the optional constructor JSONObjectConfigurationMerger(Map).

Since:

2.1.0

Author:

oswaldo.bapvic.jr (Oswaldo Junior)

See Also:

ConfigurationMerger

Constructor Summary

Constructors

Constructor and Description
JSONObjectConfigurationMerger() Creates a standard JSONObjectConfigurationMerger.
JSONObjectConfigurationMerger(Map<String,String> distinctObjectKeysInsideArrays) Creates a new JSONObjectConfigurationMerger with a map of distinct keys associated with specific JsonPath expressions.

Method Summary

Methods inherited from class net.obvj.confectory.merger.AbstractConfigurationMerger

merge

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JSONObjectConfigurationMerger

public JSONObjectConfigurationMerger()

Creates a standard JSONObjectConfigurationMerger.

JSONObjectConfigurationMerger

public JSONObjectConfigurationMerger(Map<String,String> distinctObjectKeysInsideArrays)

Creates a new JSONObjectConfigurationMerger with a map of distinct keys associated with specific JsonPath expressions.

Use the distinctObjectKeysInsideArrays map to specify how to combine arrays of objects inside the JSON. For example, considering the following document:

 {
   "params": [
     {
       "param": "name",
       "value": "John Doe"
     },
     {
       "param": "age",
       "value": 33
     }
   ]
 }
 

A map containing an entry with the key "$.params" associated with the "param" value tells the algorithm to check for distinct objects identified by the value inside the "param" field during the merge of the "$.params" array.

In other words, if two JSON documents contain different objects identified by the same "param" attribute inside the array returned by the JsonPath expression "$.params", then only the object from the Configuration with the highest precedence will be selected.

A JsonPath expression can be specified using either dot- or bracket-notation, but complex expressions containing filters, script, subscript, or union operations, are not supported.

Parameters:

distinctObjectKeysInsideArrays - a map that associates JsonPath expressions inside the JSONObject and object keys for distinction during the merge of an array; null is allowed

Throws:

IllegalArgumentException - if the specified expression is null or empty

com.jayway.jsonpath.InvalidPathException - if the specified JsonPath expression is invalid