org.glassfish.jersey.message.internal
Class ReaderInterceptorExecutor

java.lang.Object
  org.glassfish.jersey.message.internal.ReaderInterceptorExecutor

All Implemented Interfaces:

InterceptorContext, ReaderInterceptorContext

public final class ReaderInterceptorExecutor
extends java.lang.Object
implements ReaderInterceptorContext

Represents reader interceptor chain executor for both client and server side. It constructs wrapped interceptor chain and invokes it. At the end of the chain a message body reader execution interceptor is inserted, which finally reads an entity from the output stream provided by the chain.

Author:

Miroslav Fuksa (miroslav.fuksa at oracle.com), Jakub Podlesak (jakub.podlesak at oracle.com)

Field Summary

static java.lang.String

INTERCEPTORS Defines property, which is used to pass a list of reader interceptors to the executor via PropertiesDelegate.

Constructor Summary

ReaderInterceptorExecutor(java.lang.Class<?> rawType, java.lang.reflect.Type type, java.lang.annotation.Annotation[] annotations, MediaType mediaType, MultivaluedMap<java.lang.String,java.lang.String> headers, PropertiesDelegate propertiesDelegate, java.io.InputStream inputStream, MessageBodyWorkers workers, boolean intercept)
Constructs a new executor to read given type from provided entityStream.

Method Summary

java.lang.annotation.Annotation[]	getAnnotations() Get an array of the annotations formally declared on the artifact that initiated the intercepted entity provider invocation.
java.lang.reflect.Type	getGenericType() Get the type of the object to be produced or written.
MultivaluedMap<java.lang.String,java.lang.String>	getHeaders() Get mutable map of HTTP headers.
java.io.InputStream	getInputStream() Get the input stream of the object to be read.
MediaType	getMediaType() Get media type of HTTP entity.
ReaderInterceptor	getNextInterceptor() Returns next interceptor in the chain.
java.lang.Object	getProperty(java.lang.String name) Returns the property with the given name registered in the current request/response exchange context, or null if there is no property by that name.
java.util.Collection<java.lang.String>	getPropertyNames() Returns an immutable collection containing the property names available within the context of the current request/response exchange context.
java.lang.Class	getType() Get Java type supported by corresponding message body provider.
java.lang.Object	proceed() Starts the interceptor chain execution.
void	removeProperty(java.lang.String name) Removes a property with the given name from the current request/response exchange context.
void	setAnnotations(java.lang.annotation.Annotation[] annotations) Update annotations on the formal declaration of the artifact that initiated the intercepted entity provider invocation.
void	setGenericType(java.lang.reflect.Type genericType) Update type of the object to be produced or written.
void	setInputStream(java.io.InputStream is) Update the input stream of the object to be read.
void	setMediaType(MediaType mediaType) Update media type of HTTP entity.
void	setProperty(java.lang.String name, java.lang.Object object) Binds an object to a given property name in the current request/response exchange context.
void	setType(java.lang.Class type) Update Java type before calling message body provider.

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.ws.rs.ext.InterceptorContext

getAnnotations, getGenericType, getMediaType, getProperty, getPropertyNames, getType, removeProperty, setAnnotations, setGenericType, setMediaType, setProperty, setType

Field Detail

INTERCEPTORS

public static final java.lang.String INTERCEPTORS

Defines property, which is used to pass a list of reader interceptors to the executor via PropertiesDelegate.

See Also:

Constant Field Values

Constructor Detail

ReaderInterceptorExecutor

public ReaderInterceptorExecutor(java.lang.Class<?> rawType,
                                 java.lang.reflect.Type type,
                                 java.lang.annotation.Annotation[] annotations,
                                 MediaType mediaType,
                                 MultivaluedMap<java.lang.String,java.lang.String> headers,
                                 PropertiesDelegate propertiesDelegate,
                                 java.io.InputStream inputStream,
                                 MessageBodyWorkers workers,
                                 boolean intercept)

Constructs a new executor to read given type from provided entityStream. List of interceptors to be used is taken from given workers instance unless "jersey.runtime.reader.interceptors" property is set in propertiesDelegate. If such a property is present, the executor tries to cast it to List<ReaderInterceptor> and the list is then used to build the interceptor chain.

Parameters:

rawType - raw Java entity type.

type - generic Java entity type.

annotations - array of annotations on the declaration of the artifact that will be initialized with the produced instance. E.g. if the message body is to be converted into a method parameter, this will be the annotations on that parameter returned by Method.getParameterAnnotations.

mediaType - media type of the HTTP entity.

headers - mutable message headers.

propertiesDelegate - request-scoped properties delegate.

inputStream - entity input stream.

workers - Message body workers.

intercept - if set to true, user interceptors will be executed. Otherwise only exception wrapping interceptor will be executed on the client side.

Method Detail

getNextInterceptor

public ReaderInterceptor getNextInterceptor()

Returns next interceptor in the chain. Stateful method.

Returns:

Next interceptor.

proceed

public java.lang.Object proceed()
                         throws java.io.IOException

Starts the interceptor chain execution.

Specified by:

proceed in interface ReaderInterceptorContext

Returns:

an entity read from the stream.

Throws:

java.io.IOException - if an IO error arises or is thrown by the wrapped MessageBodyReader.readFrom method.

getInputStream

public java.io.InputStream getInputStream()

Description copied from interface: ReaderInterceptorContext

Get the input stream of the object to be read. The JAX-RS runtime is responsible for closing the input stream.

Specified by:

getInputStream in interface ReaderInterceptorContext

Returns:

input stream of the object to be read.

setInputStream

public void setInputStream(java.io.InputStream is)

Description copied from interface: ReaderInterceptorContext

Update the input stream of the object to be read. For example, by wrapping it with another input stream. The JAX-RS runtime is responsible for closing the input stream.

Specified by:

setInputStream in interface ReaderInterceptorContext

Parameters:

is - new input stream.

getHeaders

public MultivaluedMap<java.lang.String,java.lang.String> getHeaders()

Description copied from interface: ReaderInterceptorContext

Get mutable map of HTTP headers.

Note that while the headers are mutable, a reader interceptor should typically roll-back any header modifications once the call to context.proceed() returns, to avoid externally visible side-effects of the interceptor invocation.

Specified by:

getHeaders in interface ReaderInterceptorContext

Returns:

map of HTTP headers.

getProperty

public java.lang.Object getProperty(java.lang.String name)

Description copied from interface: InterceptorContext

Returns the property with the given name registered in the current request/response exchange context, or null if there is no property by that name.

A property allows a JAX-RS filters and interceptors to exchange additional custom information not already provided by this interface.

A list of supported properties can be retrieved using InterceptorContext.getPropertyNames(). Custom property names should follow the same convention as package names.

In a Servlet container, on the server side, the properties are backed by the ServletRequest and contain all the attributes available in the ServletRequest.

Specified by:

getProperty in interface InterceptorContext

Parameters:

name - a String specifying the name of the property.

Returns:

an Object containing the value of the property, or null if no property exists matching the given name.

See Also:

InterceptorContext.getPropertyNames()

getPropertyNames

public java.util.Collection<java.lang.String> getPropertyNames()

Description copied from interface: InterceptorContext

Returns an immutable collection containing the property names available within the context of the current request/response exchange context.

Use the InterceptorContext.getProperty(java.lang.String) method with a property name to get the value of a property.

In a Servlet container, the properties are synchronized with the ServletRequest and expose all the attributes available in the ServletRequest. Any modifications of the properties are also reflected in the set of properties of the associated ServletRequest.

Specified by:

getPropertyNames in interface InterceptorContext

Returns:

an immutable collection of property names.

See Also:

InterceptorContext.getProperty(java.lang.String)

setProperty

public void setProperty(java.lang.String name,
                        java.lang.Object object)

Description copied from interface: InterceptorContext

Binds an object to a given property name in the current request/response exchange context. If the name specified is already used for a property, this method will replace the value of the property with the new value.

A property allows a JAX-RS filters and interceptors to exchange additional custom information not already provided by this interface.

A list of supported properties can be retrieved using InterceptorContext.getPropertyNames(). Custom property names should follow the same convention as package names.

If a null value is passed, the effect is the same as calling the InterceptorContext.removeProperty(String) method.

In a Servlet container, on the server side, the properties are backed by the ServletRequest and contain all the attributes available in the ServletRequest.

Specified by:

setProperty in interface InterceptorContext

Parameters:

name - a String specifying the name of the property.

object - an Object representing the property to be bound.

removeProperty

public void removeProperty(java.lang.String name)

Description copied from interface: InterceptorContext

Removes a property with the given name from the current request/response exchange context. After removal, subsequent calls to InterceptorContext.getProperty(java.lang.String) to retrieve the property value will return null.

In a Servlet container, on the server side, the properties are backed by the ServletRequest and contain all the attributes available in the ServletRequest.

Specified by:

removeProperty in interface InterceptorContext

Parameters:

name - a String specifying the name of the property to be removed.

getAnnotations

public java.lang.annotation.Annotation[] getAnnotations()

Description copied from interface: InterceptorContext

Get an array of the annotations formally declared on the artifact that initiated the intercepted entity provider invocation. E.g. if the message body is to be converted into a method parameter, this will be the annotations on that parameter returned by Method.getParameterAnnotations(); if the server-side response entity instance is to be converted into an output stream, this will be the annotations on the matched resource method returned by Method.getAnnotations(). This method may return an empty array in case the interceptor is not invoked in a context of any particular resource method (e.g. as part of the client API), but will never return null.

Specified by:

getAnnotations in interface InterceptorContext

Returns:

annotations declared on the artifact that initiated the intercepted entity provider invocation.

setAnnotations

public void setAnnotations(java.lang.annotation.Annotation[] annotations)

Description copied from interface: InterceptorContext

Update annotations on the formal declaration of the artifact that initiated the intercepted entity provider invocation. Calling this method has no effect in the client API.

Specified by:

setAnnotations in interface InterceptorContext

Parameters:

annotations - updated annotations declarataion of the artifact that initiated the intercepted entity provider invocation. Must not be null.

getType

public java.lang.Class getType()

Description copied from interface: InterceptorContext

Get Java type supported by corresponding message body provider.

Specified by:

getType in interface InterceptorContext

Returns:

java type supported by provider

setType

public void setType(java.lang.Class type)

Description copied from interface: InterceptorContext

Update Java type before calling message body provider.

Specified by:

setType in interface InterceptorContext

Parameters:

type - java type for provider

getGenericType

public java.lang.reflect.Type getGenericType()

Description copied from interface: InterceptorContext

Get the type of the object to be produced or written.

Specified by:

getGenericType in interface InterceptorContext

Returns:

type of object produced or written

setGenericType

public void setGenericType(java.lang.reflect.Type genericType)

Description copied from interface: InterceptorContext

Update type of the object to be produced or written.

Specified by:

setGenericType in interface InterceptorContext

Parameters:

genericType - new type for object

getMediaType

public MediaType getMediaType()

Description copied from interface: InterceptorContext

Get media type of HTTP entity.

Specified by:

getMediaType in interface InterceptorContext

Returns:

media type of HTTP entity

setMediaType

public void setMediaType(MediaType mediaType)

Description copied from interface: InterceptorContext

Update media type of HTTP entity.

Specified by:

setMediaType in interface InterceptorContext

Parameters:

mediaType - new type for HTTP entity