ReferenceCountedOpenSslContext (Netty 4.0.56.Final API文档

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

所有已实现的接口:

ReferenceCounted

直接已知子类:

OpenSslContext, ReferenceCountedOpenSslClientContext, ReferenceCountedOpenSslServerContext
```
public abstract class ReferenceCountedOpenSslContext
extends SslContext
implements ReferenceCounted
```
An implementation of SslContext which works with libraries that support the OpenSsl C library API.
Instances of this class must be released or else native memory will leak!
Instances of this class must not be released before any ReferenceCountedOpenSslEngine which depends upon the instance of this class is released. Otherwise if any method of ReferenceCountedOpenSslEngine is called which uses this class's JNI resources the JVM may crash.

字段概要

字段
限定符和类型字段和说明

protected long ctx
The OpenSSL SSL_CTX object.

protected static int VERIFY_DEPTH

字段
限定符和类型	字段和说明
`protected long`	`ctx` The OpenSSL SSL_CTX object.
`protected static int`	`VERIFY_DEPTH`

方法概要

方法
限定符和类型	方法和说明
`ApplicationProtocolNegotiator`	`applicationProtocolNegotiator()` Returns the object responsible for negotiating application layer protocols for the TLS NPN/ALPN extensions.
`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()` Returns the list of enabled cipher suites, in the order of preference.
`long`	`context()` 已过时。 this method is considered unsafe as the returned pointer may be released later. Dont use it!
`int`	`getBioNonApplicationBufferSize()` Returns the size of the buffer used by the BIO for non-application based writes
`boolean`	`getRejectRemoteInitiatedRenegotiation()` 已过时。
`boolean`	`isClient()` Returns the `true` if and only if this context is for client-side.
`javax.net.ssl.SSLEngine`	`newEngine(ByteBufAllocator alloc)` Returns a new server-side `SSLEngine` with the current configuration.
`javax.net.ssl.SSLEngine`	`newEngine(ByteBufAllocator alloc, java.lang.String peerHost, int peerPort)` Creates a new `SSLEngine` using advisory peer information.
`protected SslHandler`	`newHandler(ByteBufAllocator alloc, boolean startTls)` Create a new SslHandler.
`protected SslHandler`	`newHandler(ByteBufAllocator alloc, java.lang.String peerHost, int peerPort, boolean startTls)` Create a new SslHandler.
`int`	`refCnt()` Returns the reference count of this object.
`boolean`	`release()` Decreases the reference count by `1` and deallocates this object if the reference count reaches at `0`.
`boolean`	`release(int decrement)` Decreases the reference count by the specified `decrement` and deallocates this object if the reference count reaches at `0`.
`ReferenceCounted`	`retain()` Increases the reference count by `1`.
`ReferenceCounted`	`retain(int increment)` Increases the reference count by the specified `increment`.
`long`	`sessionCacheSize()` Returns the size of the cache used for storing SSL session objects.
`abstract OpenSslSessionContext`	`sessionContext()` Returns the `SSLSessionContext` object held by this context.
`long`	`sessionTimeout()` Returns the timeout for the cached SSL session objects, in seconds.
`void`	`setBioNonApplicationBufferSize(int bioNonApplicationBufferSize)` Set the size of the buffer used by the BIO for non-application based writes (e.g. handshake, renegotiation, etc...).
`void`	`setRejectRemoteInitiatedRenegotiation(boolean rejectRemoteInitiatedRenegotiation)` 已过时。
`void`	`setTicketKeys(byte[] keys)` 已过时。 use `OpenSslSessionContext.setTicketKeys(byte[])`
`long`	`sslCtxPointer()` 已过时。 this method is considered unsafe as the returned pointer may be released later. Dont use it!
`OpenSslSessionStats`	`stats()` 已过时。 use `#sessionContext#stats()`

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - VERIFY_DEPTH
```
protected static final int VERIFY_DEPTH
```
    另请参阅:
    常量字段值
  - ctx
```
protected long ctx
```
    The OpenSSL SSL_CTX object. ctxLock must be hold while using ctx!
- 方法详细资料
  - cipherSuites
```
public final java.util.List<java.lang.String> cipherSuites()
```
    从类复制的说明: SslContext
    
    Returns the list of enabled cipher suites, in the order of preference.
    
    指定者:
    
    cipherSuites 在类中 SslContext
  - sessionCacheSize
```
public final long sessionCacheSize()
```
    从类复制的说明: SslContext
    
    Returns the size of the cache used for storing SSL session objects.
    
    指定者:
    
    sessionCacheSize 在类中 SslContext
  - sessionTimeout
```
public final long sessionTimeout()
```
    从类复制的说明: SslContext
    
    Returns the timeout for the cached SSL session objects, in seconds.
    
    指定者:
    
    sessionTimeout 在类中 SslContext
  - applicationProtocolNegotiator
```
public ApplicationProtocolNegotiator applicationProtocolNegotiator()
```
    从类复制的说明: SslContext
    
    Returns the object responsible for negotiating application layer protocols for the TLS NPN/ALPN extensions.
    
    指定者:
    
    applicationProtocolNegotiator 在类中 SslContext
  - isClient
```
public final boolean isClient()
```
    从类复制的说明: SslContext
    
    Returns the true if and only if this context is for client-side.
    
    指定者:
    
    isClient 在类中 SslContext
  - newEngine
```
public final javax.net.ssl.SSLEngine newEngine(ByteBufAllocator alloc,
                                java.lang.String peerHost,
                                int peerPort)
```
    从类复制的说明: SslContext
    
    Creates a new SSLEngine using advisory peer information.
    If SslProvider.OPENSSL_REFCNT is used then the object must be released. One way to do this is to wrap in a SslHandler and insert it into a pipeline. See SslContext.newHandler(ByteBufAllocator, String, int).
    
    指定者:
    
    newEngine 在类中 SslContext
    
    peerHost - the non-authoritative name of the host
    peerPort - the non-authoritative port
    
    返回:
    a new SSLEngine
  - newHandler
```
protected final SslHandler newHandler(ByteBufAllocator alloc,
                    boolean startTls)
```
    从类复制的说明: SslContext
    
    Create a new SslHandler.
    
    覆盖:
    
    newHandler 在类中 SslContext
    
    另请参阅:
    SslContext.newHandler(ByteBufAllocator)
  - newHandler
```
protected final SslHandler newHandler(ByteBufAllocator alloc,
                    java.lang.String peerHost,
                    int peerPort,
                    boolean startTls)
```
    从类复制的说明: SslContext
    
    Create a new SslHandler.
    
    覆盖:
    
    newHandler 在类中 SslContext
    
    另请参阅:
    SslContext.newHandler(ByteBufAllocator, String, int, boolean)
  - newEngine
```
public final javax.net.ssl.SSLEngine newEngine(ByteBufAllocator alloc)
```
    Returns a new server-side SSLEngine with the current configuration.
    
    指定者:
    
    newEngine 在类中 SslContext
    
    返回:
    a new SSLEngine
  - context
```
@Deprecated
public final long context()
```
    已过时。 this method is considered unsafe as the returned pointer may be released later. Dont use it!
    
    Returns the pointer to the SSL_CTX object for this ReferenceCountedOpenSslContext. Be aware that it is freed as soon as the Object.finalize() method is called. At this point 0 will be returned.
  - stats
```
@Deprecated
public final OpenSslSessionStats stats()
```
    已过时。 use #sessionContext#stats()
    
    Returns the stats of this context.
  - setRejectRemoteInitiatedRenegotiation
```
@Deprecated
public void setRejectRemoteInitiatedRenegotiation(boolean rejectRemoteInitiatedRenegotiation)
```
    已过时。
    
    Specify if remote initiated renegotiation is supported or not. If not supported and the remote side tries to initiate a renegotiation a SSLHandshakeException will be thrown during decoding.
  - getRejectRemoteInitiatedRenegotiation
```
@Deprecated
public boolean getRejectRemoteInitiatedRenegotiation()
```
    已过时。
    
    返回:
    true because renegotiation is not supported.
  - setBioNonApplicationBufferSize
```
public void setBioNonApplicationBufferSize(int bioNonApplicationBufferSize)
```
    Set the size of the buffer used by the BIO for non-application based writes (e.g. handshake, renegotiation, etc...).
  - getBioNonApplicationBufferSize
```
public int getBioNonApplicationBufferSize()
```
    Returns the size of the buffer used by the BIO for non-application based writes
  - setTicketKeys
```
@Deprecated
public final void setTicketKeys(byte[] keys)
```
    已过时。 use OpenSslSessionContext.setTicketKeys(byte[])
    
    Sets the SSL session ticket keys of this context.
  - sessionContext
```
public abstract OpenSslSessionContext sessionContext()
```
    从类复制的说明: SslContext
    
    Returns the SSLSessionContext object held by this context.
    
    指定者:
    
    sessionContext 在类中 SslContext
  - sslCtxPointer
```
@Deprecated
public final long sslCtxPointer()
```
    已过时。 this method is considered unsafe as the returned pointer may be released later. Dont use it!
    
    Returns the pointer to the SSL_CTX object for this ReferenceCountedOpenSslContext. Be aware that it is freed as soon as the release() method is called. At this point 0 will be returned.
  - 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
    
    Returns the reference count of this object. If 0, it means this object has been deallocated.
    
    指定者:
    
    refCnt 在接口中 ReferenceCounted
  - retain
```
public final ReferenceCounted retain()
```
    从接口复制的说明: ReferenceCounted
    
    Increases the reference count by 1.
    
    指定者:
    
    retain 在接口中 ReferenceCounted
  - retain
```
public final ReferenceCounted retain(int increment)
```
    从接口复制的说明: ReferenceCounted
    
    Increases the reference count by the specified increment.
    
    指定者:
    
    retain 在接口中 ReferenceCounted
  - release
```
public final boolean release()
```
    从接口复制的说明: ReferenceCounted
    
    Decreases the reference count by 1 and deallocates this object if the reference count reaches at 0.
    
    指定者:
    
    release 在接口中 ReferenceCounted
    
    返回:
    true if and only if the reference count became 0 and this object has been deallocated
  - release
```
public final boolean release(int decrement)
```
    从接口复制的说明: ReferenceCounted
    
    Decreases the reference count by the specified decrement and deallocates this object if the reference count reaches at 0.
    
    指定者:
    
    release 在接口中 ReferenceCounted
    
    返回:
    true if and only if the reference count became 0 and this object has been deallocated

类 ReferenceCountedOpenSslContext

字段概要

方法概要

从类继承的方法 io.netty.handler.ssl.SslContext

从类继承的方法 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

release

release