javax.microedition.pki
Class CertificateException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.io.IOException
                    |
                    +--javax.microedition.pki.CertificateException
Direct Known Subclasses:
TLSIOException

public class CertificateException
extends IOException

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.

Since:
MIDP 2.0

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

BAD_EXTENSIONS

public static final byte BAD_EXTENSIONS
Indicates a certificate has unrecognized critical extensions. The value is 1.
Since:
JDE 4.0.0

BROKEN_CHAIN

public static final byte BROKEN_CHAIN
Indicates a certificate in a chain was not issued by the next authority in the chain. The value is 11.
Since:
JDE 4.0.0

CERTIFICATE_CHAIN_TOO_LONG

public static final byte CERTIFICATE_CHAIN_TOO_LONG
Indicates the server certificate chain exceeds the length allowed by an issuer's policy. The value is 2.
Since:
JDE 4.0.0

EXPIRED

public static final byte EXPIRED
Indicates a certificate is expired. The value is 3.
Since:
JDE 4.0.0

INAPPROPRIATE_KEY_USAGE

public static final byte INAPPROPRIATE_KEY_USAGE
Indicates a certificate public key has been used in way deemed inappropriate by the issuer. The value is 10.
Since:
JDE 4.0.0

MISSING_SIGNATURE

public static final byte MISSING_SIGNATURE
Indicates a certificate object does not contain a signature. The value is 5.
Since:
JDE 4.0.0

NOT_YET_VALID

public static final byte NOT_YET_VALID
Indicates a certificate is not yet valid. The value is 6.
Since:
JDE 4.0.0

ROOT_CA_EXPIRED

public static final byte ROOT_CA_EXPIRED
Indicates the root CA's public key is expired. The value is 12.
Since:
JDE 4.0.0

SITENAME_MISMATCH

public static final byte SITENAME_MISMATCH
Indicates a certificate does not contain the correct site name. The value is 7.
Since:
JDE 4.0.0

UNAUTHORIZED_INTERMEDIATE_CA

public static final byte UNAUTHORIZED_INTERMEDIATE_CA
Indicates an intermediate certificate in the chain does not have the authority to be a intermediate CA. The value is 4.
Since:
JDE 4.0.0

UNRECOGNIZED_ISSUER

public static final byte UNRECOGNIZED_ISSUER
Indicates a certificate was issued by an unrecognized entity. The value is 8.
Since:
JDE 4.0.0

UNSUPPORTED_PUBLIC_KEY_TYPE

public static final byte UNSUPPORTED_PUBLIC_KEY_TYPE
Indicates that type of the public key in a certificate is not supported by the device. The value is 13.
Since:
JDE 4.0.0

UNSUPPORTED_SIGALG

public static final byte UNSUPPORTED_SIGALG
Indicates a certificate was signed using an unsupported algorithm. The value is 9.
Since:
JDE 4.0.0

VERIFICATION_FAILED

public static final byte VERIFICATION_FAILED
Indicates a certificate failed verification. The value is 14.
Since:
JDE 4.0.0
Constructor Detail

CertificateException

public CertificateException(Certificate certificate,
                            byte status)
Create a new exception with a Certificate and specific error reason. The descriptive message for the new exception will be automatically provided, based on the reason.
Parameters:
certificate - the certificate that caused the exception
status - the reason for the exception; the status MUST be between BAD_EXTENSIONS and VERIFICATION_FAILED inclusive.
Since:
JDE 4.0.0

CertificateException

public CertificateException(String message,
                            Certificate certificate,
                            byte status)
Create a new exception with a message, Certificate, and specific error reason.
Parameters:
message - a descriptive message
certificate - the certificate that caused the exception
status - the reason for the exception; the status MUST be between BAD_EXTENSIONS and VERIFICATION_FAILED inclusive.
Since:
JDE 4.0.0
Method Detail

getCertificate

public Certificate getCertificate()
Get the Certificate that caused the exception.
Returns:
the Certificate that included the failure.
Since:
JDE 4.0.0

getReason

public byte getReason()
Get the reason code.
Returns:
the reason code
Since:
JDE 4.0.0



Copyright 1999-2009 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.