Package org.apache.coyote

Class AbstractProcessor

    • Method Detail

      • setErrorState

        protected void setErrorState​(ErrorState errorState,
                             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.
        Parameters:
        errorState - The error status details
        t - The error which occurred

      • getErrorState

        protected ErrorState getErrorState()

      • getRequest

        public Request getRequest()
        Specified by:
        getRequest in interface Processor
        Returns:
        The request associated with this processor.

      • 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 void setSocketWrapper​(SocketWrapperBase<?> socketWrapper)
        Set the socket wrapper being used.
        Parameters:
        socketWrapper - The socket wrapper

      • getSocketWrapper

        protected final SocketWrapperBase<?> getSocketWrapper()
        Returns:
        the socket wrapper being used.

      • setSslSupport

        public final void setSslSupport​(SSLSupport sslSupport)
        Description copied from interface: Processor
        Set the SSL information for this HTTP connection.
        Specified by:
        setSslSupport in interface Processor
        Parameters:
        sslSupport - The SSL support object to use for this connection

      • getExecutor

        protected Executor getExecutor()
        Returns:
        the Executor used by the underlying endpoint.

      • isAsync

        public boolean isAsync()
        Specified by:
        isAsync in interface Processor

      • dispatch

        public final AbstractEndpoint.Handler.SocketState dispatch​(SocketEvent status)
                                                    throws IOException
        Description copied from class: AbstractProcessorLight
        Process an in-progress request that is not longer in standard HTTP mode. Uses currently include Servlet 3.0 Async and HTTP upgrade connections. Further uses may be added in the future. These will typically start as HTTP requests.
        Specified by:
        dispatch in class AbstractProcessorLight
        Parameters:
        status - The event to process
        Returns:
        The state the caller should put the socket in when this method returns
        Throws:
        IOException - If an I/O error occurs during the processing of the request

      • parseHost

        protected void parseHost​(MessageBytes valueMB)

      • populateHost

        protected void populateHost()
        Called when a host header is not present in the request (e.g. HTTP/1.0). It populates the server name with appropriate information. The source is expected to vary by protocol.

        The default implementation is a NO-OP.

      • populatePort

        protected void populatePort()
        Called when a host header is not present or is empty in the request (e.g. HTTP/1.0). It populates the server port with appropriate information. The source is expected to vary by protocol.

        The default implementation is a NO-OP.

      • action

        public final void action​(ActionCode actionCode,
                         Object param)
        Description copied from interface: ActionHook
        Send an action to the connector.
        Specified by:
        action in interface ActionHook
        Parameters:
        actionCode - Type of the action
        param - Action parameter

      • dispatchNonBlockingRead

        protected void dispatchNonBlockingRead()
        Perform any necessary processing for a non-blocking read before dispatching to the adapter.

      • timeoutAsync

        public void timeoutAsync​(long now)
        Check this processor to see if the timeout has expired and process a timeout if that is that case.

        Note: The name of this method originated with the Servlet 3.0 asynchronous processing but evolved over time to represent a timeout that is triggered independently of the socket read/write timeouts.

        Sub-classes of this base class represent a single request/response pair. The timeout to be processed is, therefore, the Servlet asynchronous processing timeout.

        Specified by:
        timeoutAsync in interface Processor
        Parameters:
        now - The time (as returned by System.currentTimeMillis() to use as the current time to determine whether the timeout has expired. If negative, the timeout will always be treated as ifq it has expired.

      • checkAsyncTimeoutGeneration

        public boolean checkAsyncTimeoutGeneration()
        Description copied from interface: Processor
        Check to see if the async generation (each cycle of async increments the generation of the AsyncStateMachine) is the same as the generation when the most recent async timeout was triggered. This is intended to be used to avoid unnecessary processing.
        Specified by:
        checkAsyncTimeoutGeneration in interface Processor
        Returns:
        true If the async generation has not changed since the async timeout was triggered

      • setAsyncTimeout

        public void setAsyncTimeout​(long timeout)

      • getAsyncTimeout

        public long getAsyncTimeout()

      • recycle

        public void recycle()
        Description copied from interface: Processor
        Recycle the processor, ready for the next request which may be on the same connection or a different connection.
        Specified by:
        recycle in interface Processor

      • available

        protected abstract int available​(boolean doRead)

      • setRequestBody

        protected abstract void setRequestBody​(ByteChunk body)

      • setSwallowResponse

        protected abstract void setSwallowResponse()

      • disableSwallowRequest

        protected abstract void disableSwallowRequest()

      • getPopulateRequestAttributesFromSocket

        protected boolean getPopulateRequestAttributesFromSocket()
        Processors that populate request attributes directly (e.g. AJP) should over-ride this method and return false.
        Returns:
        true if the SocketWrapper should be used to populate the request attributes, otherwise false.

      • populateRequestAttributeRemoteHost

        protected void populateRequestAttributeRemoteHost()
        Populate the remote host request attribute. Processors (e.g. AJP) that populate this from an alternative source should override this method.

      • populateSslRequestAttributes

        protected void populateSslRequestAttributes()
        Populate the TLS related request attributes from the SSLSupport instance associated with this processor. Protocols that populate TLS attributes from a different source (e.g. AJP) should override this method.

      • sslReHandShake

        protected void sslReHandShake()
                       throws IOException
        Processors that can perform a TLS re-handshake (e.g. HTTP/1.1) should override this method and implement the re-handshake.
        Throws:
        IOException - If authentication is required then there will be I/O with the client and this exception will be thrown if that goes wrong

      • processSocketEvent

        protected void processSocketEvent​(SocketEvent event,
                                  boolean dispatch)

      • isReadyForRead

        protected boolean isReadyForRead()

      • isRequestBodyFullyRead

        protected abstract boolean isRequestBodyFullyRead()

      • registerReadInterest

        protected abstract void registerReadInterest()

      • isReadyForWrite

        protected abstract boolean isReadyForWrite()

      • executeDispatches

        protected void executeDispatches()

      • getUpgradeToken

        public UpgradeToken getUpgradeToken()
        Generate an upgrade token. Processors that implement HTTP upgrade must override this method and provide the necessary token.
        Specified by:
        getUpgradeToken in interface Processor
        Returns:
        An upgrade token encapsulating the information required to process the upgrade request

      • doHttpUpgrade

        protected void doHttpUpgrade​(UpgradeToken upgradeToken)
        Process an HTTP upgrade. Processors that support HTTP upgrade should override this method and process the provided token.
        Parameters:
        upgradeToken - Contains all the information necessary for the Processor to process the upgrade
        Throws:
        UnsupportedOperationException - if the protocol does not support HTTP upgrade

      • getLeftoverInput

        public ByteBuffer getLeftoverInput()
        Allows retrieving additional input during the upgrade process. Processors that implement HTTP upgrade must override this method.
        Specified by:
        getLeftoverInput in interface Processor
        Returns:
        leftover bytes

      • isUpgrade

        public boolean isUpgrade()
        Processors that implement HTTP upgrade must override this method.
        Specified by:
        isUpgrade in interface Processor
        Returns:
        true if the Processor is currently processing an upgrade request, otherwise false

      • isPushSupported

        protected boolean isPushSupported()
        Protocols that support push should override this method and return true.
        Returns:
        true if push is supported by this processor, otherwise false.

      • doPush

        protected void doPush​(Request pushTarget)
        Process a push. Processors that support push should override this method and process the provided token.
        Parameters:
        pushTarget - Contains all the information necessary for the Processor to process the push request
        Throws:
        UnsupportedOperationException - if the protocol does not support push

      • getConnectionID

        protected Object getConnectionID()
        Protocols that support multiplexing (e.g. HTTP/2) should override this method and return the appropriate ID.
        Returns:
        The stream ID associated with this request or null if a multiplexing protocol is not being used

      • getStreamID

        protected Object getStreamID()
        Protocols that support multiplexing (e.g. HTTP/2) should override this method and return the appropriate ID.
        Returns:
        The stream ID associated with this request or null if a multiplexing protocol is not being used

      • flushBufferedWrite

        protected abstract boolean flushBufferedWrite()
                                       throws IOException
        Flush any pending writes. Used during non-blocking writes to flush any remaining data from a previous incomplete write.
        Returns:
        true if data remains to be flushed at the end of method
        Throws:
        IOException - If an I/O error occurs while attempting to flush the data

      • dispatchEndRequest

        protected abstract AbstractEndpoint.Handler.SocketState dispatchEndRequest()
                                                                    throws IOException
        Perform any necessary clean-up processing if the dispatch resulted in the completion of processing for the current request.
        Returns:
        The state to return for the socket once the clean-up for the current request has completed
        Throws:
        IOException - If an I/O error occurs while attempting to end the request