Package org.eclipse.jetty.io

Class ClientConnector.Configurator

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.io.ClientConnector.Configurator

All Implemented Interfaces:

Container, Destroyable, Dumpable, Dumpable.DumpableContainer, LifeCycle

Direct Known Subclasses:

QuicClientConnectorConfigurator

Enclosing class:

ClientConnector

public static class ClientConnector.Configurator
extends ContainerLifeCycle

Configures a ClientConnector.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ClientConnector.Configurator.ChannelWithAddress	A pair/record holding a SelectableChannel and a SocketAddress to connect to.

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener, AbstractLifeCycle.StopException

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Container

Container.InheritedListener, Container.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Dumpable

Dumpable.DumpableContainer

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Field Summary

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, STARTED, STARTING, STOPPED, STOPPING

Fields inherited from interface org.eclipse.jetty.util.component.Dumpable

KEY

Constructor Summary

Constructors

Constructor	Description
Configurator()

Method Summary

Modifier and Type	Method	Description
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 org.eclipse.jetty.util.component.ContainerLifeCycle

addBean, addBean, addEventListener, addManaged, contains, destroy, doStart, doStop, dump, dump, dump, dumpObjects, dumpStdErr, getBean, getBeans, getBeans, getContainedBeans, getContainedBeans, isAuto, isManaged, isUnmanaged, manage, removeBean, removeBeans, removeEventListener, setBeans, start, stop, unmanage, updateBean, updateBean, updateBeans, updateBeans

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

getEventListeners, getState, getState, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, setEventListeners, start, stop, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.util.component.Container

getCachedBeans, getEventListeners

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable

dumpSelf

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable.DumpableContainer

isDumpable

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.

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

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.

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)

newConnection

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

Throws:

IOException