Interface JSON

All Superinterfaces:
Serializable
All Known Implementing Classes:
AbstractJSON, JSONArray, JSONNull, JSONObject

public interface JSON extends Serializable
Marker interface, identifies a valid JSON value.
A JSON value may be a JSONObject, a JSONArray or a JSONNull.
  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    Returns true if this object is a JSONArray, false otherwise.
    boolean
    Returns true if this object has no elements or keys.
    int
    Returns the number of properties in an object or the size of the array.
    toString(int indentFactor)
    Make a prettyprinted JSON text.
    toString(int indentFactor, int indent)
    Make a prettyprinted JSON text.
    write(Writer writer)
    Write the contents as JSON text to a writer.
    Writes the canonicalized form of this JSON object.
  • Method Details

    • isArray

      boolean isArray()
      Returns true if this object is a JSONArray, false otherwise.
    • isEmpty

      boolean isEmpty()
      Returns true if this object has no elements or keys.
      Throws:
      JSONException - if called on a 'null' object
    • size

      int size()
      Returns the number of properties in an object or the size of the array.
      Returns:
      the size of an json object or array
      Throws:
      JSONException - if called on a 'null' object
    • toString

      String toString(int indentFactor)
      Make a prettyprinted JSON text.

      Warning: This method assumes that the data structure is acyclical.

      Parameters:
      indentFactor - The number of spaces to add to each level of indentation.
      Returns:
      a printable, displayable, portable, transmittable representation of the object, beginning with { (left brace) and ending with } (right brace).
      Throws:
      JSONException - If the object contains an invalid number.
    • toString

      String toString(int indentFactor, int indent)
      Make a prettyprinted JSON text.

      Warning: This method assumes that the data structure is acyclical.

      Parameters:
      indentFactor - The number of spaces to add to each level of indentation.
      indent - The indentation of the top level.
      Returns:
      a printable, displayable, transmittable representation of the object, beginning with { (left brace) and ending with } (right brace).
      Throws:
      JSONException - If the object contains an invalid number.
    • write

      Writer write(Writer writer) throws IOException
      Write the contents as JSON text to a writer. For compactness, no whitespace is added.

      Warning: This method assumes that the data structure is acyclical.

      Returns:
      The writer.
      Throws:
      JSONException
      IOException
    • writeCanonical

      Writer writeCanonical(Writer w) throws IOException
      Writes the canonicalized form of this JSON object.
      Throws:
      IOException