com.yahoo.jdisc.test

Class ServerProviderConformanceTest.TestRequestHandler

java.lang.Object

com.yahoo.jdisc.AbstractResource

com.yahoo.jdisc.handler.AbstractRequestHandler

com.yahoo.jdisc.test.ServerProviderConformanceTest.TestRequestHandler

All Implemented Interfaces:

RequestHandler, SharedResource

Enclosing class:

ServerProviderConformanceTest

private abstract static class ServerProviderConformanceTest.TestRequestHandler
extends AbstractRequestHandler

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	ServerProviderConformanceTest.TestRequestHandler.TaskHandle

Field Summary

Fields

Modifier and Type	Field and Description
private ExecutorService	executor
private Set<ServerProviderConformanceTest.TestRequestHandler.TaskHandle>	pendingTasks
protected ServerProviderConformanceTest.Event	responseClosed
private Iterable<ByteBuffer>	responseContent
protected ServerProviderConformanceTest.Event	responseWritten
private Exception	taskException
private Object	taskMonitor

Fields inherited from interface com.yahoo.jdisc.SharedResource

DEBUG, SYSTEM_PROPERTY_NAME_DEBUG

Constructor Summary

Constructors

Modifier	Constructor and Description
private	TestRequestHandler()

Method Summary

Modifier and Type	Method and Description
private ServerProviderConformanceTest.TestRequestHandler.TaskHandle	addTask()
void	awaitAsyncTasks()
protected void	callInOtherThread(Callable<Void> task)
protected void	closeResponse(ContentChannel out)
protected void	closeResponseInOtherThread(ContentChannel out)
protected void	completeInOtherThread(CompletionHandler handler, Class<?>... allowedExceptionTypes)
protected void	fail(CompletionHandler handler, Throwable failure, Class<?>... allowedExceptionTypes)
protected void	failInOtherThread(CompletionHandler handler, Throwable failure, Class<?>... allowedExceptionTypes)
protected abstract ContentChannel	handle(Request request, ResponseHandler responseHandler)
ContentChannel	handleRequest(Request request, ResponseHandler responseHandler) This method will process the given Request and return a ContentChannel into which the caller can write the Request's content.
private static boolean	isInstanceOfAnyOf(Object object, Class<?>... types)
protected CompletionHandler	newCompletionHandler()
private void	removeTask(ServerProviderConformanceTest.TestRequestHandler.TaskHandle taskHandle)
void	reset(Iterable<ByteBuffer> responseContent)
protected void	respondNoContent(ResponseHandler handler)
protected void	respondNoContentInOtherThread(ResponseHandler handler)
protected void	respondWithContent(ResponseHandler handler)
protected void	respondWithContentInOtherThread(ResponseHandler handler)
private void	setTaskFailure(Exception e)
private void	writeAll(ContentChannel out, Iterable<ByteBuffer> content)
protected void	writeResponse(ContentChannel out)

Methods inherited from class com.yahoo.jdisc.handler.AbstractRequestHandler

handleTimeout

Methods inherited from class com.yahoo.jdisc.AbstractResource

currentState, destroy, refer, release, retainCount

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.yahoo.jdisc.SharedResource

refer, release

Field Detail

responseWritten

protected ServerProviderConformanceTest.Event responseWritten

responseClosed

protected ServerProviderConformanceTest.Event responseClosed

executor

private ExecutorService executor

taskMonitor

private final Object taskMonitor

pendingTasks

private Set<ServerProviderConformanceTest.TestRequestHandler.TaskHandle> pendingTasks

taskException

private Exception taskException

responseContent

private Iterable<ByteBuffer> responseContent

Constructor Detail

TestRequestHandler

private TestRequestHandler()

Method Detail

reset

public void reset(Iterable<ByteBuffer> responseContent)

callInOtherThread

protected final void callInOtherThread(Callable<Void> task)

setTaskFailure

private void setTaskFailure(Exception e)

removeTask

private void removeTask(ServerProviderConformanceTest.TestRequestHandler.TaskHandle taskHandle)

addTask

@CheckReturnValue
private ServerProviderConformanceTest.TestRequestHandler.TaskHandle addTask()

writeResponse

protected final void writeResponse(ContentChannel out)

writeAll

private void writeAll(ContentChannel out,
                      Iterable<ByteBuffer> content)

closeResponseInOtherThread

protected final void closeResponseInOtherThread(ContentChannel out)

closeResponse

protected final void closeResponse(ContentChannel out)

newCompletionHandler

protected final CompletionHandler newCompletionHandler()

respondWithContentInOtherThread

protected final void respondWithContentInOtherThread(ResponseHandler handler)

respondNoContentInOtherThread

protected final void respondNoContentInOtherThread(ResponseHandler handler)

respondWithContent

protected void respondWithContent(ResponseHandler handler)

respondNoContent

protected void respondNoContent(ResponseHandler handler)

completeInOtherThread

protected final void completeInOtherThread(CompletionHandler handler,
                                           Class<?>... allowedExceptionTypes)

fail

protected final void fail(CompletionHandler handler,
                          Throwable failure,
                          Class<?>... allowedExceptionTypes)

isInstanceOfAnyOf

private static boolean isInstanceOfAnyOf(Object object,
                                         Class<?>... types)

failInOtherThread

protected final void failInOtherThread(CompletionHandler handler,
                                       Throwable failure,
                                       Class<?>... allowedExceptionTypes)

handleRequest

public final ContentChannel handleRequest(Request request,
                                          ResponseHandler responseHandler)

Description copied from interface: RequestHandler

This method will process the given Request and return a ContentChannel into which the caller can write the Request's content. For every call to this method, the implementation must call the provided ResponseHandler exactly once.

Notice that unless this method throws an Exception, a reference to the currently active Container instance is kept internally until ResponseHandler.handleResponse(Response) has been called. This ensures that the configured environment of the Request is stable throughout its lifetime. Failure to call back with a Response will prevent the release of that reference, and therefore prevent the corresponding Container from ever shutting down. The requirement to call ResponseHandler.handleResponse(Response) is regardless of any subsequent errors that may occur while working with the returned ContentChannel.

Parameters:

request - The Request to handle.

responseHandler - The handler to pass the corresponding Response to.

Returns:

The ContentChannel to write the Request content to. Notice that the ContentChannel itself also holds a Container reference, so failure to close this will prevent the Container from ever shutting down.

handle

protected abstract ContentChannel handle(Request request,
                                         ResponseHandler responseHandler)

awaitAsyncTasks

public final void awaitAsyncTasks()
                           throws Exception

Throws:

Exception