CertificateRevokedException

public class CertificateRevokedException
extends CertificateException

java.lang.Object
   ↳ java.lang.Throwable
     ↳ java.lang.Exception
       ↳ java.security.GeneralSecurityException
         ↳ java.security.cert.CertificateException
           ↳ java.security.cert.CertificateRevokedException


An exception that indicates an X.509 certificate is revoked. A CertificateRevokedException contains additional information about the revoked certificate, such as the date on which the certificate was revoked and the reason it was revoked.

Summary

Public constructors

CertificateRevokedException(Date revocationDate, CRLReason reason, X500Principal authority, Map<StringExtension> extensions)

Constructs a CertificateRevokedException with the specified revocation date, reason code, authority name, and map of extensions.

Public methods

X500Principal getAuthorityName()

Returns the name of the authority that signed the certificate's revocation status information.

Map<StringExtension> getExtensions()

Returns a map of X.509 extensions containing additional information about the revoked certificate, such as the Invalidity Date Extension.

Date getInvalidityDate()

Returns the invalidity date, as specified in the Invalidity Date extension of this CertificateRevokedException.

String getMessage()

Returns the detail message string of this throwable.

Date getRevocationDate()

Returns the date on which the certificate was revoked.

CRLReason getRevocationReason()

Returns the reason the certificate was revoked.

Inherited methods

final void addSuppressed(Throwable exception)

Appends the specified exception to the exceptions that were suppressed in order to deliver this exception.

Throwable fillInStackTrace()

Fills in the execution stack trace.

Throwable getCause()

Returns the cause of this throwable or null if the cause is nonexistent or unknown.

String getLocalizedMessage()

Creates a localized description of this throwable.

String getMessage()

Returns the detail message string of this throwable.

StackTraceElement[] getStackTrace()

Provides programmatic access to the stack trace information printed by printStackTrace().

final Throwable[] getSuppressed()

Returns an array containing all of the exceptions that were suppressed, typically by the try-with-resources statement, in order to deliver this exception.

Throwable initCause(Throwable cause)

Initializes the cause of this throwable to the specified value.

void printStackTrace()

Prints this throwable and its backtrace to the standard error stream.

void printStackTrace(PrintWriter s)

Prints this throwable and its backtrace to the specified print writer.

void printStackTrace(PrintStream s)

Prints this throwable and its backtrace to the specified print stream.

void setStackTrace(StackTraceElement[] stackTrace)

Sets the stack trace elements that will be returned by getStackTrace() and printed by printStackTrace() and related methods.

String toString()

Returns a short description of this throwable.

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public constructors

CertificateRevokedException

Added in API level 24
public CertificateRevokedException (Date revocationDate, 
                CRLReason reason, 
                X500Principal authority, 
                Map<StringExtension> extensions)

Constructs a CertificateRevokedException with the specified revocation date, reason code, authority name, and map of extensions.

Parameters
revocationDate Date: the date on which the certificate was revoked. The date is copied to protect against subsequent modification.

reason CRLReason: the revocation reason

authority X500Principal: the X500Principal that represents the name of the authority that signed the certificate's revocation status information

extensions Map: a map of X.509 Extensions. Each key is an OID String that maps to the corresponding Extension. The map is copied to prevent subsequent modification.

Throws
NullPointerException if revocationDate, reason, authority, or extensions is null

Public methods

getAuthorityName

Added in API level 24
public X500Principal getAuthorityName ()

Returns the name of the authority that signed the certificate's revocation status information.

Returns
X500Principal the X500Principal that represents the name of the authority that signed the certificate's revocation status information

getExtensions

Added in API level 24
public Map<StringExtension> getExtensions ()

Returns a map of X.509 extensions containing additional information about the revoked certificate, such as the Invalidity Date Extension. Each key is an OID String that maps to the corresponding Extension.

Returns
Map<StringExtension> an unmodifiable map of X.509 extensions, or an empty map if there are no extensions

getInvalidityDate

Added in API level 24
public Date getInvalidityDate ()

Returns the invalidity date, as specified in the Invalidity Date extension of this CertificateRevokedException. The invalidity date is the date on which it is known or suspected that the private key was compromised or that the certificate otherwise became invalid. This implementation calls getExtensions() and checks the returned map for an entry for the Invalidity Date extension OID ("2.5.29.24"). If found, it returns the invalidity date in the extension; otherwise null. A new Date object is returned each time the method is invoked to protect against subsequent modification.

Returns
Date the invalidity date, or null if not specified

getMessage

Added in API level 24
public String getMessage ()

Returns the detail message string of this throwable.

Returns
String the detail message string of this Throwable instance (which may be null).

getRevocationDate

Added in API level 24
public Date getRevocationDate ()

Returns the date on which the certificate was revoked. A new copy is returned each time the method is invoked to protect against subsequent modification.

Returns
Date the revocation date

getRevocationReason

Added in API level 24
public CRLReason getRevocationReason ()

Returns the reason the certificate was revoked.

Returns
CRLReason the revocation reason