javax.microedition.contactless
Interface TransactionListener

public interface TransactionListener

This interface provides a notification to the application about secure element activity in card emulation mode. When an activity has happened between the secure element on the device and an external reader device through the RFID hardware, this notification is sent to the application registered to receive it. Applications must implement this interface to receive the notifications. Applications are not participating to these transactions.

The application is responsible for any possible synchronization required in the listener methods. The listener methods must return quickly and should not perform any extensive processing. The method calls are intended as triggers for the application. The application should do all necessary extensive processing in a separate thread and only use these methods to initiate the processing.

Version:

1.0

Author:

Nokia Corporation

Field Summary

static byte

UNKNOWN_SLOT A constant to use when the slot number is not known.

Method Summary

void	externalReaderDetected(byte slot) Called by the platform, when a card emulation event has happened on the RFID hardware.

Field Detail

UNKNOWN_SLOT

static final byte UNKNOWN_SLOT

A constant to use when the slot number is not known.

See Also:

Constant Field Values

Method Detail

externalReaderDetected

void externalReaderDetected(byte slot)

Called by the platform, when a card emulation event has happened on the RFID hardware. This notification informs the application, that there might be changes in the data on the secure element.

If the application displays for example the number of metro tickets left in the device, after receiving this notification the application can update the number of available tickets shown on the screen. How the number of tickets is acquired from the secure element is out of scope for this specification.

Parameters:

slot - the slot needed to open the APDUConnection defined in JSR 177 to the internal secure element, may be UNKNOWN_SLOT constant defined in this interface, if the slot can not be identified