org.eclipse.jetty.client.api

Interface Destination

All Known Implementing Classes:

HttpDestination, HttpDestinationOverFCGI, HttpDestinationOverHTTP, HttpDestinationOverHTTP2, MultiplexHttpDestination, MultiplexHttpDestinationOverFCGI, PoolingHttpDestination

public interface Destination

Destination represents the triple made of the getScheme(), the getHost() and the getPort().

Destination holds a pool of Connections, but allows to create unpooled connections if the application wants full control over connection management via newConnection(Promise).

Destinations may be obtained via HttpClient.getDestination(String, String, int)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getHost()
int	getPort()
java.lang.String	getScheme()
void	newConnection(Promise<Connection> promise) Creates asynchronously a new, unpooled, Connection that will be returned at a later time through the given Promise.

Method Detail

getScheme

java.lang.String getScheme()

Returns:

the scheme of this destination, such as "http" or "https"

getHost

java.lang.String getHost()

Returns:

the host of this destination, such as "127.0.0.1" or "google.com"

getPort

int getPort()

Returns:

the port of this destination such as 80 or 443

newConnection

void newConnection(Promise<Connection> promise)

Creates asynchronously a new, unpooled, Connection that will be returned at a later time through the given Promise.

Use FuturePromise to wait for the connection:

 Destination destination = ...;
 FuturePromise<Connection> futureConnection = new FuturePromise<>();
 destination.newConnection(futureConnection);
 Connection connection = futureConnection.get(5, TimeUnit.SECONDS);
 

Parameters:

promise - the promise of a new, unpooled, Connection