Mock callbacks

mockrxandroidble/README.md

@@ -38,7 +38,17 @@ RxBleClient rxBleClientMock = new RxBleClientMock.Builder()
                             .addDescriptor(descriptorUUID, descriptorData) // <-- adding descriptor mocks
                             .build() // to the characteristic, there can be multiple of them
                     ).build()
-            ).build()
+            ).characteristicReadCallback(characteristicUUID, (device, characteristic, result) -> {
+                result.success(characteristicValue);
+            })
+            .characteristicWriteCallback(characteristicUUID, (device, characteristic, bytes, result) -> {
+                if(writeData(characteristic, bytes)) {
+                    result.success();
+                } else {
+                    result.failure(0x80);
+                    // can also use result.disconnect(0x80); 
+                }
+            }).build()
         ).build()
     ).build();
 

mockrxandroidble/src/main/java/com/polidea/rxandroidble2/mockrxandroidble/RxBleClientMock.java

@@ -102,6 +102,49 @@ public CharacteristicsBuilder() {
             this.bluetoothGattCharacteristics = new ArrayList<>();
         }
 
+        /**
+         * Adds a {@link BluetoothGattCharacteristic}
+         *
+         * @param characteristic        The characteristic to add
+         */
+        public CharacteristicsBuilder addCharacteristic(BluetoothGattCharacteristic characteristic) {
+            this.bluetoothGattCharacteristics.add(characteristic);
+            return this;
+        }
+
+        /**
+         * Adds a {@link BluetoothGattCharacteristic} with specified parameters.
+         *
+         * @param uuid        characteristic UUID
+         * @param data        locally stored value of the characteristic
+         * @param properties  OR-ed {@link BluetoothGattCharacteristic} property constants
+         * @param descriptors list of characteristic descriptors. Use {@link DescriptorsBuilder} to create them.
+         */
+        public CharacteristicsBuilder addCharacteristic(@NonNull UUID uuid,
+                                                        @NonNull byte[] data,
+                                                        int properties,
+                                                        List<BluetoothGattDescriptor> descriptors) {
+            BluetoothGattCharacteristic characteristic = new BluetoothGattCharacteristic(uuid, properties, 0);
+            for (BluetoothGattDescriptor descriptor : descriptors) {
+                characteristic.addDescriptor(descriptor);
+            }
+            characteristic.setValue(data);
+            return addCharacteristic(characteristic);
+        }
+
+        /**
+         * Adds a {@link BluetoothGattCharacteristic} with specified parameters.
+         *
+         * @param uuid        characteristic UUID
+         * @param data        locally stored value of the characteristic
+         * @param properties  OR-ed {@link BluetoothGattCharacteristic} property constants
+         */
+        public CharacteristicsBuilder addCharacteristic(@NonNull UUID uuid,
+                                                        @NonNull byte[] data,
+                                                        int properties) {
+            return addCharacteristic(uuid, data, properties, new ArrayList<BluetoothGattDescriptor>());
+        }
+
         /**
          * Adds a {@link BluetoothGattCharacteristic} with specified parameters.
          *
@@ -115,6 +158,19 @@ public CharacteristicsBuilder addCharacteristic(@NonNull UUID uuid,
             return addCharacteristic(uuid, data, 0, descriptors);
         }
 
+        /**
+         * Adds a {@link BluetoothGattCharacteristic} with specified parameters.
+         *
+         * @param uuid        characteristic UUID
+         * @param data        locally stored value of the characteristic
+         * @param descriptors list of characteristic descriptors. Use {@link DescriptorsBuilder} to create them.
+         */
+        public CharacteristicsBuilder addCharacteristic(@NonNull UUID uuid,
+                                                        @NonNull byte[] data,
+                                                        BluetoothGattDescriptor... descriptors) {
+            return addCharacteristic(uuid, data, 0, descriptors);
+        }
+
         /**
          * Adds a {@link BluetoothGattCharacteristic} with specified parameters.
          *
@@ -126,14 +182,19 @@ public CharacteristicsBuilder addCharacteristic(@NonNull UUID uuid,
         public CharacteristicsBuilder addCharacteristic(@NonNull UUID uuid,
                                                         @NonNull byte[] data,
                                                         int properties,
-                                                        List<BluetoothGattDescriptor> descriptors) {
-            BluetoothGattCharacteristic characteristic = new BluetoothGattCharacteristic(uuid, properties, 0);
-            for (BluetoothGattDescriptor descriptor : descriptors) {
-                characteristic.addDescriptor(descriptor);
-            }
-            characteristic.setValue(data);
-            this.bluetoothGattCharacteristics.add(characteristic);
-            return this;
+                                                        BluetoothGattDescriptor... descriptors) {
+            return addCharacteristic(uuid, data, properties, Arrays.asList(descriptors));
+        }
+
+        /**
+         * Adds a {@link BluetoothGattCharacteristic} with specified parameters.
+         *
+         * @param uuid        characteristic UUID
+         * @param data        locally stored value of the characteristic
+         */
+        public CharacteristicsBuilder addCharacteristic(@NonNull UUID uuid,
+                                                        @NonNull byte[] data) {
+            return addCharacteristic(uuid, data, 0);
         }
 
         /**
@@ -156,6 +217,16 @@ public DescriptorsBuilder() {
             this.bluetoothGattDescriptors = new ArrayList<>();
         }
 
+        /**
+         * Adds a {@link BluetoothGattDescriptor}.
+         *
+         * @param descriptor the descriptor
+         */
+        public DescriptorsBuilder addDescriptor(@NonNull BluetoothGattDescriptor descriptor) {
+            bluetoothGattDescriptors.add(descriptor);
+            return this;
+        }
+
         /**
          * Adds a {@link BluetoothGattDescriptor} with specified parameters.
          *
@@ -165,8 +236,7 @@ public DescriptorsBuilder() {
         public DescriptorsBuilder addDescriptor(@NonNull UUID uuid, @NonNull byte[] data) {
             BluetoothGattDescriptor bluetoothGattDescriptor = new BluetoothGattDescriptor(uuid, 0);
             bluetoothGattDescriptor.setValue(data);
-            bluetoothGattDescriptors.add(bluetoothGattDescriptor);
-            return this;
+            return addDescriptor(bluetoothGattDescriptor);
         }
 
         /**