com.whitestein.lsps.json.function

Class JsonFunctionsBean

java.lang.Object

com.whitestein.lsps.json.function.JsonFunctionsBean

All Implemented Interfaces:

JsonFunctions

@PermitAll
public class JsonFunctionsBean
extends Object
implements JsonFunctions

Implementation of the JSON functions interface.

Author:

jsa

Constructor Summary

Constructors

Constructor and Description
JsonFunctionsBean()

Method Summary

Modifier and Type	Method and Description
String	convertToJson(ExecutionContext context, Boolean useExternalRef, Object object) Creates a JSON document representing a given LSPS object.
String	convertToJson(ExecutionContext context, Object object) Creates a JSON document representing a given LSPS object.
MapHolder	jsonToMap(ExecutionContext context, String json) Deprecated.
MapHolder	jsonToMap(ExecutionContext context, String json, Boolean doInsert, Boolean doUpdate)
String	mapToJson(ExecutionContext context, Boolean useExternalRef, MapHolder map) Creates a JSON document representing the given map.
String	mapToJson(ExecutionContext context, MapHolder map) Creates a JSON document representing the given map.
Object	parseJson(ExecutionContext context, String json, Type resultType) Deprecated.
Object	parseJson(ExecutionContext context, String json, Type resultType, Boolean doInsert, Boolean doUpdate) Parses JSON string to internal data structures.
String	toJsonSchema(ExecutionContext context, Boolean useExternalRef, Type type)

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonFunctionsBean

public JsonFunctionsBean()

Method Detail

toJsonSchema

public String toJsonSchema(ExecutionContext context,
                           Boolean useExternalRef,
                           Type type)
                    throws ErrorException

Specified by:

toJsonSchema in interface JsonFunctions

Throws:

ErrorException

convertToJson

public String convertToJson(ExecutionContext context,
                            Boolean useExternalRef,
                            Object object)
                     throws ErrorException

Description copied from interface: JsonFunctions

Creates a JSON document representing a given LSPS object. If the useExternalRef is true the shared records are represented by an external reference (type and primary key) in the json. In the other case the full value is put into json string.

Specified by:

convertToJson in interface JsonFunctions

Returns:

a JSON document representing the given object

Throws:

ErrorException

convertToJson

public String convertToJson(ExecutionContext context,
                            Object object)
                     throws ErrorException

Description copied from interface: JsonFunctions

Creates a JSON document representing a given LSPS object. The shared records are represented by full value in the json.

Specified by:

convertToJson in interface JsonFunctions

object - The object to convert to JSON representation. The parameter must be of RecordType or ContainerType or MapType.

Returns:

a JSON document representing the given object

Throws:

ErrorException

parseJson

@Deprecated
public Object parseJson(ExecutionContext context,
                                    String json,
                                    Type resultType)
                             throws ErrorException

Deprecated.

Description copied from interface: JsonFunctions

Parses the given JSON document into the instance of the given type

Specified by:

parseJson in interface JsonFunctions

json - the JSON string

Returns:

parsed object

Throws:

ErrorException

parseJson

public Object parseJson(ExecutionContext context,
                        String json,
                        Type resultType,
                        Boolean doInsert,
                        Boolean doUpdate)
                 throws ErrorException

Description copied from interface: JsonFunctions

Parses JSON string to internal data structures. The json parameter represents the JSON string to parse and the resultType parameter determines the type of the returned data. The referred type must be a Record, List, Set or Map type, otherwise an exception is thrown. Furthermore the data structure represented by the resultType can consist only from these supported types: String, Boolean, Binary, Decimal, Integer, Date, Set, List, Map, Record, Enumeration. If there exist a shared record with the same primary key as specified in JSON the record is used by import. Here, it does not matter whether the shared record is specified by external reference or by value in JSON. If the record specified by reference in JSON does not exist in database it is ignored and null is used as its imported value or empty collection for collection of records. No exception is thrown in this case. If the parameter doInsert is true and the database does not contain a shared record specified by value in JSON or the JSON does not specify primary key, the record from JSON is inserted to database. For auto-generated primary keys, a new key value is created, for not auto-generated primary keys, the value of the key from JSON is used. If doInsert is false, a record from JSON which does not exist in the DB is ignored and null is used for its value in the imported data instead; for collections of non-existing records, empty collections are created by import. If the parameter doUpdate is true and the database contains a shared record with the same primary key as a record specified by value in JSON, values of this record fields are updated from JSON. If false, values of fields do not change.

Specified by:

parseJson in interface JsonFunctions

Returns:

parsed object

Throws:

ErrorException

mapToJson

public String mapToJson(ExecutionContext context,
                        Boolean useExternalRef,
                        MapHolder map)
                 throws ErrorException

Description copied from interface: JsonFunctions

Creates a JSON document representing the given map. This method is useful for creating JSON representation of data structures for which there is no record representation in the model. These data structures can always be represented as a map where keys are the property names and values are their values. If the useExternalRef is true the shared records are represented by an external reference (type and primary key) in the json. In the other case the full value is put into json string.

Specified by:

mapToJson in interface JsonFunctions

map - The map to convert to JSON. The type of the map has to be Map<String, Object>.

Returns:

a JSON representation of the map.

Throws:

ErrorException

mapToJson

public String mapToJson(ExecutionContext context,
                        MapHolder map)
                 throws ErrorException

Description copied from interface: JsonFunctions

Creates a JSON document representing the given map. This method is useful for creating JSON representation of data structures for which there is no record representation in the model. These data structures can always be represented as a map where keys are the property names and values are their values.

Specified by:

mapToJson in interface JsonFunctions

map - The map to convert to JSON. The type of the map has to be Map<String, Object>.

Returns:

a JSON representation of the map.

Throws:

ErrorException

jsonToMap

@Deprecated
public MapHolder jsonToMap(ExecutionContext context,
                                       String json)
                                throws ErrorException

Deprecated.

Description copied from interface: JsonFunctions

TODO

Specified by:

jsonToMap in interface JsonFunctions

Returns:

parsed map

Throws:

ErrorException

jsonToMap

public MapHolder jsonToMap(ExecutionContext context,
                           String json,
                           Boolean doInsert,
                           Boolean doUpdate)
                    throws ErrorException

Specified by:

jsonToMap in interface JsonFunctions

Returns:

parsed map

Throws:

ErrorException