com.polidea.rxandroidble2.internal.operations

Class ServiceDiscoveryOperation

java.lang.Object

com.polidea.rxandroidble2.internal.QueueOperation<T>

com.polidea.rxandroidble2.internal.SingleResponseOperation<RxBleDeviceServices>

com.polidea.rxandroidble2.internal.operations.ServiceDiscoveryOperation

All Implemented Interfaces:

Operation<RxBleDeviceServices>, java.lang.Comparable<Operation<?>>

public class ServiceDiscoveryOperation
extends SingleResponseOperation<RxBleDeviceServices>

Method Summary

Modifier and Type	Method and Description
protected <any>	getCallback(RxBleGattCallback rxBleGattCallback) A function that should return Observable derived from the passed RxBleGattCallback.
protected boolean	startOperation(android.bluetooth.BluetoothGatt bluetoothGatt) A function that should call the passed BluetoothGatt and return `true` if the call has succeeded.
protected <any>	timeoutFallbackProcedure(android.bluetooth.BluetoothGatt bluetoothGatt, RxBleGattCallback rxBleGattCallback, Scheduler timeoutScheduler) Sometimes it happens that the BluetoothGatt will receive all BluetoothGattService's, BluetoothGattCharacteristic's and BluetoothGattDescriptor but it won't receive the final callback that the service discovery was completed.
java.lang.String	toString()

Methods inherited from class com.polidea.rxandroidble2.internal.SingleResponseOperation

protectedRun, provideException

Methods inherited from class com.polidea.rxandroidble2.internal.QueueOperation

compareTo, definedPriority, run

Methods inherited from class java.lang.Object

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

Method Detail

getCallback

protected <any> getCallback(RxBleGattCallback rxBleGattCallback)

Description copied from class: SingleResponseOperation

A function that should return Observable derived from the passed RxBleGattCallback. The returned Observable will be automatically unsubscribed after the first emission. The returned Observable is a subject to Observable#timeout(long, TimeUnit, Scheduler, io.reactivex.ObservableSource) and by default it will throw BleGattCallbackTimeoutException. This behaviour can be overridden by overriding SingleResponseOperation.timeoutFallbackProcedure(BluetoothGatt, RxBleGattCallback, Scheduler).

Specified by:

getCallback in class SingleResponseOperation<RxBleDeviceServices>

Parameters:

rxBleGattCallback - the RxBleGattCallback to use

Returns:

the Observable

startOperation

protected boolean startOperation(android.bluetooth.BluetoothGatt bluetoothGatt)

Description copied from class: SingleResponseOperation

A function that should call the passed BluetoothGatt and return `true` if the call has succeeded.

Specified by:

startOperation in class SingleResponseOperation<RxBleDeviceServices>

Parameters:

bluetoothGatt - the BluetoothGatt to use

Returns:

`true` if success, `false` otherwise

timeoutFallbackProcedure

protected <any> timeoutFallbackProcedure(android.bluetooth.BluetoothGatt bluetoothGatt,
                                         RxBleGattCallback rxBleGattCallback,
                                         Scheduler timeoutScheduler)

Sometimes it happens that the BluetoothGatt will receive all BluetoothGattService's, BluetoothGattCharacteristic's and BluetoothGattDescriptor but it won't receive the final callback that the service discovery was completed. This is a potential workaround.

There is a change in Android 7.0.0_r1 where all data is received at once - in this situation returned services size will be always 0 https://android.googlesource.com/platform/frameworks/base/+/android-7.0.0_r1/core/java/android/bluetooth/BluetoothGatt.java#206 https://android.googlesource.com/platform/frameworks/base/+/android-6.0.1_r72/core/java/android/bluetooth/BluetoothGatt.java#205

Overrides:

timeoutFallbackProcedure in class SingleResponseOperation<RxBleDeviceServices>

Parameters:

bluetoothGatt - the BluetoothGatt to use

rxBleGattCallback - the RxBleGattCallback to use

timeoutScheduler - the Scheduler for timeout to use

Returns:

Observable that may emit RxBleDeviceServices or TimeoutException

toString

public java.lang.String toString()

Overrides:

toString in class SingleResponseOperation<RxBleDeviceServices>