Package org.eclipse.jetty.server
Class HttpChannelState
- java.lang.Object
-
- org.eclipse.jetty.server.HttpChannelState
-
public class HttpChannelState extends java.lang.ObjectImplementation of AsyncContext interface that holds the state of request-response cycle.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classHttpChannelState.ActionThe actions to take as the channel moves from state to state.static classHttpChannelState.StateThe state of the HttpChannel,used to control the overall lifecycle.
-
Constructor Summary
Constructors Modifier Constructor Description protectedHttpChannelState(HttpChannel channel)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidaddListener(javax.servlet.AsyncListener listener)voidasyncError(java.lang.Throwable failure)protected voidcancelTimeout()protected voidcancelTimeout(AsyncContextEvent event)voidcomplete()voiddispatch(javax.servlet.ServletContext context, java.lang.String path)voiderrorComplete()AsyncContextEventgetAsyncContextEvent()java.lang.ObjectgetAttribute(java.lang.String name)RequestgetBaseRequest()ContextHandlergetContextHandler()HttpChannelgetHttpChannel()javax.servlet.ServletResponsegetServletResponse()javax.servlet.ServletResponsegetServletResponse(AsyncContextEvent event)HttpChannelState.StategetState()java.lang.StringgetStatusString()longgetTimeout()protected HttpChannelState.Actionhandling()booleanhasListener(javax.servlet.AsyncListener listener)booleanisAsync()booleanisAsyncComplete()booleanisAsyncStarted()booleanisExpired()booleanisIdle()booleanisInitial()booleanisSuspended()protected voidonComplete()booleanonContentAdded()Called to signal that content is now available to read.protected voidonError(java.lang.Throwable th)booleanonReadEof()Called to signal that a read has read -1.booleanonReadPossible()Called to indicate that more content may be available, but that a handling thread may need to produce (fill/parse) it.booleanonReadReady()Called to signal that the channel is ready for a callback.voidonReadUnready()Called to signal async read isReady() has returned false.protected voidonTimeout()booleanonWritePossible()protected voidrecycle()voidremoveAttribute(java.lang.String name)protected voidscheduleDispatch()voidsetAttribute(java.lang.String name, java.lang.Object attribute)voidsetTimeout(long ms)voidstartAsync(AsyncContextEvent event)java.lang.StringtoString()java.lang.StringtoStringLocked()protected HttpChannelState.Actionunhandle()Signal that the HttpConnection has finished handling the request.voidupgrade()
-
-
-
Constructor Detail
-
HttpChannelState
protected HttpChannelState(HttpChannel channel)
-
-
Method Detail
-
getState
public HttpChannelState.State getState()
-
addListener
public void addListener(javax.servlet.AsyncListener listener)
-
hasListener
public boolean hasListener(javax.servlet.AsyncListener listener)
-
setTimeout
public void setTimeout(long ms)
-
getTimeout
public long getTimeout()
-
getAsyncContextEvent
public AsyncContextEvent getAsyncContextEvent()
-
toString
public java.lang.String toString()
- Overrides:
toStringin classjava.lang.Object
-
toStringLocked
public java.lang.String toStringLocked()
-
getStatusString
public java.lang.String getStatusString()
-
handling
protected HttpChannelState.Action handling()
- Returns:
- Next handling of the request should proceed
-
startAsync
public void startAsync(AsyncContextEvent event)
-
asyncError
public void asyncError(java.lang.Throwable failure)
-
unhandle
protected HttpChannelState.Action unhandle()
Signal that the HttpConnection has finished handling the request. For blocking connectors, this call may block if the request has been suspended (startAsync called).- Returns:
- next actions be handled again (eg because of a resume that happened before unhandle was called)
-
dispatch
public void dispatch(javax.servlet.ServletContext context, java.lang.String path)
-
onTimeout
protected void onTimeout()
-
complete
public void complete()
-
errorComplete
public void errorComplete()
-
onError
protected void onError(java.lang.Throwable th)
-
onComplete
protected void onComplete()
-
recycle
protected void recycle()
-
upgrade
public void upgrade()
-
scheduleDispatch
protected void scheduleDispatch()
-
cancelTimeout
protected void cancelTimeout()
-
cancelTimeout
protected void cancelTimeout(AsyncContextEvent event)
-
isIdle
public boolean isIdle()
-
isExpired
public boolean isExpired()
-
isInitial
public boolean isInitial()
-
isSuspended
public boolean isSuspended()
-
isAsyncStarted
public boolean isAsyncStarted()
-
isAsyncComplete
public boolean isAsyncComplete()
-
isAsync
public boolean isAsync()
-
getBaseRequest
public Request getBaseRequest()
-
getHttpChannel
public HttpChannel getHttpChannel()
-
getContextHandler
public ContextHandler getContextHandler()
-
getServletResponse
public javax.servlet.ServletResponse getServletResponse()
-
getServletResponse
public javax.servlet.ServletResponse getServletResponse(AsyncContextEvent event)
-
getAttribute
public java.lang.Object getAttribute(java.lang.String name)
-
removeAttribute
public void removeAttribute(java.lang.String name)
-
setAttribute
public void setAttribute(java.lang.String name, java.lang.Object attribute)
-
onReadUnready
public void onReadUnready()
Called to signal async read isReady() has returned false. This indicates that there is no content available to be consumed and that once the channel enters the ASYNC_WAIT state it will register for read interest by callingHttpChannel.onAsyncWaitForContent()either from this method or from a subsequent call tounhandle().
-
onContentAdded
public boolean onContentAdded()
Called to signal that content is now available to read. If the channel is in ASYNC_WAIT state and unready (ie isReady() has returned false), then the state is changed to ASYNC_WOKEN and true is returned.- Returns:
- True IFF the channel was unready and in ASYNC_WAIT state
-
onReadReady
public boolean onReadReady()
Called to signal that the channel is ready for a callback. This is similar to callingonReadUnready()followed byonContentAdded(), except that as content is already available, read interest is never set.- Returns:
- true if woken
-
onReadPossible
public boolean onReadPossible()
Called to indicate that more content may be available, but that a handling thread may need to produce (fill/parse) it. Typically called by the async read success callback.- Returns:
trueif more content may be available
-
onReadEof
public boolean onReadEof()
Called to signal that a read has read -1. Will wake if the read was called while in ASYNC_WAIT state- Returns:
trueif woken
-
onWritePossible
public boolean onWritePossible()
-
-