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 Applet is not granted access to this HCI resource
static short	HCI_CONDITIONS_NOT_SATISFIED Indicates that the conditions to register a specific event or to call a specific method are not fulfilled
static short	HCI_CURRENTLY_DISABLED The interface to the contactless frontend (CLF) is currently disabled
static short	HCI_FRAGMENTED_MESSAGE_ONGOING Indicates that an attempt is made to send an HCIMessage to the CLF while receiving a fragmented HCIMessage is still ongoing
static short	HCI_INVALID_LENGTH Indicates that a parameter has not the correct length
static short	HCI_LISTENER_ALREADY_REGISTERED Indicates that an Applet instance has already registered a Listener of this type
static short	HCI_NOT_AVAILABLE The HCI protocol is not available.
static short	HCI_RESOURCES_NOT_AVAILABLE Indicates that the contactless framework has not enough resources to fulfill the command
static short	HCI_SERVICE_NOT_AVAILABLE The requested Service (CardEmulation, ReaderMode, Connectivity) is not avilable
static short	HCI_WRONG_EVENT_TYPE Indicates that a wrong event type is activated for this Service
static short	HCI_WRONG_LISTENER_TYPE Indicates that a wrong Listener type is registered to a Service

Constructor Summary

HCIException(short reason)
Constructs a HCIException with the specified reason.

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 protocol is not available.

See Also:

Constant Field Values

HCI_ACCESS_NOT_GRANTED

public static final short HCI_ACCESS_NOT_GRANTED

The Applet is not granted access to this HCI resource

See Also:

Constant Field Values

HCI_SERVICE_NOT_AVAILABLE

public static final short HCI_SERVICE_NOT_AVAILABLE

The requested Service (CardEmulation, ReaderMode, Connectivity) is not avilable

See Also:

Constant Field Values

HCI_CURRENTLY_DISABLED

public static final short HCI_CURRENTLY_DISABLED

The interface to the contactless frontend (CLF) is currently disabled

See Also:

Constant Field Values

HCI_WRONG_LISTENER_TYPE

public static final short HCI_WRONG_LISTENER_TYPE

Indicates that a wrong Listener type is registered to a Service

See Also:

Constant Field Values

HCI_LISTENER_ALREADY_REGISTERED

public static final short HCI_LISTENER_ALREADY_REGISTERED

Indicates that an Applet instance has already registered a Listener of this type

See Also:

Constant Field Values

HCI_WRONG_EVENT_TYPE

public static final short HCI_WRONG_EVENT_TYPE

Indicates that a wrong event type is activated for this Service

See Also:

Constant Field Values

HCI_FRAGMENTED_MESSAGE_ONGOING

public static final short HCI_FRAGMENTED_MESSAGE_ONGOING

Indicates that an attempt is made to send an HCIMessage to the CLF while receiving a fragmented HCIMessage is still ongoing

See Also:

Constant Field Values

HCI_RESOURCES_NOT_AVAILABLE

public static final short HCI_RESOURCES_NOT_AVAILABLE

Indicates that the contactless framework has not enough resources to fulfill the command

See Also:

Constant Field Values

HCI_INVALID_LENGTH

public static final short HCI_INVALID_LENGTH

Indicates that a parameter has not the correct length

See Also:

Constant Field Values

HCI_CONDITIONS_NOT_SATISFIED

public static final short HCI_CONDITIONS_NOT_SATISFIED

Indicates that the conditions to register a specific event or to call a specific method are not fulfilled

See Also:

Constant Field Values

Constructor Detail

HCIException

public HCIException(short reason)

Constructs a HCIException with the specified reason. To conserve on resources use throwIt() to use the JCRE instance of this class.

Parameters:

reason - the reason for the exception

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