Package org.apache.harmony.security.provider.cert

Class X509CertPathImpl

java.lang.Object

java.security.cert.CertPath

org.apache.harmony.security.provider.cert.X509CertPathImpl

All Implemented Interfaces:

Serializable

public class X509CertPathImpl
extends CertPath

This class is an implementation of X.509 CertPath. This implementation provides ability to create the instance of X.509 Certification Path by several means:
1. It can be created over the list of X.509 certificates (implementations of X509Certificate class) provided in constructor.
2. It can be created by means of getInstance methods on the base of the following ASN.1 DER encoded forms:
- PkiPath as defined in ITU-T Recommendation X.509(2000) Corrigendum 1(2001) (can be seen at ftp://ftp.bull.com/pub/OSIdirectory/DefectResolution/TechnicalCorrigenda/ApprovedTechnicalCorrigendaToX.509/8%7CX.509-TC1(4th).pdf)
- PKCS #7 SignedData object provided in the form of ContentInfo structure. CertPath object is generated on the base of certificates presented in certificates field of the SignedData object which in its turn is retrieved from ContentInfo structure. (see http://www.ietf.org/rfc/rfc2315.txt for more info on PKCS #7)

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.security.cert.CertPath

CertPath.CertPathRep

Field Summary

Fields

Modifier and Type	Field	Description
static ASN1SequenceOf	ASN1	ASN.1 DER Encoder/Decoder for PkiPath structure.

Constructor Summary

Constructors

Constructor	Description
X509CertPathImpl(List<? extends Certificate> certs)	Creates an instance of X.509 CertPath over the specified list of certificates.

Method Summary

Modifier and Type	Method	Description
List<X509Certificate>	getCertificates()	Returns an immutable List of the Certificates contained in the CertPath.
byte[]	getEncoded()	Returns in PkiPath format which is our default encoding.
byte[]	getEncoded(String encoding)	Returns an encoding of this CertPath using the given encoding from CertPath.getEncodings().
Iterator<String>	getEncodings()	Returns an Iterator over the supported encodings for a representation of the certificate path.
static X509CertPathImpl	getInstance(byte[] in)	Generates certification path object on the base of PkiPath encoded form provided via array of bytes.
static X509CertPathImpl	getInstance(byte[] in, String encoding)	Generates certification path object on the base of encoding provided via array of bytes.
static X509CertPathImpl	getInstance(InputStream in)	Generates certification path object on the base of PkiPath encoded form provided via input stream.
static X509CertPathImpl	getInstance(InputStream in, String encoding)	Generates certification path object on the basis of encoding provided via input stream.

Methods inherited from class java.security.cert.CertPath

equals, getType, hashCode, toString, writeReplace

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

ASN1

public static final ASN1SequenceOf ASN1

ASN.1 DER Encoder/Decoder for PkiPath structure.

Constructor Details

X509CertPathImpl

public X509CertPathImpl(List<? extends Certificate> certs)
                 throws CertificateException

Creates an instance of X.509 CertPath over the specified list of certificates.

Throws:

CertificateException - if some of the object in the list is not an instance of subclass of X509Certificate.

Method Details

getInstance

public static X509CertPathImpl getInstance(InputStream in)
                                    throws CertificateException

Generates certification path object on the base of PkiPath encoded form provided via input stream.

Throws:

CertificateException - if some problems occurred during the decoding.

getInstance

public static X509CertPathImpl getInstance(InputStream in,
String encoding)
                                    throws CertificateException

Generates certification path object on the basis of encoding provided via input stream. The format of provided encoded form is specified by parameter encoding.

Throws:

CertificateException - if specified encoding form is not supported, or some problems occurred during the decoding.

getInstance

public static X509CertPathImpl getInstance(byte[] in)
                                    throws CertificateException

Generates certification path object on the base of PkiPath encoded form provided via array of bytes.

Throws:

CertificateException - if some problems occurred during the decoding.

getInstance

public static X509CertPathImpl getInstance(byte[] in,
String encoding)
                                    throws CertificateException

Generates certification path object on the base of encoding provided via array of bytes. The format of provided encoded form is specified by parameter encoding.

Throws:

CertificateException - if specified encoding form is not supported, or some problems occurred during the decoding.

getCertificates

public List<X509Certificate> getCertificates()

Description copied from class: CertPath

Returns an immutable List of the Certificates contained in the CertPath.

Specified by:

getCertificates in class CertPath

Returns:

a list of Certificates in the CertPath.

See Also:

method documentation for more info

getEncoded

public byte[] getEncoded()
                  throws CertificateEncodingException

Returns in PkiPath format which is our default encoding.

Specified by:

getEncoded in class CertPath

Returns:

default encoding of the CertPath.

Throws:

CertificateEncodingException - if the encoding fails.

See Also:

CertPath.getEncoded()

getEncoded

public byte[] getEncoded(String encoding)
                  throws CertificateEncodingException

Description copied from class: CertPath

Returns an encoding of this CertPath using the given encoding from CertPath.getEncodings().

Specified by:

getEncoded in class CertPath

Throws:

CertificateEncodingException - if the encoding fails.

See Also:

CertPath.getEncoded(String)

getEncodings

public Iterator<String> getEncodings()

Description copied from class: CertPath

Returns an Iterator over the supported encodings for a representation of the certificate path.

Specified by:

getEncodings in class CertPath

Returns:

Iterator over supported encodings (as Strings).

See Also:

method documentation for more info