com.restfb

Class DefaultJsonMapper

java.lang.Object

com.restfb.DefaultJsonMapper

All Implemented Interfaces:

JsonMapper

public class DefaultJsonMapper
extends Object
implements JsonMapper

Default implementation of a JSON-to-Java mapper.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	DefaultJsonMapper.JsonMappingErrorHandler Callback interface which allows client code to specify how JSON mapping errors should be handled.

Nested classes/interfaces inherited from interface com.restfb.JsonMapper

JsonMapper.JsonMappingCompleted

Constructor Summary

Constructors

Constructor and Description
DefaultJsonMapper() Creates a JSON mapper which will throw FacebookJsonMappingException whenever an error occurs when mapping JSON data to Java objects.
DefaultJsonMapper(DefaultJsonMapper.JsonMappingErrorHandler jsonMappingErrorHandler) Creates a JSON mapper which delegates to the provided jsonMappingErrorHandler for handling mapping errors.

Method Summary

Modifier and Type	Method and Description
<T> List<T>	toJavaList(String json, Class<T> type) Given a JSON string, create and return a new instance of a corresponding Java List which contains elements of type type.
<T> T	toJavaObject(String json, Class<T> type) Given a JSON string, create and return a new instance of a corresponding Java object of type type.
String	toJson(Object object) Given a Java object, create and return a JSON string that represents it.
String	toJson(Object object, boolean ignoreNullValuedProperties) Given a Java object, create and return a JSON string that represents it.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultJsonMapper

public DefaultJsonMapper()

Creates a JSON mapper which will throw FacebookJsonMappingException whenever an error occurs when mapping JSON data to Java objects.

DefaultJsonMapper

public DefaultJsonMapper(DefaultJsonMapper.JsonMappingErrorHandler jsonMappingErrorHandler)

Creates a JSON mapper which delegates to the provided jsonMappingErrorHandler for handling mapping errors.

Parameters:

jsonMappingErrorHandler - The JSON mapping error handler to use.

Throws:

IllegalArgumentException - If jsonMappingErrorHandler is null.

Since:

1.6.2

Method Detail

toJavaList

public <T> List<T> toJavaList(String json,
                              Class<T> type)

Description copied from interface: JsonMapper

Given a JSON string, create and return a new instance of a corresponding Java List which contains elements of type type.

The Java type must have a no-argument constructor.

Specified by:

toJavaList in interface JsonMapper

Type Parameters:

T - Java type to map to for each element of the list.

Parameters:

json - The JSON to be mapped to a Java type.

type - Java type token.

Returns:

A Java object (of type List which contains elements of type type) representation of the JSON input.

See Also:

JsonMapper.toJavaList(java.lang.String, java.lang.Class)

toJavaObject

public <T> T toJavaObject(String json,
                          Class<T> type)

Description copied from interface: JsonMapper

Given a JSON string, create and return a new instance of a corresponding Java object of type type.

The Java type must have a no-argument constructor.

Specified by:

toJavaObject in interface JsonMapper

Type Parameters:

T - Java type to map to.

Parameters:

json - The JSON to be mapped to a Java type.

type - Java type token.

Returns:

A Java object (of type type) representation of the JSON input.

See Also:

JsonMapper.toJavaObject(java.lang.String, java.lang.Class)

toJson

public String toJson(Object object)

Description copied from interface: JsonMapper

Given a Java object, create and return a JSON string that represents it.

The object's properties will be traversed recursively, allowing for arbitrarily complex JSON generation.

Specified by:

toJson in interface JsonMapper

Parameters:

object - The Java object to map to JSON. Can be a Javabean, List, or Map.

Returns:

A JSON string.

See Also:

JsonMapper.toJson(java.lang.Object)

toJson

public String toJson(Object object,
                     boolean ignoreNullValuedProperties)

Description copied from interface: JsonMapper

Given a Java object, create and return a JSON string that represents it.

The object's properties will be traversed recursively, allowing for arbitrarily complex JSON generation.

Specified by:

toJson in interface JsonMapper

Parameters:

object - The Java object to map to JSON. Can be a Javabean, List, or Map.

ignoreNullValuedProperties - If true, no Javabean properties with null values will be included in the generated JSON.

Returns:

A JSON string.

See Also:

JsonMapper.toJson(java.lang.Object, boolean)