Package jakarta.servlet
Class AsyncEvent
java.lang.Object
jakarta.servlet.AsyncEvent
public class AsyncEvent extends 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
Constructors Constructor Description 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, Throwable throwable)
Constructs an AsyncEvent from the given AsyncContext, ServletRequest, ServletResponse, and Throwable.AsyncEvent(AsyncContext context, Throwable throwable)
Constructs an AsyncEvent from the given AsyncContext and Throwable. -
Method Summary
Modifier and Type Method Description AsyncContext
getAsyncContext()
Gets the AsyncContext from this AsyncEvent.ServletRequest
getSuppliedRequest()
Gets the ServletRequest from this AsyncEvent.ServletResponse
getSuppliedResponse()
Gets the ServletResponse from this AsyncEvent.Throwable
getThrowable()
Gets the Throwable from this AsyncEvent.
-
Constructor Details
-
AsyncEvent
Constructs an AsyncEvent from the given AsyncContext.- Parameters:
context
- the AsyncContex to be delivered with this AsyncEvent
-
AsyncEvent
Constructs an AsyncEvent from the given AsyncContext, ServletRequest, and ServletResponse.- Parameters:
context
- the AsyncContex to be delivered with this AsyncEventrequest
- the ServletRequest to be delivered with this AsyncEventresponse
- the ServletResponse to be delivered with this AsyncEvent
-
AsyncEvent
Constructs an AsyncEvent from the given AsyncContext and Throwable.- Parameters:
context
- the AsyncContex to be delivered with this AsyncEventthrowable
- the Throwable to be delivered with this AsyncEvent
-
AsyncEvent
public AsyncEvent(AsyncContext context, ServletRequest request, ServletResponse response, Throwable throwable)Constructs an AsyncEvent from the given AsyncContext, ServletRequest, ServletResponse, and Throwable.- Parameters:
context
- the AsyncContex to be delivered with this AsyncEventrequest
- the ServletRequest to be delivered with this AsyncEventresponse
- the ServletResponse to be delivered with this AsyncEventthrowable
- the Throwable to be delivered with this AsyncEvent
-
-
Method Details
-
getAsyncContext
Gets the AsyncContext from this AsyncEvent.- Returns:
- the AsyncContext that was used to initialize this AsyncEvent
-
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 viaAsyncContext.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
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 viaAsyncContext.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
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
-