Class HTTP2CServerConnectionFactory

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.server.AbstractConnectionFactory

org.eclipse.jetty.http2.server.AbstractHTTP2ServerConnectionFactory

org.eclipse.jetty.http2.server.HTTP2ServerConnectionFactory

org.eclipse.jetty.http2.server.HTTP2CServerConnectionFactory

All Implemented Interfaces:

ConnectionFactory, ConnectionFactory.Upgrading, NegotiatingServerConnection.CipherDiscriminator, Container, Destroyable, Dumpable, Dumpable.DumpableContainer, LifeCycle

public class HTTP2CServerConnectionFactory
extends HTTP2ServerConnectionFactory
implements ConnectionFactory.Upgrading

HTTP2 Clear Text Connection factory.

This extension of HTTP2ServerConnection Factory sets the protocol name to "h2c" as used by the clear text upgrade mechanism for HTTP2 and marks all TLS ciphers as unacceptable.

If used in combination with a HttpConnectionFactory as the default protocol, this factory can support the non-standard direct update mechanism, where an HTTP1 request of the form "PRI * HTTP/2.0" is used to trigger a switch to an HTTP2 connection. This approach allows a single port to accept either HTTP/1 or HTTP/2 direct connections.

Nested Class Summary

Nested classes/interfaces inherited from class HTTP2ServerConnectionFactory

HTTP2ServerConnectionFactory.HTTPServerSessionListener

Nested classes/interfaces inherited from class AbstractHTTP2ServerConnectionFactory

AbstractHTTP2ServerConnectionFactory.HTTP2SessionContainer

Nested classes/interfaces inherited from class AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener, AbstractLifeCycle.StopException

Nested classes/interfaces inherited from interface ConnectionFactory

ConnectionFactory.Configuring, ConnectionFactory.Detecting, ConnectionFactory.Upgrading

Nested classes/interfaces inherited from interface Container

Container.InheritedListener, Container.Listener

Nested classes/interfaces inherited from interface Dumpable

Dumpable.DumpableContainer

Nested classes/interfaces inherited from interface LifeCycle

LifeCycle.Listener

Field Summary

Fields inherited from class AbstractLifeCycle

FAILED, STARTED, STARTING, STOPPED, STOPPING

Fields inherited from interface Dumpable

KEY

Constructor Summary

Constructors

Constructor	Description
HTTP2CServerConnectionFactory()
HTTP2CServerConnectionFactory(HttpConfiguration httpConfiguration)
HTTP2CServerConnectionFactory(HttpConfiguration httpConfiguration, String... protocols)

Method Summary

Modifier and Type	Method	Description
boolean	isAcceptable(String protocol, String tlsProtocol, String tlsCipher)
Connection	upgradeConnection(Connector connector, EndPoint endPoint, MetaData.Request request, HttpFields.Mutable response101)	Create a connection for an upgrade request.

Methods inherited from class HTTP2ServerConnectionFactory

newSessionListener

Methods inherited from class AbstractHTTP2ServerConnectionFactory

getFlowControlStrategyFactory, getHttpConfiguration, getInitialSessionRecvWindow, getInitialStreamRecvWindow, getMaxConcurrentStreams, getMaxDecoderTableCapacity, getMaxEncoderTableCapacity, getMaxFrameSize, getMaxHeaderBlockFragment, getMaxSettingsKeys, getRateControlFactory, getStreamIdleTimeout, isConnectProtocolEnabled, isUseInputDirectByteBuffers, isUseOutputDirectByteBuffers, newConnection, newSettings, setConnectProtocolEnabled, setFlowControlStrategyFactory, setInitialSessionRecvWindow, setInitialStreamRecvWindow, setMaxConcurrentStreams, setMaxDecoderTableCapacity, setMaxEncoderTableCapacity, setMaxFrameSize, setMaxHeaderBlockFragment, setMaxSettingsKeys, setRateControlFactory, setStreamIdleTimeout, setUseInputDirectByteBuffers, setUseOutputDirectByteBuffers

Methods inherited from class AbstractConnectionFactory

configure, findNextProtocol, findNextProtocol, getFactories, getInputBufferSize, getProtocol, getProtocols, setInputBufferSize, toString

Methods inherited from class 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 AbstractLifeCycle

getEventListeners, getState, getState, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, setEventListeners, start, stop

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface ConnectionFactory

getProtocol, getProtocols, newConnection

Methods inherited from interface Container

getCachedBeans, getEventListeners

Methods inherited from interface Dumpable

dumpSelf

Methods inherited from interface Dumpable.DumpableContainer

isDumpable

Constructor Details

HTTP2CServerConnectionFactory

public HTTP2CServerConnectionFactory()

HTTP2CServerConnectionFactory

public HTTP2CServerConnectionFactory(@Name("config")
 HttpConfiguration httpConfiguration)

HTTP2CServerConnectionFactory

public HTTP2CServerConnectionFactory(@Name("config")
 HttpConfiguration httpConfiguration,
 @Name("protocols")
 String... protocols)

Method Details

isAcceptable

public boolean isAcceptable(String protocol,
 String tlsProtocol,
 String tlsCipher)

Specified by:

isAcceptable in interface NegotiatingServerConnection.CipherDiscriminator

Overrides:

isAcceptable in class HTTP2ServerConnectionFactory

upgradeConnection

public Connection upgradeConnection(Connector connector,
 EndPoint endPoint,
 MetaData.Request request,
 HttpFields.Mutable response101)
                             throws BadMessageException

Description copied from interface: ConnectionFactory.Upgrading

Create a connection for an upgrade request.

This is a variation of ConnectionFactory.newConnection(Connector, EndPoint) that can create (and/or customise) a connection for an upgrade request. Implementations may call ConnectionFactory.newConnection(Connector, EndPoint) or may construct the connection instance themselves.

Specified by:

upgradeConnection in interface ConnectionFactory.Upgrading

Parameters:

connector - The connector to upgrade for.

endPoint - The endpoint of the connection.

request - The meta data of the upgrade request.

response101 - The fields to be sent with the 101 response

Returns:

Null to indicate that request processing should continue normally without upgrading. A new connection instance to indicate that the upgrade should proceed.

Throws:

BadMessageException - Thrown to indicate the upgrade attempt was illegal and that a bad message response should be sent.