Interface HttpClientTransport

  • All Superinterfaces:
    ClientConnectionFactory
    All Known Implementing Classes:
    AbstractConnectorHttpClientTransport, AbstractHttpClientTransport, HttpClientTransportOverHTTP

    @Deprecated(since="2021-05-27")
    public interface HttpClientTransport
    extends ClientConnectionFactory
    Deprecated.
    The Eclipse Jetty and Apache Felix Http Jetty packages are no longer supported.
    HttpClientTransport represents what transport implementations should provide in order to plug-in a different transport for HttpClient.

    While the HttpClient APIs define the HTTP semantic (request, response, headers, etc.) how an HTTP exchange is carried over the network depends on implementations of this class.

    The default implementation uses the HTTP protocol to carry over the network the HTTP exchange, but the HTTP exchange may also be carried using the FCGI protocol, the HTTP/2 protocol or, in future, other protocols.

    • Field Detail

      • HTTP_DESTINATION_CONTEXT_KEY

        static final java.lang.String HTTP_DESTINATION_CONTEXT_KEY
        Deprecated.
        See Also:
        Constant Field Values
      • HTTP_CONNECTION_PROMISE_CONTEXT_KEY

        static final java.lang.String HTTP_CONNECTION_PROMISE_CONTEXT_KEY
        Deprecated.
        See Also:
        Constant Field Values
    • Method Detail

      • setHttpClient

        void setHttpClient​(HttpClient client)
        Deprecated.
        Sets the HttpClient instance on this transport.

        This is needed because of a chicken-egg problem: in order to create the HttpClient a HttpClientTransport is needed, that therefore cannot have a reference yet to the HttpClient.

        Parameters:
        client - the HttpClient that uses this transport.
      • newHttpDestination

        HttpDestination newHttpDestination​(Origin origin)
        Deprecated.
        Creates a new, transport-specific, HttpDestination object.

        HttpDestination controls the destination-connection cardinality: protocols like HTTP have 1-N cardinality, while multiplexed protocols like HTTP/2 have a 1-1 cardinality.

        Parameters:
        origin - the destination origin
        Returns:
        a new, transport-specific, HttpDestination object
      • connect

        void connect​(java.net.InetSocketAddress address,
                     java.util.Map<java.lang.String,​java.lang.Object> context)
        Deprecated.
        Establishes a physical connection to the given address.
        Parameters:
        address - the address to connect to
        context - the context information to establish the connection
      • getConnectionPoolFactory

        ConnectionPool.Factory getConnectionPoolFactory()
        Deprecated.
        Returns:
        the factory for ConnectionPool instances
      • setConnectionPoolFactory

        void setConnectionPoolFactory​(ConnectionPool.Factory factory)
        Deprecated.
        Parameters:
        factory - the factory for ConnectionPool instances