uicc.hci.framework
Interface HCIListener

All Superinterfaces:

javacard.framework.Shareable

All Known Subinterfaces:

CardEmulationListener, ConnectivityListener, ReaderListener

public interface HCIListener
extends javacard.framework.Shareable

The tagging interface for all types of HCI listeners.

An HCIListener interface has to be implemented by an Applet which wants to interact with an HCIService.

Each sub interfaces of this interface shall implement a method to process incoming messages to process HCI messages. These methods may also support an internal callback triggering requested by the Applet itself.

See Also:

HCIService, HCIMessage

Field Summary

static short

TRIG_NO_MORE_PROCESS this value must be used as return value by an HCIListener to indicate to to the framework when it does not want to be called back anymore.

Method Summary

byte	onCallBackTriggering(byte event, HCIMessage message) This method is called by the HCI framework in 3 situations: 1.

Field Detail

TRIG_NO_MORE_PROCESS

static final short TRIG_NO_MORE_PROCESS

this value must be used as return value by an HCIListener to indicate to to the framework when it does not want to be called back anymore.

See Also:

Constant Field Values

Method Detail

onCallBackTriggering

byte onCallBackTriggering(byte event,
                          HCIMessage message)

This method is called by the HCI framework in 3 situations:

• 1. A predefined condition (see HCIService.activateEvent()) is fulfilled.
• 2. A certain return value on a previous invocation of this method was returned.
• 3. When a previous call to the method HCIService.requestCallBackNotification() from the same Applet was made.

2. improve wording )

Parameters:

event - that triggers the invocation of the method

message - the HCIMessage

Returns:

condition for next invocation of this method must be >= 0:

• TRIG_NO_MORE_PROCESS: the listener does not request to be called back
• all other values are defined in subinterfaces