ApplicationProtocolNegotiationHandler (Netty API Reference (4.1.22.Final))

java.lang.Object
- io.netty.channel.ChannelHandlerAdapter
- - io.netty.channel.ChannelInboundHandlerAdapter
  - - io.netty.handler.ssl.ApplicationProtocolNegotiationHandler

All Implemented Interfaces:: ChannelHandler ， ChannelInboundHandler

public abstract class ApplicationProtocolNegotiationHandler
extends ChannelInboundHandlerAdapter

配置一个ChannelPipeline取决于应用层协议协商结果SslHandler 。例如，您可以根据ALPN的结果来配置HTTP管道：

  public class MyInitializer extends ChannelInitializer<Channel> {
     private final SslContext sslCtx;

     public MyInitializer(SslContext sslCtx) {
         this.sslCtx = sslCtx;
     }

     protected void initChannel(Channel ch) {
         ChannelPipeline p = ch.pipeline();
         p.addLast(sslCtx.newHandler(...)); // Adds SslHandler
         p.addLast(new MyNegotiationHandler());
     }
 }

 public class MyNegotiationHandler extends ApplicationProtocolNegotiationHandler {
     public MyNegotiationHandler() {
         super(ApplicationProtocolNames.HTTP_1_1);
     }

     protected void configurePipeline(ChannelHandlerContext ctx, String protocol) {
         if (ApplicationProtocolNames.HTTP_2.equals(protocol) {
             configureHttp2(ctx);
         } else if (ApplicationProtocolNames.HTTP_1_1.equals(protocol)) {
             configureHttp1(ctx);
         } else {
             throw new IllegalStateException("unknown protocol: " + protocol);
         }
     }
 }

Nested Class Summary
- Nested classes/interfaces inherited from interface io.netty.channel.ChannelHandler
  ChannelHandler.Sharable

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`ApplicationProtocolNegotiationHandler(java.lang.String fallbackProtocol)` 使用指定的回退协议名称创建新实例。

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`protected abstract void`	`configurePipeline(ChannelHandlerContext ctx, java.lang.String protocol)` 调用成功的初始SSL / TLS握手。
`void`	`exceptionCaught(ChannelHandlerContext ctx, java.lang.Throwable cause)` 致电`ChannelHandlerContext.fireExceptionCaught(Throwable)`转发到`ChannelPipeline`中的下一个`ChannelHandler` 。
`protected void`	`handshakeFailure(ChannelHandlerContext ctx, java.lang.Throwable cause)` 在失败的初始SSL / TLS握手中调用。
`void`	`userEventTriggered(ChannelHandlerContext ctx, java.lang.Object evt)` 致电`ChannelHandlerContext.fireUserEventTriggered(Object)`转发到`ChannelPipeline`中的下一个`ChannelInboundHandler` 。

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter
channelActive, channelInactive, channelRead, channelReadComplete, channelRegistered, channelUnregistered, channelWritabilityChanged

Methods inherited from class io.netty.channel.ChannelHandlerAdapter
ensureNotSharable, handlerAdded, handlerRemoved, isSharable

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.netty.channel.ChannelHandler
handlerAdded, handlerRemoved

- 构造方法详细信息
  - ApplicationProtocolNegotiationHandler
```
protected ApplicationProtocolNegotiationHandler(java.lang.String fallbackProtocol)
```
    使用指定的回退协议名称创建新实例。
    
    参数
    
    fallbackProtocol - ALPN / NPN协商失败或客户端不支持ALPN / NPN时使用的协议名称
- 方法详细信息
  - userEventTriggered
```
public void userEventTriggered(ChannelHandlerContext ctx,
                               java.lang.Object evt)
                        throws java.lang.Exception
```
    从类复制的描述： ChannelInboundHandlerAdapter
    
    致电ChannelHandlerContext.fireUserEventTriggered(Object)转发到ChannelPipeline中的下一个ChannelInboundHandler 。子类可以重写此方法来更改行为。
    
    Specified by:
    
    userEventTriggered ，界面 ChannelInboundHandler
    
    重写：
    
    userEventTriggered ChannelInboundHandlerAdapter
    
    异常
    
    java.lang.Exception
  - configurePipeline
```
protected abstract void configurePipeline(ChannelHandlerContext ctx,
                                          java.lang.String protocol)
                                   throws java.lang.Exception
```
    调用成功的初始SSL / TLS握手。实现这种方法来为协商的应用程序级协议配置流水线。
    
    参数
    
    protocol - 协商失败或客户端不知道ALPN / NPN扩展的协商应用程序级协议的名称或构造函数调用中指定的回退协议名称
    
    异常
    
    java.lang.Exception
  - handshakeFailure
```
protected void handshakeFailure(ChannelHandlerContext ctx,
                                java.lang.Throwable cause)
                         throws java.lang.Exception
```
    在失败的初始SSL / TLS握手中调用。
    
    异常
    
    java.lang.Exception
  - exceptionCaught
```
public void exceptionCaught(ChannelHandlerContext ctx,
                            java.lang.Throwable cause)
                     throws java.lang.Exception
```
    从类复制的描述： ChannelInboundHandlerAdapter
    
    致电ChannelHandlerContext.fireExceptionCaught(Throwable)转发到ChannelPipeline中的下一个ChannelHandler 。子类可以重写此方法来更改行为。
    
    Specified by:
    
    exceptionCaught在界面 ChannelHandler
    
    Specified by:
    
    exceptionCaught在界面 ChannelInboundHandler
    
    重写：
    
    exceptionCaught在课堂上 ChannelInboundHandlerAdapter
    
    异常
    
    java.lang.Exception

Class ApplicationProtocolNegotiationHandler

Nested Class Summary

Nested classes/interfaces inherited from interface io.netty.channel.ChannelHandler

构造方法摘要

方法摘要

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

Methods inherited from class java.lang.Object

Methods inherited from interface io.netty.channel.ChannelHandler

构造方法详细信息

ApplicationProtocolNegotiationHandler

方法详细信息

userEventTriggered

configurePipeline

handshakeFailure

exceptionCaught