SslHandler (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.SslHandler

All Implemented Interfaces:

ChannelHandler ， ChannelInboundHandler ， ChannelOutboundHandler
```
public class SslHandler
extends ByteToMessageDecoder
implements ChannelOutboundHandler
```
将SSL · TLS和StartTLS支持添加到Channel 。有关详细用法，请参阅发行版或网站中的“SecureChat”示例。
开始握手

除了使用握手ChannelFuture来获得握手完成的通知之外，还可以通过执行ChannelInboundHandler.userEventTriggered(ChannelHandlerContext, Object)方法来检测它，并检查SslHandshakeCompletionEvent 。

握手

一旦Channel处于活动状态， SSLEngine.getUseClientMode()返回true ，握手将自动发出。所以不需要你自己去打扰它。

结束会议

要关闭SSL会话，应调用close()方法将close_notify消息发送到远程对等方。一个例外是，当您关闭Channel - SslHandler时会截获关闭请求并自动在通道关闭前发送close_notify消息。 SSL会话关闭后，它不可重用，因此您应该创建一个新的SslHandler，并带有新的SSLEngine如下一节所述。

重新开始会话

要重新启动SSL会话，则必须删除现有的封闭SslHandler从ChannelPipeline ，插入一个新SslHandler用新SSLEngine进入管道，并在第一部分中描述开始握手过程。

实施StartTLS

StartTLS是在明文连接中间保护线路的通信模式。请注意，它与SSL？TLS不同，它可以在连接开始时保护连线。通常，StartTLS由三个步骤组成：
1. 客户端向服务器发送StartTLS请求。
2. 服务器向客户端发送StartTLS响应。
3. 客户端开始SSL握手。
如果您实施服务器，则需要：
1. 创建一个新的SslHandler实例，其中startTls标志设置为true ，
2. 将SslHandler插入到ChannelPipeline ，然后
3. 写一个StartTLS响应。
请注意，您必须在发送StartTLS响应之前插入SslHandler 。否则客户端可以在将SslHandler插入到ChannelPipeline之前发送开始SSL握手，从而导致数据损坏。
客户端实现要简单得多。
1. 写一个StartTLS请求，
2. 等待StartTLS响应，
3. 创建一个新的SslHandler实例，其中startTls标志设置为false ，
4. 将SslHandler插入到ChannelPipeline ，然后
5. 启动SSL握手。
已知的问题

由于Java自带的SslEngine的当前实现存在已知问题，因此在完成完整的GC时可能会看到阻塞的IO线程。

所以如果你受到影响，你可以通过调整缓存设置来解决这个问题，如下所示：
```
  SslContext context = ...;
     context.getServerSessionContext().setSessionCacheSize(someSaneSize);
     context.getServerSessionContext().setSessionTime(someSameTimeout); 
```
这里使用的值取决于应用程序的性质，应该根据监视和调试来设置。有关更多详细信息，请参阅我们的问题跟踪器中的#832 。

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
`SslHandler(javax.net.ssl.SSLEngine engine)` 创建一个新的实例。
`SslHandler(javax.net.ssl.SSLEngine engine, boolean startTls)` 创建一个新的实例。
`SslHandler(javax.net.ssl.SSLEngine engine, boolean startTls, java.util.concurrent.Executor delegatedTaskExecutor)` 已过时。改为使用`SslHandler(SSLEngine, boolean)` 。
`SslHandler(javax.net.ssl.SSLEngine engine, java.util.concurrent.Executor delegatedTaskExecutor)` 已过时。改为使用`SslHandler(SSLEngine)` 。

方法摘要

所有方法静态方法接口方法具体的方法弃用的方法
Modifier and Type	Method and Description
`java.lang.String`	`applicationProtocol()` 返回当前应用程序级协议的名称。
`void`	`bind(ChannelHandlerContext ctx, java.net.SocketAddress localAddress, ChannelPromise promise)` 调用一次绑定操作。
`void`	`channelActive(ChannelHandlerContext ctx)` 在客户端模式下使用时连接发起初始TLS握手
`void`	`channelInactive(ChannelHandlerContext ctx)` 致电`ChannelHandlerContext.fireChannelInactive()`转发到8263283910958中的下一个`ChannelInboundHandler` 。
`void`	`channelReadComplete(ChannelHandlerContext ctx)` 致电`ChannelHandlerContext.fireChannelReadComplete()`转发到`ChannelPipeline`中的下一个`ChannelInboundHandler` 。
`ChannelFuture`	`close()` 已过时。使用`ChannelOutboundInvoker.close()`或`ChannelOutboundInvoker.close()`
`void`	`close(ChannelHandlerContext ctx, ChannelPromise promise)` 一旦进行了密切的操作，就会被调用。
`ChannelFuture`	`close(ChannelPromise promise)` 已过时。使用`ChannelOutboundInvoker.close()`或`ChannelOutboundInvoker.close()`
`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)` 调用一次断开操作。
`javax.net.ssl.SSLEngine`	`engine()` 返回此处理程序使用的 `SSLEngine` 。
`void`	`exceptionCaught(ChannelHandlerContext ctx, java.lang.Throwable cause)` 致电`ChannelHandlerContext.fireExceptionCaught(Throwable)`转发到`ChannelPipeline`中的下一个`ChannelHandler` 。
`void`	`flush(ChannelHandlerContext ctx)` 调用一次冲洗操作。
`long`	`getCloseNotifyFlushTimeoutMillis()` 获取刷新关闭`Channel`触发的close_notify的超时时间。
`long`	`getCloseNotifyReadTimeoutMillis()` 获取用于接收由关闭`Channel`触发的close_notify响应的超时（以毫秒为单位）。
`long`	`getCloseNotifyTimeoutMillis()` 已过时。使用`getCloseNotifyFlushTimeoutMillis()`
`long`	`getHandshakeTimeoutMillis()`
`void`	`handlerAdded(ChannelHandlerContext ctx)` 子类可以忽略这个方法。
`void`	`handlerRemoved0(ChannelHandlerContext ctx)` 在`ByteToMessageDecoder`从实际上下文中移除之后调用，它不再处理事件。
`Future<Channel>`	`handshakeFuture()` 返回一个当前TLS握手完成后会通知的`Future` 。
`static boolean`	`isEncrypted(ByteBuf buffer)` 如果给定的`ByteBuf`已加密，则返回`true` 。
`void`	`read(ChannelHandlerContext ctx)` 拦截 `ChannelHandlerContext.read()` 。
`Future<Channel>`	`renegotiate()` 执行TLS重新协商。
`Future<Channel>`	`renegotiate(Promise<Channel> promise)` 执行TLS重新协商。
`void`	`setCloseNotifyFlushTimeout(long closeNotifyFlushTimeout, java.util.concurrent.TimeUnit unit)` 设置刷新由关闭`Channel`触发的close_notify的超时。
`void`	`setCloseNotifyFlushTimeoutMillis(long closeNotifyFlushTimeoutMillis)` 见 `setCloseNotifyFlushTimeout(long, TimeUnit)` 。
`void`	`setCloseNotifyReadTimeout(long closeNotifyReadTimeout, java.util.concurrent.TimeUnit unit)` 设置接收关闭`Channel`触发的close_notify响应的超时时间。
`void`	`setCloseNotifyReadTimeoutMillis(long closeNotifyReadTimeoutMillis)` 见 `setCloseNotifyReadTimeout(long, TimeUnit)` 。
`void`	`setCloseNotifyTimeout(long closeNotifyTimeout, java.util.concurrent.TimeUnit unit)` 已过时。使用`setCloseNotifyFlushTimeout(long, TimeUnit)`
`void`	`setCloseNotifyTimeoutMillis(long closeNotifyFlushTimeoutMillis)` 已过时。使用`setCloseNotifyFlushTimeoutMillis(long)`
`void`	`setHandshakeTimeout(long handshakeTimeout, java.util.concurrent.TimeUnit unit)`
`void`	`setHandshakeTimeoutMillis(long handshakeTimeoutMillis)`
`void`	`setWrapDataSize(int wrapDataSize)` 设置传递给每个 `SSLEngine.wrap(ByteBuffer[], int, int, ByteBuffer)`调用的字节数。
`Future<Channel>`	`sslCloseFuture()` 返回`Future` ，如果`SSLEngine`的入站已关闭，将会收到通知。
`void`	`write(ChannelHandlerContext ctx, java.lang.Object msg, ChannelPromise promise)` 一旦写入操作被调用，就调用它。

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

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

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

- 构造方法详细信息
  - SslHandler
```
public SslHandler(javax.net.ssl.SSLEngine engine)
```
    创建一个新的实例。
    
    参数
    
    engine - 此处理程序将使用 SSLEngine
  - SslHandler
```
public SslHandler(javax.net.ssl.SSLEngine engine,
                  boolean startTls)
```
    创建一个新的实例。
    
    参数
    
    engine - 该处理程序将使用 SSLEngine
    
    startTls - true如果第一个写入请求不应该由 SSLEngine加密
  - SslHandler
```
@Deprecated
public SslHandler(javax.net.ssl.SSLEngine engine,
                              java.util.concurrent.Executor delegatedTaskExecutor)
```
    已过时。改为使用SslHandler(SSLEngine) 。
  - SslHandler
```
@Deprecated
public SslHandler(javax.net.ssl.SSLEngine engine,
                              boolean startTls,
                              java.util.concurrent.Executor delegatedTaskExecutor)
```
    已过时。改为使用SslHandler(SSLEngine, boolean) 。
- 方法详细信息
  - getHandshakeTimeoutMillis
```
public long getHandshakeTimeoutMillis()
```
  - setHandshakeTimeout
```
public void setHandshakeTimeout(long handshakeTimeout,
                                java.util.concurrent.TimeUnit unit)
```
  - setHandshakeTimeoutMillis
```
public void setHandshakeTimeoutMillis(long handshakeTimeoutMillis)
```
  - setWrapDataSize
```
@UnstableApi
public final void setWrapDataSize(int wrapDataSize)
```
    设置传递给每个SSLEngine.wrap(ByteBuffer[], int, int, ByteBuffer)调用的字节数。
    该值将分割传递给写入write(ChannelHandlerContext, Object, ChannelPromise)的数据。分区工作如下：
    - 如果wrapDataSize <= 0那么我们将按wrapDataSize <= 0写入每个数据块。
    - 如果wrapDataSize > data size那么我们将尝试将多个数据块聚合在一起。
    - 如果wrapDataSize > data size否则如果wrapDataSize <= data size那么我们将在写入时将数据分成wrapDataSize块。
    如果SSLEngine不支持收集包装操作（例如SslProvider.OPENSSL ），那么在包装之前聚合数据可以帮助减少TLS开销与数据负载之间的比率，这将导致更好的吞吐量。编写固定的数据块也可以帮助定位底层传输的（例如TCP）帧大小。在有损/拥塞的网络条件下，这可以帮助对方更早地获得完整的TLS数据包，并且能够尽快完成工作，而不是等待所有TLS数据包到达。
    参数
    
    wrapDataSize - 将传递给每个 SSLEngine.wrap(ByteBuffer[], int, int, ByteBuffer)调用的字节数。
  - getCloseNotifyTimeoutMillis
```
@Deprecated
public long getCloseNotifyTimeoutMillis()
```
    已过时。使用getCloseNotifyFlushTimeoutMillis()
  - setCloseNotifyTimeout
```
@Deprecated
public void setCloseNotifyTimeout(long closeNotifyTimeout,
                                              java.util.concurrent.TimeUnit unit)
```
    已过时。使用setCloseNotifyFlushTimeout(long, TimeUnit)
  - setCloseNotifyTimeoutMillis
```
@Deprecated
public void setCloseNotifyTimeoutMillis(long closeNotifyFlushTimeoutMillis)
```
    已过时。使用setCloseNotifyFlushTimeoutMillis(long)
  - getCloseNotifyFlushTimeoutMillis
```
public final long getCloseNotifyFlushTimeoutMillis()
```
    获取刷新由关闭Channel触发的close_notify的超时。如果close_notify在给定的超时时间内未刷新，则强制关闭Channel 。
  - setCloseNotifyFlushTimeout
```
public final void setCloseNotifyFlushTimeout(long closeNotifyFlushTimeout,
                                             java.util.concurrent.TimeUnit unit)
```
    设置刷新关闭Channel触发的close_notify超时。如果close_notify未在给定的超时时间内刷新，则强制关闭Channel 。
  - setCloseNotifyFlushTimeoutMillis
```
public final void setCloseNotifyFlushTimeoutMillis(long closeNotifyFlushTimeoutMillis)
```
    见 setCloseNotifyFlushTimeout(long, TimeUnit) 。
  - getCloseNotifyReadTimeoutMillis
```
public final long getCloseNotifyReadTimeoutMillis()
```
    获取用于接收由关闭Channel而触发的close_notify响应的超时（以毫秒为单位）。该超时在close_notify消息成功写入远程对等体之后开始。使用0直接关闭Channel ，不要等待响应。
  - setCloseNotifyReadTimeout
```
public final void setCloseNotifyReadTimeout(long closeNotifyReadTimeout,
                                            java.util.concurrent.TimeUnit unit)
```
    设置接收关闭Channel触发的close_notify响应的超时时间。该超时在close_notify消息成功写入远程对等体之后开始。使用0直接关闭Channel，而不是等待响应。
  - setCloseNotifyReadTimeoutMillis
```
public final void setCloseNotifyReadTimeoutMillis(long closeNotifyReadTimeoutMillis)
```
    见 setCloseNotifyReadTimeout(long, TimeUnit) 。
  - engine
```
public javax.net.ssl.SSLEngine engine()
```
    返回此处理程序使用的 SSLEngine 。
  - applicationProtocol
```
public java.lang.String applicationProtocol()
```
    返回当前应用程序级协议的名称。
    
    结果
    
    协议名称或 null如果应用程序级协议尚未协商）
  - handshakeFuture
```
public Future<Channel> handshakeFuture()
```
    返回一个当前TLS握手完成后会通知的Future 。
    
    结果
    
    该Future初始TLS握手如果renegotiate()没有被引用。该Future为最近TLS renegotiation其他。
  - close
```
@Deprecated
public ChannelFuture close()
```
    已过时。使用ChannelOutboundInvoker.close()或ChannelOutboundInvoker.close()
    
    将SSL close_notify消息发送到指定的通道并销毁底层的 SSLEngine 。
  - close
```
@Deprecated
public ChannelFuture close(ChannelPromise promise)
```
    已过时。请使用ChannelOutboundInvoker.close()或ChannelOutboundInvoker.close()
    
    见 close()
  - sslCloseFuture
```
public Future<Channel> sslCloseFuture()
```
    返回Future ，如果SSLEngine的入站已关闭，将会收到通知。此方法将始终返回相同的Future 。
    
    另请参见：
    
    SSLEngine
  - handlerRemoved0
```
public void handlerRemoved0(ChannelHandlerContext ctx)
                     throws java.lang.Exception
```
    从类复制的描述： ByteToMessageDecoder
    
    在ByteToMessageDecoder已从实际上下文中移除并且不再处理事件之后调用。
    
    重写：
    
    handlerRemoved0在课堂上 ByteToMessageDecoder
    
    异常
    
    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 - 发生错误时抛出
  - 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 - 发生错误时抛出
  - 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 - 发生错误时抛出
  - read
```
public void read(ChannelHandlerContext ctx)
          throws java.lang.Exception
```
    从接口ChannelOutboundHandler复制的描述
    
    拦截 ChannelHandlerContext.read() 。
    
    Specified by:
    
    read接口 ChannelOutboundHandler
    
    异常
    
    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 - 发生错误时抛出
  - channelInactive
```
public void channelInactive(ChannelHandlerContext ctx)
                     throws java.lang.Exception
```
    从类复制的描述： ChannelInboundHandlerAdapter
    
    致电ChannelHandlerContext.fireChannelInactive()转发到ChannelPipeline中的下一个ChannelInboundHandler 。子类可以重写此方法来更改行为。
    
    Specified by:
    
    channelInactive在界面 ChannelInboundHandler
    
    重写：
    
    channelInactive在课堂上 ByteToMessageDecoder
    
    异常
    
    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
  - isEncrypted
```
public static boolean isEncrypted(ByteBuf buffer)
```
    如果给定的ByteBuf已加密，则返回true 。请注意，此方法不会增加给定ByteBuf的readerIndex 。
    
    参数
    
    buffer - 从ByteBuf读取。请注意，它必须至少有5个字节才能读取，否则会抛出IllegalArgumentException 。
    
    结果
    
    加密true如果ByteBuf被加密， false否则。
    
    异常
    
    java.lang.IllegalArgumentException - 如果给定的ByteBuf未读取至少5个字节，则抛出。
  - decode
```
protected void decode(ChannelHandlerContext ctx,
                      ByteBuf in,
                      java.util.List<java.lang.Object> out)
               throws javax.net.ssl.SSLException
```
    从类复制的描述： ByteToMessageDecoder
    
    解码从一个ByteBuf到另一个。该方法将被调用，直到输入ByteBuf在从此方法返回时没有任何可读的内容或直到输入ByteBuf中没有读取任何内容。
    
    Specified by:
    
    decode在课堂 ByteToMessageDecoder
    
    参数
    
    ctx - ByteToMessageDecoder所属的ChannelHandlerContext
    
    in - 从中读取数据的ByteBuf
    
    out - 应该添加解码消息的 List
    
    异常
    
    javax.net.ssl.SSLException
  - channelReadComplete
```
public void channelReadComplete(ChannelHandlerContext ctx)
                         throws java.lang.Exception
```
    从类复制的描述： ChannelInboundHandlerAdapter
    
    致电ChannelHandlerContext.fireChannelReadComplete()转发到ChannelPipeline中的下一个ChannelInboundHandler 。子类可以重写此方法来更改行为。
    
    Specified by:
    
    channelReadComplete在界面 ChannelInboundHandler
    
    重写：
    
    channelReadComplete在课堂上 ByteToMessageDecoder
    
    异常
    
    java.lang.Exception
  - handlerAdded
```
public void handlerAdded(ChannelHandlerContext ctx)
                  throws java.lang.Exception
```
    从类复制的描述： ChannelHandlerAdapter
    
    子类可以忽略这个方法。
    
    Specified by:
    
    handlerAdded在界面 ChannelHandler
    
    重写：
    
    handlerAdded在课堂上 ChannelHandlerAdapter
    
    异常
    
    java.lang.Exception
  - renegotiate
```
public Future<Channel> renegotiate()
```
    执行TLS重新协商。
  - renegotiate
```
public Future<Channel> renegotiate(Promise<Channel> promise)
```
    执行TLS重新协商。
  - channelActive
```
public void channelActive(ChannelHandlerContext ctx)
                   throws java.lang.Exception
```
    在客户端模式下使用时连接发起初始TLS握手
    
    Specified by:
    
    channelActive ，界面 ChannelInboundHandler
    
    重写：
    
    channelActive在课堂上 ChannelInboundHandlerAdapter
    
    异常
    
    java.lang.Exception

Class SslHandler

开始握手

握手

结束会议

重新开始会话

实施StartTLS

已知的问题

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

构造方法详细信息

SslHandler

SslHandler

SslHandler

SslHandler

方法详细信息

getHandshakeTimeoutMillis

setHandshakeTimeout

setHandshakeTimeoutMillis

setWrapDataSize

getCloseNotifyTimeoutMillis

setCloseNotifyTimeout

setCloseNotifyTimeoutMillis

getCloseNotifyFlushTimeoutMillis

setCloseNotifyFlushTimeout

setCloseNotifyFlushTimeoutMillis

getCloseNotifyReadTimeoutMillis

setCloseNotifyReadTimeout

setCloseNotifyReadTimeoutMillis

engine

applicationProtocol

handshakeFuture

close

close

sslCloseFuture

handlerRemoved0

bind

connect

deregister

disconnect

close

read

write

flush

channelInactive

exceptionCaught

isEncrypted

decode

channelReadComplete

handlerAdded

renegotiate

renegotiate

channelActive