Package org.eclipse.jetty.server

Interface ConnectionFactory

All Known Subinterfaces:

ConnectionFactory.Upgrading

All Known Implementing Classes:

AbstractConnectionFactory, HttpConnectionFactory, NegotiatingServerConnectionFactory, ProxyConnectionFactory, 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 a HTTP connection that can handle multiple versions of HTTP from 0.9 to 1.1

h2

Creates a 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 a 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.Upgrading

Method Summary

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