| OLD | NEW |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef DEVICE_BLUETOOTH_BLUETOOTH_SOCKET_H_ | 5 #ifndef DEVICE_BLUETOOTH_BLUETOOTH_SOCKET_H_ |
| 6 #define DEVICE_BLUETOOTH_BLUETOOTH_SOCKET_H_ | 6 #define DEVICE_BLUETOOTH_BLUETOOTH_SOCKET_H_ |
| 7 | 7 |
| 8 #include <string> | 8 #include <string> |
| 9 | 9 |
| 10 #include "base/callback.h" | 10 #include "base/callback.h" |
| 11 #include "base/memory/ref_counted.h" | 11 #include "base/memory/ref_counted.h" |
| 12 | 12 |
| 13 namespace net { | 13 namespace net { |
| 14 class IOBuffer; | 14 class IOBuffer; |
| 15 } // namespace net | 15 } // namespace net |
| 16 | 16 |
| 17 namespace device { | 17 namespace device { |
| 18 | 18 |
| 19 class BluetoothDevice; | 19 class BluetoothDevice; |
| 20 class BluetoothUUID; | 20 class BluetoothUUID; |
| 21 | 21 |
| 22 // BluetoothSocket represents a socket to a specific service on a | 22 // BluetoothSocket represents a socket to a specific service on a |
| 23 // BluetoothDevice. BluetoothSocket objects are ref counted and may outlive | 23 // BluetoothDevice. BluetoothSocket objects are ref counted and may outlive |
| 24 // both the BluetoothDevice and BluetoothAdapter that were involved in their | 24 // both the BluetoothDevice and BluetoothAdapter that were involved in their |
| 25 // creation. In terms of threading, platform specific implementations may | 25 // creation. In terms of threading, platform specific implementations may |
| 26 // differ slightly, but platform independent consumers must guarantee calling | 26 // differ slightly, but platform independent consumers must guarantee calling |
| 27 // various instance methods on the same thread as the thread used at | 27 // various instance methods on the same thread as the thread used at |
| 28 // construction time -- platform specific implementation are resonsible for | 28 // construction time -- platform specific implementation are responsible for |
| 29 // marshalling calls to a different thread if required. | 29 // marshalling calls to a different thread if required. |
| 30 class BluetoothSocket : public base::RefCountedThreadSafe<BluetoothSocket> { | 30 class BluetoothSocket : public base::RefCountedThreadSafe<BluetoothSocket> { |
| 31 public: | 31 public: |
| 32 enum ErrorReason { kSystemError, kIOPending, kDisconnected }; | 32 enum ErrorReason { kSystemError, kIOPending, kDisconnected }; |
| 33 | 33 |
| 34 typedef base::Callback<void(int)> SendCompletionCallback; | 34 typedef base::Callback<void(int)> SendCompletionCallback; |
| 35 typedef base::Callback<void(int, scoped_refptr<net::IOBuffer> io_buffer)> | 35 typedef base::Callback<void(int, scoped_refptr<net::IOBuffer> io_buffer)> |
| 36 ReceiveCompletionCallback; | 36 ReceiveCompletionCallback; |
| 37 typedef base::Callback<void(const BluetoothDevice* device, | 37 typedef base::Callback<void(const BluetoothDevice* device, |
| 38 scoped_refptr<BluetoothSocket> socket)> | 38 scoped_refptr<BluetoothSocket> socket)> |
| 39 AcceptCompletionCallback; | 39 AcceptCompletionCallback; |
| 40 typedef base::Callback<void(const std::string& error_message)> | 40 typedef base::Callback<void(const std::string& error_message)> |
| 41 ErrorCompletionCallback; | 41 ErrorCompletionCallback; |
| 42 typedef base::Callback<void(ErrorReason, const std::string& error_message)> | 42 typedef base::Callback<void(ErrorReason, const std::string& error_message)> |
| 43 ReceiveErrorCompletionCallback; | 43 ReceiveErrorCompletionCallback; |
| 44 | 44 |
| 45 // Destroys resources associated with the socket. After calling this method, | 45 // Destroys resources associated with the socket. After calling this method, |
| 46 // it is illegal to call any method on this socket instance (except for the | 46 // it is illegal to call any method on this socket instance (except for the |
| 47 // desctrutor via Release). | 47 // destructor via Release). |
| 48 virtual void Close() = 0; | 48 virtual void Close() = 0; |
| 49 | 49 |
| 50 // Gracefully disconnects the socket and calls |callback| upon completion. | 50 // Gracefully disconnects the socket and calls |callback| upon completion. |
| 51 // There is no failure case, as this is a best effort operation. | 51 // There is no failure case, as this is a best effort operation. |
| 52 virtual void Disconnect(const base::Closure& success_callback) = 0; | 52 virtual void Disconnect(const base::Closure& success_callback) = 0; |
| 53 | 53 |
| 54 // Receives data from the socket and calls |success_callback| when data is | 54 // Receives data from the socket and calls |success_callback| when data is |
| 55 // available. |buffer_size| specifies the maximum number of bytes that can be | 55 // available. |buffer_size| specifies the maximum number of bytes that can be |
| 56 // received. If an error occurs, calls |error_callback| with a reason and an | 56 // received. If an error occurs, calls |error_callback| with a reason and an |
| 57 // error message. | 57 // error message. |
| (...skipping 18 matching lines...) Expand all Loading... |
| 76 const ErrorCompletionCallback& error_callback) = 0; | 76 const ErrorCompletionCallback& error_callback) = 0; |
| 77 | 77 |
| 78 protected: | 78 protected: |
| 79 friend class base::RefCountedThreadSafe<BluetoothSocket>; | 79 friend class base::RefCountedThreadSafe<BluetoothSocket>; |
| 80 virtual ~BluetoothSocket(); | 80 virtual ~BluetoothSocket(); |
| 81 }; | 81 }; |
| 82 | 82 |
| 83 } // namespace device | 83 } // namespace device |
| 84 | 84 |
| 85 #endif // DEVICE_BLUETOOTH_BLUETOOTH_SOCKET_H_ | 85 #endif // DEVICE_BLUETOOTH_BLUETOOTH_SOCKET_H_ |
| OLD | NEW |