Interface Connection

All Superinterfaces:
AutoCloseable, Closeable
All Known Subinterfaces:
IConnection
All Known Implementing Classes:
HttpConnection, HttpConnectionOverFCGI, HttpConnectionOverHTTP, HttpConnectionOverHTTP2

public interface Connection extends Closeable
Connection represent a connection to a Destination and allow applications to send requests via send(Request, Response.CompleteListener).

Connections are normally pooled by Destinations, but unpooled Connections may be created by applications that want to do their own connection management via Destination.newConnection(Promise) and close().

  • Method Details

    • send

      void send(Request request, Response.CompleteListener listener)
      Sends a request with an associated response listener.

      Request.send(Response.CompleteListener) will eventually call this method to send the request. It is exposed to allow applications to send requests via unpooled connections.

      Parameters:
      request - the request to send
      listener - the response listener
    • close

      void close()
      Specified by:
      close in interface AutoCloseable
      Specified by:
      close in interface Closeable
    • isClosed

      boolean isClosed()
      Returns:
      whether this connection has been closed
      See Also:
    • getLocalSocketAddress

      default SocketAddress getLocalSocketAddress()
      Returns:
      the local socket address associated with the connection
    • getRemoteSocketAddress

      default SocketAddress getRemoteSocketAddress()
      Returns:
      the remote socket address associated with the connection
    • getSslSessionData

      default EndPoint.SslSessionData getSslSessionData()
      Returns:
      the EndPoint.SslSessionData associated with the connection, or null if the connection is not secure.