public
abstract
class
SSLContextSpi
extends Object
| java.lang.Object | |
| ↳ | javax.net.ssl.SSLContextSpi |
This class defines the Service Provider Interface (SPI)
for the SSLContext class.
All the abstract methods in this class must be implemented by each cryptographic service provider who wishes to supply the implementation of a particular SSL context.
See also:
Public constructors | |
|---|---|
SSLContextSpi()
|
|
Protected methods | |
|---|---|
abstract
SSLEngine
|
engineCreateSSLEngine()
Creates a new |
abstract
SSLEngine
|
engineCreateSSLEngine(String host, int port)
Creates a |
abstract
SSLSessionContext
|
engineGetClientSessionContext()
Returns a client |
SSLParameters
|
engineGetDefaultSSLParameters()
Returns a copy of the SSLParameters indicating the default settings for this SSL context. |
abstract
SSLSessionContext
|
engineGetServerSessionContext()
Returns a server |
abstract
SSLServerSocketFactory
|
engineGetServerSocketFactory()
Returns a |
abstract
SSLSocketFactory
|
engineGetSocketFactory()
Returns a |
SSLParameters
|
engineGetSupportedSSLParameters()
Returns a copy of the SSLParameters indicating the maximum supported settings for this SSL context. |
abstract
void
|
engineInit(KeyManager[] km, TrustManager[] tm, SecureRandom sr)
Initializes this context. |
Inherited methods | |
|---|---|
 From
class
java.lang.Object
| |
SSLEngine engineCreateSSLEngine ()
Creates a new SSLEngine using this context.
Applications using this factory method are providing no hints
for an internal session reuse strategy. If hints are desired,
engineCreateSSLEngine(String, int) should be used
instead.
Some cipher suites (such as Kerberos) require remote hostname information, in which case this factory method should not be used.
| Returns | |
|---|---|
SSLEngine |
the SSLEngine Object |
| Throws | |
|---|---|
IllegalStateException |
if the SSLContextImpl requires
initialization and the engineInit()
has not been called |
See also:
SSLEngine engineCreateSSLEngine (String host, int port)
Creates a SSLEngine using this context.
Applications using this factory method are providing hints for an internal session reuse strategy.
Some cipher suites (such as Kerberos) require remote hostname information, in which case peerHost needs to be specified.
| Parameters | |
|---|---|
host |
String:
the non-authoritative name of the host |
port |
int:
the non-authoritative port |
| Returns | |
|---|---|
SSLEngine |
the SSLEngine Object |
| Throws | |
|---|---|
IllegalStateException |
if the SSLContextImpl requires
initialization and the engineInit()
has not been called |
See also:
SSLSessionContext engineGetClientSessionContext ()
Returns a client SSLSessionContext object for
this context.
| Returns | |
|---|---|
SSLSessionContext |
the SSLSessionContext object |
See also:
SSLParameters engineGetDefaultSSLParameters ()
Returns a copy of the SSLParameters indicating the default settings for this SSL context.
The parameters will always have the ciphersuite and protocols arrays set to non-null values.
The default implementation obtains the parameters from an SSLSocket created by calling the SocketFactory.createSocket() method of this context's SocketFactory.
| Returns | |
|---|---|
SSLParameters |
a copy of the SSLParameters object with the default settings |
| Throws | |
|---|---|
UnsupportedOperationException |
if the default SSL parameters could not be obtained. |
SSLSessionContext engineGetServerSessionContext ()
Returns a server SSLSessionContext object for
this context.
| Returns | |
|---|---|
SSLSessionContext |
the SSLSessionContext object |
See also:
SSLServerSocketFactory engineGetServerSocketFactory ()
Returns a ServerSocketFactory object for
this context.
| Returns | |
|---|---|
SSLServerSocketFactory |
the ServerSocketFactory object |
| Throws | |
|---|---|
IllegalStateException |
if the SSLContextImpl requires
initialization and the engineInit()
has not been called |
See also:
SSLSocketFactory engineGetSocketFactory ()
Returns a SocketFactory object for this
context.
| Returns | |
|---|---|
SSLSocketFactory |
the SocketFactory object |
| Throws | |
|---|---|
IllegalStateException |
if the SSLContextImpl requires
initialization and the engineInit()
has not been called |
See also:
SSLParameters engineGetSupportedSSLParameters ()
Returns a copy of the SSLParameters indicating the maximum supported settings for this SSL context.
The parameters will always have the ciphersuite and protocols arrays set to non-null values.
The default implementation obtains the parameters from an SSLSocket created by calling the SocketFactory.createSocket() method of this context's SocketFactory.
| Returns | |
|---|---|
SSLParameters |
a copy of the SSLParameters object with the maximum supported settings |
| Throws | |
|---|---|
UnsupportedOperationException |
if the supported SSL parameters could not be obtained. |
void engineInit (KeyManager[] km, TrustManager[] tm, SecureRandom sr)
Initializes this context.
| Parameters | |
|---|---|
km |
KeyManager:
the sources of authentication keys |
tm |
TrustManager:
the sources of peer authentication trust decisions |
sr |
SecureRandom:
the source of randomness |
| Throws | |
|---|---|
KeyManagementException |
if this operation fails |
Developers