javax.net.ssl
Class SSLContextSpi
- java.lang.Object
javax.net.ssl.SSLContextSpi
- public abstract class SSLContextSpi
- extends Object
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.
Constructor Summary
Constructor and Description |
---|
SSLContextSpi()
|
Method Summary
Modifier and Type | Method and Description |
---|---|
|
engineCreateSSLEngine()
Creates a new
SSLEngine using this context.
|
|
engineCreateSSLEngine(String host,int port)
Creates a
SSLEngine using this context.
|
|
engineGetClientSessionContext()
Returns a client
SSLSessionContext object for
this context.
|
|
engineGetDefaultSSLParameters()
Returns a copy of the SSLParameters indicating the default
settings for this SSL context.
|
|
engineGetServerSessionContext()
Returns a server
SSLSessionContext object for
this context.
|
|
engineGetServerSocketFactory()
Returns a
ServerSocketFactory object for
this context.
|
|
engineGetSocketFactory()
Returns a
SocketFactory object for this
context.
|
|
engineGetSupportedSSLParameters()
Returns a copy of the SSLParameters indicating the maximum supported
settings for this SSL context.
|
|
engineInit(KeyManager[] km,TrustManager[] tm,SecureRandom sr)
Initializes this context.
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail
SSLContextSpi
- public SSLContextSpi()
Method Detail
engineInit
- protected abstract void engineInit( KeyManager[] km,
- TrustManager[] tm,
- SecureRandom sr)
- throws KeyManagementException
km
- the sources of authentication keys tm
- the sources of peer authentication trust decisions sr
- the source of randomness KeyManagementException
- if this operation fails engineGetSocketFactory
- protected abstract SSLSocketFactory engineGetSocketFactory( )
SocketFactory
object for this
context.
SocketFactory
object IllegalStateException
- if the SSLContextImpl requires
initialization and the engineInit()
has not been called engineGetServerSocketFactory
- protected abstract SSLServerSocketFactory engineGetServerSocketFactory( )
ServerSocketFactory
object for
this context.
ServerSocketFactory
object IllegalStateException
- if the SSLContextImpl requires
initialization and the engineInit()
has not been called engineCreateSSLEngine
- protected abstract SSLEngine engineCreateSSLEngine( )
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.
SSLEngine
Object IllegalStateException
- if the SSLContextImpl requires
initialization and the engineInit()
has not been called engineCreateSSLEngine
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.
host
- the non-authoritative name of the host port
- the non-authoritative port SSLEngine
Object IllegalStateException
- if the SSLContextImpl requires
initialization and the engineInit()
has not been called engineGetServerSessionContext
- protected abstract SSLSessionContext engineGetServerSessionContext( )
SSLSessionContext
object for
this context.
engineGetClientSessionContext
- protected abstract SSLSessionContext engineGetClientSessionContext( )
SSLSessionContext
object for
this context.
engineGetDefaultSSLParameters
- protected SSLParameters engineGetDefaultSSLParameters( )
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.
UnsupportedOperationException
- if the default SSL parameters
could not be obtained. engineGetSupportedSSLParameters
- protected SSLParameters engineGetSupportedSSLParameters( )
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.
UnsupportedOperationException
- if the supported SSL parameters
could not be obtained.