Module org.eclipse.jetty.server
Package org.eclipse.jetty.server

Interface ConnectionFactory

  • All Known Subinterfaces:
    ConnectionFactory.Upgrading
    All Known Implementing Classes:
    AbstractConnectionFactory, HttpConnectionFactory, NegotiatingServerConnectionFactory, OptionalSslConnectionFactory, 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 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.

    • 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

        org.eclipse.jetty.io.Connection newConnection​(Connector connector,
                                              org.eclipse.jetty.io.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