AbstractProcessor (Apache Tomcat 8.0.53 API Documentation)

java.lang.Object
- org.apache.coyote.AbstractProcessor<S>

All Implemented Interfaces:

ActionHook, Processor<S>

Direct Known Subclasses:

AbstractAjpProcessor, AbstractHttp11Processor
```
public abstract class AbstractProcessor<S>
extends java.lang.Object
implements ActionHook, Processor<S>
```
Provides functionality and attributes common to all supported protocols (currently HTTP and AJP).

Field Summary

Fields
Modifier and Type	Field and Description
`protected Adapter`	`adapter`
`protected AsyncStateMachine`	`asyncStateMachine`
`protected AbstractEndpoint<S>`	`endpoint`
`protected char[]`	`hostNameC`
`protected Request`	`request`
`protected Response`	`response`
`protected static StringManager`	`sm`
`protected SocketWrapper<S>`	`socketWrapper`
`protected UserDataHelper`	`userDataHelper`

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`AbstractProcessor()` Intended for use by the Upgrade sub-classes that have no need to initialise the request, response, etc.
	`AbstractProcessor(AbstractEndpoint<S> endpoint)`

Method Summary

Methods
Modifier and Type	Method and Description
`abstract AbstractEndpoint.Handler.SocketState`	`asyncDispatch(SocketStatus status)` Process in-progress Servlet 3.0 Async requests.
`AbstractEndpoint.Handler.SocketState`	`asyncPostProcess()`
`void`	`errorDispatch()`
`abstract AbstractEndpoint.Handler.SocketState`	`event(SocketStatus status)` Process in-progress Comet requests.
`Adapter`	`getAdapter()` Get the associated adapter.
`protected AbstractEndpoint<S>`	`getEndpoint()` The endpoint receiving connections that are handled by this processor.
`protected ErrorState`	`getErrorState()`
`java.util.concurrent.Executor`	`getExecutor()` Obtain the Executor used by the underlying endpoint.
`protected abstract Log`	`getLog()`
`int`	`getMaxCookieCount()`
`Request`	`getRequest()` The request associated with this processor.
`protected SocketWrapper<S>`	`getSocketWrapper()` Get the socket wrapper being used.
`abstract UpgradeToken`	`getUpgradeToken()`
`boolean`	`isAsync()`
`abstract boolean`	`isComet()`
`abstract boolean`	`isUpgrade()`
`protected void`	`parseHost(MessageBytes valueMB)`
`protected void`	`populateHost()` Called when a host name is not present in the request (e.g.
`abstract AbstractEndpoint.Handler.SocketState`	`process(SocketWrapper<S> socket)` Process HTTP requests.
`protected abstract void`	`registerForEvent(boolean read, boolean write)` Register the socket for the specified events.
`protected void`	`resetErrorState()`
`void`	`setAdapter(Adapter adapter)` Set the associated adapter.
`protected void`	`setErrorState(ErrorState errorState, java.lang.Throwable t)` Update the current error state to the new error state if the new error state is more severe than the current error state.
`void`	`setMaxCookieCount(int maxCookieCount)`
`protected void`	`setSocketWrapper(SocketWrapper<S> socketWrapper)` Set the socket wrapper being used.
`abstract AbstractEndpoint.Handler.SocketState`	`upgradeDispatch(SocketStatus status)` Processes data received on a connection that has been through an HTTP upgrade.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.coyote.ActionHook
action

Methods inherited from interface org.apache.coyote.Processor
getLeftoverInput, recycle, setSslSupport

- Field Detail
  - sm
```
protected static final StringManager sm
```
  - hostNameC
```
protected char[] hostNameC
```
  - adapter
```
protected Adapter adapter
```
  - asyncStateMachine
```
protected final AsyncStateMachine asyncStateMachine
```
  - endpoint
```
protected final AbstractEndpoint<S> endpoint
```
  - request
```
protected final Request request
```
  - response
```
protected final Response response
```
  - socketWrapper
```
protected volatile SocketWrapper<S> socketWrapper
```
  - userDataHelper
```
protected final UserDataHelper userDataHelper
```
- Constructor Detail
  - AbstractProcessor
```
protected AbstractProcessor()
```
    Intended for use by the Upgrade sub-classes that have no need to initialise the request, response, etc.
  - AbstractProcessor
```
public AbstractProcessor(AbstractEndpoint<S> endpoint)
```
- Method Detail
  - setErrorState
```
protected void setErrorState(ErrorState errorState,
                 java.lang.Throwable t)
```
    Update the current error state to the new error state if the new error state is more severe than the current error state.
  - resetErrorState
```
protected void resetErrorState()
```
  - getErrorState
```
protected ErrorState getErrorState()
```
  - getEndpoint
```
protected AbstractEndpoint<S> getEndpoint()
```
    The endpoint receiving connections that are handled by this processor.
  - getRequest
```
public Request getRequest()
```
    The request associated with this processor.
    
    Specified by:
    
    getRequest in interface Processor<S>
  - setAdapter
```
public void setAdapter(Adapter adapter)
```
    Set the associated adapter.
    
    Parameters:
    adapter - the new adapter
  - getAdapter
```
public Adapter getAdapter()
```
    Get the associated adapter.
    
    Returns:
    the associated adapter
  - setSocketWrapper
```
protected final void setSocketWrapper(SocketWrapper<S> socketWrapper)
```
    Set the socket wrapper being used.
  - getSocketWrapper
```
protected final SocketWrapper<S> getSocketWrapper()
```
    Get the socket wrapper being used.
  - getExecutor
```
public java.util.concurrent.Executor getExecutor()
```
    Obtain the Executor used by the underlying endpoint.
    
    Specified by:
    
    getExecutor in interface Processor<S>
  - isAsync
```
public boolean isAsync()
```
    Specified by:
    
    isAsync in interface Processor<S>
  - asyncPostProcess
```
public AbstractEndpoint.Handler.SocketState asyncPostProcess()
```
    Specified by:
    
    asyncPostProcess in interface Processor<S>
  - errorDispatch
```
public void errorDispatch()
```
    Specified by:
    
    errorDispatch in interface Processor<S>
  - isComet
```
public abstract boolean isComet()
```
    Specified by:
    
    isComet in interface Processor<S>
  - parseHost
```
protected void parseHost(MessageBytes valueMB)
```
  - populateHost
```
protected void populateHost()
```
    Called when a host name is not present in the request (e.g. HTTP/1.0). It populates the server name and port with appropriate information. The source is expected to vary by protocol.
    The default implementation is a NO-OP.
  - isUpgrade
```
public abstract boolean isUpgrade()
```
    Specified by:
    
    isUpgrade in interface Processor<S>
  - process
```
public abstract AbstractEndpoint.Handler.SocketState process(SocketWrapper<S> socket)
                                                      throws java.io.IOException
```
    Process HTTP requests. All requests are treated as HTTP requests to start with although they may change type during processing.
    
    Specified by:
    
    process in interface Processor<S>
    
    Throws:
    
    java.io.IOException
  - event
```
public abstract AbstractEndpoint.Handler.SocketState event(SocketStatus status)
                                                    throws java.io.IOException
```
    Process in-progress Comet requests. These will start as HTTP requests.
    
    Specified by:
    
    event in interface Processor<S>
    
    Throws:
    
    java.io.IOException
  - asyncDispatch
```
public abstract AbstractEndpoint.Handler.SocketState asyncDispatch(SocketStatus status)
```
    Process in-progress Servlet 3.0 Async requests. These will start as HTTP requests.
    
    Specified by:
    
    asyncDispatch in interface Processor<S>
  - upgradeDispatch
```
public abstract AbstractEndpoint.Handler.SocketState upgradeDispatch(SocketStatus status)
                                                              throws java.io.IOException
```
    Processes data received on a connection that has been through an HTTP upgrade.
    
    Specified by:
    
    upgradeDispatch in interface Processor<S>
    
    Throws:
    
    java.io.IOException
  - getMaxCookieCount
```
public int getMaxCookieCount()
```
  - setMaxCookieCount
```
public void setMaxCookieCount(int maxCookieCount)
```
  - getUpgradeToken
```
public abstract UpgradeToken getUpgradeToken()
```
    Specified by:
    
    getUpgradeToken in interface Processor<S>
  - registerForEvent
```
protected abstract void registerForEvent(boolean read,
                    boolean write)
```
    Register the socket for the specified events.
    
    Parameters:
    read - Register the socket for read events
    write - Register the socket for write events
  - getLog
```
protected abstract Log getLog()
```

Class AbstractProcessor<S>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.apache.coyote.ActionHook

Methods inherited from interface org.apache.coyote.Processor

Field Detail

sm

hostNameC

adapter

asyncStateMachine

endpoint

request

response

socketWrapper

userDataHelper

Constructor Detail

AbstractProcessor

AbstractProcessor

Method Detail

setErrorState

resetErrorState

getErrorState

getEndpoint

getRequest

setAdapter

getAdapter

setSocketWrapper

getSocketWrapper

getExecutor

isAsync

asyncPostProcess

errorDispatch

isComet

parseHost

populateHost

isUpgrade

process

event

asyncDispatch

upgradeDispatch

getMaxCookieCount

setMaxCookieCount

getUpgradeToken

registerForEvent

getLog