diff options
Diffstat (limited to 'java/jau/direct_bt/DBTGattService.java')
-rw-r--r-- | java/jau/direct_bt/DBTGattService.java | 192 |
1 files changed, 192 insertions, 0 deletions
diff --git a/java/jau/direct_bt/DBTGattService.java b/java/jau/direct_bt/DBTGattService.java new file mode 100644 index 00000000..eca6ddf1 --- /dev/null +++ b/java/jau/direct_bt/DBTGattService.java @@ -0,0 +1,192 @@ +/** + * Author: Sven Gothel <[email protected]> + * Copyright (c) 2020 Gothel Software e.K. + * Copyright (c) 2020 ZAFENA AB + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject to + * the following conditions: + * + * The above copyright notice and this permission notice shall be + * included in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND + * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE + * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION + * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION + * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + */ + +package direct_bt.tinyb; + +import java.lang.ref.WeakReference; +import java.util.List; + +import org.tinyb.BluetoothDevice; +import org.tinyb.BluetoothGattCharacteristic; +import org.tinyb.BluetoothGattDescriptor; +import org.tinyb.BluetoothGattService; +import org.tinyb.BluetoothObject; +import org.tinyb.BluetoothType; + +public class DBTGattService extends DBTObject implements BluetoothGattService +{ + /** Service's device weak back-reference */ + final WeakReference<DBTDevice> wbr_device; + + private final boolean isPrimary; + private final String type_uuid; + private final short handleStart; + private final short handleEnd; + /* pp */ final List<BluetoothGattCharacteristic> characteristicList; + + /* pp */ DBTGattService(final long nativeInstance, final DBTDevice device, final boolean isPrimary, + final String type_uuid, final short handleStart, final short handleEnd) + { + super(nativeInstance, compHash(handleStart, handleEnd)); + this.wbr_device = new WeakReference<DBTDevice>(device); + this.isPrimary = isPrimary; + this.type_uuid = type_uuid; + this.handleStart = handleStart; + this.handleEnd = handleEnd; + this.characteristicList = getCharacteristicsImpl(); + } + + @Override + public boolean equals(final Object obj) + { + if (obj == null || !(obj instanceof DBTGattService)) { + return false; + } + final DBTGattService other = (DBTGattService)obj; + return handleStart == other.handleStart && handleEnd == other.handleEnd; /** unique attribute handles */ + } + + @Override + public String getUUID() { return type_uuid; } + + @Override + public BluetoothType getBluetoothType() { return class_type(); } + + static BluetoothType class_type() { return BluetoothType.GATT_SERVICE; } + + @Override + public final BluetoothGattService clone() + { throw new UnsupportedOperationException(); } // FIXME + + @Override + public BluetoothGattCharacteristic find(final String UUID, final long timeoutMS) { + if( !checkServiceCache() ) { + return null; + } + return (DBTGattCharacteristic) findInCache(UUID, BluetoothType.GATT_CHARACTERISTIC); + } + + @Override + public BluetoothGattCharacteristic find(final String UUID) { + return find(UUID, 0); + } + + @Override + public final BluetoothDevice getDevice() { return wbr_device.get(); } + + @Override + public final boolean getPrimary() { return isPrimary; } + + @Override + public final List<BluetoothGattCharacteristic> getCharacteristics() { return characteristicList; } + + /** + * Returns the service start handle. + * <p> + * Attribute handles are unique for each device (server) (BT Core Spec v5.2: Vol 3, Part F Protocol..: 3.2.2 Attribute Handle). + * </p> + */ + public final short getHandleStart() { return handleStart; } + + /** + * Returns the service end handle. + * <p> + * Attribute handles are unique for each device (server) (BT Core Spec v5.2: Vol 3, Part F Protocol..: 3.2.2 Attribute Handle). + * </p> + */ + public final short getHandleEnd() { return handleEnd; } + + @Override + public final String toString() { + if( !isValid() ) { + return "Service" + "\u271D" + "[uuid "+getUUID()+", handles [0x"+Integer.toHexString(handleStart)+".."+Integer.toHexString(handleEnd)+"]]"; + } + return toStringImpl(); + } + + /* Native method calls: */ + + private native String toStringImpl(); + + private native List<BluetoothGattCharacteristic> getCharacteristicsImpl(); + + @Override + protected native void deleteImpl(long nativeInstance); + + /* local functionality */ + + /* pp */ boolean checkServiceCache() { + final DBTDevice device = wbr_device.get(); + return null != device && device.checkServiceCache(false); + } + + /** + * Returns the matching {@link DBTObject} from the internal cache if found, + * otherwise {@code null}. + * <p> + * The returned {@link DBTObject} may be of type + * <ul> + * <li>{@link DBTGattCharacteristic}</li> + * <li>{@link DBTGattDescriptor}</li> + * </ul> + * or alternatively in {@link BluetoothObject} space + * <ul> + * <li>{@link BluetoothType#GATT_CHARACTERISTIC} -> {@link BluetoothGattCharacteristic}</li> + * <li>{@link BluetoothType#GATT_DESCRIPTOR} -> {@link BluetoothGattDescriptor}</li> + * </ul> + * </p> + * @param uuid UUID of the desired + * {@link BluetoothType#GATT_CHARACTERISTIC characteristic} or {@link BluetoothType#GATT_DESCRIPTOR descriptor} to be found. + * Maybe {@code null}, in which case the first object of the desired type is being returned - if existing. + * @param type specify the type of the object to be found, either + * {@link BluetoothType#GATT_CHARACTERISTIC characteristic} + * or {@link BluetoothType#GATT_DESCRIPTOR descriptor}. + * {@link BluetoothType#NONE none} means anything. + */ + /* pp */ DBTObject findInCache(final String uuid, final BluetoothType type) { + final boolean anyType = BluetoothType.NONE == type; + final boolean charType = BluetoothType.GATT_CHARACTERISTIC== type; + final boolean descType = BluetoothType.GATT_DESCRIPTOR == type; + + if( !anyType && !charType && !descType ) { + return null; + } + final int characteristicSize = characteristicList.size(); + for(int charIdx = 0; charIdx < characteristicSize; charIdx++ ) { + final DBTGattCharacteristic characteristic = (DBTGattCharacteristic) characteristicList.get(charIdx); + if( ( anyType || charType ) && ( null == uuid || characteristic.getUUID().equals(uuid) ) ) { + return characteristic; + } + if( anyType || descType ) { + final DBTObject dbtObj = characteristic.findInCache(uuid, type); + if( null != dbtObj ) { + return dbtObj; + } + } + } + return null; + } + +} |