Package org.eclipse.jetty.io

Class Transport.Wrapper

java.lang.Object

org.eclipse.jetty.io.Transport.Wrapper

All Implemented Interfaces:

Transport

Direct Known Subclasses:

QuicTransport

Enclosing interface:

Transport

public static class Transport.Wrapper
extends Object
implements Transport

A wrapper for Transport instances to allow layering of Transports.

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.jetty.io.Transport

Transport.IP, Transport.Socket, Transport.TCPIP, Transport.TCPUnix, Transport.UDPIP, Transport.UDPUnix, Transport.Unix, Transport.Wrapper

Field Summary

Fields inherited from interface org.eclipse.jetty.io.Transport

TCP_IP, UDP_IP

Constructor Summary

Constructors

Constructor	Description
Wrapper(Transport wrapped)

Method Summary

Modifier and Type	Method	Description
void	connect(SocketAddress socketAddress, Map<String,Object> context)	Establishes a connection to the given socket address.
SocketAddress	getSocketAddress()
Transport	getWrapped()
boolean	isIntrinsicallySecure()
Connection	newConnection(EndPoint endPoint, Map<String,Object> context)	Creates a new Connection to be associated with the given low-level EndPoint.
EndPoint	newEndPoint(Scheduler scheduler, ManagedSelector selector, SelectableChannel selectable, SelectionKey selectionKey)	For Transports that are based on sockets, or for Transports that are layered on top of another Transport that is based on sockets, this method is invoked to create a new EndPoint that wraps the SelectableChannel created by Transport.newSelectableChannel().
SelectableChannel	newSelectableChannel()	For Transports that are based on sockets, or for Transports that are layered on top of another Transport that is based on sockets, this method is invoked to create a new SelectableChannel used for the socket communication.
boolean	requiresDomainNameResolution()	Returns whether this Transport requires resolution of domain names.
String	toString()
Transport	unwrap()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.io.Transport

equals, hashCode

Constructor Details

Wrapper

public Wrapper(Transport wrapped)

Method Details

getWrapped

public Transport getWrapped()

unwrap

public Transport unwrap()

isIntrinsicallySecure

public boolean isIntrinsicallySecure()

Specified by:

isIntrinsicallySecure in interface Transport

Returns:

whether this Transport is intrinsically secure.

requiresDomainNameResolution

public boolean requiresDomainNameResolution()

Description copied from interface: Transport

Returns whether this Transport requires resolution of domain names.

When domain name resolution is required, it must be performed by an external service, and the value returned by Transport.getSocketAddress() is ignored, while the resolved socket address is eventually passed to Transport.connect(SocketAddress, Map). Otherwise, domain name resolution is not required, and the value returned by Transport.getSocketAddress() is eventually passed to Transport.connect(SocketAddress, Map).

Specified by:

requiresDomainNameResolution in interface Transport

Returns:

whether this Transport requires domain names resolution

connect

public void connect(SocketAddress socketAddress,
 Map<String,Object> context)

Description copied from interface: Transport

Establishes a connection to the given socket address.

For Transports that require domain name resolution, this is the IP address resolved from the domain name. For Transports that do not require domain name resolution (for example Unix-Domain sockets, or memory) this is the socket address to connect to.

Specified by:

connect in interface Transport

Parameters:

socketAddress - the socket address to connect to

context - the context information to establish the connection

getSocketAddress

public SocketAddress getSocketAddress()

Specified by:

getSocketAddress in interface Transport

Returns:

the socket address to connect to in case domain name resolution is not required

newSelectableChannel

public SelectableChannel newSelectableChannel()
                                       throws IOException

Description copied from interface: Transport

For Transports that are based on sockets, or for Transports that are layered on top of another Transport that is based on sockets, this method is invoked to create a new SelectableChannel used for the socket communication.

Specified by:

newSelectableChannel in interface Transport

Returns:

a new SelectableChannel used for the socket communication, or null if the communication does not use sockets.

Throws:

IOException - if the SelectableChannel cannot be created

newEndPoint

public EndPoint newEndPoint(Scheduler scheduler,
 ManagedSelector selector,
 SelectableChannel selectable,
 SelectionKey selectionKey)

Description copied from interface: Transport

For Transports that are based on sockets, or for Transports that are layered on top of another Transport that is based on sockets, this method is invoked to create a new EndPoint that wraps the SelectableChannel created by Transport.newSelectableChannel().

Specified by:

newEndPoint in interface Transport

Parameters:

scheduler - the Scheduler

selector - the ManagedSelector

selectable - the SelectableChannel

selectionKey - the SelectionKey

Returns:

a new EndPoint

newConnection

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

Description copied from interface: Transport

Creates a new Connection to be associated with the given low-level EndPoint.

For non-layered Transports such as TCP/IP, the Connection is typically that of the high-level protocol. For layered Transports such as QUIC, the Connection is typically that of the layered Transport.

Specified by:

newConnection in interface Transport

Parameters:

endPoint - the EndPoint to associate the Connection to

context - the context information to create the connection

Returns:

a new Connection

Throws:

IOException - if the Connection cannot be created

toString

public String toString()

Overrides:

toString in class Object