JSON (Grace Framework

grails.converters.JSON

All Implemented Interfaces and Traits:

IncludeExcludeConverter
```
public class JSON
extends AbstractConverter
implements IncludeExcludeConverter
```
A converter that converts domain classes, Maps, Lists, Arrays, POJOs and POGOs to JSON.
Authors:
Siegfried Puchbauer
Graeme Rocher

Nested Class Summary

Nested classes
Modifiers	Name	Description
`class`	`JSON.Builder`

Field Summary

Fields
Modifiers	Name	Description
`protected CircularReferenceBehaviour`	`circularReferenceBehaviour`
`protected ConverterConfiguration<JSON>`	`config`
`protected boolean`	`prettyPrint`
`protected Stack<Object>`	`referenceStack`
`protected Object`	`target`
`protected JSONWriter`	`writer`

Inherited fields
Fields inherited from class	Fields
`class AbstractConverter`	`contentType, encoding, excludes, includes`

Constructor Summary

Constructors
Constructor and description
`JSON()` Default Constructor for a JSON Converter
`JSON(Object target)` Creates a new JSON Converter for the given Object

Methods Summary

Methods
Type Params	Return Type	Name and description
	`public void`	`build(Closure c)`
	`public void`	`convertAnother(Object o)`
	`public static void`	`createNamedConfig(String name, Closure<?> callable)`
	`public int`	`getDepth()`
	`public static ConverterConfiguration<JSON>`	`getNamedConfig(String configName)`
	`public JSONWriter`	`getWriter()`
	`protected void`	`handleCircularRelationship(Object o)`
	`protected ConverterConfiguration<JSON>`	`initConfig()`
	`public ObjectMarshaller<JSON>`	`lookupObjectMarshaller(Object target)`
	`public static JSONElement`	`parse(Reader reader)` Parses the given JSON String and returns either a JSONObject or a JSONArray
	`public static JSONElement`	`parse(String source)` Parses the given JSON String and returns either a JSONObject or a JSONArray
	`public static JSONElement`	`parse(InputStream is, String encoding)` Parses the given JSON and returns either a JSONObject or a JSONArray
	`public static Object`	`parse(HttpServletRequest request)` Parses the given request's InputStream and returns either a JSONObject or a JSONArray
	`public void`	`property(String key, Object value)`
	`public static void`	`registerObjectMarshaller(Class<?> clazz, Closure<?> callable)`
	`public static void`	`registerObjectMarshaller(Class<?> clazz, int priority, Closure<?> callable)`
	`public static void`	`registerObjectMarshaller(ObjectMarshaller<JSON> om)`
	`public static void`	`registerObjectMarshaller(ObjectMarshaller<JSON> om, int priority)`
	`public void`	`render(Writer out)` Directs the JSON Writer to the given Writer
	`public void`	`render(HttpServletResponse response)` Directs the JSON Writer to the Outputstream of the HttpServletResponse and sets the Content-Type to application/json
	`public void`	`setExcludes(List<String> excludes)`
	`public void`	`setIncludes(List<String> includes)`
	`public void`	`setPrettyPrint(boolean prettyPrint)`
	`public void`	`setTarget(Object target)` Sets the Object which is later converted to JSON
	`public String`	`toString(boolean prettyPrint)` Performs the conversion and returns the resulting JSON as String
	`public static Object`	`use(String configName, Closure<?> callable)`
	`public static void`	`use(String cfgName)`
	`public void`	`value(Object o)` Parameters: o
	`public static void`	`withDefaultConfiguration(Closure<?> callable)`

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class AbstractConverter`	`createBeanWrapper, getExcludes, getIncludes, setContentType, setEncoding, setExcludes, setIncludes, setTarget, toString, writeTo`

- Field Detail
  - protected final CircularReferenceBehaviour circularReferenceBehaviour
  - protected final ConverterConfiguration<JSON> config
  - protected boolean prettyPrint
  - protected Stack<Object> referenceStack
  - protected Object target
  - protected JSONWriter writer
- Constructor Detail
  - public JSON()
    
    Default Constructor for a JSON Converter
  - public JSON(Object target)
    
    Creates a new JSON Converter for the given Object
    Parameters:
    target - the Object to convert
- Method Detail
  - public void build(@SuppressWarnings("rawtypes")
    Closure c)
  - public void convertAnother(Object o)
  - public static void createNamedConfig(String name, Closure<?> callable)
  - public int getDepth()
  - public static ConverterConfiguration<JSON> getNamedConfig(String configName)
  - public JSONWriter getWriter()
  - protected void handleCircularRelationship(Object o)
  - protected ConverterConfiguration<JSON> initConfig()
  - public ObjectMarshaller<JSON> lookupObjectMarshaller(Object target)
  - public static JSONElement parse(Reader reader)
    
    Parses the given JSON String and returns either a JSONObject or a JSONArray
    throws:
    ConverterException when the JSON content is not valid
    
    Parameters:
    reader - JSON source
    Returns:
    either a JSONObject or a JSONArray - depending on the given JSON
  - public static JSONElement parse(String source)
    
    Parses the given JSON String and returns either a JSONObject or a JSONArray
    throws:
    ConverterException when the JSON content is not valid
    
    Parameters:
    source - A string containing some JSON
    Returns:
    either a JSONObject or a JSONArray - depending on the given JSON
  - public static JSONElement parse(InputStream is, String encoding)
    
    Parses the given JSON and returns either a JSONObject or a JSONArray
    throws:
    ConverterException when the JSON content is not valid
    
    Parameters:
    is - An InputStream which delivers some JSON
    encoding - the Character Encoding to use
    Returns:
    either a JSONObject or a JSONArray - depending on the given JSON
  - public static Object parse(HttpServletRequest request)
    
    Parses the given request's InputStream and returns either a JSONObject or a JSONArray
    throws:
    ConverterException when the JSON content is not valid
    
    Parameters:
    request - the JSON Request
    Returns:
    either a JSONObject or a JSONArray - depending on the given JSON
  - public void property(String key, Object value)
  - public static void registerObjectMarshaller(Class<?> clazz, Closure<?> callable)
  - public static void registerObjectMarshaller(Class<?> clazz, int priority, Closure<?> callable)
  - public static void registerObjectMarshaller(ObjectMarshaller<JSON> om)
  - public static void registerObjectMarshaller(ObjectMarshaller<JSON> om, int priority)
  - public void render(Writer out)
    
    Directs the JSON Writer to the given Writer
    throws:
    org.grails.web.converters.exceptions.ConverterException
    
    Parameters:
    out - the Writer
  - public void render(HttpServletResponse response)
    
    Directs the JSON Writer to the Outputstream of the HttpServletResponse and sets the Content-Type to application/json
    throws:
    ConverterException
    
    Parameters:
    response - a HttpServletResponse
  - @Override
    public void setExcludes(List<String> excludes)
  - @Override
    public void setIncludes(List<String> includes)
  - public void setPrettyPrint(boolean prettyPrint)
  - @Override
    public void setTarget(Object target)
    
    Sets the Object which is later converted to JSON
    Parameters:
    target - the Object
    See Also:
    Converter
  - public String toString(boolean prettyPrint)
    
    Performs the conversion and returns the resulting JSON as String
    throws:
    JSONException
    
    Parameters:
    prettyPrint - true, if the output should be indented, otherwise false
    Returns:
    a JSON String
  - public static Object use(String configName, Closure<?> callable)
  - public static void use(String cfgName)
  - public void value(Object o)
    
    throws:
    ConverterException
    
    Parameters:
    o
  - public static void withDefaultConfiguration(Closure<?> callable)

| Detail:
Field
Constructor
Method

[Java] Class JSON

Nested Class Summary

Field Summary

Constructor Summary

Methods Summary

Inherited Methods Summary

Field Detail

protected final CircularReferenceBehaviour circularReferenceBehaviour

protected final ConverterConfiguration<JSON> config

protected boolean prettyPrint

protected Stack<Object> referenceStack

protected Object target

protected JSONWriter writer

Constructor Detail

public JSON()

public JSON(Object target)

Method Detail

public void build(@SuppressWarnings("rawtypes")Closure c)

public void convertAnother(Object o)

public static void createNamedConfig(String name, Closure<?> callable)

public int getDepth()

public static ConverterConfiguration<JSON> getNamedConfig(String configName)

public JSONWriter getWriter()

protected void handleCircularRelationship(Object o)

protected ConverterConfiguration<JSON> initConfig()

public ObjectMarshaller<JSON> lookupObjectMarshaller(Object target)

public static JSONElement parse(Reader reader)

public static JSONElement parse(String source)

public static JSONElement parse(InputStream is, String encoding)

public static Object parse(HttpServletRequest request)

public void property(String key, Object value)

public static void registerObjectMarshaller(Class<?> clazz, Closure<?> callable)

public static void registerObjectMarshaller(Class<?> clazz, int priority, Closure<?> callable)

public static void registerObjectMarshaller(ObjectMarshaller<JSON> om)

public static void registerObjectMarshaller(ObjectMarshaller<JSON> om, int priority)

public void render(Writer out)

public void render(HttpServletResponse response)

@Overridepublic void setExcludes(List<String> excludes)

@Overridepublic void setIncludes(List<String> includes)

public void setPrettyPrint(boolean prettyPrint)

@Overridepublic void setTarget(Object target)

public String toString(boolean prettyPrint)

public static Object use(String configName, Closure<?> callable)

public static void use(String cfgName)

public void value(Object o)

public static void withDefaultConfiguration(Closure<?> callable)

public void build(@SuppressWarnings("rawtypes")
Closure c)

@Override
public void setExcludes(List<String> excludes)

@Override
public void setIncludes(List<String> includes)

@Override
public void setTarget(Object target)