uicc.hci.framework
Class HCIException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              javacard.framework.CardRuntimeException
                  uicc.hci.framework.HCIException

All Implemented Interfaces:

java.io.Serializable

public class HCIException
extends javacard.framework.CardRuntimeException

The HCIException class encapsulates specific exceptions allows the classes of this package to throw specific exceptions in case of problems.

See Also:

Serialized Form

Field Summary

static short	HCI_ACCESS_NOT_GRANTED The caller context is not granted access to this HCI resource
static short	HCI_NOT_AVAILABLE The HCI resource is not available.
static short	INTERLEAVE_MESSAGE_DURING_PENDING_CMD Indicates that an attempt to send a command was made before the responses to the previous command were received.
static short	SYSTEM_SERVICE_RESERVED Listener could not be registered because it is already set to another Applet or used by the system itself.

Constructor Summary

HCIException(short reason)
Construct an HCIException with a reason code.

Method Summary

static void

throwIt(short reason) Throws the JCRE owned instance of the HCIException with the specified reason code.

Methods inherited from class javacard.framework.CardRuntimeException

getReason, setReason

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

HCI_NOT_AVAILABLE

public static final short HCI_NOT_AVAILABLE

The HCI resource is not available.

See Also:

Constant Field Values

HCI_ACCESS_NOT_GRANTED

public static final short HCI_ACCESS_NOT_GRANTED

The caller context is not granted access to this HCI resource

See Also:

Constant Field Values

INTERLEAVE_MESSAGE_DURING_PENDING_CMD

public static final short INTERLEAVE_MESSAGE_DURING_PENDING_CMD

Indicates that an attempt to send a command was made before the responses to the previous command were received. (editor's note: better wording needed, eventually rename reason code.

See Also:

Constant Field Values

SYSTEM_SERVICE_RESERVED

public static final short SYSTEM_SERVICE_RESERVED

Listener could not be registered because it is already set to another Applet or used by the system itself. (editor's note: check in which context this reason code is used an reword eventually.)

See Also:

Constant Field Values

Constructor Detail

HCIException

public HCIException(short reason)

Construct an HCIException with a reason code. To save resources use the throwIt() method to re-use the JCRE instance of this class. (editor's note: sha to align wording with tS 102 241)

Parameters:

reason - the error reason

Method Detail

throwIt

public static void throwIt(short reason)
                    throws HCIException

Throws the JCRE owned instance of the HCIException with the specified reason code.

Parameters:

reason - the reason for the exception.

Throws:

HCIException