Module org.eclipse.jetty.server

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.Configuring, ConnectionFactory.Detecting, 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.Mutable responseFields)	Create a connection for an upgrade request.

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

getProtocol, getProtocols, newConnection

Method Details

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