de.undercouch.actson

Class DefaultJsonFeeder

java.lang.Object

de.undercouch.actson.DefaultJsonFeeder

All Implemented Interfaces:

JsonFeeder

public class DefaultJsonFeeder
extends java.lang.Object
implements JsonFeeder

Default implementation of JsonFeeder used internally by the JsonParser.

Since:

1.0.0

Constructor Summary

Constructors

Constructor and Description
DefaultJsonFeeder(java.nio.charset.Charset charset) Constructs a feeder
DefaultJsonFeeder(java.nio.charset.Charset charset, int capacity) Constructs a feeder

Method Summary

Modifier and Type	Method and Description
void	done() Call this method to indicate that the end of the JSON text has been reached and that there is no more input to parse.
void	feed(byte b) Provide more data to the JsonParser.
int	feed(byte[] buf) Provide more data to the JsonParser.
int	feed(byte[] buf, int offset, int len) Provide more data to the JsonParser.
boolean	hasInput() Determine if the feeder has input data that can be parsed
boolean	isDone() Check if the end of the JSON text has been reached
boolean	isFull() Checks if the parser accepts more input at the moment.
char	nextInput() Decode and return the next character to be parsed

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultJsonFeeder

public DefaultJsonFeeder(java.nio.charset.Charset charset)

Constructs a feeder

Parameters:

charset - the charset that should be used to decode input data

DefaultJsonFeeder

public DefaultJsonFeeder(java.nio.charset.Charset charset,
                         int capacity)

Constructs a feeder

Parameters:

charset - the charset that should be used to decode input data

capacity - the capacity of the internal byte buffer caching input data

Method Detail

feed

public void feed(byte b)

Description copied from interface: JsonFeeder

Provide more data to the JsonParser. Should only be called if JsonFeeder.isFull() returns false.

Specified by:

feed in interface JsonFeeder

Parameters:

b - the byte to provide as input to the parser

feed

public int feed(byte[] buf)

Description copied from interface: JsonFeeder

Provide more data to the JsonParser. The method will consume as many bytes from the input buffer as possible, either until all bytes have been consumed or until the feeder is full (see JsonFeeder.isFull()). The method will return the number of bytes consumed (which can be 0 if the parser does not accept more input at the moment).

Specified by:

feed in interface JsonFeeder

Parameters:

buf - the byte array containing the data to consume

Returns:

the number of bytes consumed (can be 0 if the parser does not accept more input at the moment, see JsonFeeder.isFull())

feed

public int feed(byte[] buf,
                int offset,
                int len)

Description copied from interface: JsonFeeder

Provide more data to the JsonParser. The method will consume as many bytes from the input buffer as possible, either until len bytes have been consumed or until the feeder is full (see JsonFeeder.isFull()). The method will return the number of bytes consumed (which can be 0 if the parser does not accept more input at the moment).

Specified by:

feed in interface JsonFeeder

Parameters:

buf - the byte array containing the data to consume

offset - the start offset in the byte array

len - the number of bytes to consume

Returns:

the number of bytes consumed (can be 0 if the parser does not accept more input at the moment, see JsonFeeder.isFull())

done

public void done()

Description copied from interface: JsonFeeder

Call this method to indicate that the end of the JSON text has been reached and that there is no more input to parse.

Specified by:

done in interface JsonFeeder

isFull

public boolean isFull()

Description copied from interface: JsonFeeder

Checks if the parser accepts more input at the moment. If it doesn't, you have to call JsonParser.nextEvent() until it returns JsonEvent.NEED_MORE_INPUT. Only then new input can be provided to the parser.

Specified by:

isFull in interface JsonFeeder

Returns:

true if the parser does not accept more input

hasInput

public boolean hasInput()
                 throws java.nio.charset.CharacterCodingException

Description copied from interface: JsonFeeder

Determine if the feeder has input data that can be parsed

Specified by:

hasInput in interface JsonFeeder

Returns:

true if the feeder has more input to be parsed

Throws:

java.nio.charset.CharacterCodingException - if the input data contains invalid characters

isDone

public boolean isDone()
               throws java.nio.charset.CharacterCodingException

Description copied from interface: JsonFeeder

Check if the end of the JSON text has been reached

Specified by:

isDone in interface JsonFeeder

Returns:

true if the end of input has been reached

Throws:

java.nio.charset.CharacterCodingException - if the input data contains invalid characters

nextInput

public char nextInput()
               throws java.nio.charset.CharacterCodingException

Description copied from interface: JsonFeeder

Decode and return the next character to be parsed

Specified by:

nextInput in interface JsonFeeder

Returns:

the next character to be parsed

Throws:

java.nio.charset.CharacterCodingException - if the input data contains invalid characters