Bluetooth class changes for implementing local GATT attributes.

device/bluetooth/bluez/bluetooth_local_gatt_service_bluez.h

 // 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_BLUEZ_BLUETOOTH_LOCAL_GATT_SERVICE_BLUEZ_H_
 #define DEVICE_BLUETOOTH_BLUEZ_BLUETOOTH_LOCAL_GATT_SERVICE_BLUEZ_H_
 
 #include <string>
+#include <vector>
 
 #include "base/callback_forward.h"
 #include "base/macros.h"
 #include "base/memory/weak_ptr.h"
 #include "device/bluetooth/bluetooth_local_gatt_service.h"
 #include "device/bluetooth/bluetooth_uuid.h"
 #include "device/bluetooth/bluez/bluetooth_gatt_service_bluez.h"
+#include "device/bluetooth/bluez/bluetooth_local_gatt_characteristic_bluez.h"
 
 namespace device {
 
 class BluetoothAdapter;
 class BluetoothDevice;
 
 }  // namespace device
 
 namespace bluez {
 
 class BluetoothAdapterBlueZ;
-class BluetoothDeviceBlueZ;
+class BluetoothLocalGattCharacteristicBlueZ;
 
 // The BluetoothLocalGattServiceBlueZ class implements BluetootGattService
 // for local GATT services for platforms that use BlueZ.
 class BluetoothLocalGattServiceBlueZ
     : public BluetoothGattServiceBlueZ,
       public device::BluetoothLocalGattService {
  public:
-  // device::BluetoothGattService overrides.
-  device::BluetoothUUID GetUUID() const override;
-  bool IsPrimary() const override;
+  // A simpler interface for reacting to GATT attribute value requests by the
+  // DBus attribute service providers.
+  class AttributeValueDelegate {
+   public:
+    virtual ~AttributeValueDelegate() {}
 
-  // device::BluetoothLocalGattService overrides.
+    // This method will be called when a remote device requests to read the
+    // value of the exported GATT attribute. Invoke |callback| with a value
+    // to return that value to the requester. Invoke |error_callback| to report
+    // a failure to read the value. This can happen, for example, if the
+    // attribute has no read permission set. Either callback should be
+    // invoked after a reasonable amount of time, since the request will time
+    // out if left pending for too long causing a disconnection.
+    virtual void GetValue(
+        const device::BluetoothLocalGattService::Delegate::ValueCallback&
+            callback,
+        const device::BluetoothLocalGattService::Delegate::ErrorCallback&
+            error_callback) = 0;
+
+    // This method will be called, when a remote device requests to write the
+    // value of the exported GATT attribute. Invoke |callback| to report
+    // that the value was successfully written. Invoke |error_callback| to
+    // report a failure to write the value. This can happen, for example, if the
+    // attribute has no write permission set. Either callback should be
+    // invoked after a reasonable amount of time, since the request will time
+    // out if left pending for too long causing a disconnection.
+    virtual void SetValue(
+        const std::vector<uint8_t>& value,
+        const base::Closure& callback,
+        const device::BluetoothLocalGattService::Delegate::ErrorCallback&
+            error_callback) = 0;
+  };
+
   static base::WeakPtr<device::BluetoothLocalGattService> Create(
       device::BluetoothAdapter* adapter,
       const device::BluetoothUUID& uuid,
       bool is_primary,
       BluetoothLocalGattService* included_service,
       BluetoothLocalGattService::Delegate* delegate);
-  void Register(const base::Closure& callback,
-                const ErrorCallback& error_callback) override;
-  void Unregister(const base::Closure& callback,
-                  const ErrorCallback& error_callback) override;
 
   BluetoothLocalGattServiceBlueZ(
       BluetoothAdapterBlueZ* adapter,
       const device::BluetoothUUID& uuid,
       bool is_primary,
       device::BluetoothLocalGattService::Delegate* delegate);
+
   ~BluetoothLocalGattServiceBlueZ() override;
 
+  // device::BluetoothGattService overrides.
+  device::BluetoothUUID GetUUID() const override;
+  bool IsPrimary() const override;
+
+  // device::BluetoothLocalGattService overrides.
+  void Register(const base::Closure& callback,
+                const ErrorCallback& error_callback) override;
+  void Unregister(const base::Closure& callback,
+                  const ErrorCallback& error_callback) override;
+
+  const std::vector<std::unique_ptr<BluetoothLocalGattCharacteristicBlueZ>>&
+  GetCharacteristics() const;
+
+  Delegate* GetDelegate() { return delegate_; }
+
+  static dbus::ObjectPath AddGuidToObjectPath(const std::string& path);
+
  private:
+  friend class BluetoothLocalGattCharacteristicBlueZ;
+
   // Called by dbus:: on unsuccessful completion of a request to register a
   // local service.
   void OnRegistrationError(const ErrorCallback& error_callback,
                            const std::string& error_name,
                            const std::string& error_message);
 
-  BluetoothAdapterBlueZ* adapter_;
-  const device::BluetoothUUID& uuid_;
+  void AddCharacteristic(
+      std::unique_ptr<BluetoothLocalGattCharacteristicBlueZ> characteristic);
+
+  // UUID of this service.
+  device::BluetoothUUID uuid_;
+
+  // If this service is primary.
   bool is_primary_;
+
+  // Delegate to receive read/write requests for attribute  values contained
+  // in this service.
   device::BluetoothLocalGattService::Delegate* delegate_;
 
+  // Characteristics contained by this service.
+  std::vector<std::unique_ptr<BluetoothLocalGattCharacteristicBlueZ>>
+      characteristics_;
+
   // Note: This should remain the last member so it'll be destroyed and
   // invalidate its weak pointers before any other members are destroyed.
   base::WeakPtrFactory<BluetoothLocalGattServiceBlueZ> weak_ptr_factory_;
 
   DISALLOW_COPY_AND_ASSIGN(BluetoothLocalGattServiceBlueZ);
 };
 
 }  // namespace bluez
 
 #endif  // DEVICE_BLUETOOTH_BLUEZ_BLUETOOTH_LOCAL_GATT_SERVICE_BLUEZ_H_