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 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

Fields

Modifier and Type	Field and Description
static String	INTERCEPTORS Defines property, which is used to pass a list of reader interceptors to the executor via PropertiesDelegate.

Constructor Summary

Constructors

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

Method Summary

Methods

Modifier and Type	Method and Description
Annotation[]	getAnnotations()
Type	getGenericType()
MultivaluedMap<String,String>	getHeaders()
InputStream	getInputStream()
MediaType	getMediaType()
ReaderInterceptor	getNextInterceptor() Returns next interceptor in the chain.
Object	getProperty(String name)
Collection<String>	getPropertyNames()
Class	getType()
Object	proceed() Starts the interceptor chain execution.
void	removeProperty(String name)
void	setAnnotations(Annotation[] annotations)
void	setGenericType(Type genericType)
void	setInputStream(InputStream is)
void	setMediaType(MediaType mediaType)
void	setProperty(String name, Object object)
void	setType(Class type)

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 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(Class<?> rawType,
                         Type type,
                         Annotation[] annotations,
                         MediaType mediaType,
                         MultivaluedMap<String,String> headers,
                         PropertiesDelegate propertiesDelegate,
                         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 Object proceed()
               throws IOException

Starts the interceptor chain execution.

Specified by:

proceed in interface ReaderInterceptorContext

Returns:

an entity read from the stream.

Throws:

IOException

getInputStream

public InputStream getInputStream()

Specified by:

getInputStream in interface ReaderInterceptorContext

setInputStream

public void setInputStream(InputStream is)

Specified by:

setInputStream in interface ReaderInterceptorContext

getHeaders

public MultivaluedMap<String,String> getHeaders()

Specified by:

getHeaders in interface ReaderInterceptorContext

getProperty

public Object getProperty(String name)

Specified by:

getProperty in interface InterceptorContext

getPropertyNames

public Collection<String> getPropertyNames()

Specified by:

getPropertyNames in interface InterceptorContext

setProperty

public void setProperty(String name,
               Object object)

Specified by:

setProperty in interface InterceptorContext

removeProperty

public void removeProperty(String name)

Specified by:

removeProperty in interface InterceptorContext

getAnnotations

public Annotation[] getAnnotations()

Specified by:

getAnnotations in interface InterceptorContext

setAnnotations

public void setAnnotations(Annotation[] annotations)

Specified by:

setAnnotations in interface InterceptorContext

getType

public Class getType()

Specified by:

getType in interface InterceptorContext

setType

public void setType(Class type)

Specified by:

setType in interface InterceptorContext

getGenericType

public Type getGenericType()

Specified by:

getGenericType in interface InterceptorContext

setGenericType

public void setGenericType(Type genericType)

Specified by:

setGenericType in interface InterceptorContext

getMediaType

public MediaType getMediaType()

Specified by:

getMediaType in interface InterceptorContext

setMediaType

public void setMediaType(MediaType mediaType)

Specified by:

setMediaType in interface InterceptorContext