caspervk/AndroidAPS
1
0
Fork 0
Code Releases Activity

comboctl-base: Add exceptions for disabled and missing Bluetooth adapters

Browse source 
Signed-off-by: Carlos Rafael Giani <crg7475@mailbox.org>
This commit is contained in:
Carlos Rafael Giani 2023-03-09 00:01:01 +01:00
parent fe1235dbe1
commit 72819cbc53
2 changed files with 31 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
pump/combov2/comboctl/src/commonMain/kotlin/info/nightscout/comboctl/base/BluetoothException.kt
View file

@ -23,3 +23,19 @@ open class BluetoothPermissionException(message: String?, cause: Throwable?) : B
constructor(message: String) : this(message, null)
constructor(cause: Throwable) : this(null, cause)
}
/**
* Exception thrown when trying to use Bluetooth even though the adapter is not enabled.
*
* Note that unlike [BluetoothNotAvailableException], here, the adapter _does_ exist,
* and is just currently turned off.
*/
open class BluetoothNotEnabledException : BluetoothException("Bluetooth is not enabled")
/**
* Exception thrown when trying to use Bluetooth even though there no adapter available.
*
* "Not available" typically means that the platform has no Bluetooth hardware, or that
* said hardware is inaccessible.
*/
open class BluetoothNotAvailableException : BluetoothException("Bluetooth is not available - there is no usable adapter")

15
pump/combov2/comboctl/src/commonMain/kotlin/info/nightscout/comboctl/base/BluetoothInterface.kt
View file

@ -140,6 +140,10 @@ interface BluetoothInterface {
* a Bluetooth subsystem that has been shut down.
* @throws BluetoothPermissionException if discovery fails because
* scanning and connection permissions are missing.
* @throws BluetoothNotEnabledException if the system's
* Bluetooth adapter is currently not enabled.
* @throws BluetoothNotAvailableException if the system's
* Bluetooth adapter is currently not available.
* @throws BluetoothException if discovery fails due to an underlying
* Bluetooth issue.
*/
@ -172,6 +176,10 @@ interface BluetoothInterface {
*
* @return BluetoothDevice instance for the device with the
* given address
* @throws BluetoothNotEnabledException if the system's
* Bluetooth adapter is currently not enabled.
* @throws BluetoothNotAvailableException if the system's
* Bluetooth adapter is currently not available.
* @throws IllegalStateException if the interface is in a state
* in which accessing devices is not possible, such as
* a Bluetooth subsystem that has been shut down.
@ -183,6 +191,8 @@ interface BluetoothInterface {
*
* @throws BluetoothPermissionException if getting the adapter name
* fails because connection permissions are missing.
* @throws BluetoothNotAvailableException if the system's
* Bluetooth adapter is currently not available.
* @throws BluetoothException if getting the adapter name fails
* due to an underlying Bluetooth issue.
*/
@ -205,6 +215,11 @@ interface BluetoothInterface {
* round, it is possible that between the [getPairedDeviceAddresses]
* call and the [onDeviceUnpaired] assignment, a device is
* unpaired, and thus does not get noticed.
*
* @throws BluetoothNotEnabledException if the system's
* Bluetooth adapter is currently not enabled.
* @throws BluetoothNotAvailableException if the system's
* Bluetooth adapter is currently not available.
*/
fun getPairedDeviceAddresses(): Set<BluetoothAddress>
}