com.dkfqs.tools.json

Class SimpleJsonValueModifier

java.lang.Object

com.dkfqs.tools.json.SimpleJsonValueModifier

public class SimpleJsonValueModifier
extends java.lang.Object

Modify Json values of Json data selected by simple Json queries.

Programming Example:

String jsonSource = "{\"testArray\":[1,2,3,{\"A\":5,\"B\":7},\"X\"],\"tail\":9}";
SimpleJsonValueModifier jsonValueModifier = new SimpleJsonValueModifier(jsonSource);
if (jsonValueModifier.update("testArray.[3].A", Json.value(23))) {
   System.out.println(jsonValueModifier.getResultRoot().toString() + "  |  " + jsonValueModifier.getOldValue().toString());
   // {"testArray":[1,2,3,{"A":23,"B":7},"X"],"tail":9}  |  5
}
else {
   System.out.println("[No match found]");
}

Constructor Summary

Constructors

Constructor and Description
SimpleJsonValueModifier(java.io.Reader jsonReader) Create a new instance from a Json Reader.
SimpleJsonValueModifier(java.lang.String jsonSource) Create a new instance from a Json String.

Method Summary

Modifier and Type	Method and Description
JsonValue	getOldValue() Get the old value of the latest executed update.
JsonValue	getResultRoot() Get the root of the modified Json data.
boolean	update(java.lang.String simpleQuery, JsonValue newValue) Modify/update a Json value selected by a simple Json query.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleJsonValueModifier

public SimpleJsonValueModifier(java.lang.String jsonSource)

Create a new instance from a Json String.

Parameters:

jsonSource - a String containing the Json data

SimpleJsonValueModifier

public SimpleJsonValueModifier(java.io.Reader jsonReader)
                        throws java.io.IOException

Create a new instance from a Json Reader.

Parameters:

jsonReader - a Reader for the Json data

Throws:

java.io.IOException - if somewhat fails.

Method Detail

update

public boolean update(java.lang.String simpleQuery,
                      JsonValue newValue)

Modify/update a Json value selected by a simple Json query.

Parameters:

simpleQuery - the simple query to address the value. Examples: "[0].datapoints.[2].[1]", "customers.person.name"

newValue - the new value

Returns:

true if the simple query was successful and the old value was replaced by the new value

Throws:

java.lang.IllegalArgumentException - if the root of the Json data is not an Object or Array

getResultRoot

public JsonValue getResultRoot()

Get the root of the modified Json data.

Returns:

the root of the modified Json data

getOldValue

public JsonValue getOldValue()

Get the old value of the latest executed update.

Returns:

the old value of the latest executed update, or null if the simple query has failed

See Also:

update(String, JsonValue)