javax.net.ssl.TrustManagerFactory Maven / Gradle / Ivy

Neither this file nor any files generated from it describe a complete specification, and they may only be used as described below. For example, no permission is given for you to incorporate this file, in whole or in part, in an implementation of a Java specification.

Sun Microsystems Inc. owns the copyright in this file and it is provided to you for informative, as opposed to normative, use. The file and any files generated from it may be used to generate other informative documentation, such as a unified set of documents of API signatures for a platform that includes technologies expressed as Java APIs. The file may also be used to produce "compilation stubs," which allow applications to be compiled and validated for such platforms.

Any work generated from this file, such as unified javadocs or compiled stub files, must be accompanied by this notice in its entirety.

This work corresponds to the API signatures of CDC Security (Java Secure Socket Extension - JSSE) Optional Package interfaces and modules. */ /* * @(#)TrustManagerFactory.java 1.7 05/03/12 */ /* * NOTE: * Because of various external restrictions (i.e. US export * regulations, etc.), the actual source code can not be provided * at this time. This file represents the skeleton of the source * file, so that javadocs of the API can be created. */ package javax.net.ssl; import java.security.*; import java.security.Security; /** * This class acts as a factory for trust managers based on a * source of trust material. Each trust manager manages a specific * type of trust material for use by secure sockets. The trust * material is based on a KeyStore and/or provider specific sources. * * @since 1.4 * @see TrustManager * @version 1.12 */ public class TrustManagerFactory { /** * Creates a TrustManagerFactory object. * * @param factorySpi the delegate * @param provider the provider * @param algorithm the algorithm */ protected TrustManagerFactory(TrustManagerFactorySpi factorySpi, Provider provider, String algorithm) { } /** * Obtains the default TrustManagerFactory algorithm name. * *

The default TrustManager can be changed at runtime by setting * the value of the "ssl.TrustManagerFactory.algorithm" security * property (set in the Java security properties file or by calling * {@link java.security.Security#setProperty(String, String) }) * to the desired algorithm name. * * @return the default algorithm name as specified in the * Java security properties, or an implementation-specific default * if no such property exists. */ public static final String getDefaultAlgorithm() { return null; } /** * Returns the algorithm name of this TrustManagerFactory * object. * *

This is the same name that was specified in one of the * getInstance calls that created this * TrustManagerFactory object. * * @return the algorithm name of this TrustManagerFactory * object */ public final String getAlgorithm() { return null; } /** * Generates a TrustManagerFactory object that implements the * specified trust management algorithm. *

* If the default provider package provides an implementation of the * requested trust management algorithm, an instance of * TrustManagerFactory containing that implementation is * returned. If the algorithm is not available in the default provider * package, other provider packages are searched. * * @param algorithm the standard name of the requested trust management * algorithm. * @return the new TrustManagerFactory object * @exception NoSuchAlgorithmException if the specified algorithm is not * available in the default provider package or any of the other * provider packages that were searched. */ public static final TrustManagerFactory getInstance(String algorithm) throws NoSuchAlgorithmException { return null; } /** * Generates a TrustManagerFactory object for the specified * trust management algorithm from the specified provider. * * @param algorithm the standard name of the requested trust management * algorithm. * @param provider the name of the provider * @return the new TrustManagerFactory object * @throws NoSuchAlgorithmException if the specified algorithm is not * available from the specified provider. * @throws NoSuchProviderException if the specified provider has not * been configured. * @throws IllegalArgumentException if provider is not specified */ public static final TrustManagerFactory getInstance(String algorithm, String provider) throws NoSuchAlgorithmException, NoSuchProviderException { return null; } /** * Generates a TrustManagerFactory object for the specified * trust management algorithm from the specified provider. * * @param algorithm the standard name of the requested trust management * algorithm. * @param provider an instance of the provider * @return the new TrustManagerFactory object * @throws NoSuchAlgorithmException if the specified algorithm is not * available from the specified provider. * @throws IllegalArgumentException if provider is not specified */ public static final TrustManagerFactory getInstance(String algorithm, Provider provider) throws NoSuchAlgorithmException { return null; } /** * Returns the provider of this TrustManagerFactory object. * * @return the provider of this TrustManagerFactory object */ public final Provider getProvider() { return null; } /** * Initializes this factory with a source of certificate * authorities and related trust material. *

* The provider typically uses a KeyStore as a basis for making * trust decisions. *

* For more flexible initialization, please see * {@link #init(ManagerFactoryParameters)}. * * @param ks the key store, or null * @throws KeyStoreException if this operation fails */ public final void init(KeyStore ks) throws KeyStoreException { } /** * Initializes this factory with a source of provider-specific * trust material. *