net.markenwerk.utils.json.parser

Interface JsonPushParser

All Superinterfaces:

AutoCloseable, Closeable

All Known Implementing Classes:

JsonSourcePushParser

public interface JsonPushParser
extends Closeable

A JsonPullParser is an event based JSON parser. It reports it consume the underlying JSON document and reports the appropriate events to a JsonHandler.

Since:

1.0.0

Author:

Torsten Krause (tk at markenwerk dot net)

Method Summary

Modifier and Type	Method and Description
int	getColumn() Returns the column that corresponds to the current position of the underlying JsonSource in the character sequence, as if the character source was a regular file.
int	getLine() Returns the line that corresponds to the current position of the underlying JsonSource in the character sequence, as if the character source was a regular file.
<Result> Result	handle(JsonHandler<Result> handler) Handle the character sequence from the JsonSource and report to the JsonHandler.

Methods inherited from interface java.io.Closeable

close

Method Detail

handle

<Result> Result handle(JsonHandler<Result> handler)
                throws IllegalArgumentException,
                       JsonSyntaxException,
                       IOException

Handle the character sequence from the JsonSource and report to the JsonHandler.

Calling this method closes the underlying JsonSource, but it can be closed manually.

Type Parameters:

Result - The result type of the JsonHandler.

Parameters:

handler - The JsonHandler to report to.

Returns:

The result that has been calculated by the given JsonHandler.

Throws:

IllegalArgumentException - If the given JsonHandler is null.

JsonSyntaxException - If the JsonSyntaxException document contains a syntax error.

IOException - If reading from the underlying Reader failed.

getLine

int getLine()

Returns the line that corresponds to the current position of the underlying JsonSource in the character sequence, as if the character source was a regular file.

Returns:

The line.

getColumn

int getColumn()

Returns the column that corresponds to the current position of the underlying JsonSource in the character sequence, as if the character source was a regular file.

Returns:

The line.