play.libs

Class Json

java.lang.Object

play.libs.Json

public class Json
extends java.lang.Object

Helper functions to handle JsonNode values.

Constructor Summary

Constructors

Constructor and Description
Json()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	asciiStringify(com.fasterxml.jackson.databind.JsonNode json) Convert a JsonNode to its string representation, escaping non-ascii characters.
static <A> A	fromJson(com.fasterxml.jackson.databind.JsonNode json, java.lang.Class<A> clazz) Convert a JsonNode to a Java value
static com.fasterxml.jackson.databind.ObjectMapper	mapper() Get the ObjectMapper used to serialize and deserialize objects to and from JSON values.
static com.fasterxml.jackson.databind.node.ArrayNode	newArray() Creates a new empty ArrayNode.
static com.fasterxml.jackson.databind.node.ObjectNode	newObject() Creates a new empty ObjectNode.
static com.fasterxml.jackson.databind.JsonNode	parse(byte[] src) Parse a byte array representing a json, and return it as a JsonNode.
static com.fasterxml.jackson.databind.JsonNode	parse(java.io.InputStream src) Parse a InputStream representing a json, and return it as a JsonNode.
static com.fasterxml.jackson.databind.JsonNode	parse(java.lang.String src) Parse a String representing a json, and return it as a JsonNode.
static java.lang.String	prettyPrint(com.fasterxml.jackson.databind.JsonNode json) Convert a JsonNode to its string representation.
static void	setObjectMapper(com.fasterxml.jackson.databind.ObjectMapper mapper) Inject the object mapper to use.
static java.lang.String	stringify(com.fasterxml.jackson.databind.JsonNode json) Convert a JsonNode to its string representation.
static com.fasterxml.jackson.databind.JsonNode	toJson(java.lang.Object data) Convert an object to JsonNode.

Methods inherited from class java.lang.Object

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

Constructor Detail

Json

public Json()

Method Detail

mapper

public static com.fasterxml.jackson.databind.ObjectMapper mapper()

Get the ObjectMapper used to serialize and deserialize objects to and from JSON values. This can be set to a custom implementation using Json.setObjectMapper.

Returns:

the ObjectMapper currently being used

toJson

public static com.fasterxml.jackson.databind.JsonNode toJson(java.lang.Object data)

Convert an object to JsonNode.

Parameters:

data - Value to convert in Json.

fromJson

public static <A> A fromJson(com.fasterxml.jackson.databind.JsonNode json,
                             java.lang.Class<A> clazz)

Convert a JsonNode to a Java value

Parameters:

json - Json value to convert.

clazz - Expected Java value type.

newObject

public static com.fasterxml.jackson.databind.node.ObjectNode newObject()

Creates a new empty ObjectNode.

newArray

public static com.fasterxml.jackson.databind.node.ArrayNode newArray()

Creates a new empty ArrayNode.

stringify

public static java.lang.String stringify(com.fasterxml.jackson.databind.JsonNode json)

Convert a JsonNode to its string representation.

asciiStringify

public static java.lang.String asciiStringify(com.fasterxml.jackson.databind.JsonNode json)

Convert a JsonNode to its string representation, escaping non-ascii characters.

prettyPrint

public static java.lang.String prettyPrint(com.fasterxml.jackson.databind.JsonNode json)

Convert a JsonNode to its string representation.

parse

public static com.fasterxml.jackson.databind.JsonNode parse(java.lang.String src)

Parse a String representing a json, and return it as a JsonNode.

parse

public static com.fasterxml.jackson.databind.JsonNode parse(java.io.InputStream src)

Parse a InputStream representing a json, and return it as a JsonNode.

parse

public static com.fasterxml.jackson.databind.JsonNode parse(byte[] src)

Parse a byte array representing a json, and return it as a JsonNode.

setObjectMapper

public static void setObjectMapper(com.fasterxml.jackson.databind.ObjectMapper mapper)

Inject the object mapper to use. This is intended to be used when Play starts up. By default, Play will inject its own object mapper here, but this mapper can be overridden either by a custom plugin or from Global.onStart.