com.google.api.client.json
Class JsonGenerator

java.lang.Object
  com.google.api.client.json.JsonGenerator

Direct Known Subclasses:

GsonGenerator

public abstract class JsonGenerator
extends Object

Abstract low-level JSON serializer.

Implementation has no fields and therefore thread-safe, but sub-classes are not necessarily thread-safe.

Since:

1.3

Author:

Yaniv Inbar

Constructor Summary

JsonGenerator()

Method Summary

abstract void	close() Closes the serializer and the underlying output stream or writer, and releases any memory associated with it.
abstract void	flush() Flushes any buffered content to the underlying output stream or writer.
abstract JsonFactory	getFactory() Returns the JSON factory from which this generator was created.
void	serialize(Object value) Serializes the given JSON value object.
abstract void	writeBoolean(boolean state) Writes a literal JSON boolean value ('true' or 'false').
abstract void	writeEndArray() Writes a JSON end array character ']'.
abstract void	writeEndObject() Writes a JSON end object character '}'.
abstract void	writeFieldName(String name) Writes a JSON quoted field name.
abstract void	writeNull() Writes a literal JSON null value.
abstract void	writeNumber(BigDecimal v) Writes a JSON big decimal value.
abstract void	writeNumber(BigInteger v) Writes a JSON big integer value.
abstract void	writeNumber(double v) Writes a JSON double value.
abstract void	writeNumber(float v) Writes a JSON float value.
abstract void	writeNumber(int v) Writes a JSON int value.
abstract void	writeNumber(long v) Writes a JSON long value.
abstract void	writeNumber(String encodedValue) Writes a JSON numeric value that has already been encoded properly.
abstract void	writeStartArray() Writes a JSON start array character '['.
abstract void	writeStartObject() Writes a JSON start object character '{'.
abstract void	writeString(String value) Writes a JSON quoted string value.

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonGenerator

public JsonGenerator()

Method Detail

getFactory

public abstract JsonFactory getFactory()

Returns the JSON factory from which this generator was created.

flush

public abstract void flush()
                    throws IOException

Flushes any buffered content to the underlying output stream or writer.

Throws:

IOException - if failed

close

public abstract void close()
                    throws IOException

Closes the serializer and the underlying output stream or writer, and releases any memory associated with it.

Throws:

IOException - if failed

writeStartArray

public abstract void writeStartArray()
                              throws IOException

Writes a JSON start array character '['.

Throws:

IOException - if failed

writeEndArray

public abstract void writeEndArray()
                            throws IOException

Writes a JSON end array character ']'.

Throws:

IOException - if failed

writeStartObject

public abstract void writeStartObject()
                               throws IOException

Writes a JSON start object character '{'.

Throws:

IOException - if failed

writeEndObject

public abstract void writeEndObject()
                             throws IOException

Writes a JSON end object character '}'.

Throws:

IOException - if failed

writeFieldName

public abstract void writeFieldName(String name)
                             throws IOException

Writes a JSON quoted field name.

Throws:

IOException - if failed

writeNull

public abstract void writeNull()
                        throws IOException

Writes a literal JSON null value.

Throws:

IOException - if failed

writeString

public abstract void writeString(String value)
                          throws IOException

Writes a JSON quoted string value.

Throws:

IOException - if failed

writeBoolean

public abstract void writeBoolean(boolean state)
                           throws IOException

Writes a literal JSON boolean value ('true' or 'false').

Throws:

IOException - if failed

writeNumber

public abstract void writeNumber(int v)
                          throws IOException

Writes a JSON int value.

Throws:

IOException - if failed

writeNumber

public abstract void writeNumber(long v)
                          throws IOException

Writes a JSON long value.

Throws:

IOException - if failed

writeNumber

public abstract void writeNumber(BigInteger v)
                          throws IOException

Writes a JSON big integer value.

Throws:

IOException - if failed

writeNumber

public abstract void writeNumber(float v)
                          throws IOException

Writes a JSON float value.

Throws:

IOException - if failed

writeNumber

public abstract void writeNumber(double v)
                          throws IOException

Writes a JSON double value.

Throws:

IOException - if failed

writeNumber

public abstract void writeNumber(BigDecimal v)
                          throws IOException

Writes a JSON big decimal value.

Throws:

IOException - if failed

writeNumber

public abstract void writeNumber(String encodedValue)
                          throws IOException

Writes a JSON numeric value that has already been encoded properly.

Throws:

IOException - if failed

serialize

public final void serialize(Object value)
                     throws IOException

Serializes the given JSON value object.

Parameters:

value - JSON value object or null to ignore

Throws:

IOException