io.netty.handler.codec.http2

Class Http2ClientUpgradeCodec

java.lang.Object

io.netty.handler.codec.http2.Http2ClientUpgradeCodec

All Implemented Interfaces:

HttpClientUpgradeHandler.UpgradeCodec

@UnstableApi
public class Http2ClientUpgradeCodec
extends java.lang.Object
implements HttpClientUpgradeHandler.UpgradeCodec

Client-side cleartext upgrade codec from HTTP to HTTP/2.

Constructor Summary

Constructors

Constructor and Description
Http2ClientUpgradeCodec(Http2ConnectionHandler connectionHandler) Creates the codec using a default name for the connection handler when adding to the pipeline.
Http2ClientUpgradeCodec(Http2FrameCodec frameCodec, ChannelHandler upgradeToHandler)
Http2ClientUpgradeCodec(java.lang.String handlerName, Http2ConnectionHandler connectionHandler) Creates the codec providing an upgrade to the given handler for HTTP/2.
Http2ClientUpgradeCodec(java.lang.String handlerName, Http2FrameCodec frameCodec, ChannelHandler upgradeToHandler)

Method Summary

Modifier and Type	Method and Description
java.lang.CharSequence	protocol() Returns the name of the protocol supported by this codec, as indicated by the 'UPGRADE' header.
java.util.Collection<java.lang.CharSequence>	setUpgradeHeaders(ChannelHandlerContext ctx, HttpRequest upgradeRequest) Sets any protocol-specific headers required to the upgrade request.
void	upgradeTo(ChannelHandlerContext ctx, FullHttpResponse upgradeResponse) Performs an HTTP protocol upgrade from the source codec.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Http2ClientUpgradeCodec

public Http2ClientUpgradeCodec(Http2FrameCodec frameCodec,
                               ChannelHandler upgradeToHandler)

Http2ClientUpgradeCodec

public Http2ClientUpgradeCodec(java.lang.String handlerName,
                               Http2FrameCodec frameCodec,
                               ChannelHandler upgradeToHandler)

Http2ClientUpgradeCodec

public Http2ClientUpgradeCodec(Http2ConnectionHandler connectionHandler)

Creates the codec using a default name for the connection handler when adding to the pipeline.

Parameters:

connectionHandler - the HTTP/2 connection handler

Http2ClientUpgradeCodec

public Http2ClientUpgradeCodec(java.lang.String handlerName,
                               Http2ConnectionHandler connectionHandler)

Creates the codec providing an upgrade to the given handler for HTTP/2.

Parameters:

handlerName - the name of the HTTP/2 connection handler to be used in the pipeline, or null to auto-generate the name

connectionHandler - the HTTP/2 connection handler

Method Detail

protocol

public java.lang.CharSequence protocol()

Description copied from interface: HttpClientUpgradeHandler.UpgradeCodec

Returns the name of the protocol supported by this codec, as indicated by the 'UPGRADE' header.

Specified by:

protocol in interface HttpClientUpgradeHandler.UpgradeCodec

setUpgradeHeaders

public java.util.Collection<java.lang.CharSequence> setUpgradeHeaders(ChannelHandlerContext ctx,
                                                                      HttpRequest upgradeRequest)

Description copied from interface: HttpClientUpgradeHandler.UpgradeCodec

Sets any protocol-specific headers required to the upgrade request. Returns the names of all headers that were added. These headers will be used to populate the CONNECTION header.

Specified by:

setUpgradeHeaders in interface HttpClientUpgradeHandler.UpgradeCodec

upgradeTo

public void upgradeTo(ChannelHandlerContext ctx,
                      FullHttpResponse upgradeResponse)
               throws java.lang.Exception

Description copied from interface: HttpClientUpgradeHandler.UpgradeCodec

Performs an HTTP protocol upgrade from the source codec. This method is responsible for adding all handlers required for the new protocol.

Specified by:

upgradeTo in interface HttpClientUpgradeHandler.UpgradeCodec

Parameters:

ctx - the context for the current handler.

upgradeResponse - the 101 Switching Protocols response that indicates that the server has switched to this protocol.

Throws:

java.lang.Exception