Interface ClientConnectionOperator

  • All Known Implementing Classes:
    DefaultClientConnectionOperator

    @Deprecated
    public interface ClientConnectionOperator
    Deprecated.
    (4.3) replaced by HttpClientConnectionManager.
    ClientConnectionOperator represents a strategy for creating OperatedClientConnection instances and updating the underlying Socket of those objects. Implementations will most likely make use of SchemeSocketFactorys to create Socket instances.

    The methods in this interface allow the creation of plain and layered sockets. Creating a tunnelled connection through a proxy, however, is not within the scope of the operator.

    Implementations of this interface must be thread-safe. Access to shared data must be synchronized as methods of this interface may be executed from multiple threads.

    Since:
    4.0
    • Method Detail

      • createConnection

        OperatedClientConnection createConnection()
        Deprecated.
        Creates a new connection that can be operated.
        Returns:
        a new, unopened connection for use with this operator
      • openConnection

        void openConnection​(OperatedClientConnection conn,
                            HttpHost target,
                            java.net.InetAddress local,
                            HttpContext context,
                            HttpParams params)
                     throws java.io.IOException
        Deprecated.
        Opens a connection to the given target host.
        Parameters:
        conn - the connection to open
        target - the target host to connect to
        local - the local address to route from, or null for the default
        context - the context for the connection
        params - the parameters for the connection
        Throws:
        java.io.IOException - in case of a problem
      • updateSecureConnection

        void updateSecureConnection​(OperatedClientConnection conn,
                                    HttpHost target,
                                    HttpContext context,
                                    HttpParams params)
                             throws java.io.IOException
        Deprecated.
        Updates a connection with a layered secure connection. The typical use of this method is to update a tunnelled plain connection (HTTP) to a secure TLS/SSL connection (HTTPS).
        Parameters:
        conn - the open connection to update
        target - the target host for the updated connection. The connection must already be open or tunnelled to the host and port, but the scheme of the target will be used to create a layered connection.
        context - the context for the connection
        params - the parameters for the updated connection
        Throws:
        java.io.IOException - in case of a problem