CertPathValidatorpublic class CertPathValidator extends Object | A class for validating certification paths (also known as certificate
chains).
This class uses a provider-based 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.
<JAVA_HOME> refers to the value of the java.home system property,
and specifies the directory where the JRE is 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.
This method traverses the list of registered security Providers,
starting with the most preferred Provider.
A new CertPathValidator object encapsulating the
CertPathValidatorSpi implementation from the first
Provider that supports the specified algorithm is returned.
Note that the list of registered providers may be retrieved via
the {@link Security#getProviders() Security.getProviders()} method.
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.
A new CertPathValidator object encapsulating the
CertPathValidatorSpi 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 {@link Security#getProviders() Security.getProviders()} method.
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.
A new CertPathValidator object encapsulating the
CertPathValidatorSpi implementation from the specified Provider
object is returned. Note that the specified Provider object
does not have to be registered in the provider list.
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);
|
|
