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 application itself.

See Also:

HCIService, HCIMessage

Field Summary

static short

TRIG_NO_MORE_PROCESS this value must be used as return by an HCIListener when it no more want to be call back for an internal process (e.g do not want to initiate more output...) whereas defined values in each HCIListener sub-interfaces for related conditions will trigger a call back.

Method Summary

byte	onCallBack(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 by an HCIListener when it no more want to be call back for an internal process (e.g do not want to initiate more output...) whereas defined values in each HCIListener sub-interfaces for related conditions will trigger a call back.

See Also:

Constant Field Values

Method Detail

onCallBack

byte onCallBack(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. (editor's note: 1. align all methods with the word fragment 'triggering'. 2. improve wording )

Parameters:

event - the condition caused this invocation of onCallBack()

message - the HCIMessage

Returns:

condition for next invocation:

• TRIG_NO_MORE_PROCESS: the listener does not request to be called back
• value greater than 0: The listener request to be call back as soon as possible with the given triggering condition. The specific values are listed in the documentation of the sub interfaces.
• value less than 0: forbidden (will be ignored).