com.bluelinelabs.logansquare

Class JsonMapper<T>

java.lang.Object

com.bluelinelabs.logansquare.JsonMapper<T>

Direct Known Subclasses:

BooleanMapper, DoubleMapper, FloatMapper, IntegerMapper, ListMapper, LongMapper, MapMapper, ObjectMapper, StringMapper

public abstract class JsonMapper<T>
extends java.lang.Object

The class that handles all parsing and serialization of @JsonObject's

Constructor Summary

Constructors

Constructor and Description
JsonMapper()

Method Summary

Modifier and Type	Method and Description
T	parse(byte[] byteArray) Parse an object from a byte array.
T	parse(char[] charArray) Parse an object from a char array.
T	parse(java.io.InputStream is) Parse an object from an InputStream.
abstract T	parse(com.fasterxml.jackson.core.JsonParser jsonParser) Parse an object from a pre-configured JsonParser object.
T	parse(java.lang.String jsonString) Parse an object from a String.
abstract void	parseField(T instance, java.lang.String fieldName, com.fasterxml.jackson.core.JsonParser jsonParser) Parse a single field from a pre-configured JsonParser object into a T instance.
java.util.List<T>	parseList(byte[] byteArray) Parse a list of objects from a byte array.
java.util.List<T>	parseList(char[] charArray) Parse a list of objects from a char array.
java.util.List<T>	parseList(java.io.InputStream is) Parse a list of objects from an InputStream.
java.util.List<T>	parseList(com.fasterxml.jackson.core.JsonParser jsonParser) Parse a list of objects from a JsonParser.
java.util.List<T>	parseList(java.lang.String jsonString) Parse a list of objects from a String.
java.util.Map<java.lang.String,T>	parseMap(byte[] byteArray) Parse a map of objects from a byte array.
java.util.Map<java.lang.String,T>	parseMap(char[] charArray) Parse a map of objects from a char array.
java.util.Map<java.lang.String,T>	parseMap(java.io.InputStream is) Parse a map of objects from an InputStream.
java.util.Map<java.lang.String,T>	parseMap(com.fasterxml.jackson.core.JsonParser jsonParser) Parse a map of objects from a JsonParser.
java.util.Map<java.lang.String,T>	parseMap(java.lang.String jsonString) Parse a map of objects from a String.
java.lang.String	serialize(java.util.List<T> list) Serialize a list of objects to a JSON String.
void	serialize(java.util.List<T> list, com.fasterxml.jackson.core.JsonGenerator jsonGenerator) Serialize a list of objects to a JsonGenerator.
void	serialize(java.util.List<T> list, java.io.OutputStream os) Serialize a list of objects to an OutputStream.
java.lang.String	serialize(java.util.Map<java.lang.String,T> map) Serialize a list of objects to a JSON String.
void	serialize(java.util.Map<java.lang.String,T> map, com.fasterxml.jackson.core.JsonGenerator jsonGenerator) Serialize a list of objects to a JsonGenerator.
void	serialize(java.util.Map<java.lang.String,T> map, java.io.OutputStream os) Serialize a list of objects to an OutputStream.
java.lang.String	serialize(T object) Serialize an object to a JSON String.
abstract void	serialize(T object, com.fasterxml.jackson.core.JsonGenerator generator, boolean writeStartAndEnd) Serialize an object to a pre-configured JsonGenerator object.
void	serialize(T object, java.io.OutputStream os) Serialize an object to an OutputStream.

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonMapper

public JsonMapper()

Method Detail

parse

public abstract T parse(com.fasterxml.jackson.core.JsonParser jsonParser)
                 throws java.io.IOException

Parse an object from a pre-configured JsonParser object.

Parameters:

jsonParser - The pre-configured JsonParser

Throws:

java.io.IOException

parseField

public abstract void parseField(T instance,
                                java.lang.String fieldName,
                                com.fasterxml.jackson.core.JsonParser jsonParser)
                         throws java.io.IOException

Parse a single field from a pre-configured JsonParser object into a T instance.

Parameters:

instance - The instance of the object that the JsonParser should parse into

fieldName - The name of the field that should be parsed

jsonParser - The pre-configured JsonParser

Throws:

java.io.IOException

serialize

public abstract void serialize(T object,
                               com.fasterxml.jackson.core.JsonGenerator generator,
                               boolean writeStartAndEnd)
                        throws java.io.IOException

Serialize an object to a pre-configured JsonGenerator object.

Parameters:

object - The object to serialize.

generator - The pre-configured JsonGenerator being written to.

writeStartAndEnd - True if writeStartObject() should be called before and writeEndObject() should be called after serializing. False if not.

Throws:

java.io.IOException

parse

public T parse(java.io.InputStream is)
        throws java.io.IOException

Parse an object from an InputStream.

Parameters:

is - The InputStream, most likely from your networking library.

Throws:

java.io.IOException

parse

public T parse(byte[] byteArray)
        throws java.io.IOException

Parse an object from a byte array. Note: parsing from an InputStream should be preferred over parsing from a byte array if possible.

Parameters:

byteArray - The byte array being parsed.

Throws:

java.io.IOException

parse

public T parse(char[] charArray)
        throws java.io.IOException

Parse an object from a char array. Note: parsing from an InputStream should be preferred over parsing from a char array if possible.

Parameters:

charArray - The char array being parsed.

Throws:

java.io.IOException

parse

public T parse(java.lang.String jsonString)
        throws java.io.IOException

Parse an object from a String. Note: parsing from an InputStream should be preferred over parsing from a String if possible.

Parameters:

jsonString - The JSON string being parsed.

Throws:

java.io.IOException

parseList

public java.util.List<T> parseList(java.io.InputStream is)
                            throws java.io.IOException

Parse a list of objects from an InputStream.

Parameters:

is - The inputStream, most likely from your networking library.

Throws:

java.io.IOException

parseList

public java.util.List<T> parseList(byte[] byteArray)
                            throws java.io.IOException

Parse a list of objects from a byte array. Note: parsing from an InputStream should be preferred over parsing from a byte array if possible.

Parameters:

byteArray - The inputStream, most likely from your networking library.

Throws:

java.io.IOException

parseList

public java.util.List<T> parseList(char[] charArray)
                            throws java.io.IOException

Parse a list of objects from a char array. Note: parsing from an InputStream should be preferred over parsing from a char array if possible.

Parameters:

charArray - The char array, most likely from your networking library.

Throws:

java.io.IOException

parseList

public java.util.List<T> parseList(java.lang.String jsonString)
                            throws java.io.IOException

Parse a list of objects from a String. Note: parsing from an InputStream should be preferred over parsing from a String if possible.

Parameters:

jsonString - The JSON string being parsed.

Throws:

java.io.IOException

parseList

public java.util.List<T> parseList(com.fasterxml.jackson.core.JsonParser jsonParser)
                            throws java.io.IOException

Parse a list of objects from a JsonParser.

Parameters:

jsonParser - The JsonParser, preconfigured to be at the START_ARRAY token.

Throws:

java.io.IOException

parseMap

public java.util.Map<java.lang.String,T> parseMap(java.io.InputStream is)
                                           throws java.io.IOException

Parse a map of objects from an InputStream.

Parameters:

is - The inputStream, most likely from your networking library.

Throws:

java.io.IOException

parseMap

public java.util.Map<java.lang.String,T> parseMap(byte[] byteArray)
                                           throws java.io.IOException

Parse a map of objects from a byte array. Note: parsing from an InputStream should be preferred over parsing from a byte array if possible.

Parameters:

byteArray - The byte array string being parsed.

Throws:

java.io.IOException

parseMap

public java.util.Map<java.lang.String,T> parseMap(char[] charArray)
                                           throws java.io.IOException

Parse a map of objects from a char array. Note: parsing from an InputStream should be preferred over parsing from a char array if possible.

Parameters:

charArray - The char array being parsed.

Throws:

java.io.IOException

parseMap

public java.util.Map<java.lang.String,T> parseMap(java.lang.String jsonString)
                                           throws java.io.IOException

Parse a map of objects from a String. Note: parsing from an InputStream should be preferred over parsing from a String if possible.

Parameters:

jsonString - The JSON string being parsed.

Throws:

java.io.IOException

parseMap

public java.util.Map<java.lang.String,T> parseMap(com.fasterxml.jackson.core.JsonParser jsonParser)
                                           throws java.io.IOException

Parse a map of objects from a JsonParser.

Parameters:

jsonParser - The JsonParser, preconfigured to be at the START_ARRAY token.

Throws:

java.io.IOException

serialize

public java.lang.String serialize(T object)
                           throws java.io.IOException

Serialize an object to a JSON String.

Parameters:

object - The object to serialize.

Throws:

java.io.IOException

serialize

public void serialize(T object,
                      java.io.OutputStream os)
               throws java.io.IOException

Serialize an object to an OutputStream.

Parameters:

object - The object to serialize.

os - The OutputStream being written to.

Throws:

java.io.IOException

serialize

public java.lang.String serialize(java.util.List<T> list)
                           throws java.io.IOException

Serialize a list of objects to a JSON String.

Parameters:

list - The list of objects to serialize.

Throws:

java.io.IOException

serialize

public void serialize(java.util.List<T> list,
                      java.io.OutputStream os)
               throws java.io.IOException

Serialize a list of objects to an OutputStream.

Parameters:

list - The list of objects to serialize.

os - The OutputStream to which the list should be serialized

Throws:

java.io.IOException

serialize

public void serialize(java.util.List<T> list,
                      com.fasterxml.jackson.core.JsonGenerator jsonGenerator)
               throws java.io.IOException

Serialize a list of objects to a JsonGenerator.

Parameters:

list - The list of objects to serialize.

jsonGenerator - The JsonGenerator to which the list should be serialized

Throws:

java.io.IOException

serialize

public java.lang.String serialize(java.util.Map<java.lang.String,T> map)
                           throws java.io.IOException

Serialize a list of objects to a JSON String.

Parameters:

map - The map of objects to serialize.

Throws:

java.io.IOException

serialize

public void serialize(java.util.Map<java.lang.String,T> map,
                      java.io.OutputStream os)
               throws java.io.IOException

Serialize a list of objects to an OutputStream.

Parameters:

map - The map of objects to serialize.

os - The OutputStream to which the list should be serialized

Throws:

java.io.IOException

serialize

public void serialize(java.util.Map<java.lang.String,T> map,
                      com.fasterxml.jackson.core.JsonGenerator jsonGenerator)
               throws java.io.IOException

Serialize a list of objects to a JsonGenerator.

Parameters:

map - The map of objects to serialize.

jsonGenerator - The JsonGenerator to which the list should be serialized

Throws:

java.io.IOException