|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.digt.trusted.jce.cert.DIGTCertPathBuilder
public class DIGTCertPathBuilder
A class for building certification paths (also known as certificate
chains).
This class uses a provider-based architecture, as described in the
Java Cryptography Architecture. To create a
CertPathBuilder
, call one of the static
getInstance
methods, passing in the algorithm name of
the CertPathBuilder desired and optionally the name of the provider
desired.
Once a CertPathBuilder
object has been created,
certification paths can be constructed by calling the
build
method and passing it an algorithm-specific set
of parameters. If successful, the result (including the CertPath
that was built) is returned in an object that implements the
CertPathBuilderResult
interface.
Concurrent Access
The static methods of this class are guaranteed to be
thread-safe. Multiple threads may concurrently invoke the static
methods defined in this class with no ill effects.
However, this is not true for the non-static methods defined by
this class. Unless otherwise documented by a specific provider,
threads that need to access a single CertPathBuilder
instance concurrently should synchronize amongst themselves and
provide the necessary locking. Multiple threads each manipulating a
different CertPathBuilder
instance need not
synchronize.
Uses CertUtil
to actualiy load the SPI classes.
CertUtil
Constructor Summary | |
---|---|
protected |
DIGTCertPathBuilder(java.security.cert.CertPathBuilderSpi builderSpi,
java.security.Provider provider,
java.lang.String algorithm)
Creates a CertPathBuilder object of the given algorithm, and encapsulates the given provider implementation (SPI object) in it. |
Method Summary | |
---|---|
java.security.cert.CertPathBuilderResult |
build(java.security.cert.CertPathParameters params)
Attempts to build a certification path using the specified algorithm parameter set. |
java.lang.String |
getAlgorithm()
Returns the name of the algorithm of this CertPathBuilder . |
static java.lang.String |
getDefaultType()
Returns the default CertPathBuilder type as specified in
the Java security properties file, or the string "PKIX"
if no such property exists. |
static DIGTCertPathBuilder |
getInstance(java.lang.String algorithm)
Returns a CertPathBuilder object that implements the specified algorithm. |
static DIGTCertPathBuilder |
getInstance(java.lang.String algorithm,
java.security.Provider provider)
Returns a CertPathBuilder object that implements the specified algorithm, as supplied by the specified provider. |
static DIGTCertPathBuilder |
getInstance(java.lang.String algorithm,
java.lang.String provider)
Returns a CertPathBuilder object that implements the specified algorithm, as supplied by the specified provider. |
java.security.Provider |
getProvider()
Returns the provider of this CertPathBuilder . |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
protected DIGTCertPathBuilder(java.security.cert.CertPathBuilderSpi builderSpi, java.security.Provider provider, java.lang.String algorithm)
builderSpi
- the provider implementationprovider
- the provideralgorithm
- the algorithm nameMethod Detail |
---|
public static DIGTCertPathBuilder getInstance(java.lang.String algorithm) throws java.security.NoSuchAlgorithmException
algorithm
- the name of the requested CertPathBuilder algorithm
java.security.NoSuchAlgorithmException
- if the requested
algorithm is not available in the default provider package
or any of the other provider packages that were searchedpublic static DIGTCertPathBuilder getInstance(java.lang.String algorithm, java.lang.String provider) throws java.security.NoSuchAlgorithmException, java.security.NoSuchProviderException
algorithm
- the name of the requested CertPathBuilder
algorithmprovider
- the name of the provider
java.security.NoSuchAlgorithmException
- if the requested algorithm
is not available from the specified provider
java.security.NoSuchProviderException
- if the provider has not
been configured
java.lang.IllegalArgumentException
- if the provider is nullpublic static DIGTCertPathBuilder getInstance(java.lang.String algorithm, java.security.Provider provider) throws java.security.NoSuchAlgorithmException
algorithm
- the name of the requested CertPathBuilder
algorithmprovider
- the provider
java.security.NoSuchAlgorithmException
- if the requested algorithm
is not available from the specified provider
java.lang.IllegalArgumentException
- if the provider is null.public final java.security.Provider getProvider()
CertPathBuilder
.
CertPathBuilder
public final java.lang.String getAlgorithm()
CertPathBuilder
.
CertPathBuilder
public final java.security.cert.CertPathBuilderResult build(java.security.cert.CertPathParameters params) throws java.security.cert.CertPathBuilderException, java.security.InvalidAlgorithmParameterException
params
- the algorithm parameters
java.security.cert.CertPathBuilderException
- if the builder is unable to construct
a certification path that satisfies the specified parameters
java.security.InvalidAlgorithmParameterException
- if the specified parameters * are inappropriate for this CertPathBuilder
public static final java.lang.String getDefaultType()
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,
where <JAVA_HOME> refers to the directory where the SDK was
installed.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.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.
CertPathBuilder
type as specified
in the Java security properties file, or the string "PKIX"
if no such property exists.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |