Class CertificateException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
javacard.framework.CardRuntimeException
javacardx.security.cert.CertificateException
public class CertificateException extends CardRuntimeException
CertificateException represents a certificate-related exception.

The API classes throw Java Card runtime environment-owned instances of CertificateException.

Java Card runtime environment-owned instances of exception classes are temporary Java Card runtime environment Entry Point Objects and can be accessed from any applet context. References to these temporary objects cannot be stored in class variables or instance variables or array components.

Since:
3.1

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final short
    INVALID_ENCODING
    Certificate encoding exception
    static final short
    INVALID_PARAM
    One or more input parameters is invalid
    static final short
    INVALID_SIGNATURE
    Certificate signature verification failed
    static final short
    MISSING_DATA
    Data missing to complete the operation
    static final short
    PARSER_HANDLER_EXCEPTION
    A certificate parser handler has thrown an exception
    static final short
    PARSER_HANDLER_INVALID_KEY
    A certificate parser handler has passed an invalid key.

  • Constructor Summary

    Constructors
    Constructor
    Description
    CertificateException(short reason)
    Constructs a CertificateException with the specified reason.

  • Method Summary

    Modifier and Type
    Method
    Description
    static void
    throwIt(short reason)
    Throws the Java Card runtime environment owned instance of CertificateException with the specified reason.

    Methods inherited from class CardRuntimeException

    getReason, setReason
    Modifier and Type
    Method
    Description
    short
    getReason()
    Gets the reason code
    void
    setReason(short reason)
    Sets the reason code.

    Methods inherited from class Object

    equals
    Modifier and Type
    Method
    Description
    boolean
    equals(Object obj)
    Compares two Objects for equality.

  • Field Details

    • INVALID_ENCODING

      public static final short INVALID_ENCODING
      Certificate encoding exception
      See Also:

    • INVALID_PARAM

      public static final short INVALID_PARAM
      One or more input parameters is invalid
      See Also:

    • MISSING_DATA

      public static final short MISSING_DATA
      Data missing to complete the operation
      See Also:

    • INVALID_SIGNATURE

      public static final short INVALID_SIGNATURE
      Certificate signature verification failed
      See Also:

    • PARSER_HANDLER_EXCEPTION

      public static final short PARSER_HANDLER_EXCEPTION
      A certificate parser handler has thrown an exception
      See Also:

    • PARSER_HANDLER_INVALID_KEY

      public static final short PARSER_HANDLER_INVALID_KEY
      A certificate parser handler has passed an invalid key.
      See Also:

  • Constructor Details

    • CertificateException

      public CertificateException(short reason)
      Constructs a CertificateException with the specified reason. To conserve on resources use throwIt() to use the Java Card runtime environment-owned instance of this class.
      Parameters:
      reason - the reason for the exception

  • Method Details

    • throwIt

      public static void throwIt(short reason) throws CertificateException
      Throws the Java Card runtime environment owned instance of CertificateException with the specified reason. Java Card runtime environment owned instances of exception classes are temporary Java Card runtime environment Entry Point Objects and can be accessed from any applet context. References to these objects cannot be stored in class variables or instance variables or array components.
      Parameters:
      reason - the reason for the exception.
      Throws:
      CertificateException - always.