OLD | NEW |
1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 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 COMPONENTS_COPRESENCE_PUBLIC_COPRESENCE_CLIENT_H_ | 5 #ifndef COMPONENTS_COPRESENCE_PUBLIC_COPRESENCE_CLIENT_H_ |
6 #define COMPONENTS_COPRESENCE_PUBLIC_COPRESENCE_CLIENT_H_ | 6 #define COMPONENTS_COPRESENCE_PUBLIC_COPRESENCE_CLIENT_H_ |
7 | 7 |
8 #include <string> | 8 #include <string> |
9 #include <vector> | 9 #include <vector> |
10 | 10 |
(...skipping 23 matching lines...) Expand all Loading... |
34 std::string app_id; | 34 std::string app_id; |
35 StatusCallback callback; | 35 StatusCallback callback; |
36 }; | 36 }; |
37 | 37 |
38 // The CopresenceClient class is the central interface for Copresence | 38 // The CopresenceClient class is the central interface for Copresence |
39 // functionality. This class handles all the initialization and delegation of | 39 // functionality. This class handles all the initialization and delegation of |
40 // copresence tasks. Any user of copresence only needs to interact with this | 40 // copresence tasks. Any user of copresence only needs to interact with this |
41 // client. | 41 // client. |
42 class CopresenceClient : public base::SupportsWeakPtr<CopresenceClient> { | 42 class CopresenceClient : public base::SupportsWeakPtr<CopresenceClient> { |
43 public: | 43 public: |
44 // The delegate must outlive us. | |
45 explicit CopresenceClient(CopresenceClientDelegate* delegate); | |
46 virtual ~CopresenceClient(); | 44 virtual ~CopresenceClient(); |
47 | 45 |
48 // This method will execute a report request. Each report request can have | 46 // This method will execute a report request. Each report request can have |
49 // multiple (un)publishes, (un)subscribes. This will ensure that once the | 47 // multiple (un)publishes, (un)subscribes. This will ensure that once the |
50 // client is initialized, it sends all request to the server and handles | 48 // client is initialized, it sends all request to the server and handles |
51 // the response. If an error is encountered, the status callback is used | 49 // the response. If an error is encountered, the status callback is used |
52 // to relay it to the requester. | 50 // to relay it to the requester. |
53 void ExecuteReportRequest(copresence::ReportRequest request, | 51 virtual void ExecuteReportRequest(copresence::ReportRequest request, |
54 const std::string& app_id, | 52 const std::string& app_id, |
55 const StatusCallback& callback); | 53 const StatusCallback& callback); |
56 | 54 |
57 // Called before the API (and thus the Client) is destructed. | 55 // Called before the API (and thus the Client) is destructed. |
58 void Shutdown(); | 56 void Shutdown(); |
59 | 57 |
| 58 // Factory method for CopresenceClients. The delegate is owned |
| 59 // by the caller, and must outlive the client. |
| 60 static scoped_ptr<CopresenceClient> Create( |
| 61 CopresenceClientDelegate* delegate); |
| 62 |
| 63 protected: |
| 64 // Create clients with the Create() method. |
| 65 CopresenceClient(); |
| 66 |
60 private: | 67 private: |
| 68 |
61 void CompleteInitialization(); | 69 void CompleteInitialization(); |
62 void InitStepComplete(const std::string& step, bool success); | 70 void InitStepComplete(const std::string& step, bool success); |
63 | 71 |
64 CopresenceClientDelegate* delegate_; | 72 CopresenceClientDelegate* delegate_; |
65 bool init_failed_; | 73 bool init_failed_; |
66 std::vector<PendingRequest> pending_requests_queue_; | 74 std::vector<PendingRequest> pending_requests_queue_; |
67 | 75 |
68 // TODO(rkc): This code is almost identical to what we use in feedback to | 76 // TODO(rkc): This code is almost identical to what we use in feedback to |
69 // perform multiple blocking tasks and then run a post process method. Look | 77 // perform multiple blocking tasks and then run a post process method. Look |
70 // into refactoring it all out to a common construct, like maybe a | 78 // into refactoring it all out to a common construct, like maybe a |
71 // PostMultipleTasksAndReply? | 79 // PostMultipleTasksAndReply? |
72 size_t pending_init_operations_; | 80 size_t pending_init_operations_; |
73 | 81 |
74 scoped_ptr<RpcHandler> rpc_handler_; | 82 scoped_ptr<RpcHandler> rpc_handler_; |
75 | 83 |
76 DISALLOW_COPY_AND_ASSIGN(CopresenceClient); | 84 DISALLOW_COPY_AND_ASSIGN(CopresenceClient); |
77 }; | 85 }; |
78 | 86 |
79 } // namespace copresence | 87 } // namespace copresence |
80 | 88 |
81 #endif // COMPONENTS_COPRESENCE_PUBLIC_COPRESENCE_CLIENT_H_ | 89 #endif // COMPONENTS_COPRESENCE_PUBLIC_COPRESENCE_CLIENT_H_ |
OLD | NEW |