Package 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	Description
org.eclipse.jetty.io.Connection	upgradeConnection(Connector connector, org.eclipse.jetty.io.EndPoint endPoint, org.eclipse.jetty.http.MetaData.Request upgradeRequest, org.eclipse.jetty.http.HttpFields responseFields)	Create a connection for an upgrade request.

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

getProtocol, getProtocols, newConnection

Method Detail

upgradeConnection

org.eclipse.jetty.io.Connection upgradeConnection(Connector connector,
                                                  org.eclipse.jetty.io.EndPoint endPoint,
                                                  org.eclipse.jetty.http.MetaData.Request upgradeRequest,
                                                  org.eclipse.jetty.http.HttpFields responseFields)
                                           throws org.eclipse.jetty.http.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:

org.eclipse.jetty.http.BadMessageException - Thrown to indicate the upgrade attempt was illegal and that a bad message response should be sent.