com.tencent.kona.sun.security.provider.certpath

Class X509CertPath

java.lang.Object

java.security.cert.CertPath

com.tencent.kona.sun.security.provider.certpath.X509CertPath

All Implemented Interfaces:

java.io.Serializable

public class X509CertPath
extends java.security.cert.CertPath

A CertPath (certification path) consisting exclusively of X509Certificates.

By convention, X.509 CertPaths are stored from target to trust anchor. That is, the issuer of one certificate is the subject of the following one. However, unvalidated X.509 CertPaths may not follow this convention. PKIX CertPathValidators will detect any departure from this convention and throw a CertPathValidatorException.

Since:

1.4

See Also:

Serialized Form

Nested Class Summary

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

java.security.cert.CertPath.CertPathRep

Constructor Summary

Constructors

Constructor and Description
X509CertPath(java.io.InputStream is) Creates an X509CertPath, reading the encoded form from an InputStream.
X509CertPath(java.io.InputStream is, java.lang.String encoding) Creates an X509CertPath, reading the encoded form from an InputStream.
X509CertPath(java.util.List<? extends java.security.cert.Certificate> certs) Creates an X509CertPath from a List of X509Certificates.

Method Summary

Modifier and Type	Method and Description
java.util.List<java.security.cert.X509Certificate>	getCertificates() Returns the list of certificates in this certification path.
byte[]	getEncoded() Returns the encoded form of this certification path, using the default encoding.
byte[]	getEncoded(java.lang.String encoding) Returns the encoded form of this certification path, using the specified encoding.
java.util.Iterator<java.lang.String>	getEncodings() Returns an iteration of the encodings supported by this certification path, with the default encoding first.
static java.util.Iterator<java.lang.String>	getEncodingsStatic() Returns the encodings supported by this certification path, with the default encoding first.

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

Constructor Detail

X509CertPath

public X509CertPath(java.util.List<? extends java.security.cert.Certificate> certs)
             throws java.security.cert.CertificateException

Creates an X509CertPath from a List of X509Certificates.

The certificates are copied out of the supplied List object.

Parameters:

certs - a List of X509Certificates

Throws:

java.security.cert.CertificateException - if certs contains an element that is not an X509Certificate

X509CertPath

public X509CertPath(java.io.InputStream is)
             throws java.security.cert.CertificateException

Creates an X509CertPath, reading the encoded form from an InputStream. The data is assumed to be in the default encoding.

Parameters:

is - the InputStream to read the data from

Throws:

java.security.cert.CertificateException - if an exception occurs while decoding

X509CertPath

public X509CertPath(java.io.InputStream is,
                    java.lang.String encoding)
             throws java.security.cert.CertificateException

Creates an X509CertPath, reading the encoded form from an InputStream. The data is assumed to be in the specified encoding.

Parameters:

is - the InputStream to read the data from

encoding - the encoding used

Throws:

java.security.cert.CertificateException - if an exception occurs while decoding or the encoding requested is not supported

Method Detail

getEncoded

public byte[] getEncoded()
                  throws java.security.cert.CertificateEncodingException

Returns the encoded form of this certification path, using the default encoding.

Specified by:

getEncoded in class java.security.cert.CertPath

Returns:

the encoded bytes

Throws:

java.security.cert.CertificateEncodingException - if an encoding error occurs

getEncoded

public byte[] getEncoded(java.lang.String encoding)
                  throws java.security.cert.CertificateEncodingException

Returns the encoded form of this certification path, using the specified encoding.

Specified by:

getEncoded in class java.security.cert.CertPath

Parameters:

encoding - the name of the encoding to use

Returns:

the encoded bytes

Throws:

java.security.cert.CertificateEncodingException - if an encoding error occurs or the encoding requested is not supported

getEncodingsStatic

public static java.util.Iterator<java.lang.String> getEncodingsStatic()

Returns the encodings supported by this certification path, with the default encoding first.

Returns:

an Iterator over the names of the supported encodings (as Strings)

getEncodings

public java.util.Iterator<java.lang.String> getEncodings()

Returns an iteration of the encodings supported by this certification path, with the default encoding first.

Attempts to modify the returned Iterator via its remove method result in an UnsupportedOperationException.

Specified by:

getEncodings in class java.security.cert.CertPath

Returns:

an Iterator over the names of the supported encodings (as Strings)

getCertificates

public java.util.List<java.security.cert.X509Certificate> getCertificates()

Returns the list of certificates in this certification path. The List returned must be immutable and thread-safe.

Specified by:

getCertificates in class java.security.cert.CertPath

Returns:

an immutable List of X509Certificates (may be empty, but not null)