device/bluetooth: Introduce BluetoothGattConnection.

device/bluetooth/bluetooth_device.h

 // Copyright (c) 2012 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_DEVICE_H_
 #define DEVICE_BLUETOOTH_BLUETOOTH_DEVICE_H_
 
 #include <map>
 #include <string>
 #include <vector>
 
 #include "base/callback.h"
 #include "base/memory/ref_counted.h"
 #include "base/memory/scoped_vector.h"
 #include "base/strings/string16.h"
 #include "device/bluetooth/bluetooth_uuid.h"
 #include "net/base/net_log.h"
 
 namespace device {
 
+class BluetoothGattConnection;
 class BluetoothGattService;
 class BluetoothSocket;
 class BluetoothUUID;
 
 // BluetoothDevice represents a remote Bluetooth device, both its properties and
 // capabilities as discovered by a local adapter and actions that may be
 // performed on the remove device such as pairing, connection and disconnection.
 //
 // The class is instantiated and managed by the BluetoothAdapter class
 // and pointers should only be obtained from that class and not cached,
@@ skipping 343 matching lines @@
   // cause.
   typedef base::Callback<void(scoped_refptr<BluetoothSocket>)>
       ConnectToServiceCallback;
   typedef base::Callback<void(const std::string& message)>
       ConnectToServiceErrorCallback;
   virtual void ConnectToService(
       const BluetoothUUID& uuid,
       const ConnectToServiceCallback& callback,
       const ConnectToServiceErrorCallback& error_callback) = 0;
 
+  // Opens a new GATT connection to this device. On success, a new
+  // BluetoothGattConnection will be handed to the caller via |callback|. On
+  // error, |error_callback| will be called. The connection will be kept alive,
+  // as long as there is at least one active GATT connection. In the case that
+  // the underlying connection gets terminated, either due to a call to
+  // BluetoothDevice::Disconnect or other unexpected circumstances, the
+  // returned BluetoothGattConnection will be automatically marked as inactive.
+  // To monitor the state of the connection, observe the
+  // BluetoothAdapter::Observer::DeviceChanged method.
+  typedef base::Callback<void(BluetoothGattConnection*)>
+      GattConnectionCallback;
+  virtual void CreateGattConnection(
+      const GattConnectionCallback& callback,
+      const ConnectErrorCallback& error_callback) = 0;
+
   // Starts monitoring the connection properties, RSSI and TX power. These
   // properties will be tracked, and updated when their values change. Exactly
   // one of |callback| or |error_callback| will be run.
   virtual void StartConnectionMonitor(const base::Closure& callback,
                                       const ErrorCallback& error_callback) = 0;
 
   // Returns the list of discovered GATT services.
   virtual std::vector<BluetoothGattService*> GetGattServices() const;
 
   // Returns the GATT service with device-specific identifier |identifier|.
@@ skipping 19 matching lines @@
 
  private:
   // Returns a localized string containing the device's bluetooth address and
   // a device type for display when |name_| is empty.
   base::string16 GetAddressWithLocalizedDeviceTypeName() const;
 };
 
 }  // namespace device
 
 #endif  // DEVICE_BLUETOOTH_BLUETOOTH_DEVICE_H_