javax.net.ssl
Class TrustManagerFactory

java.lang.Object
  extended by javax.net.ssl.TrustManagerFactory

public class TrustManagerFactory
extends Object

A factory for creating trust manager objects.


Constructor Summary
protected TrustManagerFactory(TrustManagerFactorySpi tmfSpi, Provider provider, String algorithm)
          Creates a new trust manager factory.
 
Method Summary
 String getAlgorithm()
          Returns the name of this trust manager algorithm.
static String getDefaultAlgorithm()
          Returns the default algorithm for trust manager factories.
static TrustManagerFactory getInstance(String algorithm)
          Returns an instance of a trust manager factory for the given algorithm from the first provider that implements it.
static TrustManagerFactory getInstance(String algorithm, Provider provider)
          Returns an instance of a trust manager factory for the given algorithm from the specified provider.
static TrustManagerFactory getInstance(String algorithm, String provider)
          Returns an instance of a trust manager factory for the given algorithm from the named provider.
 Provider getProvider()
          Returns the provider of the underlying implementation.
 TrustManager[] getTrustManagers()
          Returns the trust managers created by this factory.
 void init(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,
                              Provider provider,
                              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(String algorithm)
                                             throws 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:
NoSuchAlgorithmException - If no provider implements the given algorithm.
IllegalArgumentException - if algorithm is null or is an empty string.

getInstance

public static final TrustManagerFactory getInstance(String algorithm,
                                                    String provider)
                                             throws NoSuchAlgorithmException,
                                                    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:
NoSuchAlgorithmException - If the provider does not implement the given algorithm.
NoSuchProviderException - If there is no such named provider.
IllegalArgumentException - if either algorithm or provider is null, or if algorithm is an empty string.

getInstance

public static final TrustManagerFactory getInstance(String algorithm,
                                                    Provider provider)
                                             throws 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:
NoSuchAlgorithmException - If the provider does not implement the given algorithm.
IllegalArgumentException - if either algorithm or provider is null, or if algorithm is an empty string.

getDefaultAlgorithm

public static final 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 String getAlgorithm()
Returns the name of this trust manager algorithm.

Returns:
The algorithm name.

getProvider

public final 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 InvalidAlgorithmParameterException
Initialize this instance with some algorithm-specific parameters.

Parameters:
params - The parameters.
Throws:
InvalidAlgorithmParameterException - If the supplied parameters are inappropriate for this instance.

init

public final void init(KeyStore store)
                throws 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:
KeyStoreException - If there is a problem reading from the key store.