org.boon.json

Interface ObjectMapper

All Known Implementing Classes:

ObjectMapperImpl

public interface ObjectMapper

This mapper (or, data binder, or codec) provides functionality for converting between Java objects (instances of JDK provided core classes, beans), and matching JSON constructs. It will use instances of JsonParserAndMapper and JsonSerializer for implementing actual reading/writing of JSON.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	fromJson(byte[] bytes)
<T> T	fromJson(byte[] bytes, java.lang.Class<T> clazz)
java.lang.Object	fromJson(char[] chars)
<T> T	fromJson(char[] chars, java.lang.Class<T> clazz)
java.lang.Object	fromJson(java.io.InputStream reader)
<T> T	fromJson(java.io.InputStream reader, java.lang.Class<T> clazz)
java.lang.Object	fromJson(java.io.Reader reader)
<T> T	fromJson(java.io.Reader reader, java.lang.Class<T> clazz)
java.lang.Object	fromJson(java.lang.String json)
<T> T	fromJson(java.lang.String json, java.lang.Class<T> clazz)
JsonParserAndMapper	parser()
<T extends java.util.Collection<C>,C> T	readValue(byte[] src, java.nio.charset.Charset charset, java.lang.Class<T> valueType, java.lang.Class<C> componentType) Method to deserialize JSON content into a container like Set or List.
<T> T	readValue(byte[] src, java.lang.Class<T> valueType) Method to deserialize JSON content into a non-container type typically a bean or wrapper type.
<T extends java.util.Collection<C>,C> T	readValue(byte[] src, java.lang.Class<T> valueType, java.lang.Class<C> componentType) Method to deserialize JSON content into a container like Set or List.
<T> T	readValue(char[] src, java.lang.Class<T> valueType) Method to deserialize JSON content into a non-container type typically a bean or wrapper type.
<T extends java.util.Collection<C>,C> T	readValue(char[] src, java.lang.Class<T> valueType, java.lang.Class<C> componentType) Method to deserialize JSON content into a container like Set or List.
<T> T	readValue(java.io.File src, java.lang.Class<T> valueType) Method to deserialize JSON content into a non-container type typically a bean or wrapper type.
<T extends java.util.Collection<C>,C> T	readValue(java.io.File src, java.lang.Class<T> valueType, java.lang.Class<C> componentType) Method to deserialize JSON content into a container like Set or List.
<T extends java.util.Collection<C>,C> T	readValue(java.io.InputStream src, java.nio.charset.Charset charset, java.lang.Class<T> valueType, java.lang.Class<C> componentType) Method to deserialize JSON content into a container like Set or List.
<T> T	readValue(java.io.InputStream src, java.lang.Class<T> valueType) Method to deserialize JSON content into a non-container type typically a bean or wrapper type.
<T extends java.util.Collection<C>,C> T	readValue(java.io.InputStream src, java.lang.Class<T> valueType, java.lang.Class<C> componentType) Method to deserialize JSON content into a container like Set or List.
<T> T	readValue(java.io.Reader src, java.lang.Class<T> valueType) Method to deserialize JSON content into a non-container type typically a bean or wrapper type.
<T extends java.util.Collection<C>,C> T	readValue(java.io.Reader src, java.lang.Class<T> valueType, java.lang.Class<C> componentType) Method to deserialize JSON content into a container like Set or List.
<T> T	readValue(java.lang.String src, java.lang.Class<T> valueType) Method to deserialize JSON content into a non-container type typically a bean or wrapper type.
<T extends java.util.Collection<C>,C> T	readValue(java.lang.String src, java.lang.Class<T> valueType, java.lang.Class<C> componentType) Method to deserialize JSON content into a container like Set or List.
JsonSerializer	serializer()
java.lang.String	toJson(java.lang.Object value)
void	toJson(java.lang.Object value, java.lang.Appendable appendable)
void	writeValue(java.io.File dest, java.lang.Object value) Method that can be used to serialize any Java value as JSON output, written to File provided.
void	writeValue(java.io.OutputStream dest, java.lang.Object value) Method that can be used to serialize any Java value as JSON output, using output stream provided (using encoding UTF8.
void	writeValue(java.io.Writer dest, java.lang.Object value) Method that can be used to serialize any Java value as JSON output, using Writer provided.
byte[]	writeValueAsBytes(java.lang.Object value) Method that can be used to serialize any Java value as a byte array.
byte[]	writeValueAsBytes(java.lang.Object value, java.nio.charset.Charset charset) Method that can be used to serialize any Java value as a byte array.
char[]	writeValueAsCharArray(java.lang.Object value) Method that can be used to serialize any Java value as a char[].
java.lang.String	writeValueAsString(java.lang.Object value) Method that can be used to serialize any Java value as a String.

Method Detail

readValue

<T> T readValue(java.lang.String src,
              java.lang.Class<T> valueType)

Method to deserialize JSON content into a non-container type typically a bean or wrapper type.

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.

readValue

<T> T readValue(java.io.File src,
              java.lang.Class<T> valueType)

Method to deserialize JSON content into a non-container type typically a bean or wrapper type.

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.

readValue

<T> T readValue(byte[] src,
              java.lang.Class<T> valueType)

Method to deserialize JSON content into a non-container type typically a bean or wrapper type.

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.

readValue

<T> T readValue(char[] src,
              java.lang.Class<T> valueType)

Method to deserialize JSON content into a non-container type typically a bean or wrapper type.

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.

readValue

<T> T readValue(java.io.Reader src,
              java.lang.Class<T> valueType)

Method to deserialize JSON content into a non-container type typically a bean or wrapper type.

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.

readValue

<T> T readValue(java.io.InputStream src,
              java.lang.Class<T> valueType)

Method to deserialize JSON content into a non-container type typically a bean or wrapper type.

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.

readValue

<T extends java.util.Collection<C>,C> T readValue(java.lang.String src,
                                                java.lang.Class<T> valueType,
                                                java.lang.Class<C> componentType)

Method to deserialize JSON content into a container like Set or List.

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

readValue

<T extends java.util.Collection<C>,C> T readValue(java.io.File src,
                                                java.lang.Class<T> valueType,
                                                java.lang.Class<C> componentType)

Method to deserialize JSON content into a container like Set or List.

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

readValue

<T extends java.util.Collection<C>,C> T readValue(byte[] src,
                                                java.lang.Class<T> valueType,
                                                java.lang.Class<C> componentType)

Method to deserialize JSON content into a container like Set or List.

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

readValue

<T extends java.util.Collection<C>,C> T readValue(char[] src,
                                                java.lang.Class<T> valueType,
                                                java.lang.Class<C> componentType)

Method to deserialize JSON content into a container like Set or List.

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

readValue

<T extends java.util.Collection<C>,C> T readValue(java.io.Reader src,
                                                java.lang.Class<T> valueType,
                                                java.lang.Class<C> componentType)

Method to deserialize JSON content into a container like Set or List.

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

readValue

<T extends java.util.Collection<C>,C> T readValue(java.io.InputStream src,
                                                java.lang.Class<T> valueType,
                                                java.lang.Class<C> componentType)

Method to deserialize JSON content into a container like Set or List.

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

readValue

<T extends java.util.Collection<C>,C> T readValue(byte[] src,
                                                java.nio.charset.Charset charset,
                                                java.lang.Class<T> valueType,
                                                java.lang.Class<C> componentType)

Method to deserialize JSON content into a container like Set or List.

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

readValue

<T extends java.util.Collection<C>,C> T readValue(java.io.InputStream src,
                                                java.nio.charset.Charset charset,
                                                java.lang.Class<T> valueType,
                                                java.lang.Class<C> componentType)

Method to deserialize JSON content into a container like Set or List.

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

writeValue

void writeValue(java.io.File dest,
              java.lang.Object value)

Method that can be used to serialize any Java value as JSON output, written to File provided.

writeValue

void writeValue(java.io.OutputStream dest,
              java.lang.Object value)

Method that can be used to serialize any Java value as JSON output, using output stream provided (using encoding UTF8.

Note: method does not close the underlying stream explicitly here.

writeValue

void writeValue(java.io.Writer dest,
              java.lang.Object value)

Method that can be used to serialize any Java value as JSON output, using Writer provided.

Note: method does not close the underlying stream explicitly here.

writeValueAsString

java.lang.String writeValueAsString(java.lang.Object value)

Method that can be used to serialize any Java value as a String. Functionally equivalent to calling writeValue(Writer,Object) with StringWriter and constructing String, but more efficient.

writeValueAsCharArray

char[] writeValueAsCharArray(java.lang.Object value)

Method that can be used to serialize any Java value as a char[]. Functionally equivalent to calling writeValue(Writer,Object) with StringWriter and constructing String, but more efficient.

writeValueAsBytes

byte[] writeValueAsBytes(java.lang.Object value)

Method that can be used to serialize any Java value as a byte array. Encoding used will be UTF-8.

writeValueAsBytes

byte[] writeValueAsBytes(java.lang.Object value,
                       java.nio.charset.Charset charset)

Method that can be used to serialize any Java value as a byte array.

parser

JsonParserAndMapper parser()

serializer

JsonSerializer serializer()

toJson

java.lang.String toJson(java.lang.Object value)

toJson

void toJson(java.lang.Object value,
          java.lang.Appendable appendable)

fromJson

<T> T fromJson(java.lang.String json,
             java.lang.Class<T> clazz)

fromJson

<T> T fromJson(byte[] bytes,
             java.lang.Class<T> clazz)

fromJson

<T> T fromJson(char[] chars,
             java.lang.Class<T> clazz)

fromJson

<T> T fromJson(java.io.Reader reader,
             java.lang.Class<T> clazz)

fromJson

<T> T fromJson(java.io.InputStream reader,
             java.lang.Class<T> clazz)

fromJson

java.lang.Object fromJson(java.lang.String json)

fromJson

java.lang.Object fromJson(java.io.Reader reader)

fromJson

java.lang.Object fromJson(byte[] bytes)

fromJson

java.lang.Object fromJson(char[] chars)

fromJson

java.lang.Object fromJson(java.io.InputStream reader)