ConnectionFactory (Jetty :: Project 9.4.56.v20240826 API)

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 create Connection instances for Connectors.
A Connection factory is responsible for instantiating and configuring a Connection instance to handle an EndPoint accepted by a Connector.
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 implement `Connection.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 new `Connection` 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 - The Connector creating this connection
    
    endPoint - the EndPoint associated with the connection
    
    Returns:
    
    a new Connection