org.eclipse.jetty.client.api

Interface Destination

All Known Implementing Classes:

HttpDestination, HttpDestinationOverFCGI, HttpDestinationOverHTTP, HttpDestinationOverSPDY, 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

Methods

Modifier and Type	Method and Description
String	getHost()
int	getPort()
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

String getScheme()

Returns:

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

getHost

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