Package com.restfb
Schnittstelle JsonMapper
- Alle bekannten Implementierungsklassen:
DefaultJsonMapper
public interface JsonMapper
Specifies how a Facebook JSON-to-Java (and vice-versa) mapper must operate.
Note that implementors must be able to handle illegal JSON in toJavaObject(String, Class)
and
toJavaList(String, Class)
in order to correctly process Facebook responses. For example, the
Users.getLoggedInUser
Legacy API call returns a value like 1240077
, which is not valid JSON.
- Autor:
- Mark Allen
-
Verschachtelte Klassen - Übersicht
Verschachtelte KlassenModifizierer und TypSchnittstelleBeschreibungstatic @interface
If you apply this annotation to a method of a type mapped byJsonMapper
, it will be called after the mapping operation has been completed. -
Methodenübersicht
Modifizierer und TypMethodeBeschreibungvoid
setFacebookClient
(FacebookClient facebookClient) adds aFacebookClient
implementation to the mapper.<T> List<T>
toJavaList
(String json, Class<T> type) Given a JSON string, create and return a new instance of a corresponding JavaList
which contains elements of typetype
.<T> T
toJavaObject
(String json, Class<T> type) Given a JSON string, create and return a new instance of a corresponding Java object of typetype
.Given a Javaobject
, create and return a JSON string that represents it.Given a Javaobject
, create and return a JSON string that represents it.
-
Methodendetails
-
toJavaObject
Given a JSON string, create and return a new instance of a corresponding Java object of typetype
.The Java
type
must have a no-argument constructor.- Typparameter:
T
- Java type to map to.- Parameter:
json
- The JSON to be mapped to a Java type.type
- Java type token.- Gibt zurück:
- A Java object (of type
type
) representation of the JSON input. - Löst aus:
FacebookJsonMappingException
- If an error occurs while mapping JSON to Java.
-
toJavaList
Given a JSON string, create and return a new instance of a corresponding JavaList
which contains elements of typetype
.The Java
type
must have a no-argument constructor.- Typparameter:
T
- Java type to map to for each element of the list.- Parameter:
json
- The JSON to be mapped to a Java type.type
- Java type token.- Gibt zurück:
- A Java object (of type
List
which contains elements of typetype
) representation of the JSON input. - Löst aus:
FacebookJsonMappingException
- If an error occurs while mapping JSON to Java.
-
toJson
Given a Javaobject
, create and return a JSON string that represents it.The
object
's properties will be traversed recursively, allowing for arbitrarily complex JSON generation.- Parameter:
object
- The Java object to map to JSON. Can be a Javabean,List
, orMap
.- Gibt zurück:
- A JSON string.
- Löst aus:
FacebookJsonMappingException
- If an error occurs while mapping Java to JSON.- Seit:
- 1.4
-
toJson
Given a Javaobject
, create and return a JSON string that represents it.The
object
's properties will be traversed recursively, allowing for arbitrarily complex JSON generation.- Parameter:
object
- The Java object to map to JSON. Can be a Javabean,List
, orMap
.ignoreNullValuedProperties
- Iftrue
, no Javabean properties withnull
values will be included in the generated JSON.- Gibt zurück:
- A JSON string.
- Löst aus:
FacebookJsonMappingException
- If an error occurs while mapping Java to JSON.- Seit:
- 1.6.5
-
setFacebookClient
adds aFacebookClient
implementation to the mapper. This is especially useful for mapping json to Connection objects that need the client itself.- Parameter:
facebookClient
- that is used for Connection objects
-