java.security.cert
public class CertificateFactory extends Object
Modifier | Constructor and Description |
---|---|
protected |
CertificateFactory(CertificateFactorySpi certFacSpi,
Provider provider,
String type)
Creates an instance of CertificateFactory.
|
Modifier and Type | Method and Description |
---|---|
Certificate |
generateCertificate(InputStream inStream)
Generates a Certificate from the encoded data read
from an InputStream.
|
Collection<? extends Certificate> |
generateCertificates(InputStream inStream)
Returns a collection of certificates that were read from the
input stream.
|
CertPath |
generateCertPath(InputStream inStream)
Generate a
CertPath and initialize it with data parsed from
the input stream. |
CertPath |
generateCertPath(InputStream inStream,
String encoding)
Generate a
CertPath and initialize it with data parsed from
the input stream, using the specified encoding. |
CertPath |
generateCertPath(List<? extends Certificate> certificates)
|
CRL |
generateCRL(InputStream inStream)
Generates a CRL based on the encoded data read
from the InputStream.
|
Collection<? extends CRL> |
generateCRLs(InputStream inStream)
Generates CRLs based on the encoded data read
from the InputStream.
|
Iterator<String> |
getCertPathEncodings()
Returns an Iterator of CertPath encodings supported by this
factory, with the default encoding first.
|
static CertificateFactory |
getInstance(String type)
Returns an instance of a
CertificateFactory representing the
specified certificate factory type. |
static CertificateFactory |
getInstance(String type,
Provider provider)
Returns an instance of a
CertificateFactory representing the
specified certificate factory type from the designated provider. |
static CertificateFactory |
getInstance(String type,
String provider)
Returns an instance of a
CertificateFactory representing the
specified certificate factory type from the named provider. |
Provider |
getProvider()
Gets the provider of this implementation.
|
String |
getType()
Returns the type of the certificate this factory creates.
|
protected CertificateFactory(CertificateFactorySpi certFacSpi, Provider provider, String type)
certFacSpi
- The underlying CertificateFactory engine.provider
- The provider of this implementation.type
- The type of Certificate this factory creates.public static final CertificateFactory getInstance(String type) throws CertificateException
CertificateFactory
representing the
specified certificate factory type.type
- The type of certificate factory to create.CertificateFactory
of the desired type.CertificateException
- If the type of certificate factory is not
implemented by any installed provider.IllegalArgumentException
- if type
is
null
or is an empty string.public static final CertificateFactory getInstance(String type, String provider) throws CertificateException, NoSuchProviderException
CertificateFactory
representing the
specified certificate factory type from the named provider.type
- The type of certificate factory to create.provider
- The name of the provider to use.CertificateFactory
for the desired type.CertificateException
- If the type of certificate is not implemented
by the named provider.NoSuchProviderException
- If the named provider is not installed.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
CertificateFactory
representing the
specified certificate factory type from the designated provider.type
- The type of certificate factory to create.provider
- The provider from which to get the implementation.CertificateFactory
for the desired type.CertificateException
- If the type of certificate is not implemented
by the provider.IllegalArgumentException
- if either type
or
provider
is null
, or if
type
is an empty string.public final Provider getProvider()
public final String getType()
public final Certificate generateCertificate(InputStream inStream) throws CertificateException
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-----.
inStream
- An input stream containing the certificate data.CertificateException
- If an error occurs decoding the
certificate.public final Collection<? extends Certificate> generateCertificates(InputStream inStream) throws CertificateException
inStream
- An input stream containing the certificate data.CertificateException
- If an error occurs decoding the
certificates.public final CRL generateCRL(InputStream inStream) throws CRLException
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.
inStream
- An input stream containing the CRL data.CRLException
- If an error occurs decoding the CRL.public final Collection<? extends CRL> generateCRLs(InputStream inStream) throws CRLException
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.
inStream
- an input stream containing the CRLs.CRLException
- If an error occurs decoding the CRLs.public final CertPath generateCertPath(InputStream inStream) throws CertificateException
CertPath
and initialize it with data parsed from
the input stream. The default encoding of this factory is used.inStream
- The InputStream containing the CertPath data.CertificateException
- If an error occurs decoding the
CertPath.public final CertPath generateCertPath(InputStream inStream, String encoding) throws CertificateException
CertPath
and initialize it with data parsed from
the input stream, using the specified encoding.inStream
- The InputStream containing the CertPath data.encoding
- The encoding of the InputStream data.CertificateException
- If an error occurs decoding the
CertPath.public final CertPath generateCertPath(List<? extends Certificate> certificates) throws CertificateException
certificates
- The list of certificates with which to create
the CertPath.CertificateException
- If an error occurs generating the
CertPath.public final Iterator<String> getCertPathEncodings()