org.hotwheel.json.impl.jackson

类 ObjectCodec

java.lang.Object

org.hotwheel.json.impl.jackson.ObjectCodec

public abstract class ObjectCodec
extends Object

Abstract class that defines the interface that JacksonParser and JsonGenerator use to serialize and deserialize regular Java objects (POJOs aka Beans).

The standard implementation of this class is com.fasterxml.jackson.databind.ObjectMapper, defined in the "jackson-databind".

方法概要

限定符和类型	方法和说明
abstract TreeNode	createArrayNode() Method for construct root level Array nodes for Tree Model instances.
abstract TreeNode	createObjectNode() Method for construct root level Object nodes for Tree Model instances.
abstract JsonFactory	getJsonFactory() Accessor for finding JsonFactory codec will use.
abstract <T extends TreeNode> T	readTree(JacksonParser jp) Method to deserialize JSON content as tree expressed using set of TreeNode instances.
abstract <T> T	readValue(JacksonParser jp, Class<T> valueType) Method to deserialize JSON content into a non-container type (it can be an array type, however): typically a bean, array or a wrapper type (like Boolean).
abstract <T> T	readValue(JacksonParser jp, ResolvedType valueType) Method to deserialize JSON content into a POJO, type specified with fully resolved type object (so it can be a generic type, including containers like Collection and Map).
abstract <T> T	readValue(JacksonParser jp, TypeReference<?> valueTypeRef) Method to deserialize JSON content into a Java type, reference to which is passed as argument.
abstract <T> Iterator<T>	readValues(JacksonParser jp, Class<T> valueType) Method for reading sequence of Objects from parser stream, all with same specified value type.
abstract <T> Iterator<T>	readValues(JacksonParser jp, ResolvedType valueType) Method for reading sequence of Objects from parser stream, all with same specified value type.
abstract <T> Iterator<T>	readValues(JacksonParser jp, TypeReference<?> valueTypeRef) Method for reading sequence of Objects from parser stream, all with same specified value type.
abstract JacksonParser	treeAsTokens(TreeNode n) Method for constructing a JacksonParser for reading contents of a JSON tree, as if it was external serialized JSON content.
abstract <T> T	treeToValue(TreeNode n, Class<T> valueType) Convenience method for converting given JSON tree into instance of specified value type.
abstract void	writeValue(JsonGenerator jgen, Object value) Method to serialize given Java Object, using generator provided.

从类继承的方法 java.lang.Object

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

方法详细资料

readValue

public abstract <T> T readValue(JacksonParser jp,
                                Class<T> valueType)
                         throws IOException,
                                JsonProcessingException

Method to deserialize JSON content into a non-container type (it can be an array type, however): typically a bean, array or a wrapper type (like Boolean).

Note: this method should NOT be used if the result type is a container (Collection or Map. The reason is that due to type erasure, key and value types can not be introspected when using this method.

抛出:

IOException

JsonProcessingException

readValue

public abstract <T> T readValue(JacksonParser jp,
                                TypeReference<?> valueTypeRef)
                         throws IOException,
                                JsonProcessingException

Method to deserialize JSON content into a Java type, reference to which is passed as argument. Type is passed using so-called "super type token" and specifically needs to be used if the root type is a parameterized (generic) container type.

抛出:

IOException

JsonProcessingException

readValue

public abstract <T> T readValue(JacksonParser jp,
                                ResolvedType valueType)
                         throws IOException,
                                JsonProcessingException

Method to deserialize JSON content into a POJO, type specified with fully resolved type object (so it can be a generic type, including containers like Collection and Map).

抛出:

IOException

JsonProcessingException

readTree

public abstract <T extends TreeNode> T readTree(JacksonParser jp)
                                         throws IOException,
                                                JsonProcessingException

Method to deserialize JSON content as tree expressed using set of TreeNode instances. Returns root of the resulting tree (where root can consist of just a single node if the current event is a value event, not container).

抛出:

IOException

JsonProcessingException

readValues

public abstract <T> Iterator<T> readValues(JacksonParser jp,
                                           Class<T> valueType)
                                    throws IOException,
                                           JsonProcessingException

Method for reading sequence of Objects from parser stream, all with same specified value type.

抛出:

IOException

JsonProcessingException

readValues

public abstract <T> Iterator<T> readValues(JacksonParser jp,
                                           TypeReference<?> valueTypeRef)
                                    throws IOException,
                                           JsonProcessingException

Method for reading sequence of Objects from parser stream, all with same specified value type.

抛出:

IOException

JsonProcessingException

readValues

public abstract <T> Iterator<T> readValues(JacksonParser jp,
                                           ResolvedType valueType)
                                    throws IOException,
                                           JsonProcessingException

Method for reading sequence of Objects from parser stream, all with same specified value type.

抛出:

IOException

JsonProcessingException

writeValue

public abstract void writeValue(JsonGenerator jgen,
                                Object value)
                         throws IOException,
                                JsonProcessingException

Method to serialize given Java Object, using generator provided.

抛出:

IOException

JsonProcessingException

createObjectNode

public abstract TreeNode createObjectNode()

Method for construct root level Object nodes for Tree Model instances.

createArrayNode

public abstract TreeNode createArrayNode()

Method for construct root level Array nodes for Tree Model instances.

treeAsTokens

public abstract JacksonParser treeAsTokens(TreeNode n)

Method for constructing a JacksonParser for reading contents of a JSON tree, as if it was external serialized JSON content.

treeToValue

public abstract <T> T treeToValue(TreeNode n,
                                  Class<T> valueType)
                           throws JsonProcessingException

Convenience method for converting given JSON tree into instance of specified value type. This is equivalent to first constructing a JacksonParser to iterate over contents of the tree, and using that parser for data binding.

抛出:

JsonProcessingException

getJsonFactory

public abstract JsonFactory getJsonFactory()

Accessor for finding JsonFactory codec will use.

从以下版本开始:

2.0