Package org.apache.http.nio.reactor.ssl

Class SSLIOSession

  • All Implemented Interfaces:
    IOSession, SessionBufferStatus, SocketAccessor
    Direct Known Subclasses:
    SSLIOSession
    @Contract(threading=SAFE_CONDITIONAL)
public class SSLIOSession
extends Object
implements IOSession, SessionBufferStatus, SocketAccessor
    SSLIOSession is a decorator class intended to transparently extend an IOSession with transport layer security capabilities based on the SSL/TLS protocol.

    The resultant instance of SSLIOSession must be added to the original I/O session as an attribute with the SESSION_KEY key. 

      SSLContext sslContext = SSLContext.getInstance("SSL");
  sslContext.init(null, null, null);
  SSLIOSession sslsession = new SSLIOSession(
      iosession, SSLMode.CLIENT, sslContext, null);
  iosession.setAttribute(SSLIOSession.SESSION_KEY, sslsession);
    Since:
    4.2

    • Field Detail

      • SESSION_KEY

        public static final String SESSION_KEY
        Name of the context attribute key, which can be used to obtain the SSL session.
        See Also:
        Constant Field Values

    • Constructor Detail

      • SSLIOSession

        public SSLIOSession​(IOSession session,
                    SSLMode sslMode,
                    HttpHost host,
                    SSLContext sslContext,
                    SSLSetupHandler handler)
        Creates new instance of SSLIOSession class. The instances created uses a PermanentSSLBufferManagementStrategy to manage its buffers.
        Parameters:
        session - I/O session to be decorated with the TLS/SSL capabilities.
        sslMode - SSL mode (client or server)
        host - original host (applicable in client mode only)
        sslContext - SSL context to use for this I/O session.
        handler - optional SSL setup handler. May be null.
        Since:
        4.4

      • SSLIOSession

        public SSLIOSession​(IOSession session,
                    SSLMode sslMode,
                    HttpHost host,
                    SSLContext sslContext,
                    SSLSetupHandler handler,
                    SSLBufferManagementStrategy bufferManagementStrategy)
        Creates new instance of SSLIOSession class.
        Parameters:
        session - I/O session to be decorated with the TLS/SSL capabilities.
        sslMode - SSL mode (client or server)
        host - original host (applicable in client mode only)
        sslContext - SSL context to use for this I/O session.
        handler - optional SSL setup handler. May be null.
        bufferManagementStrategy - buffer management strategy

      • SSLIOSession

        public SSLIOSession​(IOSession session,
                    SSLMode sslMode,
                    SSLContext sslContext,
                    SSLSetupHandler handler)
        Creates new instance of SSLIOSession class.
        Parameters:
        session - I/O session to be decorated with the TLS/SSL capabilities.
        sslMode - SSL mode (client or server)
        sslContext - SSL context to use for this I/O session.
        handler - optional SSL setup handler. May be null.

    • Method Detail

      • isInitialized

        public boolean isInitialized()
        Returns true is the session has been fully initialized, false otherwise.

      • getSSLSession

        public SSLSession getSSLSession()

      • isAppInputReady

        public boolean isAppInputReady()
                        throws IOException
        Reads encrypted data and returns whether the channel associated with this session has any decrypted inbound data available for reading.
        Throws:
        IOException - in case of an I/O error.

      • isAppOutputReady

        public boolean isAppOutputReady()
                         throws IOException
        Returns whether the channel associated with this session is ready to accept outbound unecrypted data for writing.
        Throws:
        IOException - - not thrown currently

      • inboundTransport

        public void inboundTransport()
                      throws IOException
        Executes inbound SSL transport operations.
        Throws:
        IOException - - not thrown currently

      • outboundTransport

        public void outboundTransport()
                       throws IOException
        Sends encrypted data and executes outbound SSL transport operations.
        Throws:
        IOException - in case of an I/O error.

      • isInboundDone

        public boolean isInboundDone()
        Returns whether the session will produce any more inbound data.

      • isOutboundDone

        public boolean isOutboundDone()
        Returns whether the session will accept any more outbound data.

      • close

        public void close()
        Description copied from interface: IOSession
        Terminates the session gracefully and closes the underlying I/O channel. This method ensures that session termination handshake, such as the one used by the SSL/TLS protocol, is correctly carried out.
        Specified by:
        close in interface IOSession

      • shutdown

        public void shutdown()
        Description copied from interface: IOSession
        Terminates the session by shutting down the underlying I/O channel.
        Specified by:
        shutdown in interface IOSession

      • isClosed

        public boolean isClosed()
        Description copied from interface: IOSession
        Determines if the session has been terminated.
        Specified by:
        isClosed in interface IOSession
        Returns:
        true if the session has been terminated, false otherwise.

      • channel

        public ByteChannel channel()
        Description copied from interface: IOSession
        Returns the underlying I/O channel associated with this session.
        Specified by:
        channel in interface IOSession
        Returns:
        the I/O channel.

      • getEventMask

        public int getEventMask()
        Description copied from interface: IOSession
        Returns mask of I/O evens this session declared interest in.
        Specified by:
        getEventMask in interface IOSession
        Returns:
        I/O event mask.

      • setEventMask

        public void setEventMask​(int ops)
        Description copied from interface: IOSession
        Declares interest in I/O event notifications by setting the event mask associated with the session
        Specified by:
        setEventMask in interface IOSession
        Parameters:
        ops - new I/O event mask.

      • setEvent

        public void setEvent​(int op)
        Description copied from interface: IOSession
        Declares interest in a particular I/O event type by updating the event mask associated with the session.
        Specified by:
        setEvent in interface IOSession
        Parameters:
        op - I/O event type.

      • clearEvent

        public void clearEvent​(int op)
        Description copied from interface: IOSession
        Clears interest in a particular I/O event type by updating the event mask associated with the session.
        Specified by:
        clearEvent in interface IOSession
        Parameters:
        op - I/O event type.

      • getSocketTimeout

        public int getSocketTimeout()
        Description copied from interface: IOSession
        Returns value of the socket timeout in milliseconds. The value of 0 signifies the session cannot time out.
        Specified by:
        getSocketTimeout in interface IOSession
        Returns:
        socket timeout.

      • setSocketTimeout

        public void setSocketTimeout​(int timeout)
        Description copied from interface: IOSession
        Sets value of the socket timeout in milliseconds. The value of 0 signifies the session cannot time out.
        Specified by:
        setSocketTimeout in interface IOSession
        Parameters:
        timeout - socket timeout.

      • hasBufferedInput

        public boolean hasBufferedInput()
        Description copied from interface: IOSession
        Determines if the input buffer associated with the session contains data.
        Specified by:
        hasBufferedInput in interface IOSession
        Specified by:
        hasBufferedInput in interface SessionBufferStatus
        Returns:
        true if the session input buffer contains data, false otherwise.

      • hasBufferedOutput

        public boolean hasBufferedOutput()
        Description copied from interface: IOSession
        Determines if the output buffer associated with the session contains data.
        Specified by:
        hasBufferedOutput in interface IOSession
        Specified by:
        hasBufferedOutput in interface SessionBufferStatus
        Returns:
        true if the session output buffer contains data, false otherwise.

      • setBufferStatus

        public void setBufferStatus​(SessionBufferStatus status)
        Description copied from interface: IOSession
        Quite often I/O sessions need to maintain internal I/O buffers in order to transform input / output data prior to returning it to the consumer or writing it to the underlying channel. Memory management in HttpCore NIO is based on the fundamental principle that the data consumer can read only as much input data as it can process without having to allocate more memory. That means, quite often some input data may remain unread in one of the internal or external session buffers. The I/O reactor can query the status of these session buffers, and make sure the consumer gets notified correctly as more data gets stored in one of the session buffers, thus allowing the consumer to read the remaining data once it is able to process it

        I/O sessions can be made aware of the status of external session buffers using the SessionBufferStatus interface.

        Specified by:
        setBufferStatus in interface IOSession

      • setAttribute

        public void setAttribute​(String name,
                         Object obj)
        Description copied from interface: IOSession
        This method can be used to associate a particular object with the session by the given attribute name.

        I/O sessions are not bound to an execution thread, therefore one cannot use the context of the thread to store a session's state. All details about a particular session must be stored within the session itself.

        Specified by:
        setAttribute in interface IOSession
        Parameters:
        name - name of the attribute.
        obj - value of the attribute.

      • getSocket

        public Socket getSocket()
        Description copied from interface: SocketAccessor
        Return the underlying socket
        Specified by:
        getSocket in interface SocketAccessor
        Returns:
        - the underlying Socket, may be null.