org.glassfish.jersey.process.internal
Class ResponseProcessor<DATA>

java.lang.Object
  com.google.common.util.concurrent.AbstractFuture<DATA>
      org.glassfish.jersey.process.internal.ResponseProcessor<DATA>

Type Parameters:

DATA - processed data type.

All Implemented Interfaces:

com.google.common.util.concurrent.ListenableFuture<DATA>, java.lang.Runnable, java.util.concurrent.Future<DATA>

public abstract class ResponseProcessor<DATA>
extends com.google.common.util.concurrent.AbstractFuture<DATA>
implements java.lang.Runnable

Processes result of the request transformation (successful or not). The response processor also represents the ultimate future request-to-response transformation result.

A response processor is invoked when the request-to-response transformation processing is finished. When invoked, the response processor retrieves the transformation result. If the transformation was successful and a response instance is returned, the response processor runs the response instance through the chain of registered response filters and returns a result once finished. In case the request transformation finished with an exception, the response processor tries to map the exception to a response using the registered exception mappers and, if successful, runs the mapped response instance through the chain of registered response filters and returns a result once finished. In case the exception was not mapped to a response, the exception is presented as the ultimate request-to-response transformation result.

Author:

Marek Potociar (marek.potociar at oracle.com)

Nested Class Summary

static interface	ResponseProcessor.Builder<DATA> Response processor factory.
static interface	ResponseProcessor.RespondingContext<DATA> Injectable context that can be used during the data processing for registering response processing functions that will be invoked during the response processing.
static class	ResponseProcessor.ResponseBuilder Response processor builder for JAX-RS response data type.

Method Summary

protected abstract DATA	convertResponse(Response exceptionResponse) Convert an exception-mapped JAX-RS response to supported processing data type.
void	run()

Methods inherited from class com.google.common.util.concurrent.AbstractFuture

addListener, cancel, get, get, interruptTask, isCancelled, isDone, set, setException

Methods inherited from class java.lang.Object

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

Method Detail

run

public void run()

Specified by:

run in interface java.lang.Runnable

convertResponse

protected abstract DATA convertResponse(Response exceptionResponse)

Convert an exception-mapped JAX-RS response to supported processing data type.

Parameters:

exceptionResponse - a processing exception mapped to a JAX-RS response.

Returns:

JAX-RS exception-mapped response transformed to supported processing data type.