org.eclipse.jetty.server

Interface ConnectionFactory.Upgrading

All Superinterfaces:

ConnectionFactory

Enclosing interface:

ConnectionFactory

public static interface ConnectionFactory.Upgrading
extends ConnectionFactory

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.jetty.server.ConnectionFactory

ConnectionFactory.Upgrading

Method Summary

Modifier and Type	Method and Description
Connection	upgradeConnection(Connector connector, EndPoint endPoint, MetaData.Request upgradeRequest, HttpFields responseFields) Create a connection for an upgrade request.

Methods inherited from interface org.eclipse.jetty.server.ConnectionFactory

getProtocol, getProtocols, newConnection

Method Detail

upgradeConnection

Connection upgradeConnection(Connector connector,
                             EndPoint endPoint,
                             MetaData.Request upgradeRequest,
                             HttpFields responseFields)
                      throws BadMessageException

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.

Parameters:

connector - The connector to upgrade for.

endPoint - The endpoint of the connection.

upgradeRequest - The meta data of the upgrade request.

responseFields - 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.