Package org.glassfish.jersey.server.model

Class Invocable

java.lang.Object

org.glassfish.jersey.server.model.Invocable

All Implemented Interfaces:

Parameterized, ResourceModelComponent

public final class Invocable
extends java.lang.Object
implements Parameterized, ResourceModelComponent

A common interface for invocable resource components. This includes resource methods, sub-resource methods and sub-resource locators bound to a concrete handler class and a Java method (either directly or indirectly) declared & implemented by the handler class.

Invocable component information is used at runtime by a Java method dispatcher when processing requests.

Class defines two kinds of java methods: definition method and handling method. Definition method is the java Method that is defined by the user to be executed. This can be java Method of the class but also method of the interface. If it is the method of the interface (method handler class is the class but method itself is from the interface) then the definition method is the method from the inherited class. In other words, the handling method is the concrete method but definition method can be its parent abstract definition. However, in most cases these methods are the same.

See Also:

ResourceMethod, ResourceMethodDispatcher

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static java.lang.reflect.Method	APPLY_INFLECTOR_METHOD	Method instance representing the Inflector.apply(Object) method.
private java.lang.reflect.Method	definitionMethod
private MethodHandler	handler
private java.lang.reflect.Method	handlingMethod
private java.util.List<Parameter>	parameters
private java.lang.Class<?>	rawResponseType
private java.lang.Class<?>	rawRoutingResponseType
private java.lang.reflect.Type	responseType
private java.lang.reflect.Type	routingResponseType

Constructor Summary

Constructors

Modifier	Constructor	Description
private	Invocable(MethodHandler handler, java.lang.reflect.Method definitionMethod, java.lang.reflect.Method handlingMethod, boolean encodedParameters, java.lang.reflect.Type routingResponseType)

Method Summary

Modifier and Type	Method	Description
void	accept(ResourceModelVisitor visitor)	A component should call the visitor back with an appropriate visitor interface method to give it a chance to process.
static Invocable	create(java.lang.Class<? extends Inflector> inflectorClass)	Create a new resource method invocable model backed by an inflector class.
static <T> Invocable	create(Inflector<javax.ws.rs.core.Request,T> inflector)	Create a new resource method invocable model backed by an inflector instance.
static Invocable	create(MethodHandler handler, java.lang.reflect.Method handlingMethod)	Create a new resource method invocable model.
static Invocable	create(MethodHandler handler, java.lang.reflect.Method definitionMethod, boolean encodedParameters)	Create a new resource method invocable model.
static Invocable	create(MethodHandler handler, java.lang.reflect.Method definitionMethod, java.lang.reflect.Method handlingMethod, boolean encodedParameters)	Create a new resource method invocable model.
static Invocable	create(MethodHandler handler, java.lang.reflect.Method definitionMethod, java.lang.reflect.Method handlingMethod, boolean encodedParameters, java.lang.reflect.Type routingResponseType)	Create a new resource method invocable model.
java.util.List<? extends ResourceModelComponent>	getComponents()	Should return all existing resource model sub-components.
java.lang.reflect.Method	getDefinitionMethod()	Getter for the Java method that should be executed.
MethodHandler	getHandler()	Get the model of the resource method handler that will be used to invoke the handling resource method on.
java.lang.reflect.Method	getHandlingMethod()	Getter for the Java method
java.util.List<Parameter>	getParameters()	Provides access to all parameters associated with given Parameterized instance.
java.lang.Class<?>	getRawResponseType()	Get the resource method raw response type.
java.lang.Class<?>	getRawRoutingResponseType()	Get the response Class of the handlingMethod that will be used during the routing for the purpose of selection of the resource method.
java.lang.reflect.Type	getResponseType()	Get the resource method generic response type information.
java.lang.reflect.Type	getRoutingResponseType()	Get the response type of the handlingMethod that will be used during the routing for the purpose of selection of the resource method.
private static java.lang.reflect.Method	initApplyMethod()
boolean	isInflector()	Check if the invocable represents an inflector processing method.
boolean	requiresEntity()	Provides information on presence of an entity parameter.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

APPLY_INFLECTOR_METHOD

static final java.lang.reflect.Method APPLY_INFLECTOR_METHOD

Method instance representing the Inflector.apply(Object) method.

handler

private final MethodHandler handler

definitionMethod

private final java.lang.reflect.Method definitionMethod

handlingMethod

private final java.lang.reflect.Method handlingMethod

parameters

private final java.util.List<Parameter> parameters

rawResponseType

private final java.lang.Class<?> rawResponseType

responseType

private final java.lang.reflect.Type responseType

routingResponseType

private final java.lang.reflect.Type routingResponseType

rawRoutingResponseType

private final java.lang.Class<?> rawRoutingResponseType

Constructor Detail

Invocable

private Invocable(MethodHandler handler,
                  java.lang.reflect.Method definitionMethod,
                  java.lang.reflect.Method handlingMethod,
                  boolean encodedParameters,
                  java.lang.reflect.Type routingResponseType)

Method Detail

initApplyMethod

private static java.lang.reflect.Method initApplyMethod()

create

public static <T> Invocable create(Inflector<javax.ws.rs.core.Request,T> inflector)

Create a new resource method invocable model backed by an inflector instance.

Parameters:

inflector - inflector processing the request method.

Returns:

Invocable.

create

public static Invocable create(java.lang.Class<? extends Inflector> inflectorClass)

Create a new resource method invocable model backed by an inflector class.

Parameters:

inflectorClass - inflector syb-type processing the request method.

Returns:

Invocable.

create

public static Invocable create(MethodHandler handler,
                               java.lang.reflect.Method handlingMethod)

Create a new resource method invocable model. Parameter values will be automatically decoded.

Parameters:

handler - resource method handler.

handlingMethod - handling Java method.

Returns:

Invocable.

create

public static Invocable create(MethodHandler handler,
                               java.lang.reflect.Method definitionMethod,
                               boolean encodedParameters)

Create a new resource method invocable model.

Parameters:

handler - resource method handler.

definitionMethod - method that is defined to be executed on the handler.

encodedParameters - true if the automatic parameter decoding should be disabled, false otherwise.

Returns:

Invocable

create

public static Invocable create(MethodHandler handler,
                               java.lang.reflect.Method definitionMethod,
                               java.lang.reflect.Method handlingMethod,
                               boolean encodedParameters)

Create a new resource method invocable model.

Parameters:

handler - resource method handler.

definitionMethod - method that is defined to be executed on the handler.

handlingMethod - specific and concrete method to be actually executed as a resource method. If null then the definitionMethod will be used.

encodedParameters - true if the automatic parameter decoding should be disabled, false otherwise.

Returns:

Invocable.

create

public static Invocable create(MethodHandler handler,
                               java.lang.reflect.Method definitionMethod,
                               java.lang.reflect.Method handlingMethod,
                               boolean encodedParameters,
                               java.lang.reflect.Type routingResponseType)

Create a new resource method invocable model.

Parameters:

handler - resource method handler.

definitionMethod - method that is defined to be executed on the handler.

handlingMethod - specific and concrete method to be actually executed as a resource method. If null then the definitionMethod will be used.

encodedParameters - true if the automatic parameter decoding should be disabled, false otherwise.

routingResponseType - response type that will be used during the routing for purpose of selection of the resource method to be executed. If this parameter is non-null then it will override the return type of the the Java handling method) for purposes of resource method selection. This might be useful in cases when resource method returns a type A but thanks to registered providers (eg. WriterInterceptor) it will be always converted to type B. Then the method selecting algorithm would check presence of MessageBodyWriter for type A (which will never be actually needed) and might result in choosing undesired method. If the parameter is null then the default response type will be used.

Returns:

Invocable.

getHandler

public MethodHandler getHandler()

Get the model of the resource method handler that will be used to invoke the handling resource method on.

Returns:

resource method handler model.

getHandlingMethod

public java.lang.reflect.Method getHandlingMethod()

Getter for the Java method

Returns:

corresponding Java method

getDefinitionMethod

public java.lang.reflect.Method getDefinitionMethod()

Getter for the Java method that should be executed.

Returns:

corresponding Java method.

getResponseType

public java.lang.reflect.Type getResponseType()

Get the resource method generic response type information.

The returned value provides the Type information that contains additional generic declaration information for generic Java class types.

Returns:

resource method generic response type information.

getRawResponseType

public java.lang.Class<?> getRawResponseType()

Get the resource method raw response type.

The returned value provides information about the raw Java class.

Returns:

resource method raw response type information.

isInflector

public boolean isInflector()

Check if the invocable represents an inflector processing method.

Returns:

true, if this invocable represents an inflector invocation, false otherwise.

requiresEntity

public boolean requiresEntity()

Description copied from interface: Parameterized

Provides information on presence of an entity parameter.

Specified by:

requiresEntity in interface Parameterized

Returns:

true if entity parameter is present, false otherwise

getParameters

public java.util.List<Parameter> getParameters()

Description copied from interface: Parameterized

Provides access to all parameters associated with given Parameterized instance.

Specified by:

getParameters in interface Parameterized

Returns:

list of actual parameters

accept

public void accept(ResourceModelVisitor visitor)

Description copied from interface: ResourceModelComponent

A component should call the visitor back with an appropriate visitor interface method to give it a chance to process.

Specified by:

accept in interface ResourceModelComponent

Parameters:

visitor - resource model visitor.

getComponents

public java.util.List<? extends ResourceModelComponent> getComponents()

Description copied from interface: ResourceModelComponent

Should return all existing resource model sub-components.

Specified by:

getComponents in interface ResourceModelComponent

Returns:

list of all sub-components

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getRoutingResponseType

public java.lang.reflect.Type getRoutingResponseType()

Get the response type of the handlingMethod that will be used during the routing for the purpose of selection of the resource method. Returned value is in most cases equal to the response type. If returned value is different then it overrides the response type for purposes of resource method selection and will be used to look for available message body writers.

Returns:

Response type used for the routing.

getRawRoutingResponseType

public java.lang.Class<?> getRawRoutingResponseType()

Get the response Class of the handlingMethod that will be used during the routing for the purpose of selection of the resource method. Returned value is in most cases equal to the response type. If returned value is different then it overrides the response type for purposes of resource method selection and will be used to look for available message body writers.

Returns:

Response type used for the routing.