ReferenceCountedOpenSslContext (Netty API Reference (4.1.22.Final))

java.lang.Object
- io.netty.handler.ssl.SslContext
- - io.netty.handler.ssl.ReferenceCountedOpenSslContext

All Implemented Interfaces:

ReferenceCounted

已知直接子类：

OpenSslContext ， ReferenceCountedOpenSslClientContext ， ReferenceCountedOpenSslServerContext
```
public abstract class ReferenceCountedOpenSslContext
extends SslContext
implements ReferenceCounted
```
SslContext的一个实现，它与支持OpenSsl C库API的库一起工作。
这个类的实例必须是released ，否则本机内存将会泄漏！

在任何取决于这个类的实例的ReferenceCountedOpenSslEngine被释放之前，这个类的实例不能被释放。否则，如果调用任何使用此类的JNI资源的方法ReferenceCountedOpenSslEngine ，JVM可能会崩溃。

Field Summary

Fields
Modifier and Type	Field and Description
`protected long`	`ctx` OpenSSL SSL_CTX对象。
`protected static int`	`VERIFY_DEPTH`

方法摘要

所有方法静态方法接口方法抽象方法具体的方法弃用的方法
Modifier and Type	Method and Description
`ApplicationProtocolNegotiator`	`applicationProtocolNegotiator()` 返回负责协商TLS NPN / ALPN扩展的应用层协议的对象。
`protected static java.security.cert.X509Certificate[]`	`certificates(byte[][] chain)`
`protected static javax.net.ssl.X509TrustManager`	`chooseTrustManager(javax.net.ssl.TrustManager[] managers)`
`protected static javax.net.ssl.X509KeyManager`	`chooseX509KeyManager(javax.net.ssl.KeyManager[] kms)`
`java.util.List<java.lang.String>`	`cipherSuites()` 按优先顺序返回启用的密码套件列表。
`long`	`context()` 已过时。此方法被认为是不安全的，因为返回的指针可能稍后被释放。不要使用它！
`int`	`getBioNonApplicationBufferSize()` 返回BIO为基于非应用程序的写入所使用的缓冲区的大小
`boolean`	`getRejectRemoteInitiatedRenegotiation()` 已过时。
`boolean`	`isClient()` 当且仅当此上下文用于客户端时才返回 `true` 。
`javax.net.ssl.SSLEngine`	`newEngine(ByteBufAllocator alloc)` 用当前配置返回一个新的服务器端 `SSLEngine` 。
`javax.net.ssl.SSLEngine`	`newEngine(ByteBufAllocator alloc, java.lang.String peerHost, int peerPort)` 使用咨询对等信息创建新的 `SSLEngine` 。
`protected SslHandler`	`newHandler(ByteBufAllocator alloc, boolean startTls)` 创建一个新的SslHandler。
`protected SslHandler`	`newHandler(ByteBufAllocator alloc, java.lang.String peerHost, int peerPort, boolean startTls)` 创建一个新的SslHandler。
`int`	`refCnt()` 返回此对象的引用计数。
`boolean`	`release()` 通过减小引用计数 `1`并且如果所述引用计数达到在将释放该对象 `0` 。
`boolean`	`release(int decrement)` 减小由指定的引用计数 `decrement`并且如果所述引用计数达到在将释放该对象 `0` 。
`ReferenceCounted`	`retain()` 将引用计数增加 `1` 。
`ReferenceCounted`	`retain(int increment)` 按指定的 `increment`增加参考计数。
`long`	`sessionCacheSize()` 返回用于存储SSL会话对象的缓存大小。
`abstract OpenSslSessionContext`	`sessionContext()` 返回此上下文所持有的 `SSLSessionContext`对象。
`long`	`sessionTimeout()` 以秒为单位返回缓存的SSL会话对象的超时时间。
`void`	`setBioNonApplicationBufferSize(int bioNonApplicationBufferSize)` 设置BIO为基于非应用程序的写入所使用的缓冲区的大小（例如握手，重新协商等）。
`void`	`setRejectRemoteInitiatedRenegotiation(boolean rejectRemoteInitiatedRenegotiation)` 已过时。
`void`	`setTicketKeys(byte[] keys)` 已过时。使用`OpenSslSessionContext.setTicketKeys(byte[])`
`long`	`sslCtxPointer()` 已过时。此方法被认为是不安全的，因为返回的指针可能稍后被释放。不要使用它！
`OpenSslSessionStats`	`stats()` 已过时。使用`#sessionContext#stats()`
`ReferenceCounted`	`touch()` 记录此对象的当前访问位置以进行调试。
`ReferenceCounted`	`touch(java.lang.Object hint)` 记录此对象的当前访问位置，并附加一些用于调试的任意信息。

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

- 字段详细信息
  - VERIFY_DEPTH
```
protected static final int VERIFY_DEPTH
```
    另请参见：
    
    Constant Field Values
  - ctx
```
protected long ctx
```
    OpenSSL SSL_CTX对象。 使用ctx时必须保持ctxLock ！
- 方法详细信息
  - cipherSuites
```
public final java.util.List<java.lang.String> cipherSuites()
```
    从类复制的描述： SslContext
    
    按优先顺序返回启用的密码套件列表。
    
    Specified by:
    
    cipherSuites在课堂上 SslContext
  - sessionCacheSize
```
public final long sessionCacheSize()
```
    从类复制的描述： SslContext
    
    返回用于存储SSL会话对象的缓存大小。
    
    Specified by:
    
    sessionCacheSize在课堂上 SslContext
  - sessionTimeout
```
public final long sessionTimeout()
```
    从类复制的描述： SslContext
    
    以秒为单位返回缓存的SSL会话对象的超时时间。
    
    Specified by:
    
    sessionTimeout在课堂上 SslContext
  - applicationProtocolNegotiator
```
public ApplicationProtocolNegotiator applicationProtocolNegotiator()
```
    从类复制的描述： SslContext
    
    返回负责协商TLS NPN / ALPN扩展的应用层协议的对象。
    
    Specified by:
    
    applicationProtocolNegotiator在课堂上 SslContext
  - isClient
```
public final boolean isClient()
```
    从类复制的描述： SslContext
    
    当且仅当此上下文用于客户端时才返回 true 。
    
    Specified by:
    
    isClient在类 SslContext
  - newEngine
```
public final javax.net.ssl.SSLEngine newEngine(ByteBufAllocator alloc,
                                               java.lang.String peerHost,
                                               int peerPort)
```
    从类复制的描述： SslContext
    
    使用咨询对等信息创建新的SSLEngine 。
    如果使用SslProvider.OPENSSL_REFCNT，则必须释放该对象。一种方法是将SslHandler包装并插入流水线中。见SslContext.newHandler(ByteBufAllocator, String, int) 。
    
    Specified by:
    
    newEngine在课堂上 SslContext
    
    peerHost - 主机的非权威名称
    
    peerPort - 非权威的港口
    
    结果
    
    一个新的 SSLEngine
  - newHandler
```
protected final SslHandler newHandler(ByteBufAllocator alloc,
                                      boolean startTls)
```
    从类复制的描述： SslContext
    
    创建一个新的SslHandler。
    
    重写：
    
    newHandler在课堂上 SslContext
    
    另请参见：
    
    SslContext.newHandler(ByteBufAllocator)
  - newHandler
```
protected final SslHandler newHandler(ByteBufAllocator alloc,
                                      java.lang.String peerHost,
                                      int peerPort,
                                      boolean startTls)
```
    从类复制的描述： SslContext
    
    创建一个新的SslHandler。
    
    重写：
    
    newHandler在课堂上 SslContext
    
    另请参见：
    
    SslContext.newHandler(ByteBufAllocator, String, int, boolean)
  - newEngine
```
public final javax.net.ssl.SSLEngine newEngine(ByteBufAllocator alloc)
```
    用当前配置返回一个新的服务器端 SSLEngine 。
    
    Specified by:
    
    newEngine在课堂上 SslContext
    
    结果
    
    一个新的 SSLEngine
  - context
```
@Deprecated
public final long context()
```
    已过时。此方法被认为是不安全的，因为返回的指针可能稍后被释放。不要使用它！
    
    返回指向此ReferenceCountedOpenSslContext的SSL_CTX对象的指针。请注意，只要调用Object.finalize()方法就会释放它。此时将返回0 。
  - stats
```
@Deprecated
public final OpenSslSessionStats stats()
```
    已过时。使用#sessionContext#stats()
    
    返回此上下文的统计信息。
  - setRejectRemoteInitiatedRenegotiation
```
@Deprecated
public void setRejectRemoteInitiatedRenegotiation(boolean rejectRemoteInitiatedRenegotiation)
```
    已过时。
    
    指定是否支持远程启动的重新协商。如果不支持，并且远程端尝试启动重新协商，则解码期间将抛出SSLHandshakeException 。
  - getRejectRemoteInitiatedRenegotiation
```
@Deprecated
public boolean getRejectRemoteInitiatedRenegotiation()
```
    已过时。
    
    结果
    
    true因为不支持重新协商。
  - setBioNonApplicationBufferSize
```
public void setBioNonApplicationBufferSize(int bioNonApplicationBufferSize)
```
    设置BIO为基于非应用程序的写入所使用的缓冲区的大小（例如握手，重新协商等）。
  - getBioNonApplicationBufferSize
```
public int getBioNonApplicationBufferSize()
```
    返回BIO为基于非应用程序的写入所使用的缓冲区的大小
  - setTicketKeys
```
@Deprecated
public final void setTicketKeys(byte[] keys)
```
    已过时。使用OpenSslSessionContext.setTicketKeys(byte[])
    
    设置此上下文的SSL会话票证密钥。
  - sessionContext
```
public abstract OpenSslSessionContext sessionContext()
```
    从类复制的描述： SslContext
    
    返回此上下文所持有的 SSLSessionContext对象。
    
    Specified by:
    
    sessionContext在课堂上 SslContext
  - sslCtxPointer
```
@Deprecated
public final long sslCtxPointer()
```
    已过时。此方法被认为是不安全的，因为返回的指针可能稍后被释放。不要使用它！
    
    返回指向此ReferenceCountedOpenSslContext的SSL_CTX对象的指针。请注意，只要调用release()方法就会释放它。此时将返回0 。
  - certificates
```
protected static java.security.cert.X509Certificate[] certificates(byte[][] chain)
```
  - chooseTrustManager
```
protected static javax.net.ssl.X509TrustManager chooseTrustManager(javax.net.ssl.TrustManager[] managers)
```
  - chooseX509KeyManager
```
protected static javax.net.ssl.X509KeyManager chooseX509KeyManager(javax.net.ssl.KeyManager[] kms)
```
  - refCnt
```
public final int refCnt()
```
    从接口复制的描述： ReferenceCounted
    
    返回此对象的引用计数。如果0 ，则表示该对象已被释放。
    
    Specified by:
    
    refCnt在界面 ReferenceCounted
  - retain
```
public final ReferenceCounted retain()
```
    从接口ReferenceCounted复制的描述
    
    将引用计数增加 1 。
    
    Specified by:
    
    retain在界面 ReferenceCounted
  - retain
```
public final ReferenceCounted retain(int increment)
```
    从接口ReferenceCounted复制的描述
    
    将参考计数增加 increment 。
    
    Specified by:
    
    retain在界面 ReferenceCounted
  - touch
```
public final ReferenceCounted touch()
```
    从接口复制的描述： ReferenceCounted
    
    记录此对象的当前访问位置以进行调试。如果确定此物体泄漏，则通过此操作记录的信息将通过ResourceLeakDetector提供给您。此方法是touch(null)的快捷方式。
    
    Specified by:
    
    touch在界面 ReferenceCounted
  - touch
```
public final ReferenceCounted touch(java.lang.Object hint)
```
    从界面复制的描述： ReferenceCounted
    
    记录此对象的当前访问位置，并附加一些用于调试的任意信息。如果确定此物体泄漏，则通过此操作记录的信息将通过ResourceLeakDetector提供给您。
    
    Specified by:
    
    touch ，界面 ReferenceCounted
  - release
```
public final boolean release()
```
    从接口复制的描述： ReferenceCounted
    
    通过减小引用计数 1并且如果所述引用计数达到在将释放该对象 0 。
    
    Specified by:
    
    release在界面 ReferenceCounted
    
    结果
    
    true当且仅当引用计数变为 0且此对象已被释放
  - release
```
public final boolean release(int decrement)
```
    从界面复制的描述： ReferenceCounted
    
    减小由指定的引用计数 decrement并且如果所述引用计数达到在将释放该对象 0 。
    
    Specified by:
    
    release在界面 ReferenceCounted
    
    结果
    
    true当且仅当引用计数变为 0且此对象已被释放

Class ReferenceCountedOpenSslContext

Field Summary

方法摘要

Methods inherited from class io.netty.handler.ssl.SslContext

Methods inherited from class java.lang.Object

字段详细信息

VERIFY_DEPTH

ctx

方法详细信息

cipherSuites

sessionCacheSize

sessionTimeout

applicationProtocolNegotiator

isClient

newEngine

newHandler

newHandler

newEngine

context

stats

setRejectRemoteInitiatedRenegotiation

getRejectRemoteInitiatedRenegotiation

setBioNonApplicationBufferSize

getBioNonApplicationBufferSize

setTicketKeys

sessionContext

sslCtxPointer

certificates

chooseTrustManager

chooseX509KeyManager

refCnt

retain

retain

touch

touch

release

release