net.minidev.json.parser

Interface ContentHandler

All Known Implementing Classes:

ContentHandlerCompressor, ContentHandlerDumy

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:

ContentHandler

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:

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

IOException

endJSON

void endJSON()
      throws ParseException,
             IOException

Receive notification of the end of JSON processing.

Throws:

ParseException

IOException

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:

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

IOException

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:

ParseException

IOException

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:

ParseException

IOException

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:

ParseException

IOException

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:

ParseException

IOException

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:

ParseException

IOException

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:

ParseException

IOException