summaryrefslogtreecommitdiff
path: root/chromium/device/bluetooth/bluetooth_remote_gatt_service.h
blob: 264d844e06646fe096befaf1520e1c24a924d72c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
// Copyright 2016 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef DEVICE_BLUETOOTH_BLUETOOTH_REMOTE_GATT_SERVICE_H_
#define DEVICE_BLUETOOTH_BLUETOOTH_REMOTE_GATT_SERVICE_H_

#include <memory>
#include <string>
#include <vector>

#include "base/containers/flat_map.h"
#include "device/bluetooth/bluetooth_export.h"
#include "device/bluetooth/bluetooth_gatt_service.h"

namespace device {

class BluetoothDevice;
class BluetoothRemoteGattCharacteristic;
class BluetoothUUID;

// BluetoothRemoteGattService represents a remote GATT service.
//
// Instances of the BluetoothRemoteGATTService class are used to represent GATT
// attribute hierarchies that have been received from a
// remote Bluetooth GATT peripheral. Such BluetoothRemoteGattService instances
// are constructed and owned by a BluetoothDevice.
//
// Note: We use virtual inheritance on the GATT service since it will be
// inherited by platform specific versions of the GATT service classes also. The
// platform specific remote GATT service classes will inherit both this class
// and their GATT service class, hence causing an inheritance diamond.
class DEVICE_BLUETOOTH_EXPORT BluetoothRemoteGattService
    : public virtual BluetoothGattService {
 public:
  BluetoothRemoteGattService(const BluetoothRemoteGattService&) = delete;
  BluetoothRemoteGattService& operator=(const BluetoothRemoteGattService&) =
      delete;

  ~BluetoothRemoteGattService() override;

  // Returns the BluetoothDevice that this GATT service was received from, which
  // also owns this service.
  virtual BluetoothDevice* GetDevice() const = 0;

  // List of characteristics that belong to this service.
  virtual std::vector<BluetoothRemoteGattCharacteristic*> GetCharacteristics()
      const;

  // List of GATT services that are included by this service.
  virtual std::vector<BluetoothRemoteGattService*> GetIncludedServices()
      const = 0;

  // Returns the GATT characteristic with identifier |identifier| if it belongs
  // to this GATT service.
  virtual BluetoothRemoteGattCharacteristic* GetCharacteristic(
      const std::string& identifier) const;

  // List of characteristics that belong to this service and have a UUID equal
  // to |characteristic_uuid|.
  virtual std::vector<BluetoothRemoteGattCharacteristic*>
  GetCharacteristicsByUUID(const BluetoothUUID& characteristic_uuid) const;

  // Returns true if all the characteristics have been discovered.
  virtual bool IsDiscoveryComplete() const;

  // Sets characteristic discovery as complete or incomplete.
  virtual void SetDiscoveryComplete(bool complete);

 protected:
  using CharacteristicMap =
      base::flat_map<std::string,
                     std::unique_ptr<BluetoothRemoteGattCharacteristic>>;

  BluetoothRemoteGattService();

  bool AddCharacteristic(
      std::unique_ptr<BluetoothRemoteGattCharacteristic> characteristic);

  CharacteristicMap characteristics_;

 private:
  // Is true if all the characteristics have been discovered.
  bool discovery_complete_ = false;
};

}  // namespace device

#endif  // DEVICE_BLUETOOTH_BLUETOOTH_REMOTE_GATT_SERVICE_H_