javax.net.ssl

Class TrustManagerFactory

java.lang.Object

javax.net.ssl.TrustManagerFactory

public class TrustManagerFactory
extends java.lang.Object

A factory for creating trust manager objects.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TrustManagerFactory(TrustManagerFactorySpi tmfSpi, java.security.Provider provider, java.lang.String algorithm) Creates a new trust manager factory.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	getAlgorithm() Returns the name of this trust manager algorithm.
static java.lang.String	getDefaultAlgorithm() Returns the default algorithm for trust manager factories.
static TrustManagerFactory	getInstance(java.lang.String algorithm) Returns an instance of a trust manager factory for the given algorithm from the first provider that implements it.
static TrustManagerFactory	getInstance(java.lang.String algorithm, java.security.Provider provider) Returns an instance of a trust manager factory for the given algorithm from the specified provider.
static TrustManagerFactory	getInstance(java.lang.String algorithm, java.lang.String provider) Returns an instance of a trust manager factory for the given algorithm from the named provider.
java.security.Provider	getProvider() Returns the provider of the underlying implementation.
TrustManager[]	getTrustManagers() Returns the trust managers created by this factory.
void	init(java.security.KeyStore store) Initialize this instance with a key store.
void	init(ManagerFactoryParameters params) Initialize this instance with some algorithm-specific parameters.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TrustManagerFactory

protected TrustManagerFactory(TrustManagerFactorySpi tmfSpi,
                   java.security.Provider provider,
                   java.lang.String algorithm)

Creates a new trust manager factory.

Parameters:

tmfSpi - The underlying engine class.

provider - The provider of the engine class.

algorithm - The trust manager algorithm name.

Method Detail

getInstance

public static final TrustManagerFactory getInstance(java.lang.String algorithm)
                                             throws java.security.NoSuchAlgorithmException

Returns an instance of a trust manager factory for the given algorithm from the first provider that implements it.

Parameters:

algorithm - The name of the algorithm to get.

Returns:

The instance of the trust manager factory.

Throws:

java.security.NoSuchAlgorithmException - If no provider implements the given algorithm.

java.lang.IllegalArgumentException - if algorithm is null or is an empty string.

getInstance

public static final TrustManagerFactory getInstance(java.lang.String algorithm,
                              java.lang.String provider)
                                             throws java.security.NoSuchAlgorithmException,
                                                    java.security.NoSuchProviderException

Returns an instance of a trust manager factory for the given algorithm from the named provider.

Parameters:

algorithm - The name of the algorithm to get.

provider - The name of the provider to get the instance from.

Returns:

The instance of the trust manager factory.

Throws:

java.security.NoSuchAlgorithmException - If the provider does not implement the given algorithm.

java.security.NoSuchProviderException - If there is no such named provider.

java.lang.IllegalArgumentException - if either algorithm or provider is null, or if algorithm is an empty string.

getInstance

public static final TrustManagerFactory getInstance(java.lang.String algorithm,
                              java.security.Provider provider)
                                             throws java.security.NoSuchAlgorithmException

Returns an instance of a trust manager factory for the given algorithm from the specified provider.

Parameters:

algorithm - The name of the algorithm to get.

provider - The provider to get the instance from.

Returns:

The instance of the trust manager factory.

Throws:

java.security.NoSuchAlgorithmException - If the provider does not implement the given algorithm.

java.lang.IllegalArgumentException - if either algorithm or provider is null, or if algorithm is an empty string.

getDefaultAlgorithm

public static final java.lang.String getDefaultAlgorithm()

Returns the default algorithm for trust manager factories. The value returned is either the value of the security property "ssl.TrustManagerFactory.algorithm" if it is set, or the value "JessieX509" if not.

Returns:

The default algorithm name.

See Also:

Security.getProperty(java.lang.String)

getAlgorithm

public final java.lang.String getAlgorithm()

Returns the name of this trust manager algorithm.

Returns:

The algorithm name.

getProvider

public final java.security.Provider getProvider()

Returns the provider of the underlying implementation.

Returns:

The provider.

getTrustManagers

public final TrustManager[] getTrustManagers()

Returns the trust managers created by this factory.

Returns:

The trust managers.

init

public final void init(ManagerFactoryParameters params)
                throws java.security.InvalidAlgorithmParameterException

Initialize this instance with some algorithm-specific parameters.

Parameters:

params - The parameters.

Throws:

java.security.InvalidAlgorithmParameterException - If the supplied parameters are inappropriate for this instance.

init

public final void init(java.security.KeyStore store)
                throws java.security.KeyStoreException

Initialize this instance with a key store. The key store may be null, in which case a default will be used.

Parameters:

store - The key store.

Throws:

java.security.KeyStoreException - If there is a problem reading from the key store.