Module org.eclipse.jetty.io

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:

org.eclipse.jetty.util.component.Container, org.eclipse.jetty.util.component.Destroyable, org.eclipse.jetty.util.component.Dumpable, org.eclipse.jetty.util.component.Dumpable.DumpableContainer, org.eclipse.jetty.util.component.LifeCycle

Enclosing class:

ClientConnector

@Deprecated(since="12.0.7",
            forRemoval=true)
public static class ClientConnector.Configurator
extends org.eclipse.jetty.util.component.ContainerLifeCycle

Deprecated, for removal: This API element is subject to removal in a future version.

replaced by Transport

Configures a ClientConnector.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ClientConnector.Configurator.ChannelWithAddress	Deprecated, for removal: This API element is subject to removal in a future version. replaced by Transport

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

org.eclipse.jetty.util.component.AbstractLifeCycle.AbstractLifeCycleListener, org.eclipse.jetty.util.component.AbstractLifeCycle.StopException

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

org.eclipse.jetty.util.component.Container.InheritedListener, org.eclipse.jetty.util.component.Container.Listener

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

org.eclipse.jetty.util.component.Dumpable.DumpableContainer

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

org.eclipse.jetty.util.component.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()	Deprecated, for removal: This API element is subject to removal in a future version.

Method Summary

Modifier and Type	Method	Description
boolean	isIntrinsicallySecure(ClientConnector clientConnector, SocketAddress address)	Deprecated, for removal: This API element is subject to removal in a future version. Returns whether the connection to a given SocketAddress is intrinsically secure.
ClientConnector.Configurator.ChannelWithAddress	newChannelWithAddress(ClientConnector clientConnector, SocketAddress address, Map<String,Object> context)	Deprecated, for removal: This API element is subject to removal in a future version. 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)	Deprecated, for removal: This API element is subject to removal in a future version.
EndPoint	newEndPoint(ClientConnector clientConnector, SocketAddress address, SelectableChannel selectable, ManagedSelector selector, SelectionKey selectionKey)	Deprecated, for removal: This API element is subject to removal in a future version.
Transport	newTransport()	Deprecated, for removal: This API element is subject to removal in a future version.

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()

Deprecated, for removal: This API element is subject to removal in a future version.

Method Details

newTransport

public Transport newTransport()

Deprecated, for removal: This API element is subject to removal in a future version.

Returns:

the default Transport for this configurator

isIntrinsicallySecure

public boolean isIntrinsicallySecure(ClientConnector clientConnector,
 SocketAddress address)

Deprecated, for removal: This API element is subject to removal in a future version.

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

Deprecated, for removal: This API element is subject to removal in a future version.

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)

Deprecated, for removal: This API element is subject to removal in a future version.

newConnection

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

Deprecated, for removal: This API element is subject to removal in a future version.

Throws:

IOException