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 |