CertificateFactory representing the
* specified certificate factory type.
*
* @param type The type of certificate factory to create.
* @return A CertificateFactory of the desired type.
* @throws CertificateException If the type of certificate factory is not
* implemented by any installed provider.
* @throws IllegalArgumentException if type is
* null or is an empty string.
*/
public static final CertificateFactory getInstance(String type)
throws CertificateException
{
Provider[] p = Security.getProviders();
CertificateException lastException = null;
for (int i = 0; i < p.length; i++)
try
{
return getInstance(type, p[i]);
}
catch (CertificateException x)
{
lastException = x;
}
if (lastException != null)
throw lastException;
throw new CertificateException(type);
}
/**
* Returns an instance of a CertificateFactory representing the
* specified certificate factory type from the named provider.
*
* @param type The type of certificate factory to create.
* @param provider The name of the provider to use.
* @return A CertificateFactory for the desired type.
* @throws CertificateException If the type of certificate is not implemented
* by the named provider.
* @throws NoSuchProviderException If the named provider is not installed.
* @throws IllegalArgumentException if either type or
* provider is null, or if
* type is an empty string.
*/
public static final CertificateFactory getInstance(String type,
String provider)
throws CertificateException, NoSuchProviderException
{
if (provider == null)
throw new IllegalArgumentException("provider MUST NOT be null");
Provider p = Security.getProvider(provider);
if (p == null)
throw new NoSuchProviderException(provider);
return getInstance(type, p);
}
/**
* Returns an instance of a CertificateFactory representing the
* specified certificate factory type from the designated provider.
*
* @param type The type of certificate factory to create.
* @param provider The provider from which to get the implementation.
* @return A CertificateFactory for the desired type.
* @throws CertificateException If the type of certificate is not implemented
* by the provider.
* @throws IllegalArgumentException if either type or
* provider is null, or if
* type is an empty string.
*/
public static final CertificateFactory getInstance(String type,
Provider provider)
throws CertificateException
{
Throwable cause;
try
{
Object spi = Engine.getInstance(CERTIFICATE_FACTORY, type, provider);
return new CertificateFactory((CertificateFactorySpi) spi, provider, type);
}
catch (ClassCastException x)
{
cause = x;
}
catch (InvocationTargetException x)
{
cause = x.getCause() != null ? x.getCause() : x;
}
catch (NoSuchAlgorithmException x)
{
cause = x;
}
CertificateException x = new CertificateException(type);
x.initCause(cause);
throw x;
}
/**
* Gets the provider of this implementation.
*
* @return The provider of this implementation.
*/
public final Provider getProvider()
{
return provider;
}
/**
* Returns the type of the certificate this factory creates.
*
* @return A string with the type of certificate
*/
public final String getType()
{
return type;
}
/**
* Generates a Certificate from the encoded data read
* from an InputStream.
*
* The input stream must contain only one certificate. * *
If there exists a specialized certificate class for the * certificate format handled by the certificate factory * then the return Ceritificate should be a typecast of it. * Ex: A X.509 CertificateFactory should return X509Certificate. * *
For X.509 certificates, the certificate in inStream must be * DER encoded and supplied in binary or printable (Base64) * encoding. If the certificate is in Base64 encoding, it must be * bounded by -----BEGINCERTIFICATE-----, and * -----END CERTIFICATE-----. * * @param inStream An input stream containing the certificate data. * @return A certificate initialized from the decoded InputStream data. * @throws CertificateException If an error occurs decoding the * certificate. */ public final Certificate generateCertificate(InputStream inStream) throws CertificateException { return certFacSpi.engineGenerateCertificate(inStream); } /** * Returns a collection of certificates that were read from the * input stream. It may be empty, have only one, or have * multiple certificates. * * For a X.509 certificate factory, the stream may contain a * single DER encoded certificate or a PKCS#7 certificate * chain. This is a PKCS#7 SignedData object with the * most significant field being certificates. If no * CRLs are present, then an empty collection is returned. * * @param inStream An input stream containing the certificate data. * @return A collection of certificates initialized from the decoded * InputStream data. * @throws CertificateException If an error occurs decoding the * certificates. */ public final Collection generateCertificates(InputStream inStream) throws CertificateException { return certFacSpi.engineGenerateCertificates(inStream); } /** * Generates a CRL based on the encoded data read * from the InputStream. * *
The input stream must contain only one CRL. * *
If there exists a specialized CRL class for the * CRL format handled by the certificate factory * then the return CRL should be a typecast of it. * Ex: A X.509 CertificateFactory should return X509CRL. * * @param inStream An input stream containing the CRL data. * @return A CRL initialized from the decoded InputStream data. * @throws CRLException If an error occurs decoding the CRL. */ public final CRL generateCRL(InputStream inStream) throws CRLException { return certFacSpi.engineGenerateCRL(inStream); } /** *
Generates CRLs based on the encoded data read * from the InputStream. * *
For a X.509 certificate factory, the stream may contain a
* single DER encoded CRL or a PKCS#7 CRL set. This is a
* PKCS#7 SignedData object with the most significant
* field being crls. If no CRLs are present, then an
* empty collection is returned.
*
* @param inStream an input stream containing the CRLs.
* @return a collection of CRLs initialized from the decoded
* InputStream data.
* @throws CRLException If an error occurs decoding the CRLs.
*/
public final Collection generateCRLs(InputStream inStream)
throws CRLException
{
return certFacSpi.engineGenerateCRLs( inStream );
}
/**
* Generate a {@link CertPath} and initialize it with data parsed from
* the input stream. The default encoding of this factory is used.
*
* @param inStream The InputStream containing the CertPath data.
* @return A CertPath initialized from the input stream data.
* @throws CertificateException If an error occurs decoding the
* CertPath.
*/
public final CertPath generateCertPath(InputStream inStream)
throws CertificateException
{
return certFacSpi.engineGenerateCertPath(inStream);
}
/**
* Generate a {@link CertPath} and initialize it with data parsed from
* the input stream, using the specified encoding.
*
* @param inStream The InputStream containing the CertPath data.
* @param encoding The encoding of the InputStream data.
* @return A CertPath initialized from the input stream data.
* @throws CertificateException If an error occurs decoding the
* CertPath.
*/
public final CertPath generateCertPath(InputStream inStream, String encoding)
throws CertificateException
{
return certFacSpi.engineGenerateCertPath(inStream, encoding);
}
/**
* Generate a {@link CertPath} and initialize it with the certificates
* in the {@link java.util.List} argument.
*
* @param certificates The list of certificates with which to create
* the CertPath.
* @return A CertPath initialized from the certificates.
* @throws CertificateException If an error occurs generating the
* CertPath.
*/
public final CertPath generateCertPath(List certificates)
throws CertificateException
{
return certFacSpi.engineGenerateCertPath(certificates);
}
/**
* Returns an Iterator of CertPath encodings supported by this
* factory, with the default encoding first. The returned Iterator
* cannot be modified.
*
* @return The Iterator of supported encodings.
*/
public final Iterator