FileDocCategorySizeDatePackage
CertificateException.javaAPI DocphoneME MR2 API (J2ME)7451Wed May 02 18:00:26 BST 2007javax.microedition.pki

CertificateException

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.

Fields Summary
private byte
reason
The reason code for this exception
private javax.microedition.pki.Certificate
cert
The certificate that caused the exception
public static final byte
BAD_EXTENSIONS
Indicates a certificate has unrecognized critical extensions. The value is 1.
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.
public static final byte
EXPIRED
Indicates a certificate is expired. The value is 3.
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.
public static final byte
MISSING_SIGNATURE
Indicates a certificate object does not contain a signature. The value is 5.
public static final byte
NOT_YET_VALID
Indicates a certificate is not yet valid. The value is 6.
public static final byte
SITENAME_MISMATCH
Indicates a certificate does not contain the correct site name. The value is 7.
public static final byte
UNRECOGNIZED_ISSUER
Indicates a certificate was issued by an unrecognized entity. The value is 8.
public static final byte
UNSUPPORTED_SIGALG
Indicates a certificate was signed using an unsupported algorithm. The value is 9.
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.
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.
public static final byte
ROOT_CA_EXPIRED
Indicates the root CA's public key is expired. The value is 12.
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.
public static final byte
VERIFICATION_FAILED
Indicates a certificate failed verification. The value is 14.
Constructors Summary
public CertificateException(javax.microedition.pki.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.

param
certificate the certificate that caused the exception
param
status the reason for the exception; the status MUST be between BAD_EXTENSIONS and VERIFICATION_FAILED inclusive.


                                                             
         
        super(getMessageForReason(status));
	cert = certificate;
	reason = status;
public CertificateException(String message, javax.microedition.pki.Certificate certificate, byte status)
Create a new exception with a message, Certificate, and specific error reason.

param
message a descriptive message
param
certificate the certificate that caused the exception
param
status the reason for the exception; the status MUST be between BAD_EXTENSIONS and VERIFICATION_FAILED inclusive.

	super(message);
	cert = certificate;
	reason = status;
Methods Summary
public javax.microedition.pki.CertificategetCertificate()
Get the Certificate that caused the exception.

return
the Certificate that included the failure.

	return cert;
static java.lang.StringgetMessageForReason(int reason)
Gets the exception message for a reason.

param
reason reason code
return
exception message

        switch (reason) {
        case BAD_EXTENSIONS:
            return "Certificate has unrecognized critical extensions";

        case CERTIFICATE_CHAIN_TOO_LONG:
            return "Server certificate chain exceeds the length allowed " +
                "by an issuer's policy";

        case EXPIRED:
            return "Certificate is expired";

        case UNAUTHORIZED_INTERMEDIATE_CA:
            return "Intermediate certificate in the chain does not have the " +
                "authority to be an intermediate CA";

        case MISSING_SIGNATURE:
            return "Certificate object does not contain a signature";

        case NOT_YET_VALID:
            return "Certificate is not yet valid";


        case SITENAME_MISMATCH:
            return "Certificate does not contain the correct site name";

        case UNRECOGNIZED_ISSUER:
            return "Certificate was issued by an unrecognized entity";

        case UNSUPPORTED_SIGALG:
            return "Certificate was signed using an unsupported algorithm";

        case INAPPROPRIATE_KEY_USAGE:
            return "Certificate's public key has been used in a way deemed " +
                "inappropriate by the issuer";

        case BROKEN_CHAIN:
            return "Certificate in a chain was not issued by the next " +
                "authority in the chain";

        case ROOT_CA_EXPIRED:
            return "Root CA's public key is expired";

        case UNSUPPORTED_PUBLIC_KEY_TYPE:
            return "Certificate has a public key that is not a " +
                "supported type";

        case VERIFICATION_FAILED:
            return "Certificate failed verification";
        }

        return "Unknown reason (" + reason + ")";
public bytegetReason()
Get the reason code.

return
the reason code

	return reason;