javax.servlet
Class AsyncEvent

java.lang.Object
  extended by javax.servlet.AsyncEvent

public class AsyncEvent
extends java.lang.Object

Event that gets fired when the asynchronous operation initiated on a ServletRequest (via a call to ServletRequest#startAsync or ServletRequest#startAsync(ServletRequest, ServletResponse)) has completed, timed out, or produced an error.

Since:
Servlet 3.0

Constructor Summary
AsyncEvent(AsyncContext context)
          Constructs an AsyncEvent from the given AsyncContext.
AsyncEvent(AsyncContext context, ServletRequest request, ServletResponse response)
          Constructs an AsyncEvent from the given AsyncContext, ServletRequest, and ServletResponse.
AsyncEvent(AsyncContext context, ServletRequest request, ServletResponse response, java.lang.Throwable throwable)
          Constructs an AsyncEvent from the given AsyncContext, ServletRequest, ServletResponse, and Throwable.
AsyncEvent(AsyncContext context, java.lang.Throwable throwable)
          Constructs an AsyncEvent from the given AsyncContext and Throwable.
 
Method Summary
 AsyncContext getAsyncContext()
          Gets the AsyncContext from this AsyncEvent.
 ServletRequest getSuppliedRequest()
          Gets the ServletRequest from this AsyncEvent.
 ServletResponse getSuppliedResponse()
          Gets the ServletResponse from this AsyncEvent.
 java.lang.Throwable getThrowable()
          Gets the Throwable from this AsyncEvent.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AsyncEvent

public AsyncEvent(AsyncContext context)
Constructs an AsyncEvent from the given AsyncContext.

Parameters:
context - the AsyncContex to be delivered with this AsyncEvent

AsyncEvent

public AsyncEvent(AsyncContext context,
                  ServletRequest request,
                  ServletResponse response)
Constructs an AsyncEvent from the given AsyncContext, ServletRequest, and ServletResponse.

Parameters:
context - the AsyncContex to be delivered with this AsyncEvent
request - the ServletRequest to be delivered with this AsyncEvent
response - the ServletResponse to be delivered with this AsyncEvent

AsyncEvent

public AsyncEvent(AsyncContext context,
                  java.lang.Throwable throwable)
Constructs an AsyncEvent from the given AsyncContext and Throwable.

Parameters:
context - the AsyncContex to be delivered with this AsyncEvent
throwable - the Throwable to be delivered with this AsyncEvent

AsyncEvent

public AsyncEvent(AsyncContext context,
                  ServletRequest request,
                  ServletResponse response,
                  java.lang.Throwable throwable)
Constructs an AsyncEvent from the given AsyncContext, ServletRequest, ServletResponse, and Throwable.

Parameters:
context - the AsyncContex to be delivered with this AsyncEvent
request - the ServletRequest to be delivered with this AsyncEvent
response - the ServletResponse to be delivered with this AsyncEvent
throwable - the Throwable to be delivered with this AsyncEvent
Method Detail

getAsyncContext

public AsyncContext getAsyncContext()
Gets the AsyncContext from this AsyncEvent.

Returns:
the AsyncContext that was used to initialize this AsyncEvent

getSuppliedRequest

public ServletRequest getSuppliedRequest()
Gets the ServletRequest from this AsyncEvent.

If the AsyncListener to which this AsyncEvent is being delivered was added using AsyncContext#addListener(AsyncListener, ServletRequest, ServletResponse), the returned ServletRequest will be the same as the one supplied to the above method. If the AsyncListener was added via AsyncContext#addListener(AsyncListener), this method must return null.

Returns:
the ServletRequest that was used to initialize this AsyncEvent, or null if this AsyncEvent was initialized without any ServletRequest

getSuppliedResponse

public ServletResponse getSuppliedResponse()
Gets the ServletResponse from this AsyncEvent.

If the AsyncListener to which this AsyncEvent is being delivered was added using AsyncContext#addListener(AsyncListener, ServletRequest, ServletResponse), the returned ServletResponse will be the same as the one supplied to the above method. If the AsyncListener was added via AsyncContext#addListener(AsyncListener), this method must return null.

Returns:
the ServletResponse that was used to initialize this AsyncEvent, or null if this AsyncEvent was initialized without any ServletResponse

getThrowable

public java.lang.Throwable getThrowable()
Gets the Throwable from this AsyncEvent.

Returns:
the Throwable that was used to initialize this AsyncEvent, or null if this AsyncEvent was initialized without any Throwable


Submit a bug or feature

Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to license terms.

Generated on 10-February-2011 12:41