ConnectionFactory.Upgrading (Jetty :: Server Core 10.0.0.alpha1 API)

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

All Methods Instance Methods Abstract Methods
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.