Package org.eclipse.jetty.server
Interface ConnectionFactory
-
- All Known Subinterfaces:
ConnectionFactory.Detecting
,ConnectionFactory.Upgrading
- All Known Implementing Classes:
AbstractConnectionFactory
,AbstractHTTP2ServerConnectionFactory
,ALPNServerConnectionFactory
,DetectorConnectionFactory
,HTTP2CServerConnectionFactory
,HTTP2ServerConnectionFactory
,HttpConnectionFactory
,NegotiatingServerConnectionFactory
,OptionalSslConnectionFactory
,ProxyConnectionFactory
,RawHTTP2ServerConnectionFactory
,ServerFCGIConnectionFactory
,SslConnectionFactory
public interface ConnectionFactory
A Factory to createConnection
instances forConnector
s.A Connection factory is responsible for instantiating and configuring a
Connection
instance to handle anEndPoint
accepted by aConnector
.A ConnectionFactory has a protocol name that represents the protocol of the Connections created. Example of protocol names include:
- http
- Creates an HTTP connection that can handle multiple versions of HTTP from 0.9 to 1.1
- h2
- Creates an HTTP/2 connection that handles the HTTP/2 protocol
- SSL-XYZ
- Create an SSL connection chained to a connection obtained from a connection factory with a protocol "XYZ".
- SSL-http
- Create an SSL connection chained to an HTTP connection (aka https)
- SSL-ALPN
- Create an SSL connection chained to a ALPN connection, that uses a negotiation with the client to determine the next protocol.
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static interface
ConnectionFactory.Detecting
Connections created by this factory MUST implementConnection.UpgradeTo
.static interface
ConnectionFactory.Upgrading
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description java.lang.String
getProtocol()
java.util.List<java.lang.String>
getProtocols()
Connection
newConnection(Connector connector, EndPoint endPoint)
Creates a newConnection
with the given parameters
-
-
-
Method Detail
-
getProtocol
java.lang.String getProtocol()
- Returns:
- A string representing the primary protocol name.
-
getProtocols
java.util.List<java.lang.String> getProtocols()
- Returns:
- A list of alternative protocol names/versions including the primary protocol.
-
newConnection
Connection newConnection(Connector connector, EndPoint endPoint)
Creates a new
Connection
with the given parameters- Parameters:
connector
- TheConnector
creating this connectionendPoint
- theEndPoint
associated with the connection- Returns:
- a new
Connection
-
-