public abstract class ObjectCodec extends TreeCodec implements Versioned
JsonParser 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".
| Modifier | Constructor and Description |
|---|---|
protected |
ObjectCodec() |
| Modifier and Type | Method and Description |
|---|---|
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.
|
JsonFactory |
getFactory()
Accessor for finding underlying data format factory
(
JsonFactory) codec will use for data binding. |
abstract JsonFactory |
getJsonFactory()
Deprecated.
Since 2.1: Use
getFactory() instead. |
abstract <T extends TreeNode> |
readTree(JsonParser jp)
Method to deserialize JSON content as tree expressed
using set of
TreeNode instances. |
abstract <T> T |
readValue(JsonParser 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(JsonParser 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(JsonParser jp,
TypeReference<?> valueTypeRef)
Method to deserialize JSON content into a Java type, reference
to which is passed as argument.
|
abstract <T> Iterator<T> |
readValues(JsonParser jp,
Class<T> valueType)
Method for reading sequence of Objects from parser stream,
all with same specified value type.
|
abstract <T> Iterator<T> |
readValues(JsonParser jp,
ResolvedType valueType)
Method for reading sequence of Objects from parser stream,
all with same specified value type.
|
abstract <T> Iterator<T> |
readValues(JsonParser jp,
TypeReference<?> valueTypeRef)
Method for reading sequence of Objects from parser stream,
all with same specified value type.
|
abstract JsonParser |
treeAsTokens(TreeNode n)
Method for constructing a
JsonParser 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.
|
Version |
version()
Method called to detect version of the component that implements this interface;
returned version should never be null, but may return specific "not available"
instance (see
Version for details). |
abstract void |
writeTree(JsonGenerator jg,
TreeNode tree) |
abstract void |
writeValue(JsonGenerator jgen,
Object value)
Method to serialize given Java Object, using generator
provided.
|
public Version version()
VersionedVersion for details).public abstract <T> T readValue(JsonParser jp, Class<T> valueType) throws IOException, JsonProcessingException
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.
IOExceptionJsonProcessingExceptionpublic abstract <T> T readValue(JsonParser jp, TypeReference<?> valueTypeRef) throws IOException, JsonProcessingException
IOExceptionJsonProcessingExceptionpublic abstract <T> T readValue(JsonParser jp, ResolvedType valueType) throws IOException, JsonProcessingException
Collection and
Map).IOExceptionJsonProcessingExceptionpublic abstract <T> Iterator<T> readValues(JsonParser jp, Class<T> valueType) throws IOException, JsonProcessingException
IOExceptionJsonProcessingExceptionpublic abstract <T> Iterator<T> readValues(JsonParser jp, TypeReference<?> valueTypeRef) throws IOException, JsonProcessingException
IOExceptionJsonProcessingExceptionpublic abstract <T> Iterator<T> readValues(JsonParser jp, ResolvedType valueType) throws IOException, JsonProcessingException
IOExceptionJsonProcessingExceptionpublic abstract void writeValue(JsonGenerator jgen, Object value) throws IOException, JsonProcessingException
IOExceptionJsonProcessingExceptionpublic abstract <T extends TreeNode> T readTree(JsonParser jp) throws IOException, JsonProcessingException
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).readTree in class TreeCodecIOExceptionJsonProcessingExceptionpublic abstract void writeTree(JsonGenerator jg, TreeNode tree) throws IOException, JsonProcessingException
writeTree in class TreeCodecIOExceptionJsonProcessingExceptionpublic abstract TreeNode createObjectNode()
createObjectNode in class TreeCodecpublic abstract TreeNode createArrayNode()
createArrayNode in class TreeCodecpublic abstract JsonParser treeAsTokens(TreeNode n)
JsonParser for reading
contents of a JSON tree, as if it was external serialized
JSON content.treeAsTokens in class TreeCodecpublic abstract <T> T treeToValue(TreeNode n, Class<T> valueType) throws JsonProcessingException
JsonParser to
iterate over contents of the tree, and using that parser for data binding.JsonProcessingException@Deprecated public abstract JsonFactory getJsonFactory()
getFactory() instead.public JsonFactory getFactory()
JsonFactory) codec will use for data binding.Copyright © 2012-2013 FasterXML. All Rights Reserved.