Package org.eclipse.jetty.quic.client

Class QuicClientConnectorConfigurator

java.lang.Object

org.eclipse.jetty.io.ClientConnector.Configurator

org.eclipse.jetty.quic.client.QuicClientConnectorConfigurator

public class QuicClientConnectorConfigurator
extends ClientConnector.Configurator

A QUIC specific ClientConnector.Configurator.

Since QUIC is based on UDP, this class creates DatagramChannels instead of SocketChannels, and DatagramChannelEndPoints instead of SocketChannelEndPoints.

See Also:

• QuicConfiguration

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.io.ClientConnector.Configurator

ClientConnector.Configurator.ChannelWithAddress

Constructor Summary

Constructors

Constructor	Description
QuicClientConnectorConfigurator()
QuicClientConnectorConfigurator(UnaryOperator<Connection> configurator)

Method Summary

Modifier and Type	Method	Description
QuicConfiguration	getQuicConfiguration()
boolean	isIntrinsicallySecure(ClientConnector clientConnector, SocketAddress address)	Returns whether the connection to a given SocketAddress is intrinsically secure.
ClientConnector.Configurator.ChannelWithAddress	newChannelWithAddress(ClientConnector clientConnector, SocketAddress address, Map<String,Object> context)	Creates a new SocketChannel to connect to a SocketAddress derived from the input socket address.
Connection	newConnection(ClientConnector clientConnector, SocketAddress address, EndPoint endPoint, Map<String,Object> context)
EndPoint	newEndPoint(ClientConnector clientConnector, SocketAddress address, SelectableChannel selectable, ManagedSelector selector, SelectionKey selectionKey)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

QuicClientConnectorConfigurator

public QuicClientConnectorConfigurator()

QuicClientConnectorConfigurator

public QuicClientConnectorConfigurator(UnaryOperator<Connection> configurator)

Method Details

getQuicConfiguration

public QuicConfiguration getQuicConfiguration()

isIntrinsicallySecure

public boolean isIntrinsicallySecure(ClientConnector clientConnector,
 SocketAddress address)

Description copied from class: ClientConnector.Configurator

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.

Overrides:

isIntrinsicallySecure in class ClientConnector.Configurator

Parameters:

clientConnector - the ClientConnector

address - the SocketAddress to connect to

Returns:

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

Description copied from class: ClientConnector.Configurator

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.

Overrides:

newChannelWithAddress in class ClientConnector.Configurator

Parameters:

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

Returns:

a new SocketChannel with an associated SocketAddress to connect to

Throws:

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)

Overrides:

newEndPoint in class ClientConnector.Configurator

newConnection

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

Overrides:

newConnection in class ClientConnector.Configurator