- java.lang.Object
-
- javax.net.ssl.SSLContextSpi
-
public abstract class SSLContextSpi extends Object
This class defines the Service Provider Interface (SPI) for theSSLContext
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.
- Since:
- 1.4
- See Also:
SSLContext
-
-
Constructor Summary
Constructors Constructor and Description SSLContextSpi()
-
Method Summary
Methods Modifier and Type Method and Description protected abstract SSLEngine
engineCreateSSLEngine()
Creates a newSSLEngine
using this context.protected abstract SSLEngine
engineCreateSSLEngine(String host, int port)
Creates aSSLEngine
using this context.protected abstract SSLSessionContext
engineGetClientSessionContext()
Returns a clientSSLSessionContext
object for this context.protected SSLParameters
engineGetDefaultSSLParameters()
Returns a copy of the SSLParameters indicating the default settings for this SSL context.protected abstract SSLSessionContext
engineGetServerSessionContext()
Returns a serverSSLSessionContext
object for this context.protected abstract SSLServerSocketFactory
engineGetServerSocketFactory()
Returns aServerSocketFactory
object for this context.protected abstract SSLSocketFactory
engineGetSocketFactory()
Returns aSocketFactory
object for this context.protected SSLParameters
engineGetSupportedSSLParameters()
Returns a copy of the SSLParameters indicating the maximum supported settings for this SSL context.protected abstract void
engineInit(KeyManager[] km, TrustManager[] tm, SecureRandom sr)
Initializes this context.
-
-
-
Method Detail
-
engineInit
protected abstract void engineInit(KeyManager[] km, TrustManager[] tm, SecureRandom sr) throws KeyManagementException
Initializes this context.- Parameters:
km
- the sources of authentication keystm
- the sources of peer authentication trust decisionssr
- the source of randomness- Throws:
KeyManagementException
- if this operation fails- See Also:
SSLContext.init(KeyManager [], TrustManager [], SecureRandom)
-
engineGetSocketFactory
protected abstract SSLSocketFactory engineGetSocketFactory()
Returns aSocketFactory
object for this context.- Returns:
- the
SocketFactory
object - Throws:
IllegalStateException
- if the SSLContextImpl requires initialization and theengineInit()
has not been called- See Also:
SSLContext.getSocketFactory()
-
engineGetServerSocketFactory
protected abstract SSLServerSocketFactory engineGetServerSocketFactory()
Returns aServerSocketFactory
object for this context.- Returns:
- the
ServerSocketFactory
object - Throws:
IllegalStateException
- if the SSLContextImpl requires initialization and theengineInit()
has not been called- See Also:
SSLContext.getServerSocketFactory()
-
engineCreateSSLEngine
protected abstract SSLEngine engineCreateSSLEngine()
Creates a newSSLEngine
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:
- the
SSLEngine
Object - Throws:
IllegalStateException
- if the SSLContextImpl requires initialization and theengineInit()
has not been called- Since:
- 1.5
- See Also:
SSLContext.createSSLEngine()
-
engineCreateSSLEngine
protected abstract SSLEngine engineCreateSSLEngine(String host, int port)
Creates aSSLEngine
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
- the non-authoritative name of the hostport
- the non-authoritative port- Returns:
- the
SSLEngine
Object - Throws:
IllegalStateException
- if the SSLContextImpl requires initialization and theengineInit()
has not been called- Since:
- 1.5
- See Also:
SSLContext.createSSLEngine(String, int)
-
engineGetServerSessionContext
protected abstract SSLSessionContext engineGetServerSessionContext()
Returns a serverSSLSessionContext
object for this context.- Returns:
- the
SSLSessionContext
object - See Also:
SSLContext.getServerSessionContext()
-
engineGetClientSessionContext
protected abstract SSLSessionContext engineGetClientSessionContext()
Returns a clientSSLSessionContext
object for this context.- Returns:
- the
SSLSessionContext
object - See Also:
SSLContext.getClientSessionContext()
-
engineGetDefaultSSLParameters
protected 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:
- a copy of the SSLParameters object with the default settings
- Throws:
UnsupportedOperationException
- if the default SSL parameters could not be obtained.- Since:
- 1.6
-
engineGetSupportedSSLParameters
protected 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:
- a copy of the SSLParameters object with the maximum supported settings
- Throws:
UnsupportedOperationException
- if the supported SSL parameters could not be obtained.- Since:
- 1.6
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/net/ssl/sslcontextspi.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.