uicc.hci.services.connectivity
Interface ConnectivityListener

All Superinterfaces:

HCIListener, javacard.framework.Shareable

public interface ConnectivityListener
extends HCIListener

An instance implementing ConnectivityListener is used by an Applet to monitor the ConnectivityService.

See Also:

ConnectivityService

Field Summary

static byte

EVENT_STAND_BY This value is used to notify the Applet when the HCI event EVT_STAND_BY is received.

Fields inherited from interface uicc.hci.framework.HCIListener

TRIG_NO_MORE_PROCESS

Method Summary

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

Methods inherited from interface uicc.hci.framework.HCIListener

onCallBack

Field Detail

EVENT_STAND_BY

static final byte EVENT_STAND_BY

This value is used to notify the Applet when the HCI event EVT_STAND_BY is received. This constant can be used in HCIService.activateEvent() and HCIService.deactivateEvent().

See Also:

Constant Field Values

Method Detail

onCallBackTriggering

byte onCallBackTriggering(byte callback,
                          ConnectivityMessage 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:

• HCIListener.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).