io.servicetalk.http.router.jersey

Class HttpJerseyRouterBuilder

java.lang.Object

io.servicetalk.http.router.jersey.HttpJerseyRouterBuilder

public final class HttpJerseyRouterBuilder
extends java.lang.Object

Builds an StreamingHttpService which routes requests to JAX-RS annotated classes, using Jersey as the routing engine, eg.

 final StreamingHttpService router = new HttpJerseyRouterBuilder()
     .buildStreaming(application);
 

Constructor Summary

Constructors

Constructor and Description
HttpJerseyRouterBuilder()

Method Summary

Modifier and Type	Method and Description
HttpJerseyRouterBuilder	baseUriFunction(java.util.function.BiFunction<ConnectionContext,HttpRequestMetaData,java.lang.String> baseUriFunction) Set the function used to compute the base URI for the incoming HTTP request.
HttpService	build(javax.ws.rs.core.Application application) Build the HttpService for the specified JAX-RS Application.
HttpService	build(java.lang.Class<? extends javax.ws.rs.core.Application> applicationClass) Build the HttpService for the specified JAX-RS Application class.
BlockingHttpService	buildBlocking(javax.ws.rs.core.Application application) Build the BlockingHttpService for the specified JAX-RS Application.
BlockingHttpService	buildBlocking(java.lang.Class<? extends javax.ws.rs.core.Application> applicationClass) Build the BlockingHttpService for the specified JAX-RS Application class.
BlockingStreamingHttpService	buildBlockingStreaming(javax.ws.rs.core.Application application) Build the BlockingStreamingHttpService for the specified JAX-RS Application.
BlockingStreamingHttpService	buildBlockingStreaming(java.lang.Class<? extends javax.ws.rs.core.Application> applicationClass) Build the BlockingStreamingHttpService for the specified JAX-RS Application class.
StreamingHttpService	buildStreaming(javax.ws.rs.core.Application application) Build the StreamingHttpService for the specified JAX-RS Application.
StreamingHttpService	buildStreaming(java.lang.Class<? extends javax.ws.rs.core.Application> applicationClass) Build the StreamingHttpService for the specified JAX-RS Application class.
HttpJerseyRouterBuilder	publisherInputStreamQueueCapacity(int publisherInputStreamQueueCapacity) Set the hint for the capacity of the intermediary queue that stores items when adapting Publishers into InputStreams.
HttpJerseyRouterBuilder	routeExecutionStrategyFactory(RouteExecutionStrategyFactory<HttpExecutionStrategy> strategyFactory) Set a RouteExecutionStrategyFactory<HttpExecutionStrategy> for creating HttpExecutionStrategy instances that can be used for offloading the handling of request to resource methods, as specified via RouteExecutionStrategy annotations.

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpJerseyRouterBuilder

public HttpJerseyRouterBuilder()

Method Detail

publisherInputStreamQueueCapacity

public HttpJerseyRouterBuilder publisherInputStreamQueueCapacity(int publisherInputStreamQueueCapacity)

Set the hint for the capacity of the intermediary queue that stores items when adapting Publishers into InputStreams.

Parameters:

publisherInputStreamQueueCapacity - the capacity hint.

Returns:

this

baseUriFunction

public HttpJerseyRouterBuilder baseUriFunction(java.util.function.BiFunction<ConnectionContext,HttpRequestMetaData,java.lang.String> baseUriFunction)

Set the function used to compute the base URI for the incoming HTTP request. The computed base URI must have / as path, and no query nor fragment.

Parameters:

baseUriFunction - a BiFunction that computes a base URI String for the provided ConnectionContext and HttpRequestMetaData.

Returns:

this

See Also:

URI Syntax Components

routeExecutionStrategyFactory

public HttpJerseyRouterBuilder routeExecutionStrategyFactory(RouteExecutionStrategyFactory<HttpExecutionStrategy> strategyFactory)

Set a RouteExecutionStrategyFactory<HttpExecutionStrategy> for creating HttpExecutionStrategy instances that can be used for offloading the handling of request to resource methods, as specified via RouteExecutionStrategy annotations.

Parameters:

strategyFactory - a RouteExecutionStrategyFactory<HttpExecutionStrategy>

Returns:

this

See Also:

RouteExecutionStrategy

build

public HttpService build(javax.ws.rs.core.Application application)

Build the HttpService for the specified JAX-RS Application.

Parameters:

application - the Application to route requests to.

Returns:

the HttpService.

build

public HttpService build(java.lang.Class<? extends javax.ws.rs.core.Application> applicationClass)

Build the HttpService for the specified JAX-RS Application class.

Parameters:

applicationClass - the Application class to instantiate and route requests to.

Returns:

the HttpService.

buildStreaming

public StreamingHttpService buildStreaming(javax.ws.rs.core.Application application)

Build the StreamingHttpService for the specified JAX-RS Application.

Parameters:

application - the Application to route requests to.

Returns:

the StreamingHttpService.

buildStreaming

public StreamingHttpService buildStreaming(java.lang.Class<? extends javax.ws.rs.core.Application> applicationClass)

Build the StreamingHttpService for the specified JAX-RS Application class.

Parameters:

applicationClass - the Application class to instantiate and route requests to.

Returns:

the StreamingHttpService.

buildBlocking

public BlockingHttpService buildBlocking(javax.ws.rs.core.Application application)

Build the BlockingHttpService for the specified JAX-RS Application.

Parameters:

application - the Application to route requests to.

Returns:

the BlockingHttpService.

buildBlocking

public BlockingHttpService buildBlocking(java.lang.Class<? extends javax.ws.rs.core.Application> applicationClass)

Build the BlockingHttpService for the specified JAX-RS Application class.

Parameters:

applicationClass - the Application class to instantiate and route requests to.

Returns:

the BlockingHttpService.

buildBlockingStreaming

public BlockingStreamingHttpService buildBlockingStreaming(javax.ws.rs.core.Application application)

Build the BlockingStreamingHttpService for the specified JAX-RS Application.

Parameters:

application - the Application to route requests to.

Returns:

the BlockingStreamingHttpService.

buildBlockingStreaming

public BlockingStreamingHttpService buildBlockingStreaming(java.lang.Class<? extends javax.ws.rs.core.Application> applicationClass)

Build the BlockingStreamingHttpService for the specified JAX-RS Application class.

Parameters:

applicationClass - the Application class to instantiate and route requests to.

Returns:

the BlockingStreamingHttpService.