org.glassfish.jersey.server
Class ApplicationHandler

java.lang.Object
  org.glassfish.jersey.server.ApplicationHandler

public final class ApplicationHandler
extends Object

Jersey server-side application handler.

Container implementations use the ApplicationHandler API to process requests by invoking the handle(requestContext) method on a configured application handler instance.

Author:

Pavel Bucek (pavel.bucek at oracle.com), Jakub Podlesak (jakub.podlesak at oracle.com), Marek Potociar (marek.potociar at oracle.com)

See Also:

ResourceConfig, ContainerProvider

Constructor Summary

ApplicationHandler()
Create a new Jersey application handler using a default configuration.

ApplicationHandler(Application application)
Create a new Jersey server-side application handler configured by an instance of a JAX-RS Application sub-class.

ApplicationHandler(Class<? extends Application> jaxrsApplicationClass)
Create a new Jersey server-side application handler configured by a JAX-RS Application (sub-)class.

Method Summary

Future<ContainerResponse>	apply(ContainerRequest requestContext) Invokes a request and returns the response future.
Future<ContainerResponse>	apply(ContainerRequest requestContext, OutputStream outputStream) Invokes a request and returns the response future.
ResourceConfig	getConfiguration() Get the application configuration.
ServiceLocator	getServiceLocator() Returns ServiceLocator relevant to current application.
void	handle(ContainerRequest requestContext) The main request/response processing entry point for Jersey container implementations.
void	registerAdditionalBinders(Set<Binder> binders) Registers HK2 binders into the HK2 service register.

Methods inherited from class java.lang.Object

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

Constructor Detail

ApplicationHandler

public ApplicationHandler()

Create a new Jersey application handler using a default configuration.

ApplicationHandler

public ApplicationHandler(Class<? extends Application> jaxrsApplicationClass)

Create a new Jersey server-side application handler configured by a JAX-RS Application (sub-)class.

Parameters:

jaxrsApplicationClass - JAX-RS Application (sub-)class that will be instantiated and used to configure the new Jersey application handler.

ApplicationHandler

public ApplicationHandler(Application application)

Create a new Jersey server-side application handler configured by an instance of a JAX-RS Application sub-class.

Parameters:

application - an instance of a JAX-RS Application (sub-)class that will be used to configure the new Jersey application handler.

Method Detail

registerAdditionalBinders

public void registerAdditionalBinders(Set<Binder> binders)

Registers HK2 binders into the HK2 service register.

Parameters:

binders - binders to be registered.

apply

public Future<ContainerResponse> apply(ContainerRequest requestContext)

Invokes a request and returns the response future.

Parameters:

requestContext - request data.

Returns:

response future.

apply

public Future<ContainerResponse> apply(ContainerRequest requestContext,
                                       OutputStream outputStream)

Invokes a request and returns the response future.

Parameters:

requestContext - request data.

outputStream - response output stream.

Returns:

response future.

handle

public void handle(ContainerRequest requestContext)

The main request/response processing entry point for Jersey container implementations.

The method invokes the request processing of the provided container request context and uses the container response writer to suspend & resume the processing as well as write the response back to the container.

The the security context stored in the container request context is bound as an injectable instance in the scope of the processed request context. Also, any custom scope injections are initialized in the current request scope.

Parameters:

requestContext - container request context of the current request.

getServiceLocator

public ServiceLocator getServiceLocator()

Returns ServiceLocator relevant to current application.

Returns:

ServiceLocator instance.

getConfiguration

public ResourceConfig getConfiguration()

Get the application configuration.

Returns:

application configuration.