org.json.simple.parser

Interface ContentHandler

public interface ContentHandler

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

Author:

FangYidong<fangyidong@yahoo.com.cn>

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(java.lang.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(java.lang.String key) Receive notification of the beginning of a JSON object entry.

Method Detail

startJSON

void startJSON()
        throws java.io.IOException,
               ParseException

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

Throws:

java.io.IOException - input-output exception.

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

endJSON

void endJSON()
      throws java.io.IOException,
             ParseException

Receive notification of the end of JSON processing.

Throws:

java.io.IOException - input-output exception.

ParseException - unexpected token.

startObject

boolean startObject()
             throws java.io.IOException,
                    ParseException

Receive notification of the beginning of a JSON object.

Returns:

false if the handler wants to stop parsing after return.

Throws:

java.io.IOException - input-output exception.

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

See Also:

endJSON()

endObject

boolean endObject()
           throws java.io.IOException,
                  ParseException

Receive notification of the end of a JSON object.

Returns:

false if the handler wants to stop parsing after return.

Throws:

java.io.IOException - input-output exception.

ParseException - unexpected token.

See Also:

startObject()

startObjectEntry

boolean startObjectEntry(java.lang.String key)
                  throws java.io.IOException,
                         ParseException

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:

java.io.IOException - input-output exception.

ParseException - unexpected token.

See Also:

endObjectEntry()

endObjectEntry

boolean endObjectEntry()
                throws java.io.IOException,
                       ParseException

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

Returns:

false if the handler wants to stop parsing after return.

Throws:

java.io.IOException - input-output exception.

ParseException - unexpected token.

See Also:

startObjectEntry(java.lang.String)

startArray

boolean startArray()
            throws java.io.IOException,
                   ParseException

Receive notification of the beginning of a JSON array.

Returns:

false if the handler wants to stop parsing after return.

Throws:

java.io.IOException - input-output exception.

ParseException - unexpected token.

See Also:

endArray()

endArray

boolean endArray()
          throws java.io.IOException,
                 ParseException

Receive notification of the end of a JSON array.

Returns:

false if the handler wants to stop parsing after return.

Throws:

java.io.IOException - input-output exception.

ParseException - unexpected token.

See Also:

startArray()

primitive

boolean primitive(java.lang.Object value)
           throws java.io.IOException,
                  ParseException

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:

java.io.IOException - input-output exception.

ParseException - unexpected token.