CertPathBuilder JDK 1.6)

publicfinal CertPathBuilderResult build (CertPathParameters params) throws CertPathBuilderException InvalidAlgorithmParameterException

Attempts to build a certification path using the specified algorithm parameter set.

Attempts to build a certification path using the specified algorithm
parameter set.
Returns: the result of the build algorithm
Parameters:
- params - the algorithm parameters
Throws:
- CertPathBuilderException - if the builder is unable to construct a certification path that satisfies the specified parameters
- InvalidAlgorithmParameterException - if the specified parameters are inappropriate for this CertPathBuilder

publicfinal String getAlgorithm ()

Returns the name of the algorithm of this CertPathBuilder.

Returns the name of the algorithm of this CertPathBuilder.
Returns: the name of the algorithm of this CertPathBuilder

publicfinalstatic String getDefaultType ()

Returns the default CertPathBuilder type as specified in the Java security properties file, or the string "PKIX" if no such property exists.

Returns the default CertPathBuilder type as specified in the Java security properties file, or the string "PKIX" if no such property exists. The Java security properties file is located in the file named <JAVA_HOME>/lib/security/java.security. <JAVA_HOME> refers to the value of the java.home system property, and specifies the directory where the JRE is installed.

The default CertPathBuilder type can be used by applications that do not want to use a hard-coded type when calling one of the getInstance methods, and want to provide a default type in case a user does not specify its own.

The default CertPathBuilder type can be changed by setting the value of the "certpathbuilder.type" security property (in the Java security properties file) to the desired type.
Returns: the default CertPathBuilder type as specified in the Java security properties file, or the string "PKIX" if no such property exists.

publicstatic CertPathBuilder getInstance (String algorithm) throws NoSuchAlgorithmException

Returns a CertPathBuilder object that implements the specified algorithm.

This method traverses the list of registered security Providers, starting with the most preferred Provider. A new CertPathBuilder object encapsulating the CertPathBuilderSpi implementation from the first Provider that supports the specified algorithm is returned.

Note that the list of registered providers may be retrieved via the Security.getProviders() method.
Returns: a CertPathBuilder object that implements the specified algorithm.
Parameters:
- algorithm - the name of the requested CertPathBuilder algorithm. See Appendix A in the Java Certification Path API Programmer's Guide for information about standard algorithm names.
Throws:
- NoSuchAlgorithmException - if no Provider supports a CertPathBuilderSpi implementation for the specified algorithm.
See Also: Provider,

publicstatic CertPathBuilder getInstance (String algorithm, Provider provider) throws NoSuchAlgorithmException

Returns a CertPathBuilder object that implements the specified algorithm.

A new CertPathBuilder object encapsulating the CertPathBuilderSpi implementation from the specified Provider object is returned. Note that the specified Provider object does not have to be registered in the provider list.
Returns: a CertPathBuilder object that implements the specified algorithm.
Parameters:
- algorithm - the name of the requested CertPathBuilder algorithm. See Appendix A in the Java Certification Path API Programmer's Guide for information about standard algorithm names.
- provider - the provider.
Throws:
- NoSuchAlgorithmException - if a CertPathBuilderSpi implementation for the specified algorithm is not available from the specified Provider object.
- IllegalArgumentException - if the provider is null.
See Also: Provider,

publicstatic CertPathBuilder getInstance (String algorithm, String provider) throws NoSuchAlgorithmException NoSuchProviderException

Returns a CertPathBuilder object that implements the specified algorithm.

A new CertPathBuilder object encapsulating the CertPathBuilderSpi implementation from the specified provider is returned. The specified provider must be registered in the security provider list.

Note that the list of registered providers may be retrieved via the Security.getProviders() method.
Returns: a CertPathBuilder object that implements the specified algorithm.
Parameters:
- algorithm - the name of the requested CertPathBuilder algorithm. See Appendix A in the Java Certification Path API Programmer's Guide for information about standard algorithm names.
- provider - the name of the provider.
Throws:
- NoSuchAlgorithmException - if a CertPathBuilderSpi implementation for the specified algorithm is not available from the specified provider.
- NoSuchProviderException - if the specified provider is not registered in the security provider list.
- IllegalArgumentException - if the provider is null or empty.
See Also: Provider,

publicfinal Provider getProvider ()

Returns the provider of this CertPathBuilder.

Returns the provider of this CertPathBuilder.
Returns: the provider of this CertPathBuilder