com.google.api.client.json

Class JsonGenerator

  • Direct Known Subclasses:
    MockJsonGenerator 

    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

    • Constructor Summary

      Constructors

      Constructor and Description
      JsonGenerator()
       

    • Method Summary

      Modifier and Type Method and Description
      abstract void close()
      Closes the serializer and the underlying output stream or writer, and releases any memory associated with it.
      void enablePrettyPrint()
      Requests that the output be pretty printed (by default it is not).
      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, or if value is null it does no serialization.
      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.

    • 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

      • 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

      • writeStartArray

        public abstract void writeStartArray()
                              throws IOException
        Writes a JSON start array character '['.
        Throws:
        IOException

      • writeEndArray

        public abstract void writeEndArray()
                            throws IOException
        Writes a JSON end array character ']'.
        Throws:
        IOException

      • writeStartObject

        public abstract void writeStartObject()
                               throws IOException
        Writes a JSON start object character '{'.
        Throws:
        IOException

      • writeEndObject

        public abstract void writeEndObject()
                             throws IOException
        Writes a JSON end object character '}'.
        Throws:
        IOException

      • writeNull

        public abstract void writeNull()
                        throws IOException
        Writes a literal JSON null value.
        Throws:
        IOException

      • writeBoolean

        public abstract void writeBoolean(boolean state)
                           throws IOException
        Writes a literal JSON boolean value ('true' or 'false').
        Throws:
        IOException

      • writeNumber

        public abstract void writeNumber(int v)
                          throws IOException
        Writes a JSON int value.
        Throws:
        IOException

      • writeNumber

        public abstract void writeNumber(long v)
                          throws IOException
        Writes a JSON long value.
        Throws:
        IOException

      • writeNumber

        public abstract void writeNumber(float v)
                          throws IOException
        Writes a JSON float value.
        Throws:
        IOException

      • writeNumber

        public abstract void writeNumber(double v)
                          throws IOException
        Writes a JSON double value.
        Throws:
        IOException

      • writeNumber

        public abstract void writeNumber(String encodedValue)
                          throws IOException
        Writes a JSON numeric value that has already been encoded properly.
        Throws:
        IOException

      • serialize

        public final void serialize(Object value)
                     throws IOException
        Serializes the given JSON value object, or if value is null it does no serialization.
        Throws:
        IOException

      • enablePrettyPrint

        public void enablePrettyPrint()
                       throws IOException
        Requests that the output be pretty printed (by default it is not).

        Default implementation does nothing, but implementations may override to provide actual pretty printing.

        Throws:
        IOException - possible I/O exception (unused in default implementation)
        Since:
        1.6