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	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	Description
String	generate(T message)	Converts a single message to a JSON string.
JSONContext.Generator	getGenerator()
JSONContext.Parser	getParser()
default JSONContext.AsyncParser	newAsyncParser()
List<T>	parse(String json)	Parses an array of messages from the given string.

Method Details

parse

List<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

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