org.springframework.http.server

Class ServletServerHttpAsyncRequestControl

java.lang.Object

org.springframework.http.server.ServletServerHttpAsyncRequestControl

All Implemented Interfaces:

ServerHttpAsyncRequestControl

public class ServletServerHttpAsyncRequestControl
extends java.lang.Object
implements ServerHttpAsyncRequestControl

A ServerHttpAsyncRequestControl to use on Servlet containers (Servlet 3.0+).

Since:

4.0

Author:

Rossen Stoyanchev

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.concurrent.atomic.AtomicBoolean	asyncCompleted
private AsyncContext	asyncContext
private static long	NO_TIMEOUT_VALUE
private ServletServerHttpRequest	request
private ServletServerHttpResponse	response

Constructor Summary

Constructors

Constructor and Description
ServletServerHttpAsyncRequestControl(ServletServerHttpRequest request, ServletServerHttpResponse response) Constructor accepting a request and response pair that are expected to be of type ServletServerHttpRequest and ServletServerHttpResponse respectively.

Method Summary

Modifier and Type	Method and Description
void	complete() Mark asynchronous request processing as completed.
boolean	isCompleted() Return whether asynchronous request processing has been completed.
boolean	isStarted() Return whether asynchronous request processing has been started.
void	onComplete(AsyncEvent event)
void	onError(AsyncEvent event)
void	onStartAsync(AsyncEvent event)
void	onTimeout(AsyncEvent event)
void	start() Enable asynchronous processing after which the response remains open until a call to ServerHttpAsyncRequestControl.complete() is made or the server times out the request.
void	start(long timeout) A variation on ServerHttpAsyncRequestControl.start() that allows specifying a timeout value to use to use for asynchronous processing.

Methods inherited from class java.lang.Object

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

Field Detail

NO_TIMEOUT_VALUE

private static long NO_TIMEOUT_VALUE

request

private final ServletServerHttpRequest request

response

private final ServletServerHttpResponse response

asyncContext

private AsyncContext asyncContext

asyncCompleted

private java.util.concurrent.atomic.AtomicBoolean asyncCompleted

Constructor Detail

ServletServerHttpAsyncRequestControl

public ServletServerHttpAsyncRequestControl(ServletServerHttpRequest request,
                                            ServletServerHttpResponse response)

Constructor accepting a request and response pair that are expected to be of type ServletServerHttpRequest and ServletServerHttpResponse respectively.

Method Detail

isStarted

public boolean isStarted()

Description copied from interface: ServerHttpAsyncRequestControl

Return whether asynchronous request processing has been started.

Specified by:

isStarted in interface ServerHttpAsyncRequestControl

isCompleted

public boolean isCompleted()

Description copied from interface: ServerHttpAsyncRequestControl

Return whether asynchronous request processing has been completed.

Specified by:

isCompleted in interface ServerHttpAsyncRequestControl

start

public void start()

Description copied from interface: ServerHttpAsyncRequestControl

Enable asynchronous processing after which the response remains open until a call to ServerHttpAsyncRequestControl.complete() is made or the server times out the request. Once enabled, additional calls to this method are ignored.

Specified by:

start in interface ServerHttpAsyncRequestControl

start

public void start(long timeout)

Description copied from interface: ServerHttpAsyncRequestControl

A variation on ServerHttpAsyncRequestControl.start() that allows specifying a timeout value to use to use for asynchronous processing. If ServerHttpAsyncRequestControl.complete() is not called within the specified value, the request times out.

Specified by:

start in interface ServerHttpAsyncRequestControl

complete

public void complete()

Description copied from interface: ServerHttpAsyncRequestControl

Mark asynchronous request processing as completed.

Specified by:

complete in interface ServerHttpAsyncRequestControl

onComplete

public void onComplete(AsyncEvent event)
                throws java.io.IOException

Throws:

java.io.IOException

onStartAsync

public void onStartAsync(AsyncEvent event)
                  throws java.io.IOException

Throws:

java.io.IOException

onError

public void onError(AsyncEvent event)
             throws java.io.IOException

Throws:

java.io.IOException

onTimeout

public void onTimeout(AsyncEvent event)
               throws java.io.IOException

Throws:

java.io.IOException