Package io.helidon.media.jsonp.server

Class JsonSupport

java.lang.Object

io.helidon.media.jsonp.server.JsonSupport

All Implemented Interfaces:

Handler, Service, BiConsumer<ServerRequest,ServerResponse>

public final class JsonSupport
extends Object
implements Service, Handler

It provides contains JSON-P (javax.json) support for WebServer's Routing. It is intended to provide readers and writers for javax.json objects such as JsonObject or JsonArray. If registered on the Web Server Routing, then all Handlers can use ServerRequest.content(). as(...) and ServerResponse.send() with JSON objects.

Get Instance

Use factory methods create() or create(io.helidon.media.jsonp.common.JsonProcessing) to acquire an instance.

Usage with Routing

JsonSupport should be registered on the routing before any business logic handlers.

 Routing.builder()
        .register(JsonSupport.create())
        .etc.... // Business logic related handlers
 

Instance behaves also as a routing filter. It means that it can be registered on any routing rule (for example HTTP method) and then it can be used in following handlers with compatible rules.

 // Register JsonSupport only for POST of 'foo'
 Routing.builder()
        .post("/foo/{}", JsonSupport.create())
        .post("/foo/bar", ...) // It can use JSON structures
        .get("/foo/bar", ...);  // It can NOT use JSON structures
 

See Also:

Routing, JsonStructure, JsonReader, JsonWriter

Nested Class Summary

Nested classes/interfaces inherited from interface io.helidon.webserver.Handler

Handler.EntityHandler<T>

Method Summary

Modifier and Type	Method and Description
void	accept(ServerRequest request, ServerResponse response) It registers reader and writer for JsonSupport on ServerRequest/ServerResponse on provided routing criteria.
static JsonSupport	create() Returns a singleton instance of JsonSupport with default configuration.
static JsonSupport	create(JsonProcessing processing) Create a JsonSupport with customized processing configuration.
Reader<JsonStructure>	reader() Returns a function (reader) converting Publisher of ByteBuffers to a JSON-P object.
Reader<JsonStructure>	reader(Charset charset) Returns a function (reader) converting Publisher of ByteBuffers to a JSON-P object.
void	update(Routing.Rules routingRules) It registers reader and writer for JsonSupport on ServerRequest/ServerResponse for any HTTP method.
Function<JsonStructure,Flow.Publisher<DataChunk>>	writer() Returns a function (writer) converting JsonStructure to the Publisher of DataChunks.
Function<JsonStructure,Flow.Publisher<DataChunk>>	writer(Charset charset) Returns a function (writer) converting JsonStructure to the Publisher of DataChunks.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.helidon.webserver.Handler

create, create

Methods inherited from interface java.util.function.BiConsumer

andThen

Method Detail

update

public void update(Routing.Rules routingRules)

It registers reader and writer for JsonSupport on ServerRequest/ServerResponse for any HTTP method.

This method is called from Routing during build process. The user should register whole class ot the routing: Routing.builder().register(JsonSupport .create()).

Specified by:

update in interface Service

Parameters:

routingRules - a routing configuration where JSON support should be registered

See Also:

Routing

accept

public void accept(ServerRequest request,
                   ServerResponse response)

It registers reader and writer for JsonSupport on ServerRequest/ServerResponse on provided routing criteria.

This method is called from Routing during build process. The user should register whole class ot the routing criteria. For example: Routing.builder(). post("/foo", JsonSupport.create()).

It calls ServerRequest.next() method to invoke following handlers with particular business logic.

Specified by:

accept in interface Handler

Specified by:

accept in interface BiConsumer<ServerRequest,ServerResponse>

Parameters:

request - a server request

response - a server response

See Also:

Routing

reader

public Reader<JsonStructure> reader(Charset charset)

Returns a function (reader) converting Publisher of ByteBuffers to a JSON-P object.

It is intended for derivation of others, more specific readers.

Parameters:

charset - a charset to use or null for default charset

Returns:

the byte array content reader that transforms a publisher of byte buffers to a completion stage that might end exceptionally with a IllegalArgumentException in case of I/O error or a JsonException

reader

public Reader<JsonStructure> reader()

Returns a function (reader) converting Publisher of ByteBuffers to a JSON-P object.

It is intended for derivation of others, more specific readers.

Returns:

the byte array content reader that transforms a publisher of byte buffers to a completion stage that might end exceptionally with a IllegalArgumentException in case of I/O error or a JsonException

writer

public Function<JsonStructure,Flow.Publisher<DataChunk>> writer(Charset charset)

Returns a function (writer) converting JsonStructure to the Publisher of DataChunks.

Parameters:

charset - a charset to use or null for default charset

Returns:

created function

writer

public Function<JsonStructure,Flow.Publisher<DataChunk>> writer()

Returns a function (writer) converting JsonStructure to the Publisher of DataChunks.

Returns:

created function

create

public static JsonSupport create()

Returns a singleton instance of JsonSupport with default configuration.

Use create(io.helidon.media.jsonp.common.JsonProcessing) method to create a new instance with specific configuration.

Returns:

a singleton instance with default configuration

create

public static JsonSupport create(JsonProcessing processing)

Create a JsonSupport with customized processing configuration.

Parameters:

processing - processing to get JSON-P readers and writers

Returns:

json support to register with web server

See Also:

JsonProcessing.builder()