org.glassfish.jersey.process.internal
Class ExecutorsFactory<REQUEST>

java.lang.Object
  org.glassfish.jersey.process.internal.ExecutorsFactory<REQUEST>

Type Parameters:

REQUEST - request data type.

@Singleton
public abstract class ExecutorsFactory<REQUEST>
extends java.lang.Object

Aggregate request executors provider and response executors provider used directly in the request invoker to get the pluggable processing executor services.

Author:

Marek Potociar (marek.potociar at oracle.com), Miroslav Fuksa (miroslav.fuksa at oracle.com)

Constructor Summary

ExecutorsFactory(ServiceLocator locator)
Creates new instance.

Method Summary

protected java.util.concurrent.ExecutorService	getInitialRequestingExecutor(RequestExecutorsProvider defaultProvider) Convenience method for implementation classes which returns the requesting executor and logs the details into the log.
protected java.util.concurrent.ExecutorService	getInitialRespondingExecutor(ResponseExecutorsProvider defaultProvider) Convenience method for implementation classes which returns the responding executor and logs the details into the log.
abstract java.util.concurrent.ExecutorService	getRequestingExecutor(REQUEST request) Returns request executor for the given Request.
abstract java.util.concurrent.ExecutorService	getRespondingExecutor(REQUEST request) Returns response executor for the given Request.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExecutorsFactory

public ExecutorsFactory(ServiceLocator locator)

Creates new instance.

Parameters:

locator - Injected HK2 locator.

Method Detail

getInitialRequestingExecutor

protected java.util.concurrent.ExecutorService getInitialRequestingExecutor(RequestExecutorsProvider defaultProvider)

Convenience method for implementation classes which returns the requesting executor and logs the details into the log. If there is any custom registered request executor provider its executor will be returned. Otherwise executor of the defaultProvider is returned. The result is logged.

Parameters:

defaultProvider - Default provider which must return not-null executor. This provider will be used if no custom request executor provider is found.

Returns:

Requesting executor.

getInitialRespondingExecutor

protected java.util.concurrent.ExecutorService getInitialRespondingExecutor(ResponseExecutorsProvider defaultProvider)

Convenience method for implementation classes which returns the responding executor and logs the details into the log. If there is any custom registered response executor provider its executor will be returned. Otherwise executor of the defaultProvider is returned. The result is logged.

Parameters:

defaultProvider - Default provider which must return not-null executor. This provider will be used if no custom response executor provider is found.

Returns:

Responding executor.

getRequestingExecutor

public abstract java.util.concurrent.ExecutorService getRequestingExecutor(REQUEST request)

Returns request executor for the given Request. The implementation of the method could return different executor based on the given request data, for example return different executor for asynchronous processing than for synchronous processing.

Parameters:

request - Request object.

Returns:

Request executor which will be used for request processing of the given response.

getRespondingExecutor

public abstract java.util.concurrent.ExecutorService getRespondingExecutor(REQUEST request)

Returns response executor for the given Request. The implementation of the method could return different executor based on the given request data, for example return different executor for asynchronous processing than for synchronous processing.

Parameters:

request - Request object.

Returns:

Response executor which will be used for request processing of the given response.