com.elikill58.negativity.api.json.parser

Interface ContentHandler

public interface ContentHandler

A simplified and stoppable SAX-like content handler for stream processing of JSON text.

See Also:

JSONParser.parse(java.io.Reader, ContentHandler, boolean)

Method Summary

Modifier and Type	Method and Description
boolean	endArray() Receive notification of the end of a JSON array.
void	endJSON() Receive notification of the end of JSON processing.
boolean	endObject() Receive notification of the end of a JSON object.
boolean	endObjectEntry() Receive notification of the end of the value of previous object entry.
boolean	primitive(Object value) Receive notification of the JSON primitive values: java.lang.String, java.lang.Number, java.lang.Boolean null
boolean	startArray() Receive notification of the beginning of a JSON array.
void	startJSON() Receive notification of the beginning of JSON processing.
boolean	startObject() Receive notification of the beginning of a JSON object.
boolean	startObjectEntry(String key) Receive notification of the beginning of a JSON object entry.

Method Detail

startJSON

void startJSON()
        throws ParseException,
               IOException

Receive notification of the beginning of JSON processing. The parser will invoke this method only once.

Throws:

IOException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

ParseException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

endJSON

void endJSON()
      throws ParseException,
             IOException

Receive notification of the end of JSON processing.

Throws:

IOException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

ParseException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

startObject

boolean startObject()
             throws ParseException,
                    IOException

Receive notification of the beginning of a JSON object.

Returns:

false if the handler wants to stop parsing after return.

Throws:

IOException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

ParseException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

See Also:

endJSON()

endObject

boolean endObject()
           throws ParseException,
                  IOException

Receive notification of the end of a JSON object.

Returns:

false if the handler wants to stop parsing after return.

Throws:

IOException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

ParseException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

See Also:

startObject()

startObjectEntry

boolean startObjectEntry(String key)
                  throws ParseException,
                         IOException

Receive notification of the beginning of a JSON object entry.

Parameters:

key - - Key of a JSON object entry.

Returns:

false if the handler wants to stop parsing after return.

Throws:

IOException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

ParseException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

See Also:

endObjectEntry()

endObjectEntry

boolean endObjectEntry()
                throws ParseException,
                       IOException

Receive notification of the end of the value of previous object entry.

Returns:

false if the handler wants to stop parsing after return.

Throws:

IOException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

ParseException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

See Also:

startObjectEntry(java.lang.String)

startArray

boolean startArray()
            throws ParseException,
                   IOException

Receive notification of the beginning of a JSON array.

Returns:

false if the handler wants to stop parsing after return.

Throws:

IOException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

ParseException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

See Also:

endArray()

endArray

boolean endArray()
          throws ParseException,
                 IOException

Receive notification of the end of a JSON array.

Returns:

false if the handler wants to stop parsing after return.

Throws:

IOException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

ParseException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

See Also:

startArray()

primitive

boolean primitive(Object value)
           throws ParseException,
                  IOException

Receive notification of the JSON primitive values: java.lang.String, java.lang.Number, java.lang.Boolean null

Parameters:

value - - Instance of the following: java.lang.String, java.lang.Number, java.lang.Boolean null

Returns:

false if the handler wants to stop parsing after return.

Throws:

IOException - JSONParser will stop and throw the same exception to the caller when receiving this exception.

ParseException - JSONParser will stop and throw the same exception to the caller when receiving this exception.