blob: 73c60c1f90fba57ee3f289f1b68aa669a2b3156c [file] [log] [blame]
// Copyright 2015 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 THIRD_PARTY_BLINK_RENDERER_MODULES_BLUETOOTH_BLUETOOTH_REMOTE_GATT_SERVER_H_
#define THIRD_PARTY_BLINK_RENDERER_MODULES_BLUETOOTH_BLUETOOTH_REMOTE_GATT_SERVER_H_
#include "mojo/public/cpp/bindings/associated_receiver_set.h"
#include "third_party/blink/public/mojom/bluetooth/web_bluetooth.mojom-blink.h"
#include "third_party/blink/renderer/bindings/modules/v8/string_or_unsigned_long.h"
#include "third_party/blink/renderer/core/execution_context/context_lifecycle_observer.h"
#include "third_party/blink/renderer/modules/bluetooth/bluetooth_device.h"
#include "third_party/blink/renderer/platform/bindings/script_wrappable.h"
#include "third_party/blink/renderer/platform/heap/heap.h"
#include "third_party/blink/renderer/platform/wtf/text/wtf_string.h"
namespace blink {
class BluetoothDevice;
class ScriptPromise;
class ScriptPromiseResolver;
class ScriptState;
// BluetoothRemoteGATTServer provides a way to interact with a connected
// bluetooth peripheral.
class BluetoothRemoteGATTServer
: public ScriptWrappable,
public ContextLifecycleObserver,
public mojom::blink::WebBluetoothServerClient {
USING_PRE_FINALIZER(BluetoothRemoteGATTServer, Dispose);
DEFINE_WRAPPERTYPEINFO();
USING_GARBAGE_COLLECTED_MIXIN(BluetoothRemoteGATTServer);
public:
BluetoothRemoteGATTServer(ExecutionContext*, BluetoothDevice*);
// ContextLifecycleObserver:
void ContextDestroyed(ExecutionContext*) override;
// mojom::blink::WebBluetoothServerClient:
void GATTServerDisconnected() override;
void SetConnected(bool connected) { connected_ = connected; }
// The Active Algorithms set is maintained so that disconnection, i.e.
// disconnect() method or the device disconnecting by itself, can be detected
// by algorithms. They check via RemoveFromActiveAlgorithms that their
// resolvers is still in the set of active algorithms.
//
// Adds |resolver| to the set of Active Algorithms. CHECK-fails if
// |resolver| was already added.
void AddToActiveAlgorithms(ScriptPromiseResolver*);
// Removes |resolver| from the set of Active Algorithms if it was in the set
// and returns true, false otherwise.
bool RemoveFromActiveAlgorithms(ScriptPromiseResolver*);
// Removes all ScriptPromiseResolvers from the set of Active Algorithms.
void ClearActiveAlgorithms() { active_algorithms_.clear(); }
// If gatt is connected then sets gatt.connected to false and disconnects.
// This function only performs the necessary steps to ensure a device
// disconnects therefore it should only be used when the object is being
// garbage collected or the context is being destroyed.
void DisconnectIfConnected();
// Performs necessary cleanup when a device disconnects and fires
// gattserverdisconnected event.
void CleanupDisconnectedDeviceAndFireEvent();
void DispatchDisconnected();
// USING_PRE_FINALIZER interface.
// Called before the object gets garbage collected.
void Dispose();
// Interface required by Garbage Collectoin:
void Trace(blink::Visitor*) override;
// IDL exposed interface:
BluetoothDevice* device() { return device_; }
bool connected() { return connected_; }
ScriptPromise connect(ScriptState*);
void disconnect(ScriptState*);
ScriptPromise getPrimaryService(ScriptState*,
const StringOrUnsignedLong& service,
ExceptionState&);
ScriptPromise getPrimaryServices(ScriptState*,
const StringOrUnsignedLong& service,
ExceptionState&);
ScriptPromise getPrimaryServices(ScriptState*, ExceptionState&);
private:
ScriptPromise GetPrimaryServicesImpl(
ScriptState*,
mojom::blink::WebBluetoothGATTQueryQuantity,
String service_uuid = String());
void ConnectCallback(ScriptPromiseResolver*,
mojom::blink::WebBluetoothResult);
void GetPrimaryServicesCallback(
const String& requested_service_uuid,
mojom::blink::WebBluetoothGATTQueryQuantity,
ScriptPromiseResolver*,
mojom::blink::WebBluetoothResult,
base::Optional<Vector<mojom::blink::WebBluetoothRemoteGATTServicePtr>>
services);
// Contains a ScriptPromiseResolver corresponding to each active algorithm
// using this server’s connection.
HeapHashSet<Member<ScriptPromiseResolver>> active_algorithms_;
mojo::AssociatedReceiverSet<mojom::blink::WebBluetoothServerClient>
client_receivers_;
Member<BluetoothDevice> device_;
bool connected_;
};
} // namespace blink
#endif // THIRD_PARTY_BLINK_RENDERER_MODULES_BLUETOOTH_BLUETOOTH_REMOTE_GATT_SERVER_H_