Modifier and Type	Class and Description
public static interface	AsyncJSON.Context The state of JSON parsing.
public static class	AsyncJSON.Factory The factory that creates AsyncJSON instances.
private static class	AsyncJSON.Frame
private static class	AsyncJSON.FrameStack
private static class	AsyncJSON.NumberBuilder
private static enum	AsyncJSON.State

Modifier and Type	Field and Description
private List<ByteBuffer>	chunks
private final AsyncJSON.Factory	factory
private final AsyncJSON.NumberBuilder	numberBuilder
private final AsyncJSON.FrameStack	stack
private final Utf8StringBuilder	stringBuilder
private static final Object	UNSET

Access	Constructor and Description
public	AsyncJSON(AsyncJSON.Factory factory)

Method Summary

Modifier and Type	Method and Description
public < the type the result is cast to R> R	Returns: the result of the JSON parsing complete() Signals to the parser that the parse data is complete, and returns the object parsed from the JSON chunks passed to the `parse()` methods.
private Object	convertArray(List<?> array)
private Object	convertObject(Map<String, Object> object)
private Object	convertObject(String fieldName, Map<String, Object> object)
private Object	end()
private byte	hexToByte(ByteBuffer buffer, byte currentByte)
pack-priv boolean	isEmpty()
private static boolean	isWhitespace(byte ws)
protected List<Object>	Returns: a `List` instance newArray(AsyncJSON.Context the parsing context context) When a JSON `[` is encountered during parsing, this method is called to create a new `List` instance.
protected RuntimeException	newInvalidJSON(ByteBuffer buffer, String message)
protected Map<String, Object>	Returns: a `Map` instance newObject(AsyncJSON.Context the parsing context context) When a JSON `{` is encountered during parsing, this method is called to create a new `Map` instance.
public boolean	Returns: whether the JSON parsing was complete parse(byte[] the bytes to parse bytes) Feeds the parser with the given bytes chunk.
public boolean	Returns: whether the JSON parsing was complete parse(byte[] the bytes to parse bytes, int the offset to start parsing from offset, int the number of bytes to parse length) Feeds the parser with the given bytes chunk.
public boolean	Returns: whether the JSON parsing was complete parse(ByteBuffer the buffer to parse buffer) Feeds the parser with the given buffer chunk.
private boolean	parseAny(ByteBuffer buffer)
private boolean	parseArray(ByteBuffer buffer)
private boolean	parseEscape(ByteBuffer buffer)
private boolean	parseEscapeCharacter(char escape)
private boolean	parseFalse(ByteBuffer buffer)
private void	parseFalseCharacter(ByteBuffer buffer, int index)
private boolean	parseNull(ByteBuffer buffer)
private void	parseNullCharacter(ByteBuffer buffer, int index)
private boolean	parseNumber(ByteBuffer buffer)
private boolean	parseObject(ByteBuffer buffer)
private boolean	parseObjectField(ByteBuffer buffer)
private boolean	parseObjectFieldName(ByteBuffer buffer)
private boolean	parseObjectFieldValue(ByteBuffer buffer)
private boolean	parseString(ByteBuffer buffer)
private boolean	parseTrue(ByteBuffer buffer)
private void	parseTrueCharacter(ByteBuffer buffer, int index)
private boolean	parseUnicode(ByteBuffer buffer)
private void	reset()
private JSON.Convertible	toConvertible(String className)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

chunks	back to summary
private List<ByteBuffer> chunks

factory	back to summary
private final AsyncJSON.Factory factory

numberBuilder	back to summary
private final AsyncJSON.NumberBuilder numberBuilder

stack	back to summary
private final AsyncJSON.FrameStack stack

stringBuilder	back to summary
private final Utf8StringBuilder stringBuilder

UNSET	back to summary
private static final Object UNSET

Constructor Detail

AsyncJSON	back to summary
public AsyncJSON(AsyncJSON.Factory factory)

Method Detail

complete back to summary

complete	back to summary
public <R> R complete() Signals to the parser that the parse data is complete, and returns the object parsed from the JSON chunks passed to the `parse()` methods. Parameters <R> the type the result is cast to Returns:R the result of the JSON parsing Exceptions IllegalArgumentException: if the JSON is malformed IllegalStateException: if the no JSON was passed to the `parse()` methods

public <R> R complete()

Signals to the parser that the parse data is complete, and returns the object parsed from the JSON chunks passed to the parse() methods.

Parameters

<R>: the type the result is cast to

Returns:R

the result of the JSON parsing

Exceptions

IllegalArgumentException:: if the JSON is malformed
IllegalStateException:: if the no JSON was passed to the parse() methods

convertArray	back to summary
private Object convertArray(List<?> array)

convertObject	back to summary
private Object convertObject(Map<String, Object> object)

convertObject	back to summary
private Object convertObject(String fieldName, Map<String, Object> object)

end	back to summary
private Object end()

hexToByte	back to summary
private byte hexToByte(ByteBuffer buffer, byte currentByte)

isEmpty	back to summary
pack-priv boolean isEmpty()

isWhitespace	back to summary
private static boolean isWhitespace(byte ws)

newArray back to summary

newArray	back to summary
protected List<Object> newArray(AsyncJSON.Context context) When a JSON `[` is encountered during parsing, this method is called to create a new `List` instance. Subclasses may override to return a custom `List` instance. Parameters context:AsyncJSON.Context the parsing context Returns:List<Object> a `List` instance

protected List<Object> newArray(AsyncJSON.Context context)

When a JSON [ is encountered during parsing, this method is called to create a new List instance.

Subclasses may override to return a custom List instance.

Parameters

context:AsyncJSON.Context: the parsing context

Returns:List<Object>

a List instance

newInvalidJSON	back to summary
protected RuntimeException newInvalidJSON(ByteBuffer buffer, String message)

newObject back to summary

newObject	back to summary
protected Map<String, Object> newObject(AsyncJSON.Context context) When a JSON `{` is encountered during parsing, this method is called to create a new `Map` instance. Subclasses may override to return a custom `Map` instance. Parameters context:AsyncJSON.Context the parsing context Returns:Map<String, Object> a `Map` instance

protected Map<String, Object> newObject(AsyncJSON.Context context)

When a JSON { is encountered during parsing, this method is called to create a new Map instance.

Subclasses may override to return a custom Map instance.

Parameters

context:AsyncJSON.Context: the parsing context

Returns:Map<String, Object>

a Map instance

parse	back to summary
public boolean parse(byte[] bytes) Feeds the parser with the given bytes chunk. Parameters bytes:byte[] the bytes to parse Returns:boolean whether the JSON parsing was complete Exceptions IllegalArgumentException: if the JSON is malformed

parse

back to summary

public boolean parse(byte[] bytes)

Feeds the parser with the given bytes chunk.

Parameters

bytes:byte[]: the bytes to parse

Returns:boolean

whether the JSON parsing was complete

Exceptions

IllegalArgumentException:: if the JSON is malformed

parse	back to summary
public boolean parse(byte[] bytes, int offset, int length) Feeds the parser with the given bytes chunk. Parameters bytes:byte[] the bytes to parse offset:int the offset to start parsing from length:int the number of bytes to parse Returns:boolean whether the JSON parsing was complete Exceptions IllegalArgumentException: if the JSON is malformed

parse

back to summary

public boolean parse(byte[] bytes, int offset, int length)

Feeds the parser with the given bytes chunk.

Parameters

bytes:byte[]: the bytes to parse
offset:int: the offset to start parsing from
length:int: the number of bytes to parse

Returns:boolean

whether the JSON parsing was complete

Exceptions

IllegalArgumentException:: if the JSON is malformed

parse	back to summary
public boolean parse(ByteBuffer buffer) Feeds the parser with the given buffer chunk. Parameters buffer:ByteBuffer the buffer to parse Returns:boolean whether the JSON parsing was complete Exceptions IllegalArgumentException: if the JSON is malformed

parse

back to summary

public boolean parse(ByteBuffer buffer)

Feeds the parser with the given buffer chunk.

Parameters

buffer:ByteBuffer: the buffer to parse

Returns:boolean

whether the JSON parsing was complete

Exceptions

IllegalArgumentException:: if the JSON is malformed

parseAny	back to summary
private boolean parseAny(ByteBuffer buffer)

parseArray	back to summary
private boolean parseArray(ByteBuffer buffer)

parseEscape	back to summary
private boolean parseEscape(ByteBuffer buffer)

parseEscapeCharacter	back to summary
private boolean parseEscapeCharacter(char escape)

parseFalse	back to summary
private boolean parseFalse(ByteBuffer buffer)

parseFalseCharacter	back to summary
private void parseFalseCharacter(ByteBuffer buffer, int index)

parseNull	back to summary
private boolean parseNull(ByteBuffer buffer)

parseNullCharacter	back to summary
private void parseNullCharacter(ByteBuffer buffer, int index)

parseNumber	back to summary
private boolean parseNumber(ByteBuffer buffer)

parseObject	back to summary
private boolean parseObject(ByteBuffer buffer)

parseObjectField	back to summary
private boolean parseObjectField(ByteBuffer buffer)

parseObjectFieldName	back to summary
private boolean parseObjectFieldName(ByteBuffer buffer)

parseObjectFieldValue	back to summary
private boolean parseObjectFieldValue(ByteBuffer buffer)

parseString	back to summary
private boolean parseString(ByteBuffer buffer)

parseTrue	back to summary
private boolean parseTrue(ByteBuffer buffer)

parseTrueCharacter	back to summary
private void parseTrueCharacter(ByteBuffer buffer, int index)

parseUnicode	back to summary
private boolean parseUnicode(ByteBuffer buffer)

reset	back to summary
private void reset()

toConvertible	back to summary
private JSON.Convertible toConvertible(String className)

org.eclipse.jetty.util.ajax back to summary

public Interface AsyncJSON.Context

Known Direct Implementers: org.eclipse.jetty.util.ajax.AsyncJSON.FrameStack

The state of JSON parsing.

Method Summary

Modifier and Type	Method and Description
public int	Returns: the depth in the JSON structure depth()

Method Detail

depth	back to summary
public int depth() Returns:int the depth in the JSON structure

org.eclipse.jetty.util.ajax back to summary

public Class AsyncJSON.Factory

Class Inheritance

extends Object

java.lang.Object
org.eclipse.jetty.util.ajax.AsyncJSON.Factory

The factory that creates AsyncJSON instances.

The factory can be configured with custom Convertors, and with cached strings that will not be allocated if they can be looked up from the cache.

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	AsyncJSON.Factory.CachedString

Field Summary

Modifier and Type	Field and Description
private Function<List<?>, Object>	arrayConverter
private Index.Mutable<AsyncJSON.Factory.CachedString>	cache
private Map<String, JSON.Convertor>	convertors
private boolean	detailedParseException

Constructor Summary

Access	Constructor and Description
public	Factory()

Method Summary

Modifier and Type	Method and Description
public boolean	Returns: whether the value can be cached cache(String the string to cache value)
protected String	Returns: a cached string or `null` cached(ByteBuffer the buffer to lookup the string from buffer) Attempts to return a cached string from the buffer bytes.
public Function<List<?>, Object>	Returns: the function to customize the Java representation of JSON arrays getArrayConverter()
public JSON.Convertor	Returns: the `Convertor` associated with the class name, or `null` getConvertor(String the class name associated with the `Convertor` className) Returns the `Convertor` associated with the given class name, if any.
public boolean	Returns: whether a parse failure should report the whole JSON string or just the last chunk isDetailedParseException()
public AsyncJSON	Returns: a new parser instance newAsyncJSON()
public void	putConvertor(String the domain class name such as `com.acme.Person` className, JSON.Convertor the `Convertor` that converts `Map` to domain objects convertor) Associates the given `Convertor` to the given class name.
public JSON.Convertor	Returns: the `Convertor` associated with the class name, or `null` removeConvertor(String the class name associated with the `Convertor` className) Removes the `Convertor` associated with the given class name.
public void	setArrayConverter(Function<List<?>, Object> the function to customize the Java representation of JSON arrays arrayConverter) Sets the function to convert JSON arrays from their default Java representation, a `List<Object>`, to another Java data structure such as an `Object[]`.
public void	setDetailedParseException(boolean whether a parse failure should report the whole JSON string or just the last chunk detailedParseException)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

arrayConverter	back to summary
private Function<List<?>, Object> arrayConverter

cache	back to summary
private Index.Mutable<AsyncJSON.Factory.CachedString> cache

convertors	back to summary
private Map<String, JSON.Convertor> convertors

detailedParseException	back to summary
private boolean detailedParseException

Constructor Detail

Factory	back to summary
public Factory()

Method Detail

cache	back to summary
public boolean cache(String value) Parameters value:String the string to cache Returns:boolean whether the value can be cached

cached back to summary

protected String cached(ByteBuffer buffer)

Attempts to return a cached string from the buffer bytes.

In case of a cache hit, the string is returned and the buffer position updated.

In case of cache miss, null is returned and the buffer position is left unaltered.

Parameters

buffer:ByteBuffer: the buffer to lookup the string from

Returns:String

a cached string or null

getArrayConverter	back to summary
public Function<List<?>, Object> getArrayConverter() Returns:Function<List<?>, Object> the function to customize the Java representation of JSON arrays See Also `setArrayConverter(Function)`

getConvertor back to summary

public JSON.Convertor getConvertor(String className)

Returns the Convertor associated with the given class name, if any.

Parameters

className:String: the class name associated with the Convertor

Returns:JSON.Convertor

the Convertor associated with the class name, or null

isDetailedParseException	back to summary
public boolean isDetailedParseException() Returns:boolean whether a parse failure should report the whole JSON string or just the last chunk

newAsyncJSON	back to summary
public AsyncJSON newAsyncJSON() Returns:AsyncJSON a new parser instance

putConvertor back to summary

public void putConvertor(String className, JSON.Convertor convertor)

Associates the given Convertor to the given class name.

Parameters

className:String: the domain class name such as com.acme.Person
convertor:JSON.Convertor: the Convertor that converts Map to domain objects

removeConvertor back to summary

public JSON.Convertor removeConvertor(String className)

Removes the Convertor associated with the given class name.

Parameters

className:String: the class name associated with the Convertor

Returns:JSON.Convertor

the Convertor associated with the class name, or null

setArrayConverter back to summary

public void setArrayConverter(Function<List<?>, Object> arrayConverter)

Sets the function to convert JSON arrays from their default Java representation, a List<Object>, to another Java data structure such as an Object[].

Parameters

arrayConverter:Function<List<?>, Object>: the function to customize the Java representation of JSON arrays

See Also

getArrayConverter()

setDetailedParseException	back to summary
public void setDetailedParseException(boolean detailedParseException) Parameters detailedParseException:boolean whether a parse failure should report the whole JSON string or just the last chunk

org.eclipse.jetty.util.ajax back to summary

private Class AsyncJSON.Factory.CachedString

Class Inheritance

extends Object

java.lang.Object
org.eclipse.jetty.util.ajax.AsyncJSON.Factory.CachedString

Field Summary

Modifier and Type	Field and Description
private final String	encoded
private final String	value

Constructor Summary

Access	Constructor and Description
private	CachedString(String value)

Method Summary

Modifier and Type	Method and Description
private boolean	isCacheable()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

encoded	back to summary
private final String encoded

value	back to summary
private final String value

Constructor Detail

CachedString	back to summary
private CachedString(String value)

Method Detail

isCacheable	back to summary
private boolean isCacheable()

org.eclipse.jetty.util.ajax back to summary

private Class AsyncJSON.Frame

Class Inheritance

extends Object

java.lang.Object
org.eclipse.jetty.util.ajax.AsyncJSON.Frame

Field Summary

Modifier and Type	Field and Description
private String	name
private AsyncJSON.State	state
private Object	value

Constructor Summary

Access	Constructor and Description
private	Frame()

Method Summary

Modifier and Type	Method and Description
private void	value(Object value)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

name	back to summary
private String name

state	back to summary
private AsyncJSON.State state

value	back to summary
private Object value

Constructor Detail

Frame	back to summary
private Frame()

Method Detail

value	back to summary
private void value(Object value)

org.eclipse.jetty.util.ajax back to summary

private Class AsyncJSON.FrameStack

Class Inheritance

extends Object
implements Context

java.lang.Object
org.eclipse.jetty.util.ajax.AsyncJSON.FrameStack

All Implemented Interfaces

org.eclipse.jetty.util.ajax.AsyncJSON.Context

Field Summary

Modifier and Type	Field and Description
private int	cursor
private final List<AsyncJSON.Frame>	stack

Constructor Summary

Access	Constructor and Description
private	FrameStack()

Method Summary

Modifier and Type	Method and Description
private void	clear()
public int	depth() Implements org.eclipse.jetty.util.ajax.AsyncJSON.Context.depth.
private void	grow(int grow)
private boolean	isEmpty()
private AsyncJSON.Frame	peek()
private void	pop()
private void	push(AsyncJSON.State state, Object value)
private void	push(String name, AsyncJSON.State state, Object value)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

cursor	back to summary
private int cursor

stack	back to summary
private final List<AsyncJSON.Frame> stack

Constructor Detail

FrameStack	back to summary
private FrameStack()

Method Detail

clear	back to summary
private void clear()

depth

back to summary

public int depth()

Implements org.eclipse.jetty.util.ajax.AsyncJSON.Context.depth.

Returns:int

Doc from org.eclipse.jetty.util.ajax.AsyncJSON.Context.depth.

the depth in the JSON structure

Annotations

@Override

grow	back to summary
private void grow(int grow)

isEmpty	back to summary
private boolean isEmpty()

peek	back to summary
private AsyncJSON.Frame peek()

pop	back to summary
private void pop()

push	back to summary
private void push(AsyncJSON.State state, Object value)

push	back to summary
private void push(String name, AsyncJSON.State state, Object value)

org.eclipse.jetty.util.ajax back to summary

private Class AsyncJSON.NumberBuilder

Class Inheritance

extends Object

java.lang.Object
org.eclipse.jetty.util.ajax.AsyncJSON.NumberBuilder

Field Summary

Modifier and Type	Field and Description
private StringBuilder	builder
private int	integer
private long	value

Constructor Summary

Access	Constructor and Description
private	NumberBuilder()

Method Summary

Modifier and Type	Method and Description
private boolean	appendAlpha(byte b)
private void	appendDigit(byte b)
private boolean	appendSign(byte b)
private void	reset()
private Number	value()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

builder	back to summary
private StringBuilder builder

integer	back to summary
private int integer

value	back to summary
private long value

Constructor Detail

NumberBuilder	back to summary
private NumberBuilder()

Method Detail

appendAlpha	back to summary
private boolean appendAlpha(byte b)

appendDigit	back to summary
private void appendDigit(byte b)

appendSign	back to summary
private boolean appendSign(byte b)

reset	back to summary
private void reset()

value	back to summary
private Number value()

org.eclipse.jetty.util.ajax back to summary

private final Enum AsyncJSON.State

Class Inheritance

extends Enum<AsyncJSON.State>

java.lang.Object
java.lang.Enum
org.eclipse.jetty.util.ajax.AsyncJSON.State

Field Summary

Modifier and Type	Field and Description
public static final AsyncJSON.State	ARRAY
public static final AsyncJSON.State	COMPLETE
public static final AsyncJSON.State	ESCAPE
public static final AsyncJSON.State	FALSE
public static final AsyncJSON.State	NULL
public static final AsyncJSON.State	NUMBER
public static final AsyncJSON.State	OBJECT
public static final AsyncJSON.State	OBJECT_FIELD
public static final AsyncJSON.State	OBJECT_FIELD_NAME
public static final AsyncJSON.State	OBJECT_FIELD_VALUE
public static final AsyncJSON.State	STRING
public static final AsyncJSON.State	TRUE
public static final AsyncJSON.State	UNICODE

Constructor Summary

Access	Constructor and Description
private	State()

Method Summary

Modifier and Type	Method and Description
public static AsyncJSON.State	valueOf(String name)
public static AsyncJSON.State[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

ARRAY	back to summary
public static final AsyncJSON.State ARRAY

COMPLETE	back to summary
public static final AsyncJSON.State COMPLETE

ESCAPE	back to summary
public static final AsyncJSON.State ESCAPE

FALSE	back to summary
public static final AsyncJSON.State FALSE

NULL	back to summary
public static final AsyncJSON.State NULL

NUMBER	back to summary
public static final AsyncJSON.State NUMBER

OBJECT	back to summary
public static final AsyncJSON.State OBJECT

OBJECT_FIELD	back to summary
public static final AsyncJSON.State OBJECT_FIELD

OBJECT_FIELD_NAME	back to summary
public static final AsyncJSON.State OBJECT_FIELD_NAME

OBJECT_FIELD_VALUE	back to summary
public static final AsyncJSON.State OBJECT_FIELD_VALUE

STRING	back to summary
public static final AsyncJSON.State STRING

TRUE	back to summary
public static final AsyncJSON.State TRUE

UNICODE	back to summary
public static final AsyncJSON.State UNICODE

Constructor Detail

State	back to summary
private State()

Method Detail

valueOf	back to summary
public static AsyncJSON.State valueOf(String name)

values	back to summary
public static AsyncJSON.State[] values()