uicc.hci.framework
Interface HCIListener

All Superinterfaces:

javacard.framework.Shareable

All Known Subinterfaces:

CardEmulationListener, CLTObserverListener, ConnectivityListener, ReaderListener

public interface HCIListener
extends javacard.framework.Shareable

The base interface for all types of HCI listeners.

An Object shall not implement this interface but only implement one of the sub-interfaces.

An Applet instance implementing a *Listener interface shall only receive events defined in the same *Listener interface or in the HCIListener interface.

If a Class is implementing more than one HCIListener sub-interfaces the Applet should check the type of the HCIMesage by using instanceof in order to identify the source of the notification.

Messages received through the inherited method HCIListener.onCallback() shall be of the message type defined in the same package as the *Listener interface with the exception of the CLTObserverListener interface which will receive a CardEmulationMessage object.

See Also:

CardEmulationListener, ConnectivityListener, ReaderListener

Field Summary

static byte	EVENT_HCI_RECEPTION_FAILED This value is used to notify the Applet when the UICC failed to receive a message sent by the CLF.
static byte	EVENT_HCI_TRANSMISSION_FAILED This value is used to notify the Applet when the UICC failed to transmit a message to the CLF.

Method Summary

void	onCallback(byte event, HCIMessage message) This method is called by the HCI framework to inform the Listener Object about a specific event and pass the corresponding HCIMessage to the Listener Object.

Field Detail

EVENT_HCI_TRANSMISSION_FAILED

static final byte EVENT_HCI_TRANSMISSION_FAILED

This value is used to notify the Applet when the UICC failed to transmit a message to the CLF. The Applet has to activate this event (for a specific service) if it wants to be notified about data transmission errors (that occur for a specific service):

See Also:

Constant Field Values

EVENT_HCI_RECEPTION_FAILED

static final byte EVENT_HCI_RECEPTION_FAILED

This value is used to notify the Applet when the UICC failed to receive a message sent by the CLF. The Applet has to activate this event (for a specific service) if it wants to be notified about data transmission errors (that occur for a specific service):

See Also:

Constant Field Values

Method Detail

onCallback

void onCallback(byte event,
                HCIMessage message)

This method is called by the HCI framework to inform the Listener Object about a specific event and pass the corresponding HCIMessage to the Listener Object. In the case of an EVENT_HCI_TRANSMISSION_FAILED the message which could not be transmitted shall be made available in the HCIMessage object. If an Applet has requested the framework to send more than one message during a single onCallback method execution and a transmission to the CLF failed the framework shall not attempt to send any of the remaining messages. The EVENT_HCI_RECEPTION_FAILED shall not be raised in the case of a failure to receive a command from an external reader in CardEmulation Mode due to a problem on the data link layer

Parameters:

event - that triggers the invocation of the method

message - the HCIMessage