UpgradeProcessorExternal (Apache Tomcat 8.5.12 API Documentation)

org.apache.coyote.http11.upgrade

## Class UpgradeProcessorExternal

- java.lang.Object
- - org.apache.coyote.AbstractProcessorLight
  - - org.apache.coyote.http11.upgrade.UpgradeProcessorBase
    - - org.apache.coyote.http11.upgrade.UpgradeProcessorExternal

- All Implemented Interfaces:
    AutoCloseable, WebConnection, Processor

      public class UpgradeProcessorExternal
      extends UpgradeProcessorBase

- - ### Field Summary

    - ### Fields inherited from class org.apache.coyote.http11.upgrade.UpgradeProcessorBase

      `INFINITE_TIMEOUT`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `UpgradeProcessorExternal(SocketWrapperBase<?> wrapper, UpgradeToken upgradeToken)`

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `close()`
    `AbstractEndpoint.Handler.SocketState` | `dispatch(SocketEvent status)` Process an in-progress request that is not longer in standard HTTP mode.
    `ServletInputStream` | `getInputStream()` Provides access to the `ServletInputStream` for reading data from the client.
    `protected Log` | `getLog()`
    `ServletOutputStream` | `getOutputStream()` Provides access to the `ServletOutputStream` for writing data to the client.
    `void` | `pause()` Informs the processor that the underlying I/O layer has stopped accepting new connections.
    `void` | `setSslSupport(SSLSupport sslSupport)` Set the SSL information for this HTTP connection.

    - ### Methods inherited from class org.apache.coyote.http11.upgrade.UpgradeProcessorBase

      `asyncPostProcess, getLeftoverInput, getRequest, getUpgradeToken, isAsync, isUpgrade, recycle, service, timeoutAsync`

    - ### Methods inherited from class org.apache.coyote.AbstractProcessorLight

      `addDispatch, clearDispatches, getIteratorAndClearDispatches, process`

    - ### Methods inherited from class java.lang.Object

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

- - ### Constructor Detail

    - #### UpgradeProcessorExternal

          public UpgradeProcessorExternal(SocketWrapperBase<?> wrapper,
                                  UpgradeToken upgradeToken)

  - ### Method Detail

    - #### getLog

          protected Log getLog()

      Specified by:
        `getLog` in class `AbstractProcessorLight`

    - #### close

          public void close()
                     throws Exception

      Throws:
        `Exception`

    - #### getInputStream

          public ServletInputStream getInputStream()
                                            throws IOException

      Description copied from interface: `javax.servlet.http.WebConnection`
      Provides access to the `ServletInputStream` for reading data from the client.
      Returns:
        the input stream
      Throws:
        `IOException` - If an I/O occurs while obtaining the stream

    - #### getOutputStream

          public ServletOutputStream getOutputStream()
                                              throws IOException

      Description copied from interface: `javax.servlet.http.WebConnection`
      Provides access to the `ServletOutputStream` for writing data to the client.
      Returns:
        the output stream
      Throws:
        `IOException` - If an I/O occurs while obtaining the stream

    - #### dispatch

          public final AbstractEndpoint.Handler.SocketState dispatch(SocketEvent status)

      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 socket state

    - #### setSslSupport

          public final void setSslSupport(SSLSupport sslSupport)

      Description copied from interface: `Processor`
      Set the SSL information for this HTTP connection.
      Parameters:
        `sslSupport` - The SSL support object to use for this connection

    - #### pause

          public void pause()

      Description copied from interface: `Processor`
      Informs the processor that the underlying I/O layer has stopped accepting new connections. This is primarily intended to enable processors that use multiplexed connections to prevent further 'streams' being added to an existing multiplexed connection.

Copyright © 2000-2017 Apache Software Foundation. All Rights Reserved.