com.whitestein.lsps.json.impl

Interface ValueConverter

All Known Implementing Classes:

JsonGenericParser, MapStringObjectValueConverter, ObjectValueConverter

public interface ValueConverter

A value converter converts an LSPS object to a JsonNode and . pre-processes JsonNodes to objects easily convertible to LSPS objects.

Author:

jsa

Method Summary

Modifier and Type	Method and Description
com.fasterxml.jackson.databind.JsonNode	toNode(Object object, com.whitestein.lsps.json.impl.WriteContext context, boolean useExternalRef) Converts an LSPS object to a JsonNode.
Object	toObject(com.fasterxml.jackson.databind.JsonNode node, com.whitestein.lsps.json.impl.ParseContext context) Creates an object from JsonNode.

Method Detail

toNode

com.fasterxml.jackson.databind.JsonNode toNode(Object object,
                                               com.whitestein.lsps.json.impl.WriteContext context,
                                               boolean useExternalRef)
                                        throws JsonProcessingException

Converts an LSPS object to a JsonNode.

Parameters:

object - the object that should be written in the JSON string

context - the writing context

Returns:

a node representation for the JSON tree.

Throws:

JsonProcessingException - if the object cannot be converted to the JsonNode.

toObject

Object toObject(com.fasterxml.jackson.databind.JsonNode node,
                com.whitestein.lsps.json.impl.ParseContext context)
         throws JsonProcessingException

Creates an object from JsonNode. It does not create LSPS objects directly. The returned object can be java.util.List, a java.util.Set, java.util.Map, RecordData or Reference. The returned object which can represent a complex data structure has to be processed further prior to converting it to LSPS objects. If this node is a root node of the JSON document then after this method is returned it is necessary to call ParseContext.resolveReferences(Object) to resolve all found references. Once all the references are resolved the returned object can be easily converted to LSPS object following this mappings:

Object	LSPS
RecordData	RecordHolder
Set	SetHolder
List	ListHolder
Map	MapHolder
simple types	simple types

Parameters:

node - the JSON node

context - the parsing context

Returns:

an object easily convertible to LSPS object

Throws:

JsonProcessingException - if the JsonNode cannot be converted to a LSPS object.