Package java.security.cert

Class CertPathValidator

java.lang.Object

java.security.cert.CertPathValidator

public class CertPathValidator
extends Object

This class provides the functionality for validating certification paths (certificate chains) establishing a trust chain from a certificate to a trust anchor.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	CertPathValidator(CertPathValidatorSpi validatorSpi, Provider provider, String algorithm)	Creates a new CertPathValidator instance.

Method Summary

Modifier and Type	Method	Description
String	getAlgorithm()	Returns the certification path algorithm name.
static String	getDefaultType()	Returns the default CertPathValidator type from the Security Properties.
static CertPathValidator	getInstance(String algorithm)	Returns a new certification path validator for the specified algorithm.
static CertPathValidator	getInstance(String algorithm, String provider)	Returns a new certification path validator for the specified algorithm from the specified provider.
static CertPathValidator	getInstance(String algorithm, Provider provider)	Returns a new certification path validator for the specified algorithm from the specified provider.
Provider	getProvider()	Returns the security provider.
CertPathValidatorResult	validate(CertPath certPath, CertPathParameters params)	Validates the CertPath with the algorithm of this CertPathValidator using the specified algorithm parameters.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

CertPathValidator

protected CertPathValidator(CertPathValidatorSpi validatorSpi, Provider provider, String algorithm)

Creates a new CertPathValidator instance.

Parameters:

validatorSpi - the implementation delegate.

provider - the security provider.

algorithm - the name of the algorithm.

Method Details

getAlgorithm

public final String getAlgorithm()

Returns the certification path algorithm name.

Returns:

the certification path algorithm name.

getProvider

public final Provider getProvider()

Returns the security provider.

Returns:

the provider.

getInstance

public static CertPathValidator getInstance(String algorithm) throws NoSuchAlgorithmException

Returns a new certification path validator for the specified algorithm.

Parameters:

algorithm - the algorithm name.

Returns:

a certification path validator for the requested algorithm.

Throws:

NoSuchAlgorithmException - if no installed provider provides the specified algorithm.

NullPointerException - if algorithm is null.

getInstance

public static CertPathValidator getInstance(String algorithm, String provider) throws NoSuchAlgorithmException, NoSuchProviderException

Returns a new certification path validator for the specified algorithm from the specified provider.

Parameters:

algorithm - the algorithm name.

provider - the security provider name.

Returns:

a certification path validator for the requested algorithm.

Throws:

NoSuchAlgorithmException - if the specified security provider cannot provide the requested algorithm.

NoSuchProviderException - if no provider with the specified name can be found.

NullPointerException - if algorithm is null.

IllegalArgumentException - if provider == null || provider.isEmpty()

getInstance

public static CertPathValidator getInstance(String algorithm, Provider provider) throws NoSuchAlgorithmException

Returns a new certification path validator for the specified algorithm from the specified provider.

Parameters:

algorithm - the algorithm name.

provider - the security provider name.

Returns:

a certification path validator for the requested algorithm.

Throws:

NoSuchAlgorithmException - if the specified provider cannot provide the requested algorithm.

IllegalArgumentException - if provider == null

NullPointerException - if algorithm is null.

validate

public final CertPathValidatorResult validate(CertPath certPath, CertPathParameters params) throws CertPathValidatorException, InvalidAlgorithmParameterException

Validates the CertPath with the algorithm of this CertPathValidator using the specified algorithm parameters.

Parameters:

certPath - the certification path to be validated.

params - the certification path validator algorithm parameters.

Returns:

the validation result.

Throws:

CertPathValidatorException - if the validation fails, or the algorithm of the specified certification path cannot be validated using the algorithm of this instance.

InvalidAlgorithmParameterException - if the specified algorithm parameters cannot be used with this algorithm.

See Also:

CertPathValidatorResult

getDefaultType

public static final String getDefaultType()

Returns the default CertPathValidator type from the Security Properties.

Returns:

the default CertPathValidator type from the Security Properties, or the string "PKIX" if it cannot be determined.