Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

java.security.cert
Class CertificateFactorySpi  view CertificateFactorySpi download CertificateFactorySpi.java

java.lang.Object
  extended byjava.security.cert.CertificateFactorySpi

public abstract class CertificateFactorySpi
extends java.lang.Object

CertificateFactorySpi is the abstract class Service Provider Interface (SPI) for the CertificateFactory class. A provider must implement all the abstract methods if they wish to supply a certificate factory for a particular certificate type. Ex: X.509 Certificate factories are used to generate certificates and certificate revocation lists (CRL) from their encoding.

Since:
JDK 1.2

Constructor Summary
CertificateFactorySpi()
          Constructs a new CertificateFactorySpi
 
Method Summary
abstract  Certificate engineGenerateCertificate(java.io.InputStream inStream)
          Generates a Certificate based on the encoded data read from the InputStream.
abstract  java.util.Collection engineGenerateCertificates(java.io.InputStream inStream)
          Returns a collection of certificates that were read from the input stream.
 CertPath engineGenerateCertPath(java.io.InputStream inStream)
          Generate a CertPath and initialize it with data parsed from the input stream.
 CertPath engineGenerateCertPath(java.io.InputStream inStream, java.lang.String encoding)
          Generate a CertPath and initialize it with data parsed from the input stream, using the specified encoding.
 CertPath engineGenerateCertPath(java.util.List certificates)
          Generate a CertPath and initialize it with the certificates in the java.util.List argument.
abstract  CRL engineGenerateCRL(java.io.InputStream inStream)
          Generates a CRL based on the encoded data read from the InputStream.
abstract  java.util.Collection engineGenerateCRLs(java.io.InputStream inStream)
          Generates CRLs based on the encoded data read from the InputStream.
 java.util.Iterator engineGetCertPathEncodings()
          Returns an Iterator of CertPath encodings supported by this factory, with the default encoding first.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

CertificateFactorySpi

public CertificateFactorySpi()
Constructs a new CertificateFactorySpi

Method Detail

engineGenerateCertificate

public abstract Certificate engineGenerateCertificate(java.io.InputStream inStream)
                                               throws CertificateException
Generates a Certificate based on the encoded data read from the 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 -----BEGIN CERTIFICATE-----, and -----END CERTIFICATE-----.


engineGenerateCertificates

public abstract java.util.Collection engineGenerateCertificates(java.io.InputStream inStream)
                                                         throws CertificateException
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.


engineGenerateCRL

public abstract CRL engineGenerateCRL(java.io.InputStream inStream)
                               throws CRLException
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.


engineGenerateCRLs

public abstract java.util.Collection engineGenerateCRLs(java.io.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.


engineGenerateCertPath

public CertPath engineGenerateCertPath(java.io.InputStream inStream)
                                throws CertificateException
Generate a CertPath and initialize it with data parsed from the input stream. The default encoding of this factory is used.


engineGenerateCertPath

public CertPath engineGenerateCertPath(java.io.InputStream inStream,
                                       java.lang.String encoding)
                                throws CertificateException
Generate a CertPath and initialize it with data parsed from the input stream, using the specified encoding.


engineGenerateCertPath

public CertPath engineGenerateCertPath(java.util.List certificates)
                                throws CertificateException
Generate a CertPath and initialize it with the certificates in the java.util.List argument.


engineGetCertPathEncodings

public java.util.Iterator engineGetCertPathEncodings()
Returns an Iterator of CertPath encodings supported by this factory, with the default encoding first. The returned Iterator cannot be modified.