| // Copyright 2014 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 EXTENSIONS_BROWSER_API_BLUETOOTH_SOCKET_BLUETOOTH_API_SOCKET_H_ |
| #define EXTENSIONS_BROWSER_API_BLUETOOTH_SOCKET_BLUETOOTH_API_SOCKET_H_ |
| |
| #include <string> |
| |
| #include "base/macros.h" |
| #include "content/public/browser/browser_thread.h" |
| #include "device/bluetooth/bluetooth_device.h" |
| #include "device/bluetooth/bluetooth_socket.h" |
| #include "device/bluetooth/bluetooth_uuid.h" |
| #include "extensions/browser/api/api_resource.h" |
| #include "extensions/browser/api/api_resource_manager.h" |
| |
| namespace net { |
| class IOBuffer; |
| } // namespace net |
| |
| namespace extensions { |
| |
| // Representation of socket instances from the "bluetooth" namespace, |
| // abstracting away platform differences from the underlying BluetoothSocketXxx |
| // class. All methods must be called on the |kThreadId| thread. |
| class BluetoothApiSocket : public ApiResource { |
| public: |
| enum ErrorReason { kSystemError, kNotConnected, kNotListening, kIOPending, |
| kDisconnected }; |
| |
| typedef base::Callback<void(int)> SendCompletionCallback; |
| typedef base::Callback<void(int, scoped_refptr<net::IOBuffer> io_buffer)> |
| ReceiveCompletionCallback; |
| typedef base::Callback<void(const device::BluetoothDevice* device, |
| scoped_refptr<device::BluetoothSocket>)> |
| AcceptCompletionCallback; |
| typedef base::Callback<void(ErrorReason, const std::string& error_message)> |
| ErrorCompletionCallback; |
| |
| explicit BluetoothApiSocket(const std::string& owner_extension_id); |
| BluetoothApiSocket(const std::string& owner_extension_id, |
| scoped_refptr<device::BluetoothSocket> socket, |
| const std::string& device_address, |
| const device::BluetoothUUID& uuid); |
| ~BluetoothApiSocket() override; |
| |
| // Adopts a socket |socket| connected to a device with address |
| // |device_address| using the service with UUID |uuid|. |
| virtual void AdoptConnectedSocket( |
| scoped_refptr<device::BluetoothSocket> socket, |
| const std::string& device_address, |
| const device::BluetoothUUID& uuid); |
| |
| // Adopts a socket |socket| listening on a service advertised with UUID |
| // |uuid|. |
| virtual void AdoptListeningSocket( |
| scoped_refptr<device::BluetoothSocket> socket, |
| const device::BluetoothUUID& uuid); |
| |
| // Closes the underlying connection. This is a best effort, and never fails. |
| virtual void Disconnect(const base::Closure& callback); |
| |
| // Receives data from the socket and calls |success_callback| when data is |
| // available. |count| is maximum amount of bytes received. If an error occurs, |
| // calls |error_callback| with a reason and a message. In particular, if a |
| // |Receive| operation is still pending, |error_callback| will be called with |
| // |kIOPending| error. |
| virtual void Receive(int count, |
| const ReceiveCompletionCallback& success_callback, |
| const ErrorCompletionCallback& error_callback); |
| |
| // Sends |buffer| to the socket and calls |success_callback| when data has |
| // been successfully sent. |buffer_size| is the numberof bytes contained in |
| // |buffer|. If an error occurs, calls |error_callback| with a reason and a |
| // message. Calling |Send| multiple times without waiting for the callbacks to |
| // be called is a valid usage, as |buffer| instances are buffered until the |
| // underlying communication channel is available for sending data. |
| virtual void Send(scoped_refptr<net::IOBuffer> buffer, |
| int buffer_size, |
| const SendCompletionCallback& success_callback, |
| const ErrorCompletionCallback& error_callback); |
| |
| // Accepts a client connection from the socket and calls |success_callback| |
| // when one has connected. If an error occurs, calls |error_callback| with a |
| // reason and a message. |
| virtual void Accept(const AcceptCompletionCallback& success_callback, |
| const ErrorCompletionCallback& error_callback); |
| |
| const std::string& device_address() const { return device_address_; } |
| const device::BluetoothUUID& uuid() const { return uuid_; } |
| |
| // Overriden from extensions::ApiResource. |
| bool IsPersistent() const override; |
| |
| const std::string* name() const { return name_.get(); } |
| void set_name(const std::string& name) { name_.reset(new std::string(name)); } |
| |
| bool persistent() const { return persistent_; } |
| void set_persistent(bool persistent) { persistent_ = persistent; } |
| |
| int buffer_size() const { return buffer_size_; } |
| void set_buffer_size(int buffer_size) { buffer_size_ = buffer_size; } |
| |
| bool paused() const { return paused_; } |
| void set_paused(bool paused) { paused_ = paused; } |
| |
| bool IsConnected() const { return connected_; } |
| |
| // Platform specific implementations of |BluetoothSocket| require being called |
| // on the UI thread. |
| static const content::BrowserThread::ID kThreadId = |
| content::BrowserThread::UI; |
| |
| private: |
| friend class ApiResourceManager<BluetoothApiSocket>; |
| static const char* service_name() { return "BluetoothApiSocketManager"; } |
| |
| static void OnSocketReceiveError( |
| const ErrorCompletionCallback& error_callback, |
| device::BluetoothSocket::ErrorReason reason, |
| const std::string& message); |
| |
| static void OnSocketSendError( |
| const ErrorCompletionCallback& error_callback, |
| const std::string& message); |
| |
| static void OnSocketAcceptError( |
| const ErrorCompletionCallback& error_callback, |
| const std::string& message); |
| |
| // The underlying device socket instance. |
| scoped_refptr<device::BluetoothSocket> socket_; |
| |
| // The address of the device this socket is connected to. |
| std::string device_address_; |
| |
| // The uuid of the service this socket is connected to. |
| device::BluetoothUUID uuid_; |
| |
| // Application-defined string - see bluetooth.idl. |
| std::unique_ptr<std::string> name_; |
| |
| // Flag indicating whether the socket is left open when the application is |
| // suspended - see bluetooth.idl. |
| bool persistent_; |
| |
| // The size of the buffer used to receive data - see bluetooth.idl. |
| int buffer_size_; |
| |
| // Flag indicating whether a connected socket blocks its peer from sending |
| // more data - see bluetooth.idl. |
| bool paused_; |
| |
| // Flag indicating whether a socket is connected. |
| bool connected_; |
| |
| DISALLOW_COPY_AND_ASSIGN(BluetoothApiSocket); |
| }; |
| |
| } // namespace extensions |
| |
| #endif // EXTENSIONS_BROWSER_API_BLUETOOTH_SOCKET_BLUETOOTH_API_SOCKET_H_ |