package org.bouncycastle.jce.cert;

import java.security.InvalidAlgorithmParameterException;

/**
 * The Service Provider Interface (SPI) for the CertPathBuilder
 * class. All CertPathBuilder implementations must include a class
 * (the SPI class) that extends this class (CertPathBuilderSpi) and
 * implements all of its methods. In general, instances of this class
 * should only be accessed through the CertPathBuilder class. For
 * details, see the Java Cryptography Architecture.<br />
 * <br />
 * <b>Concurrent Access</b><br />
 * <br />
 * Instances of this class need not be protected against concurrent
 * access from multiple threads. Threads that need to access a single
 * CertPathBuilderSpi instance concurrently should synchronize amongst
 * themselves and provide the necessary locking before calling the
 * wrapping CertPathBuilder object.<br />
 * <br />
 * However, implementations of CertPathBuilderSpi may still encounter
 * concurrency issues, since multiple threads each manipulating a
 * different CertPathBuilderSpi instance need not synchronize.
 **/
public abstract class CertPathBuilderSpi
	extends Object
{
	/**
	 * The default constructor.
	 */
    public CertPathBuilderSpi() {}

	/**
	 * Attempts to build a certification path using the specified
	 * algorithm parameter set.
	 *
	 * @param params the algorithm parameters
	 *
	 * @return the result of the build algorithm
	 *
	 * @exception CertPathBuilderException if the builder is unable
	 * to construct a certification path that satisfies the
	 * specified
	 * @exception parametersInvalidAlgorithmParameterException if the
	 * specified parameters are inappropriate for this CertPathBuilder
	 */
    public abstract CertPathBuilderResult engineBuild( CertPathParameters params )
	throws CertPathBuilderException,
	InvalidAlgorithmParameterException;
}
