AbstractSniHandler (Netty API Reference (4.1.22.Final))

java.lang.Object
- io.netty.channel.ChannelHandlerAdapter
- - io.netty.channel.ChannelInboundHandlerAdapter
  - - io.netty.handler.codec.ByteToMessageDecoder
    - - io.netty.handler.ssl.AbstractSniHandler<T>

All Implemented Interfaces:

ChannelHandler ， ChannelInboundHandler ， ChannelOutboundHandler

已知直接子类：

SniHandler
```
public abstract class AbstractSniHandler<T>
extends ByteToMessageDecoder
implements ChannelOutboundHandler
```
为服务器端SSL启用SNI (Server Name Indication)扩展。对于支持SNI的客户端，服务器可以在单个IP上绑定多个主机名。客户端将在握手数据中发送主机名，以便服务器可以决定为主机名选择哪个证书。

Nested Class Summary
- Nested classes/interfaces inherited from class io.netty.handler.codec.ByteToMessageDecoder
  ByteToMessageDecoder.Cumulator
- Nested classes/interfaces inherited from interface io.netty.channel.ChannelHandler
  ChannelHandler.Sharable

Field Summary
- Fields inherited from class io.netty.handler.codec.ByteToMessageDecoder
  COMPOSITE_CUMULATOR, MERGE_CUMULATOR

构造方法摘要

构造方法
Constructor and Description
`AbstractSniHandler()`

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`void`	`bind(ChannelHandlerContext ctx, java.net.SocketAddress localAddress, ChannelPromise promise)` 调用一次绑定操作。
`void`	`close(ChannelHandlerContext ctx, ChannelPromise promise)` 一旦进行了密切的操作，就会被调用。
`void`	`connect(ChannelHandlerContext ctx, java.net.SocketAddress remoteAddress, java.net.SocketAddress localAddress, ChannelPromise promise)` 连接操作完成后调用。
`protected void`	`decode(ChannelHandlerContext ctx, ByteBuf in, java.util.List<java.lang.Object> out)` 解码从一个`ByteBuf`到另一个。
`void`	`deregister(ChannelHandlerContext ctx, ChannelPromise promise)` 一旦从当前注册的`EventLoop`开始取消注册操作，就会被调用。
`void`	`disconnect(ChannelHandlerContext ctx, ChannelPromise promise)` 调用一次断开操作。
`void`	`flush(ChannelHandlerContext ctx)` 调用一次冲洗操作。
`protected abstract Future<T>`	`lookup(ChannelHandlerContext ctx, java.lang.String hostname)` 开始查找给定的SNI值并返回一个`Future` ，这反过来会在完成时通知`onLookupComplete(ChannelHandlerContext, String, Future)` 。
`protected abstract void`	`onLookupComplete(ChannelHandlerContext ctx, java.lang.String hostname, Future<T> future)` 在完成`lookup(ChannelHandlerContext, String)` `Future`之后调用。
`void`	`read(ChannelHandlerContext ctx)` 拦截 `ChannelHandlerContext.read()` 。
`void`	`write(ChannelHandlerContext ctx, java.lang.Object msg, ChannelPromise promise)` 一旦写入操作被调用，就调用它。

Methods inherited from class io.netty.handler.codec.ByteToMessageDecoder
actualReadableBytes, callDecode, channelInactive, channelRead, channelReadComplete, decodeLast, discardSomeReadBytes, handlerRemoved, handlerRemoved0, internalBuffer, isSingleDecode, setCumulator, setDiscardAfterReads, setSingleDecode, userEventTriggered

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter
channelActive, channelRegistered, channelUnregistered, channelWritabilityChanged, exceptionCaught

Methods inherited from class io.netty.channel.ChannelHandlerAdapter
ensureNotSharable, handlerAdded, 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
exceptionCaught, handlerAdded, handlerRemoved

- 构造方法详细信息
  - AbstractSniHandler
```
public AbstractSniHandler()
```
- 方法详细信息
  - decode
```
protected void decode(ChannelHandlerContext ctx,
                      ByteBuf in,
                      java.util.List<java.lang.Object> out)
               throws java.lang.Exception
```
    从类复制的描述： ByteToMessageDecoder
    
    解码从一个ByteBuf到另一个。该方法将被调用，直到输入ByteBuf在从此方法返回时没有任何可读的内容或直到从输入ByteBuf没有读取任何内容。
    
    Specified by:
    
    decode在课堂上 ByteToMessageDecoder
    
    参数
    
    ctx - ByteToMessageDecoder属于的ChannelHandlerContext
    
    in - 从中读取数据的ByteBuf
    
    out - 应该添加解码消息的 List
    
    异常
    
    java.lang.Exception - 发生错误时抛出
  - lookup
```
protected abstract Future<T> lookup(ChannelHandlerContext ctx,
                                    java.lang.String hostname)
                             throws java.lang.Exception
```
    开始查找给定的SNI值并返回一个Future ，这反过来会在完成时通知onLookupComplete(ChannelHandlerContext, String, Future) 。
    
    异常
    
    java.lang.Exception
    
    另请参见：
    
    onLookupComplete(ChannelHandlerContext, String, Future)
  - onLookupComplete
```
protected abstract void onLookupComplete(ChannelHandlerContext ctx,
                                         java.lang.String hostname,
                                         Future<T> future)
                                  throws java.lang.Exception
```
    在完成lookup(ChannelHandlerContext, String) Future之后调用。
    
    异常
    
    java.lang.Exception
    
    另请参见：
    
    lookup(ChannelHandlerContext, String)
  - read
```
public void read(ChannelHandlerContext ctx)
          throws java.lang.Exception
```
    从界面复制的描述： ChannelOutboundHandler
    
    截取 ChannelHandlerContext.read() 。
    
    Specified by:
    
    read在界面 ChannelOutboundHandler
    
    异常
    
    java.lang.Exception
  - bind
```
public void bind(ChannelHandlerContext ctx,
                 java.net.SocketAddress localAddress,
                 ChannelPromise promise)
          throws java.lang.Exception
```
    从接口ChannelOutboundHandler复制的描述
    
    调用一次绑定操作。
    
    Specified by:
    
    bind在界面 ChannelOutboundHandler
    
    参数
    
    ctx - 为其进行绑定操作的ChannelHandlerContext
    
    localAddress - 它应该绑定的 SocketAddress
    
    promise - 操作完成后通知ChannelPromise
    
    异常
    
    java.lang.Exception - 发生错误时抛出
  - connect
```
public void connect(ChannelHandlerContext ctx,
                    java.net.SocketAddress remoteAddress,
                    java.net.SocketAddress localAddress,
                    ChannelPromise promise)
             throws java.lang.Exception
```
    从界面复制的描述： ChannelOutboundHandler
    
    连接操作完成后调用。
    
    Specified by:
    
    connect在界面 ChannelOutboundHandler
    
    参数
    
    ctx - 进行连接操作的ChannelHandlerContext
    
    remoteAddress - 它应该连接到的 SocketAddress
    
    localAddress - 用作连接源的 SocketAddress
    
    promise - 在操作完成后通知ChannelPromise
    
    异常
    
    java.lang.Exception - 发生错误时抛出
  - disconnect
```
public void disconnect(ChannelHandlerContext ctx,
                       ChannelPromise promise)
                throws java.lang.Exception
```
    从接口复制的描述： ChannelOutboundHandler
    
    调用一次断开操作。
    
    Specified by:
    
    disconnect在界面 ChannelOutboundHandler
    
    参数
    
    ctx - 为其进行断开操作的ChannelHandlerContext
    
    promise - 在操作完成后通知ChannelPromise
    
    异常
    
    java.lang.Exception - 发生错误时抛出
  - close
```
public void close(ChannelHandlerContext ctx,
                  ChannelPromise promise)
           throws java.lang.Exception
```
    从接口复制的描述： ChannelOutboundHandler
    
    一旦进行了密切的操作，就会被调用。
    
    Specified by:
    
    close在界面 ChannelOutboundHandler
    
    参数
    
    ctx - 关闭操作的ChannelHandlerContext
    
    promise - 在操作完成后通知ChannelPromise
    
    异常
    
    java.lang.Exception - 发生错误时抛出
  - deregister
```
public void deregister(ChannelHandlerContext ctx,
                       ChannelPromise promise)
                throws java.lang.Exception
```
    从接口复制的描述： ChannelOutboundHandler
    
    一旦从当前注册的EventLoop开始取消注册操作，就会被调用。
    
    Specified by:
    
    deregister ，界面 ChannelOutboundHandler
    
    参数
    
    ctx - 进行关闭操作的ChannelHandlerContext
    
    promise - 在操作完成后通知ChannelPromise
    
    异常
    
    java.lang.Exception - 发生错误时抛出
  - write
```
public void write(ChannelHandlerContext ctx,
                  java.lang.Object msg,
                  ChannelPromise promise)
           throws java.lang.Exception
```
    从接口ChannelOutboundHandler复制的描述
    
    一旦写入操作被调用，就调用它。写入操作将通过ChannelPipeline写入消息。那么一旦Channel.flush()被调用，那些准备好被刷新到实际的Channel
    
    Specified by:
    
    write ，界面 ChannelOutboundHandler
    
    参数
    
    ctx - 进行写入操作的ChannelHandlerContext
    
    msg - 要写的消息
    
    promise - 在操作完成后通知ChannelPromise
    
    异常
    
    java.lang.Exception - 发生错误时抛出
  - flush
```
public void flush(ChannelHandlerContext ctx)
           throws java.lang.Exception
```
    从接口ChannelOutboundHandler复制的描述
    
    调用一次冲洗操作。刷新操作将尝试清除所有以前写入的待处理消息。
    
    Specified by:
    
    flush接口 ChannelOutboundHandler
    
    参数
    
    ctx - 进行冲洗操作的ChannelHandlerContext
    
    异常
    
    java.lang.Exception - 发生错误时抛出

Class AbstractSniHandler<T>

Nested Class Summary

Nested classes/interfaces inherited from class io.netty.handler.codec.ByteToMessageDecoder

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

Field Summary

Fields inherited from class io.netty.handler.codec.ByteToMessageDecoder

构造方法摘要

方法摘要

Methods inherited from class io.netty.handler.codec.ByteToMessageDecoder

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

构造方法详细信息

AbstractSniHandler

方法详细信息

decode

lookup

onLookupComplete

read

bind

connect

disconnect

close

deregister

write

flush