| 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 |