public abstract class ObjectCodec extends Object
JsonParser
and
JsonGenerator
use to serialize and deserialize regular
Java objects (POJOs aka Beans).
The standard implementation of this class is
ObjectMapper
.
Modifier | Constructor and Description |
---|---|
protected |
ObjectCodec() |
Modifier and Type | Method and Description |
---|---|
abstract JsonNode |
createArrayNode()
Method for construct root level Array nodes
for Tree Model instances.
|
abstract JsonNode |
createObjectNode()
Method for construct root level Object nodes
for Tree Model instances.
|
abstract JsonNode |
readTree(JsonParser jp)
Method to deserialize JSON content as tree expressed
using set of
JsonNode 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,
JavaType valueType)
Method to deserialize JSON content as tree expressed
using set of
JsonNode instances. |
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,
JavaType 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(JsonNode 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(JsonNode n,
Class<T> valueType)
Convenience method for converting given JSON tree into instance of specified
value type.
|
abstract void |
writeTree(JsonGenerator jgen,
JsonNode rootNode)
Method to serialize given Json Tree, using generator
provided.
|
abstract void |
writeValue(JsonGenerator jgen,
Object value)
Method to serialize given Java Object, using generator
provided.
|
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.
IOException
JsonProcessingException
public abstract <T> T readValue(JsonParser jp, TypeReference<?> valueTypeRef) throws IOException, JsonProcessingException
IOException
JsonProcessingException
public abstract <T> T readValue(JsonParser jp, JavaType valueType) throws IOException, JsonProcessingException
JsonNode
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
public abstract JsonNode readTree(JsonParser jp) throws IOException, JsonProcessingException
JsonNode
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
public abstract <T> Iterator<T> readValues(JsonParser jp, Class<T> valueType) throws IOException, JsonProcessingException
IOException
JsonProcessingException
public abstract <T> Iterator<T> readValues(JsonParser jp, TypeReference<?> valueTypeRef) throws IOException, JsonProcessingException
IOException
JsonProcessingException
public abstract <T> Iterator<T> readValues(JsonParser jp, JavaType valueType) throws IOException, JsonProcessingException
IOException
JsonProcessingException
public abstract void writeValue(JsonGenerator jgen, Object value) throws IOException, JsonProcessingException
IOException
JsonProcessingException
public abstract void writeTree(JsonGenerator jgen, JsonNode rootNode) throws IOException, JsonProcessingException
IOException
JsonProcessingException
public abstract JsonNode createObjectNode()
public abstract JsonNode createArrayNode()
public abstract JsonParser treeAsTokens(JsonNode n)
JsonParser
for reading
contents of a JSON tree, as if it was external serialized
JSON content.public abstract <T> T treeToValue(JsonNode n, Class<T> valueType) throws IOException, JsonProcessingException
JsonParser
to
iterate over contents of the tree, and using that parser for data binding.IOException
JsonProcessingException