Destination (Jetty :: Project 9.4.56.v20240826 API)

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

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	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