|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.lang.Throwable
java.lang.Exception
java.io.IOException
javax.microedition.pki.CertificateException
@TransactionType(value=NOT_SUPPORTED) public class CertificateException
The CertificateException
encapsulates an error that
occurred while a Certificate
is being used. If multiple errors
are found within a Certificate
the more significant error
should be reported in the exception.
Direct instances of this exception class are not bound to any context and can be
passed between contexts without any restrictions. Objects created and returned
by the methods of this class are owned by the caller. In particular, a call to the Throwable.getMessage()
returns a String instance bound to the owner context of the caller.
See Runtime Environment Specification for the Java Card Platform, Connected Edition, chapter 7 for details regarding transfer of ownership.
Field Summary | |
---|---|
static byte |
BAD_EXTENSIONS
Indicates a certificate has unrecognized critical extensions. |
static byte |
BROKEN_CHAIN
Indicates a certificate in a chain was not issued by the next authority in the chain. |
static byte |
CERTIFICATE_CHAIN_TOO_LONG
Indicates the server certificate chain exceeds the length allowed by an issuer's policy. |
static byte |
EXPIRED
Indicates a certificate is expired. |
static byte |
INAPPROPRIATE_KEY_USAGE
Indicates a certificate public key has been used in way deemed inappropriate by the issuer. |
static byte |
MISSING_SIGNATURE
Indicates a certificate object does not contain a signature. |
static byte |
NOT_YET_VALID
Indicates a certificate is not yet valid. |
static byte |
ROOT_CA_EXPIRED
Indicates the root CA's public key is expired. |
static byte |
SITENAME_MISMATCH
Indicates a certificate does not contain the correct site name. |
static byte |
UNAUTHORIZED_INTERMEDIATE_CA
Indicates an intermediate certificate in the chain does not have the authority to be a intermediate CA. |
static byte |
UNRECOGNIZED_ISSUER
Indicates a certificate was issued by an unrecognized entity. |
static byte |
UNSUPPORTED_PUBLIC_KEY_TYPE
Indicates that type of the public key in a certificate is not supported by the device. |
static byte |
UNSUPPORTED_SIGALG
Indicates a certificate was signed using an unsupported algorithm. |
static byte |
VERIFICATION_FAILED
Indicates a certificate failed verification. |
Constructor Summary | |
---|---|
CertificateException(Certificate certificate,
byte status)
Create a new exception with a Certificate
and specific error reason. |
|
CertificateException(String message,
Certificate certificate,
byte status)
Create a new exception with a message, Certificate ,
and specific error reason. |
Method Summary | |
---|---|
Certificate |
getCertificate()
Get the Certificate that caused the exception. |
byte |
getReason()
Get the reason code. |
Methods inherited from class java.lang.Throwable |
---|
getMessage, printStackTrace, toString |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final byte BAD_EXTENSIONS
public static final byte CERTIFICATE_CHAIN_TOO_LONG
public static final byte EXPIRED
public static final byte UNAUTHORIZED_INTERMEDIATE_CA
public static final byte MISSING_SIGNATURE
public static final byte NOT_YET_VALID
public static final byte SITENAME_MISMATCH
public static final byte UNRECOGNIZED_ISSUER
public static final byte UNSUPPORTED_SIGALG
public static final byte INAPPROPRIATE_KEY_USAGE
public static final byte BROKEN_CHAIN
public static final byte ROOT_CA_EXPIRED
public static final byte UNSUPPORTED_PUBLIC_KEY_TYPE
public static final byte VERIFICATION_FAILED
Constructor Detail |
---|
public CertificateException(Certificate certificate, byte status)
Certificate
and specific error reason. The descriptive message for the new exception
will be automatically provided, based on the reason.
certificate
- the certificate that caused the exceptionstatus
- the reason for the exception;
the status MUST be between BAD_EXTENSIONS and VERIFICATION_FAILED
inclusive.public CertificateException(String message, Certificate certificate, byte status)
Certificate
,
and specific error reason.
message
- a descriptive messagecertificate
- the certificate that caused the exceptionstatus
- the reason for the exception;
the status MUST be between BAD_EXTENSIONS and VERIFICATION_FAILED
inclusive.Method Detail |
---|
public Certificate getCertificate()
Certificate
that caused the exception.
Certificate
that included the failure.public byte getReason()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |