Package org.eclipse.jetty.client

Class HttpDestination

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.client.HttpDestination

All Implemented Interfaces:

Closeable, AutoCloseable, Destination, Callback, Container, Destroyable, Dumpable, Dumpable.DumpableContainer, LifeCycle, Invocable, Sweeper.Sweepable

Direct Known Subclasses:

DuplexHttpDestination, MultiplexHttpDestination

@ManagedObject
public abstract class HttpDestination
extends ContainerLifeCycle
implements Destination, Closeable, Callback, Dumpable, Sweeper.Sweepable

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	HttpDestination.Multiplexed

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

AbstractLifeCycle.AbstractLifeCycleListener, AbstractLifeCycle.StopException

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

Callback.Completable, Callback.Completing, Callback.Nested

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

Container.InheritedListener, Container.Listener

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

Dumpable.DumpableContainer

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.thread.Invocable

Invocable.InvocationType, Invocable.ReadyTask, Invocable.Task

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

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.Callback

NOOP

Fields inherited from interface org.eclipse.jetty.util.component.Dumpable

KEY

Fields inherited from interface org.eclipse.jetty.util.thread.Invocable

__nonBlocking

Constructor Summary

Constructors

Constructor	Description
HttpDestination(HttpClient client, Origin origin, boolean intrinsicallySecure)

Method Summary

Modifier and Type	Method	Description
void	abort(Throwable cause)	Aborts all the HttpExchanges queued in this destination.
void	accept(Connection connection)
String	asString()
void	close()
protected void	createConnection(Promise<Connection> promise)
protected void	doStart()	Starts the managed lifecycle beans in the order they were added.
protected void	doStop()	Stops the managed lifecycle beans in the reverse order they were added.
void	dump(Appendable out, String indent)	Dump this object (and children) into an Appendable using the provided indent after any new lines.
protected boolean	enqueue(Queue<HttpExchange> queue, HttpExchange exchange)
void	failed(Throwable x)	Callback invoked when the operation fails.
ClientConnectionFactory	getClientConnectionFactory()
Origin.Address	getConnectAddress()
ConnectionPool	getConnectionPool()
String	getHost()
HttpField	getHostField()
HttpClient	getHttpClient()
Queue<HttpExchange>	getHttpExchanges()
long	getIdle()
Origin	getOrigin()
int	getPort()
ProxyConfiguration.Proxy	getProxy()
int	getQueuedRequestCount()
RequestNotifier	getRequestNotifier()
ResponseNotifier	getResponseNotifier()
String	getScheme()
boolean	isSecure()
boolean	isStale()
void	newConnection(Promise<Connection> promise)	Creates asynchronously a new, unpooled, Connection that will be returned at a later time through the given Promise.
protected ConnectionPool	newConnectionPool(HttpClient client)
protected Queue<HttpExchange>	newExchangeQueue(HttpClient client)
protected ClientConnectionFactory	newSslClientConnectionFactory(SslContextFactory.Client sslContextFactory, ClientConnectionFactory connectionFactory)
void	release(Connection connection)
boolean	remove(Connection connection)
boolean	remove(HttpExchange exchange)
void	send()
void	send(Request request, Response.CompleteListener listener)
void	send(HttpExchange exchange)
protected void	send(HttpRequest request, List<Response.ResponseListener> listeners)
protected SendFailure	send(IConnection connection, HttpExchange exchange)
boolean	stale()
void	succeeded()	Callback invoked when the operation completes.
boolean	sweep()
String	toString()

Methods inherited from class org.eclipse.jetty.util.component.ContainerLifeCycle

addBean, addBean, addEventListener, addManaged, contains, destroy, 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

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.Callback

completeWith

Methods inherited from interface org.eclipse.jetty.util.component.Container

getCachedBeans, getEventListeners

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable

dump, dumpSelf

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable.DumpableContainer

isDumpable

Methods inherited from interface org.eclipse.jetty.util.thread.Invocable

getInvocationType

Constructor Details

HttpDestination

public HttpDestination(HttpClient client,
 Origin origin,
 boolean intrinsicallySecure)

Method Details

accept

public void accept(Connection connection)

stale

public boolean stale()

sweep

public boolean sweep()

Specified by:

sweep in interface Sweeper.Sweepable

Returns:

whether this resource should be swept

doStart

protected void doStart()
                throws Exception

Description copied from class: ContainerLifeCycle

Starts the managed lifecycle beans in the order they were added.

Overrides:

doStart in class ContainerLifeCycle

Throws:

AbstractLifeCycle.StopException - If thrown, the lifecycle will immediately be stopped.

Exception - If there was a problem starting. Will cause a transition to FAILED state

doStop

protected void doStop()
               throws Exception

Description copied from class: ContainerLifeCycle

Stops the managed lifecycle beans in the reverse order they were added.

Overrides:

doStop in class ContainerLifeCycle

Throws:

Exception - If there was a problem stopping. Will cause a transition to FAILED state

newConnectionPool

protected ConnectionPool newConnectionPool(HttpClient client)

newExchangeQueue

protected Queue<HttpExchange> newExchangeQueue(HttpClient client)

newSslClientConnectionFactory

protected ClientConnectionFactory newSslClientConnectionFactory(SslContextFactory.Client sslContextFactory,
 ClientConnectionFactory connectionFactory)

isSecure

public boolean isSecure()

getHttpClient

public HttpClient getHttpClient()

getOrigin

public Origin getOrigin()

getHttpExchanges

public Queue<HttpExchange> getHttpExchanges()

getRequestNotifier

public RequestNotifier getRequestNotifier()

getResponseNotifier

public ResponseNotifier getResponseNotifier()

getProxy

public ProxyConfiguration.Proxy getProxy()

getClientConnectionFactory

public ClientConnectionFactory getClientConnectionFactory()

getScheme

@ManagedAttribute(value="The destination scheme",
                  readonly=true)
public String getScheme()

Specified by:

getScheme in interface Destination

Returns:

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

getHost

@ManagedAttribute(value="The destination host",
                  readonly=true)
public String getHost()

Specified by:

getHost in interface Destination

Returns:

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

getPort

@ManagedAttribute(value="The destination port",
                  readonly=true)
public int getPort()

Specified by:

getPort in interface Destination

Returns:

the port of this destination such as 80 or 443

getQueuedRequestCount

@ManagedAttribute(value="The number of queued requests",
                  readonly=true)
public int getQueuedRequestCount()

getConnectAddress

public Origin.Address getConnectAddress()

getHostField

public HttpField getHostField()

getConnectionPool

@ManagedAttribute(value="The connection pool",
                  readonly=true)
public ConnectionPool getConnectionPool()

succeeded

public void succeeded()

Description copied from interface: Callback

Callback invoked when the operation completes.

Specified by:

succeeded in interface Callback

See Also:

• Callback.failed(Throwable)

failed

public void failed(Throwable x)

Description copied from interface: Callback

Callback invoked when the operation fails.

Specified by:

failed in interface Callback

Parameters:

x - the reason for the operation failure

send

public void send(Request request,
 Response.CompleteListener listener)

send

protected void send(HttpRequest request,
 List<Response.ResponseListener> listeners)

send

public void send(HttpExchange exchange)

enqueue

protected boolean enqueue(Queue<HttpExchange> queue,
 HttpExchange exchange)

send

public void send()

send

protected SendFailure send(IConnection connection,
 HttpExchange exchange)

newConnection

public void newConnection(Promise<Connection> promise)

Description copied from interface: Destination

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

Specified by:

newConnection in interface Destination

Parameters:

promise - the promise of a new, unpooled, Connection

createConnection

protected void createConnection(Promise<Connection> promise)

remove

public boolean remove(HttpExchange exchange)

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

release

public void release(Connection connection)

remove

public boolean remove(Connection connection)

abort

public void abort(Throwable cause)

Aborts all the HttpExchanges queued in this destination.

Parameters:

cause - the abort cause

dump

public void dump(Appendable out,
 String indent)
          throws IOException

Description copied from interface: Dumpable

Dump this object (and children) into an Appendable using the provided indent after any new lines. The indent should not be applied to the first object dumped.

Specified by:

dump in interface Dumpable

Overrides:

dump in class ContainerLifeCycle

Parameters:

out - The appendable to dump to

indent - The indent to apply after any new lines.

Throws:

IOException - if unable to write to Appendable

asString

public String asString()

getIdle

@ManagedAttribute("For how long this destination has been idle in ms")
public long getIdle()

isStale

@ManagedAttribute("Whether this destinations is stale")
public boolean isStale()

toString

public String toString()

Overrides:

toString in class AbstractLifeCycle