no.nordicsemi.android.ble

Class SimpleRequest

java.lang.Object

no.nordicsemi.android.ble.Request

no.nordicsemi.android.ble.SimpleRequest

Direct Known Subclasses:

SetValueRequest, SimpleValueRequest, SleepRequest

public class SimpleRequest
extends Request

A request that requires a callback or can't have timeout for any other reason. This class defines the await() method.

Field Summary

Fields inherited from class no.nordicsemi.android.ble.Request

handler, requestHandler

Method Summary

Modifier and Type	Method and Description
void	await() Synchronously waits until the request is done.

Methods inherited from class no.nordicsemi.android.ble.Request

before, createBond, done, enqueue, fail, invalid, newConnectionPriorityRequest, newDisableBatteryLevelNotificationsRequest, newDisableIndicationsRequest, newDisableNotificationsRequest, newEnableBatteryLevelNotificationsRequest, newEnableIndicationsRequest, newEnableNotificationsRequest, newMtuRequest, newReadBatteryLevelRequest, newReadPhyRequest, newReadRequest, newReadRequest, newReadRssiRequest, newRefreshCacheRequest, newSetPreferredPhyRequest, newSleepRequest, newWaitForIndicationRequest, newWaitForNotificationRequest, newWriteRequest, newWriteRequest, newWriteRequest, newWriteRequest, newWriteRequest, newWriteRequest, removeBond, setHandler

Methods inherited from class java.lang.Object

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

Method Detail

await

public final void await()
                 throws RequestFailedException,
                        DeviceDisconnectedException,
                        BluetoothDisabledException,
                        InvalidRequestException

Synchronously waits until the request is done.

Callbacks set using Request.before(BeforeCallback), Request.done(SuccessCallback) and Request.fail(FailCallback) will be ignored.

This method may not be called from the main (UI) thread.

Throws:

RequestFailedException - thrown when the BLE request finished with status other than BluetoothGatt.GATT_SUCCESS.

java.lang.IllegalStateException - thrown when you try to call this method from the main (UI) thread.

DeviceDisconnectedException - thrown when the device disconnected before the request was completed.

BluetoothDisabledException - thrown when the Bluetooth adapter has been disabled.

InvalidRequestException - thrown when the request was called before the device was connected at least once (unknown device).