|
Bouncy Castle Cryptography 1.22 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.bouncycastle.jce.cert.CertPathValidator
A class for validating certification paths (also known as certificate
chains).
This class uses a provider-based architecture, as described in the Java
Cryptography Architecture. To create a CertPathValidator
,
call one of the static getInstance
methods, passing in the
algorithm name of the CertPathValidator
desired and
optionally the name of the provider desired.
Once a CertPathValidator
object has been created, it can
be used to validate certification paths by calling the validate
method and passing it the CertPath
to be validated
and an algorithm-specific set of parameters. If successful, the result is
returned in an object that implements the
CertPathValidatorResult
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 CertPathValidator
instance concurrently should
synchronize amongst themselves and provide the necessary locking. Multiple
threads each manipulating a different CertPathValidator
instance need not synchronize.
Uses CertUtil
to actualiy load the SPI classes.
CertPath
,
CertUtil
Constructor Summary | |
protected |
CertPathValidator(CertPathValidatorSpi validatorSpi,
java.security.Provider provider,
java.lang.String algorithm)
Creates a CertPathValidator object of the given algorithm,
and encapsulates the given provider implementation (SPI object) in it. |
Method Summary | |
java.lang.String |
getAlgorithm()
Returns the algorithm name of this CertPathValidator . |
static java.lang.String |
getDefaultType()
Returns the default CertPathValidator type as specified in
the Java security properties file, or the string "PKIX"
if no such property exists. |
static CertPathValidator |
getInstance(java.lang.String algorithm)
Returns a CertPathValidator object that implements the
specified algorithm.If the default provider package provides an implementation of the specified CertPathValidator algorithm, an instance of
CertPathValidator containing that implementation is
returned. |
static CertPathValidator |
getInstance(java.lang.String algorithm,
java.security.Provider provider)
Returns a CertPathValidator object that implements the
specified algorithm, as supplied by the specified provider. |
static CertPathValidator |
getInstance(java.lang.String algorithm,
java.lang.String provider)
Returns a CertPathValidator object that implements the
specified algorithm, as supplied by the specified provider. |
java.security.Provider |
getProvider()
Returns the Provider of this
CertPathValidator . |
CertPathValidatorResult |
validate(CertPath certPath,
CertPathParameters params)
Validates the specified certification path using the specified algorithm parameter set. The CertPath specified must be of a type that is
supported by the validation algorithm, otherwise an
InvalidAlgorithmParameterException will be thrown. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
protected CertPathValidator(CertPathValidatorSpi validatorSpi, java.security.Provider provider, java.lang.String algorithm)
CertPathValidator
object of the given algorithm,
and encapsulates the given provider implementation (SPI object) in it.validatorSpi
- the provider implementationprovider
- the provideralgorithm
- the algorithm nameMethod Detail |
public static CertPathValidator getInstance(java.lang.String algorithm) throws java.security.NoSuchAlgorithmException
CertPathValidator
object that implements the
specified algorithm.CertPathValidator
algorithm, an instance of
CertPathValidator
containing that implementation is
returned. If the requested algorithm is not available in the default
package, other packages are searched.algorithm
- the name of the requested CertPathValidator
algorithmCertPathValidator
object that implements the
specified algorithmjava.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 CertPathValidator getInstance(java.lang.String algorithm, java.lang.String provider) throws java.security.NoSuchAlgorithmException, java.security.NoSuchProviderException
CertPathValidator
object that implements the
specified algorithm, as supplied by the specified provider.algorithm
- the name of the requested CertPathValidator
algorithmprovider
- the name of the providerCertPathValidator
object that implements the
specified algorithm, as supplied by the specified providerjava.security.NoSuchAlgorithmException
- if the requested algorithm
is not available from the specified providerjava.security.NoSuchProviderException
- if the provider has not been
configuredjava.lang.IllegalArgumentException
- if the provider
is
nullpublic static CertPathValidator getInstance(java.lang.String algorithm, java.security.Provider provider) throws java.security.NoSuchAlgorithmException
CertPathValidator
object that implements the
specified algorithm, as supplied by the specified provider.
Note: the provider
doesn't have to be registered.algorithm
- the name of the requested
CertPathValidator
algorithmprovider
- the providerCertPathValidator
object that implements the
specified algorithm, as supplied by the specified providerjava.security.NoSuchAlgorithmException
- if the requested algorithm
is not available from the specified providerjava.lang.IllegalArgumentException
- if the provider
is
nullpublic final java.security.Provider getProvider()
Provider
of this
CertPathValidator
.Provider
of this CertPathValidator
public final java.lang.String getAlgorithm()
CertPathValidator
.CertPathValidator
public final CertPathValidatorResult validate(CertPath certPath, CertPathParameters params) throws CertPathValidatorException, java.security.InvalidAlgorithmParameterException
CertPath
specified must be of a type that is
supported by the validation algorithm, otherwise an
InvalidAlgorithmParameterException
will be thrown. For
example, a CertPathValidator
that implements the PKIX
algorithm validates CertPath
objects of type X.509.certPath
- the CertPath
to be validatedparams
- the algorithm parametersCertPathValidatorException
- if the CertPath
does not validatejava.security.InvalidAlgorithmParameterException
- if the specified
parameters or the type of the specified CertPath
are
inappropriate for this CertPathValidator
public static final java.lang.String getDefaultType()
CertPathValidator
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.CertPathValidator
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.CertPathValidator
type can be changed by
setting the value of the "certpathvalidator.type" security property
(in the Java security properties file) to the desired type.CertPathValidator
type as specified
in the Java security properties file, or the string "PKIX"
if no such property exists.
|
Bouncy Castle Cryptography 1.22 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |