Class ClientConnector.Configurator

All Implemented Interfaces:
Container, Destroyable, Dumpable, Dumpable.DumpableContainer, LifeCycle
Direct Known Subclasses:
Enclosing class:

public static class ClientConnector.Configurator extends ContainerLifeCycle

Configures a ClientConnector.

  • Constructor Details

    • Configurator

      public Configurator()
  • Method Details

    • isIntrinsicallySecure

      public boolean isIntrinsicallySecure(ClientConnector clientConnector, SocketAddress address)

      Returns whether the connection to a given SocketAddress is intrinsically secure.

      A protocol such as HTTP/1.1 can be transported by TCP; however, TCP is not secure because it does not offer any encryption.

      Encryption is provided by using TLS to wrap the HTTP/1.1 bytes, and then transporting the TLS bytes over TCP.

      On the other hand, protocols such as QUIC are intrinsically secure, and therefore it is not necessary to wrap the HTTP/1.1 bytes with TLS: the HTTP/1.1 bytes are transported over QUIC in an intrinsically secure way.

      clientConnector - the ClientConnector
      address - the SocketAddress to connect to
      whether the connection to the given SocketAddress is intrinsically secure
    • newChannelWithAddress

      public ClientConnector.Configurator.ChannelWithAddress newChannelWithAddress(ClientConnector clientConnector, SocketAddress address, Map<String,Object> context) throws IOException

      Creates a new SocketChannel to connect to a SocketAddress derived from the input socket address.

      The input socket address represents the destination socket address to connect to, as it is typically specified by a URI authority, for example localhost:8080 if the URI is http://localhost:8080/path.

      However, the returned socket address may be different as the implementation may use a Unix-Domain socket address to physically connect to the virtual destination socket address given as input.

      The return type is a pair/record holding the socket channel and the socket address, with the socket channel not yet connected. The implementation of this methods must not call SocketChannel.connect(SocketAddress), as this is done later, after configuring the socket, by the ClientConnector implementation.

      clientConnector - the client connector requesting channel with associated address
      address - the destination socket address, typically specified in a URI
      context - the context to create the new socket channel
      a new SocketChannel with an associated SocketAddress to connect to
      IOException - if the socket channel or the socket address cannot be created
    • newEndPoint

      public EndPoint newEndPoint(ClientConnector clientConnector, SocketAddress address, SelectableChannel selectable, ManagedSelector selector, SelectionKey selectionKey)
    • newConnection

      public Connection newConnection(ClientConnector clientConnector, SocketAddress address, EndPoint endPoint, Map<String,Object> context) throws IOException