Module org.eclipse.jetty.client

Package org.eclipse.jetty.client

Class AbstractHttpClientTransport

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.client.AbstractHttpClientTransport

All Implemented Interfaces:

HttpClient.Aware, HttpClientTransport, org.eclipse.jetty.io.ClientConnectionFactory, org.eclipse.jetty.util.component.Container, org.eclipse.jetty.util.component.Destroyable, org.eclipse.jetty.util.component.Dumpable, org.eclipse.jetty.util.component.Dumpable.DumpableContainer, org.eclipse.jetty.util.component.LifeCycle, org.eclipse.jetty.util.thread.Invocable

Direct Known Subclasses:

AbstractConnectorHttpClientTransport

@ManagedObject
public abstract class AbstractHttpClientTransport
extends org.eclipse.jetty.util.component.ContainerLifeCycle
implements HttpClientTransport

Nested Class Summary

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

org.eclipse.jetty.util.component.AbstractLifeCycle.AbstractLifeCycleListener, org.eclipse.jetty.util.component.AbstractLifeCycle.StopException

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

org.eclipse.jetty.io.ClientConnectionFactory.Decorator, org.eclipse.jetty.io.ClientConnectionFactory.Info

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

org.eclipse.jetty.util.component.Container.InheritedListener, org.eclipse.jetty.util.component.Container.Listener

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

org.eclipse.jetty.util.component.Dumpable.DumpableContainer

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

org.eclipse.jetty.util.thread.Invocable.Callable, org.eclipse.jetty.util.thread.Invocable.InvocationType, org.eclipse.jetty.util.thread.Invocable.ReadyTask, org.eclipse.jetty.util.thread.Invocable.Task

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

org.eclipse.jetty.util.component.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.io.ClientConnectionFactory

CLIENT_CONTEXT_KEY

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

KEY

Fields inherited from interface org.eclipse.jetty.client.HttpClientTransport

HTTP_CONNECTION_PROMISE_CONTEXT_KEY, HTTP_DESTINATION_CONTEXT_KEY

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

__nonBlocking, NOOP

Constructor Summary

Constructors

Constructor	Description
AbstractHttpClientTransport()

Method Summary

Modifier and Type	Method	Description
protected void	connectFailed(Map<String,Object> context, Throwable failure)
ConnectionPool.Factory	getConnectionPoolFactory()
protected HttpClient	getHttpClient()
org.eclipse.jetty.util.thread.Invocable.InvocationType	getInvocationType()
void	setConnectionPoolFactory(ConnectionPool.Factory factory)	Set the factory for ConnectionPool instances.
void	setHttpClient(HttpClient client)	Sets the HttpClient instance on this transport.
void	setInvocationType(org.eclipse.jetty.util.thread.Invocable.InvocationType invocationType)	Sets the Invocable.InvocationType associated with this HttpClientTransport.

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

addBean, addBean, addEventListener, addManaged, contains, destroy, doStart, doStop, dump, dump, dump, dumpObjects, dumpStdErr, getBean, getBeans, getBeans, getContainedBeans, getContainedBeans, installBean, installBean, 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, toString

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

customize, newConnection

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

getCachedBeans, getEventListeners

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

dumpSelf

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

isDumpable

Methods inherited from interface org.eclipse.jetty.client.HttpClientTransport

connect, newDestination, newOrigin

Constructor Details

AbstractHttpClientTransport

public AbstractHttpClientTransport()

Method Details

getHttpClient

protected HttpClient getHttpClient()

setHttpClient

public void setHttpClient(HttpClient client)

Description copied from interface: HttpClientTransport

Sets the HttpClient instance on this transport.

This is needed because of a chicken-egg problem: in order to create the HttpClient a HttpClientTransport is needed, that therefore cannot have a reference yet to the HttpClient.

Specified by:

setHttpClient in interface HttpClient.Aware

Specified by:

setHttpClient in interface HttpClientTransport

Parameters:

client - the HttpClient that uses this transport.

getConnectionPoolFactory

public ConnectionPool.Factory getConnectionPoolFactory()

Specified by:

getConnectionPoolFactory in interface HttpClientTransport

Returns:

the factory for ConnectionPool instances

setConnectionPoolFactory

public void setConnectionPoolFactory(ConnectionPool.Factory factory)

Description copied from interface: HttpClientTransport

Set the factory for ConnectionPool instances.

Specified by:

setConnectionPoolFactory in interface HttpClientTransport

Parameters:

factory - the factory for ConnectionPool instances

connectFailed

protected void connectFailed(Map<String,Object> context,
 Throwable failure)

getInvocationType

public org.eclipse.jetty.util.thread.Invocable.InvocationType getInvocationType()

Specified by:

getInvocationType in interface HttpClientTransport

Specified by:

getInvocationType in interface org.eclipse.jetty.util.thread.Invocable

Returns:

the Invocable.InvocationType associated with this HttpClientTransport.

See Also:

• HttpClientTransport.setInvocationType(InvocationType)

setInvocationType

public void setInvocationType(org.eclipse.jetty.util.thread.Invocable.InvocationType invocationType)

Description copied from interface: HttpClientTransport

Sets the Invocable.InvocationType associated with this HttpClientTransport.

The values are typically either:

• Invocable.InvocationType.BLOCKING, to indicate that response listeners are executing blocking code, for example blocking network I/O, JDBC, etc.
• Invocable.InvocationType.NON_BLOCKING, to indicate that response listeners are executing non-blocking code.

By default, the value is Invocable.InvocationType.BLOCKING.

A response listener declared to be Invocable.InvocationType.BLOCKING incurs in one additional context switch, where the NIO processing thread delegates the response processing to another thread. This ensures that the NIO processing thread can immediately continue with other NIO processing activities, if any (for example, processing another connection). This also means that processing of different connections is parallelized.

Invocable.InvocationType.BLOCKING must be used when you want response listeners to be invoked by virtual threads.

On the other hand, a response listener declared to be Invocable.InvocationType.NON_BLOCKING does not incur in the additional context switch, and therefore it is potentially more efficient. However, the processing of different connections is serialized, which means that the last connection will be processed only after the previous connections (and their respective response listeners) have been processed.

A response listener declared to be Invocable.InvocationType.NON_BLOCKING, but then executing blocking code, will block the NIO processing performed by HttpClient's implementation: the current connection and possibly other connections will not be further processed, until the blocking response listener returns.

Specified by:

setInvocationType in interface HttpClientTransport

Parameters:

invocationType - the Invocable.InvocationType associated with this HttpClientTransport.

See Also:

• HttpClientTransport.getInvocationType()