java.security.cert
Class CertPath
java.lang.Object
|
+--java.security.cert.CertPath
All Implemented Interfaces:
Serializable
This class represents an immutable sequence, or path, of security
certificates. The path type must match the type of each certificate in the
path, or in other words, for all instances of cert in a certpath object,
cert.getType().equals(certpath.getType())
will return true.
Since this class is immutable, it is thread-safe. During serialization,
the path is consolidated into a CertPathRep, which preserves the
data regardless of the underlying implementation of the path.
Since:Author:- Eric Blake <ebb9@email.byu.edu>
CertPath
protected CertPath(java.lang.String type)
Create a certificate path with the given type. Most code should use
CertificateFactory to create CertPaths.
Parameters:
equals
public boolean equals(java.lang.Object o)
Compares this path to another for semantic equality. To be equal, both
must be instances of CertPath, with the same type, and identical
certificate lists. Overriding classes must not change this behavior.
Parameters:
Returns:
- true if the two are equal
getCertificates
public List getCertificates()
Returns the immutable, thread-safe list of certificates in this path.
Returns:
- the list of certificates, non-null but possibly empty
getEncoded
public byte[] getEncoded()
Returns the encoded form of this path, via the default encoding.
Returns:
Throws:
getEncoded
public byte[] getEncoded(java.lang.String encoding)
Returns the encoded form of this path, via the specified encoding.
Parameters:
Returns:
Throws:
getEncodings
public Iterator getEncodings()
Get an immutable iterator over the path encodings (all String names),
starting with the default encoding. The iterator will throw an
UnsupportedOperationException
if an attempt is made to
remove items from the list.
Returns:
- the iterator of supported encodings in the path
getType
public String getType()
Get the (non-null) type of all certificates in the path.
Returns:
- the path certificate type
hashCode
public int hashCode()
Returns the hashcode of this certificate path. This is defined as:
31 * getType().hashCode() + getCertificates().hashCode()
.
Returns:
toString
public String toString()
writeReplace
protected Object writeReplace()
Serializes the path in its encoded form, to ensure reserialization with
the appropriate factory object without worrying about list implementation.
The result will always be an instance of CertPathRep.
Returns:
Throws:
cert.getType().equals(certpath.getType())
will return true.Since this class is immutable, it is thread-safe. During serialization, the path is consolidated into a CertPathRep, which preserves the data regardless of the underlying implementation of the path.