public abstract class

X509CRL

extends CRL
implements X509Extension
java.lang.Object
   ↳ java.security.cert.CRL
     ↳ java.security.cert.X509CRL

Class Overview

Abstract base class for X.509 certificate revocation lists (CRL).

More information regarding CRL can be found in RFC 2459, "Internet X.509 Public Key Infrastructure Certificate and CRL Profile" at http://www.ietf.org/rfc/rfc2459.txt .

Summary

Protected Constructors
X509CRL()
Creates a new X509CRL instance.
Public Methods
boolean equals(Object other)
Returns whether the specified object equals to this instance.
abstract byte[] getEncoded()
Returns this CRL in ASN.1 DER encoded form.
abstract Principal getIssuerDN()
Do not use, use getIssuerX500Principal() instead.
X500Principal getIssuerX500Principal()
Returns the issuer distinguished name of this CRL.
abstract Date getNextUpdate()
Returns the nextUpdate value of this CRL.
X509CRLEntry getRevokedCertificate(X509Certificate certificate)
Returns the CRL entry for the specified certificate.
abstract X509CRLEntry getRevokedCertificate(BigInteger serialNumber)
Returns the CRL entry with the specified certificate serial number.
abstract Set<? extends X509CRLEntry> getRevokedCertificates()
Returns the set of revoked certificates.
abstract String getSigAlgName()
Returns the name of the signature algorithm.
abstract String getSigAlgOID()
Returns the OID of the signature algorithm.
abstract byte[] getSigAlgParams()
Returns the parameters of the signature algorithm in DER encoded form.
abstract byte[] getSignature()
Returns the signature bytes of this CRL.
abstract byte[] getTBSCertList()
Returns the tbsCertList information of this CRL in DER encoded form.
abstract Date getThisUpdate()
Returns the thisUpdate value of this CRL.
abstract int getVersion()
Returns the version number of this CRL.
int hashCode()
Returns the hashcode of this CRL instance.
abstract void verify(PublicKey key)
Verifies this CRL by verifying that this CRL was signed with the corresponding private key to the specified public key.
abstract void verify(PublicKey key, String sigProvider)
Verifies this CRL by verifying that this CRL was signed with the corresponding private key to the specified public key.
[Expand]
Inherited Methods
From class java.security.cert.CRL
From class java.lang.Object
From interface java.security.cert.X509Extension

Protected Constructors

protected X509CRL ()

Since: API Level 1

Creates a new X509CRL instance.

Public Methods

public boolean equals (Object other)

Since: API Level 1

Returns whether the specified object equals to this instance.

Parameters
other the object to compare.
Returns
  • true if the specified object is equal to this, otherwise false.

public abstract byte[] getEncoded ()

Since: API Level 1

Returns this CRL in ASN.1 DER encoded form.

Returns
  • this CRL in ASN.1 DER encoded form.
Throws
CRLException if encoding fails.

public abstract Principal getIssuerDN ()

Since: API Level 1

Do not use, use getIssuerX500Principal() instead. Returns the issuer as an implementation specific Principal object.

Returns
  • the issuer distinguished name.

public X500Principal getIssuerX500Principal ()

Since: API Level 1

Returns the issuer distinguished name of this CRL.

Returns
  • the issuer distinguished name of this CRL.

public abstract Date getNextUpdate ()

Since: API Level 1

Returns the nextUpdate value of this CRL.

Returns
  • the nextUpdate value of this CRL, or null if none is present.

public X509CRLEntry getRevokedCertificate (X509Certificate certificate)

Since: API Level 1

Returns the CRL entry for the specified certificate.

Parameters
certificate the certificate to search a CRL entry for.
Returns
  • the entry for the specified certificate, or null if not found.

public abstract X509CRLEntry getRevokedCertificate (BigInteger serialNumber)

Since: API Level 1

Returns the CRL entry with the specified certificate serial number.

Parameters
serialNumber the certificate serial number to search for a CRL entry.
Returns
  • the entry for the specified certificate serial number, or null if not found.

public abstract Set<? extends X509CRLEntry> getRevokedCertificates ()

Since: API Level 1

Returns the set of revoked certificates.

Returns
  • the set of revoked certificates, or null if no revoked certificates are in this CRL.

public abstract String getSigAlgName ()

Since: API Level 1

Returns the name of the signature algorithm.

Returns
  • the name of the signature algorithm.

public abstract String getSigAlgOID ()

Since: API Level 1

Returns the OID of the signature algorithm.

Returns
  • the OID of the signature algorithm.

public abstract byte[] getSigAlgParams ()

Since: API Level 1

Returns the parameters of the signature algorithm in DER encoded form.

Returns
  • the parameters of the signature algorithm in DER encoded form, or null if not present.

public abstract byte[] getSignature ()

Since: API Level 1

Returns the signature bytes of this CRL.

Returns
  • the signature bytes of this CRL.

public abstract byte[] getTBSCertList ()

Since: API Level 1

Returns the tbsCertList information of this CRL in DER encoded form.

Returns
  • the CRL information in DER encoded form.
Throws
CRLException if encoding fails.

public abstract Date getThisUpdate ()

Since: API Level 1

Returns the thisUpdate value of this CRL.

Returns
  • the thisUpdate value of this CRL.

public abstract int getVersion ()

Since: API Level 1

Returns the version number of this CRL.

Returns
  • the version number of this CRL.

public int hashCode ()

Since: API Level 1

Returns the hashcode of this CRL instance.

Returns
  • the hashcode.

public abstract void verify (PublicKey key)

Since: API Level 1

Verifies this CRL by verifying that this CRL was signed with the corresponding private key to the specified public key.

Parameters
key the public key to verify this CRL with.
Throws
CRLException if encoding or decoding fails.
NoSuchAlgorithmException if a needed algorithm is not present.
InvalidKeyException if the specified key is invalid.
NoSuchProviderException if no provider can be found.
SignatureException if errors occur on signatures.

public abstract void verify (PublicKey key, String sigProvider)

Since: API Level 1

Verifies this CRL by verifying that this CRL was signed with the corresponding private key to the specified public key. The signature verification engine of the specified provider will be used.

Parameters
key the public key to verify this CRL with.
sigProvider the name of the provider for the signature algorithm.
Throws
CRLException if encoding decoding fails.
NoSuchAlgorithmException if a needed algorithm is not present.
InvalidKeyException if the specified key is invalid.
NoSuchProviderException if the specified provider cannot be found.
SignatureException if errors occur on signatures.