src/share/classes/java/security/cert/CertPathValidatorSpi.java

Print this page

        

*** 29,55 **** /** * * The <i>Service Provider Interface</i> (<b>SPI</b>) * for the {@link CertPathValidator CertPathValidator} class. All ! * <code>CertPathValidator</code> implementations must include a class (the ! * SPI class) that extends this class (<code>CertPathValidatorSpi</code>) * and implements all of its methods. In general, instances of this class ! * should only be accessed through the <code>CertPathValidator</code> class. * For details, see the Java Cryptography Architecture. * <p> * <b>Concurrent Access</b> * <p> * Instances of this class need not be protected against concurrent * access from multiple threads. Threads that need to access a single ! * <code>CertPathValidatorSpi</code> instance concurrently should synchronize * amongst themselves and provide the necessary locking before calling the ! * wrapping <code>CertPathValidator</code> object. * <p> ! * However, implementations of <code>CertPathValidatorSpi</code> may still * encounter concurrency issues, since multiple threads each ! * manipulating a different <code>CertPathValidatorSpi</code> instance need not * synchronize. * * @since 1.4 * @author Yassir Elley */ --- 29,55 ---- /** * * The <i>Service Provider Interface</i> (<b>SPI</b>) * for the {@link CertPathValidator CertPathValidator} class. All ! * {@code CertPathValidator} implementations must include a class (the ! * SPI class) that extends this class ({@code CertPathValidatorSpi}) * and implements all of its methods. In general, instances of this class ! * should only be accessed through the {@code CertPathValidator} class. * For details, see the Java Cryptography Architecture. * <p> * <b>Concurrent Access</b> * <p> * Instances of this class need not be protected against concurrent * access from multiple threads. Threads that need to access a single ! * {@code CertPathValidatorSpi} instance concurrently should synchronize * amongst themselves and provide the necessary locking before calling the ! * wrapping {@code CertPathValidator} object. * <p> ! * However, implementations of {@code CertPathValidatorSpi} may still * encounter concurrency issues, since multiple threads each ! * manipulating a different {@code CertPathValidatorSpi} instance need not * synchronize. * * @since 1.4 * @author Yassir Elley */
*** 62,85 **** /** * Validates the specified certification path using the specified * algorithm parameter set. * <p> ! * The <code>CertPath</code> specified must be of a type that is * supported by the validation algorithm, otherwise an ! * <code>InvalidAlgorithmParameterException</code> will be thrown. For ! * example, a <code>CertPathValidator</code> that implements the PKIX ! * algorithm validates <code>CertPath</code> objects of type X.509. * ! * @param certPath the <code>CertPath</code> to be validated * @param params the algorithm parameters * @return the result of the validation algorithm ! * @exception CertPathValidatorException if the <code>CertPath</code> * does not validate * @exception InvalidAlgorithmParameterException if the specified ! * parameters or the type of the specified <code>CertPath</code> are ! * inappropriate for this <code>CertPathValidator</code> */ public abstract CertPathValidatorResult engineValidate(CertPath certPath, CertPathParameters params) throws CertPathValidatorException, InvalidAlgorithmParameterException; --- 62,85 ---- /** * Validates the specified certification path using the specified * algorithm parameter set. * <p> ! * The {@code CertPath} specified must be of a type that is * supported by the validation algorithm, otherwise an ! * {@code InvalidAlgorithmParameterException} will be thrown. For ! * example, a {@code CertPathValidator} that implements the PKIX ! * algorithm validates {@code CertPath} objects of type X.509. * ! * @param certPath the {@code CertPath} to be validated * @param params the algorithm parameters * @return the result of the validation algorithm ! * @exception CertPathValidatorException if the {@code CertPath} * does not validate * @exception InvalidAlgorithmParameterException if the specified ! * parameters or the type of the specified {@code CertPath} are ! * inappropriate for this {@code CertPathValidator} */ public abstract CertPathValidatorResult engineValidate(CertPath certPath, CertPathParameters params) throws CertPathValidatorException, InvalidAlgorithmParameterException;