Package javax.security.cert

Class Certificate

java.lang.Object

javax.security.cert.Certificate

Direct Known Subclasses:

X509Certificate

public abstract class Certificate
extends Object

Abstract class to represent identity certificates. It represents a way to verify the binding of a Principal and its public key. Examples are X.509, PGP, and SDSI.

Note: This package is provided only for compatibility reasons. It contains a simplified version of the java.security.cert package that was previously used by JSSE (Java SSL package). All applications that do not have to be compatible with older versions of JSSE (that is before Java SDK 1.5) should only use java.security.cert.

Constructor Summary

Constructors

Constructor	Description
Certificate()	Creates a new Certificate.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)	Compares the argument to this Certificate.
abstract byte[]	getEncoded()	Returns the encoded representation for this certificate.
abstract PublicKey	getPublicKey()	Returns the public key corresponding to this certificate.
int	hashCode()	Returns an integer hash code for the receiver.
abstract String	toString()	Returns a string containing a concise, human-readable description of the receiver.
abstract void	verify(PublicKey key)	Verifies that this certificate was signed with the given public key.
abstract void	verify(PublicKey key, String sigProvider)	Verifies that this certificate was signed with the given public key.

Methods inherited from class java.lang.Object

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

Constructor Detail

Certificate

public Certificate()

Creates a new Certificate.

Method Detail

equals

public boolean equals(Object obj)

Compares the argument to this Certificate. If both have the same bytes they are assumed to be equal.

Overrides:

equals in class Object

Parameters:

obj - the Certificate to compare with this object

Returns:

true if obj is the same as this Certificate, false otherwise

See Also:

hashCode()

hashCode

public int hashCode()

Returns an integer hash code for the receiver. Any two objects which return true when passed to equals must answer the same value for this method.

Overrides:

hashCode in class Object

Returns:

the receiver's hash

See Also:

equals(java.lang.Object)

getEncoded

public abstract byte[] getEncoded()
                           throws CertificateEncodingException

Returns the encoded representation for this certificate.

Returns:

the encoded representation for this certificate.

Throws:

CertificateEncodingException - if encoding fails.

verify

public abstract void verify(PublicKey key)
                     throws CertificateException,
                            NoSuchAlgorithmException,
                            InvalidKeyException,
                            NoSuchProviderException,
                            SignatureException

Verifies that this certificate was signed with the given public key.

Parameters:

key - public key for which verification should be performed.

Throws:

CertificateException - if encoding errors are detected

NoSuchAlgorithmException - if an unsupported algorithm is detected

InvalidKeyException - if an invalid key is detected

NoSuchProviderException - if there is no default provider

SignatureException - if signature errors are detected

verify

public abstract void verify(PublicKey key,
                            String sigProvider)
                     throws CertificateException,
                            NoSuchAlgorithmException,
                            InvalidKeyException,
                            NoSuchProviderException,
                            SignatureException

Verifies that this certificate was signed with the given public key. Uses the signature algorithm given by the provider.

Parameters:

key - public key for which verification should be performed.

sigProvider - the name of the signature provider.

Throws:

CertificateException - if encoding errors are detected

NoSuchAlgorithmException - if an unsupported algorithm is detected

InvalidKeyException - if an invalid key is detected

NoSuchProviderException - if the specified provider does not exists.

SignatureException - if signature errors are detected

toString

public abstract String toString()

Returns a string containing a concise, human-readable description of the receiver.

Overrides:

toString in class Object

Returns:

a printable representation for the receiver.

getPublicKey

public abstract PublicKey getPublicKey()

Returns the public key corresponding to this certificate.

Returns:

the public key corresponding to this certificate.