net.rim.device.api.io.nfc.handover
Class ConnectionHandoverManager

java.lang.Object
  net.rim.device.api.io.nfc.handover.ConnectionHandoverManager

public class ConnectionHandoverManager
extends Object

Registers connection handover listeners. The listeners are called by the platform when a connection handover event occurs. Currently, the platform only supports handovers for the Bluetooth® transport.

Since:

BlackBerry API 7.1.0

Method Summary
void	addConnectionHandoverListener(ConnectionHandoverListener listener, int transportType, boolean autoRemoveOnSuccess) Registers a ConnectionHandoverListener for handover events releating to the transport specified.
static ConnectionHandoverManager	getInstance() Retrieves the system instance of the ConnectionHandoverManager object, which provides access to NFC handover functionality.
void	removeConnectionHandoverListener(ConnectionHandoverListener listener) Removes a ConnectionHandoverListener.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static ConnectionHandoverManager getInstance()

Retrieves the system instance of the ConnectionHandoverManager object, which provides access to NFC handover functionality.

Returns:

The system instance of the ConnectionHandoverManager.

Since:

BlackBerry API 7.1.0

addConnectionHandoverListener

public void addConnectionHandoverListener(ConnectionHandoverListener listener,
                                          int transportType,
                                          boolean autoRemoveOnSuccess)
                                   throws NFCException

Registers a ConnectionHandoverListener for handover events releating to the transport specified.

Parameters:

listener - A ConnectionHandoverListener.

transportType - The connection transport type. Currently, the platform only supports the BLUETOOTH_TRANSPORT.

autoRemoveOnSuccess - Remove the listener when a successful connection handover event has occured.

Throws:

NFCException - When the ConnectionHandoverListener cannot be registered.

Since:

BlackBerry API 7.1.0

removeConnectionHandoverListener

public void removeConnectionHandoverListener(ConnectionHandoverListener listener)
                                      throws NFCException

Removes a ConnectionHandoverListener.

Parameters:

listener - The ConnectionHandoverListener to remove.

Throws:

NFCException - When the ConnectionHandoverListener cannot be removed.

Since:

BlackBerry API 7.1.0