org.cometd.common

Interface JSONContext<T extends Message.Mutable>

Type Parameters:

T - the type of message

All Known Subinterfaces:

JSONContext.Client, JSONContextServer

All Known Implementing Classes:

JacksonJSONContextClient, JacksonJSONContextServer, JettyJSONContextClient, JettyJSONContextServer

public interface JSONContext<T extends Message.Mutable>

Abstraction for JSON parsing and generation.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	JSONContext.AsyncParser A non-blocking JSON parser.
static interface	JSONContext.Client Client specific JSONContext that binds to Message.Mutable.
static interface	JSONContext.Generator A JSON stringifier.
static interface	JSONContext.Parser A blocking JSON parser.

Method Summary

Modifier and Type	Method and Description
String	generate(List<T> messages) Converts a list of messages to a JSON string.
String	generate(T message) Converts a single message to a JSON string.
JSONContext.Generator	getGenerator()
JSONContext.Parser	getParser()
default JSONContext.AsyncParser	newAsyncParser()
T[]	parse(InputStream stream) Deprecated. use parse(Reader) instead
T[]	parse(Reader reader) Parses an array of messages from the given reader.
T[]	parse(String json) Parses an array of messages from the given string.

Method Detail

parse

@Deprecated
T[] parse(InputStream stream)
               throws ParseException

Deprecated. use parse(Reader) instead

Parses an array of messages from the given stream.

Parameters:

stream - the stream to parse from

Returns:

an array of messages

Throws:

ParseException - in case of parsing errors

parse

T[] parse(Reader reader)
   throws ParseException

Parses an array of messages from the given reader.

Parameters:

reader - the reader to parse from

Returns:

an array of messages

Throws:

ParseException - in case of parsing errors

parse

T[] parse(String json)
   throws ParseException

Parses an array of messages from the given string.

Parameters:

json - the JSON string to parse from

Returns:

an array of messages

Throws:

ParseException - in case of parsing errors

newAsyncParser

default JSONContext.AsyncParser newAsyncParser()

Returns:

a new JSONContext.AsyncParser instance, or null if non-blocking parsing is not supported

generate

String generate(T message)

Converts a single message to a JSON string.

Parameters:

message - the message to stringify

Returns:

the JSON string for the message

generate

String generate(List<T> messages)

Converts a list of messages to a JSON string.

Parameters:

messages - the list of messages to stringify

Returns:

the JSON string for the messages

getParser

JSONContext.Parser getParser()

Returns:

a synchronous JSON parser to parse any JSON string

getGenerator

JSONContext.Generator getGenerator()

Returns:

a JSON generator to stringify any object to a JSON string