Package org.glassfish.jersey.server.model.internal

Class AbstractJavaResourceMethodDispatcher

java.lang.Object

org.glassfish.jersey.server.model.internal.AbstractJavaResourceMethodDispatcher

All Implemented Interfaces:

ResourceMethodDispatcher

Direct Known Subclasses:

JavaResourceMethodDispatcherProvider.AbstractMethodParamInvoker, VoidVoidDispatcherProvider.VoidToVoidDispatcher

abstract class AbstractJavaResourceMethodDispatcher
extends Object
implements ResourceMethodDispatcher

Abstract resource method dispatcher that provides skeleton implementation of dispatching requests to a particular Java method using supplied Java method invocation handler.

Nested Class Summary

Nested classes/interfaces inherited from interface org.glassfish.jersey.server.spi.internal.ResourceMethodDispatcher

ResourceMethodDispatcher.Provider

Field Summary

Fields

Modifier and Type	Field	Description
private final Method	method
private final InvocationHandler	methodHandler
private final Invocable	resourceMethod
private final ConfiguredValidator	validator

Constructor Summary

Constructors

Constructor	Description
AbstractJavaResourceMethodDispatcher(Invocable resourceMethod, InvocationHandler methodHandler, ConfiguredValidator validator)	Initialize common java resource method dispatcher structures.

Method Summary

Modifier and Type	Method	Description
final javax.ws.rs.core.Response	dispatch(Object resource, ContainerRequest request)	Reflectively dispatch a request to the underlying invocable resource method via the configured invocation handler using the provided resource class instance.
protected abstract javax.ws.rs.core.Response	doDispatch(Object resource, ContainerRequest request)	Dispatching functionality to be implemented by a concrete dispatcher implementation sub-class.
(package private) final Object	invoke(ContainerRequest containerRequest, Object resource, Object... args)	Use the underlying invocation handler to invoke the underlying Java method with the supplied input method argument values on a given resource instance.
private static RuntimeException	mapTargetToRuntimeEx(Throwable throwable)
String	toString()

Methods inherited from class java.lang.Object

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

Field Details

method

private final Method method

methodHandler

private final InvocationHandler methodHandler

resourceMethod

private final Invocable resourceMethod

validator

private final ConfiguredValidator validator

Constructor Details

AbstractJavaResourceMethodDispatcher

AbstractJavaResourceMethodDispatcher(Invocable resourceMethod,
 InvocationHandler methodHandler,
 ConfiguredValidator validator)

Initialize common java resource method dispatcher structures.

Parameters:

resourceMethod - invocable resource class Java method.

methodHandler - method invocation handler.

validator - input/output parameter validator.

Method Details

dispatch

public final javax.ws.rs.core.Response dispatch(Object resource,
 ContainerRequest request)
                                         throws javax.ws.rs.ProcessingException

Description copied from interface: ResourceMethodDispatcher

Reflectively dispatch a request to the underlying invocable resource method via the configured invocation handler using the provided resource class instance.

In summary, the main job of the dispatcher is to convert a request into an array of the Java method input parameters and subsequently convert the returned response of an arbitrary Java type to a JAX-RS response instance.

When the method is invoked, the dispatcher will extract the Java method information from the invocable resource method and use the information to retrieve the required input parameters from either the request instance or any other available run-time information. Once the set of input parameter values is computed, the underlying invocation handler instance is invoked to process (invoke) the Java resource method with the computed input parameter values. The returned response is subsequently converted into a JAX-RS Response type and returned from the dispatcher.

It is assumed that the supplied resource implements the invocable method. Dispatcher implementation should not need to do any additional checks in that respect.

Specified by:

dispatch in interface ResourceMethodDispatcher

Parameters:

resource - the resource class instance.

request - request to be dispatched.

Returns:

response for the dispatched request.

Throws:

javax.ws.rs.ProcessingException - (possibly mappable) container exception that will be handled by the Jersey server container.

doDispatch

protected abstract javax.ws.rs.core.Response doDispatch(Object resource,
 ContainerRequest request)
                                                 throws javax.ws.rs.ProcessingException

Dispatching functionality to be implemented by a concrete dispatcher implementation sub-class.

Parameters:

resource - resource class instance.

request - request to be dispatched.

Returns:

response for the dispatched request.

Throws:

javax.ws.rs.ProcessingException - in case of a processing error.

See Also:

• ResourceMethodDispatcher.dispatch(Object, org.glassfish.jersey.server.ContainerRequest)

invoke

final Object invoke(ContainerRequest containerRequest,
 Object resource,
 Object... args)
             throws javax.ws.rs.ProcessingException

Use the underlying invocation handler to invoke the underlying Java method with the supplied input method argument values on a given resource instance.

Parameters:

containerRequest - container request.

resource - resource class instance.

args - input argument values for the invoked Java method.

Returns:

invocation result.

Throws:

javax.ws.rs.ProcessingException - (possibly mappable) container exception in case the invocation failed.

mapTargetToRuntimeEx

private static RuntimeException mapTargetToRuntimeEx(Throwable throwable)

toString

public String toString()

Overrides:

toString in class Object