CertPathValidatorpublic class CertPathValidator extends Object | 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 {@link #validate
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. |
| Fields Summary |
|---|
| private static final String | CPV_TYPE | | private static final Debug | debug | | private CertPathValidatorSpi | validatorSpi | | private Provider | provider | | private String | algorithm |
| Constructors Summary |
|---|
protected CertPathValidator(CertPathValidatorSpi validatorSpi, Provider provider, String algorithm)Creates a CertPathValidator object of the given algorithm,
and encapsulates the given provider implementation (SPI object) in it.
this.validatorSpi = validatorSpi;
this.provider = provider;
this.algorithm = algorithm;
|
| Methods Summary |
|---|
| public final java.lang.String | getAlgorithm()Returns the algorithm name of this CertPathValidator.
return this.algorithm;
| | public static final 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. 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 JDK was
installed.
The default 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.
The default 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.
String cpvtype;
cpvtype = (String)AccessController.doPrivileged(new PrivilegedAction() {
public Object run() {
return Security.getProperty(CPV_TYPE);
}
});
if (cpvtype == null) {
cpvtype = "PKIX";
}
return cpvtype;
| | public static java.security.cert.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. If the requested algorithm is not available in the default
package, other packages are searched.
Instance instance = GetInstance.getInstance("CertPathValidator",
CertPathValidatorSpi.class, algorithm);
return new CertPathValidator((CertPathValidatorSpi)instance.impl,
instance.provider, algorithm);
| | public static java.security.cert.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.
Instance instance = GetInstance.getInstance("CertPathValidator",
CertPathValidatorSpi.class, algorithm, provider);
return new CertPathValidator((CertPathValidatorSpi)instance.impl,
instance.provider, algorithm);
| | public static java.security.cert.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.
Note: the provider doesn't have to be registered.
Instance instance = GetInstance.getInstance("CertPathValidator",
CertPathValidatorSpi.class, algorithm, provider);
return new CertPathValidator((CertPathValidatorSpi)instance.impl,
instance.provider, algorithm);
| | public final java.security.Provider | getProvider()Returns the Provider of this
CertPathValidator.
return this.provider;
| | public final java.security.cert.CertPathValidatorResult | validate(java.security.cert.CertPath certPath, java.security.cert.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. For
example, a CertPathValidator that implements the PKIX
algorithm validates CertPath objects of type X.509.
return validatorSpi.engineValidate(certPath, params);
|
|
