|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Continuation.
A continuation is a mechanism by which a HTTP Request can be
suspended and restarted after a timeout or an asynchronous event
has occured.
Blocking continuations will block the process of the request during a
call to suspend(long)
.
Non-blocking continuation can abort the current request and arrange for it
to be retried when resume()
is called or the timeout expires.
In order to supprt non-blocking continuations, it is important that
all actions taken by a filter or servlet before a call to
suspend(long)
are either idempotent (can be retried) or
are made conditional on isPending()
so they are not performed on
retried requests.
With the appropriate HTTP Connector, this allows threadless waiting
for events (see SelectChannelConnector
).
Method Summary | |
Object |
getObject()
Arbitrary object associated with the continuation for context. |
boolean |
isNew()
Is this a newly created Continuation. |
boolean |
isPending()
Get the pending status? A continuation is pending while the handling of a call to suspend has not completed. |
void |
reset()
Reset the continuation. |
void |
resume()
Resume the request. |
void |
setObject(Object o)
Arbitrary object associated with the continuation for context. |
boolean |
suspend(long timeout)
Suspend handling. |
Method Detail |
public boolean suspend(long timeout)
timeout
-
public void resume()
public void reset()
public boolean isNew()
A newly created continuation has not had #getEvent(long)
called on it.
public boolean isPending()
suspend(long)
.
For non-blocking continuations, pending is true until a second call to suspend(long)
,
thus this method can be used to determine if a request is being retried.
public Object getObject()
public void setObject(Object o)
o
- An arbitrary object to associate with the continuation
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |