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_SYNC_CORE_ATTACHMENTS_ATTACHMENT_SERVICE_PROXY_H_ | 5 #ifndef COMPONENTS_SYNC_CORE_ATTACHMENTS_ATTACHMENT_SERVICE_PROXY_H_ |
6 #define COMPONENTS_SYNC_CORE_ATTACHMENTS_ATTACHMENT_SERVICE_PROXY_H_ | 6 #define COMPONENTS_SYNC_CORE_ATTACHMENTS_ATTACHMENT_SERVICE_PROXY_H_ |
7 | 7 |
8 #include "base/callback.h" | 8 #include "base/callback.h" |
9 #include "base/macros.h" | 9 #include "base/macros.h" |
10 #include "base/memory/weak_ptr.h" | 10 #include "base/memory/weak_ptr.h" |
11 #include "base/sequenced_task_runner.h" | 11 #include "base/sequenced_task_runner.h" |
12 #include "base/task_runner.h" | 12 #include "base/task_runner.h" |
13 #include "components/sync/api/attachments/attachment.h" | 13 #include "components/sync/api/attachments/attachment.h" |
14 #include "components/sync/base/sync_export.h" | |
15 #include "components/sync/core/attachments/attachment_service.h" | 14 #include "components/sync/core/attachments/attachment_service.h" |
16 | 15 |
17 namespace syncer { | 16 namespace syncer { |
18 | 17 |
19 // AttachmentServiceProxy wraps an AttachmentService allowing multiple threads | 18 // AttachmentServiceProxy wraps an AttachmentService allowing multiple threads |
20 // to share the wrapped AttachmentService and invoke its methods in the | 19 // to share the wrapped AttachmentService and invoke its methods in the |
21 // appropriate thread. | 20 // appropriate thread. |
22 // | 21 // |
23 // Callbacks passed to methods on this class will be invoked in the same thread | 22 // Callbacks passed to methods on this class will be invoked in the same thread |
24 // from which the method was called. | 23 // from which the method was called. |
25 // | 24 // |
26 // This class does not own its wrapped AttachmentService object. This class | 25 // This class does not own its wrapped AttachmentService object. This class |
27 // holds a WeakPtr to the wrapped object. Once the the wrapped object is | 26 // holds a WeakPtr to the wrapped object. Once the the wrapped object is |
28 // destroyed, method calls on this object will be no-ops. | 27 // destroyed, method calls on this object will be no-ops. |
29 // | 28 // |
30 // Users of this class should take care to destroy the wrapped object on the | 29 // Users of this class should take care to destroy the wrapped object on the |
31 // correct thread (wrapped_task_runner). | 30 // correct thread (wrapped_task_runner). |
32 // | 31 // |
33 // This class is thread-safe and is designed to be passed by const-ref. | 32 // This class is thread-safe and is designed to be passed by const-ref. |
34 class SYNC_EXPORT AttachmentServiceProxy : public AttachmentService { | 33 class AttachmentServiceProxy : public AttachmentService { |
35 public: | 34 public: |
36 // Default copy and assignment are welcome. | 35 // Default copy and assignment are welcome. |
37 | 36 |
38 // Construct an invalid AttachmentServiceProxy. | 37 // Construct an invalid AttachmentServiceProxy. |
39 AttachmentServiceProxy(); | 38 AttachmentServiceProxy(); |
40 | 39 |
41 // Construct an AttachmentServiceProxy that forwards calls to |wrapped| on the | 40 // Construct an AttachmentServiceProxy that forwards calls to |wrapped| on the |
42 // |wrapped_task_runner| thread. | 41 // |wrapped_task_runner| thread. |
43 // | 42 // |
44 // Note, this object does not own |wrapped|. When |wrapped| is destroyed, | 43 // Note, this object does not own |wrapped|. When |wrapped| is destroyed, |
(...skipping 17 matching lines...) Expand all Loading... |
62 // | 61 // |
63 // Callback from AttachmentService are proxied back using free functions | 62 // Callback from AttachmentService are proxied back using free functions |
64 // defined in the .cc file (ProxyFooCallback functions). | 63 // defined in the .cc file (ProxyFooCallback functions). |
65 // | 64 // |
66 // Core is ref-counted because we want to allow AttachmentServiceProxy to be | 65 // Core is ref-counted because we want to allow AttachmentServiceProxy to be |
67 // copy-constructable while allowing for different implementations of Core | 66 // copy-constructable while allowing for different implementations of Core |
68 // (e.g. one type of core might own the wrapped AttachmentService). | 67 // (e.g. one type of core might own the wrapped AttachmentService). |
69 // | 68 // |
70 // Calls to objects of this class become no-ops once its wrapped object is | 69 // Calls to objects of this class become no-ops once its wrapped object is |
71 // destroyed. | 70 // destroyed. |
72 class SYNC_EXPORT Core : public AttachmentService, | 71 class Core : public AttachmentService, |
73 public base::RefCountedThreadSafe<Core> { | 72 public base::RefCountedThreadSafe<Core> { |
74 public: | 73 public: |
75 // Construct an AttachmentServiceProxyCore that forwards calls to |wrapped|. | 74 // Construct an AttachmentServiceProxyCore that forwards calls to |wrapped|. |
76 explicit Core(const base::WeakPtr<syncer::AttachmentService>& wrapped); | 75 explicit Core(const base::WeakPtr<syncer::AttachmentService>& wrapped); |
77 | 76 |
78 // AttachmentService implementation. | 77 // AttachmentService implementation. |
79 void GetOrDownloadAttachments( | 78 void GetOrDownloadAttachments( |
80 const AttachmentIdList& attachment_ids, | 79 const AttachmentIdList& attachment_ids, |
81 const GetOrDownloadCallback& callback) override; | 80 const GetOrDownloadCallback& callback) override; |
82 void UploadAttachments(const AttachmentIdList& attachment_ids) override; | 81 void UploadAttachments(const AttachmentIdList& attachment_ids) override; |
83 | 82 |
(...skipping 14 matching lines...) Expand all Loading... |
98 const scoped_refptr<Core>& core); | 97 const scoped_refptr<Core>& core); |
99 | 98 |
100 private: | 99 private: |
101 scoped_refptr<base::SequencedTaskRunner> wrapped_task_runner_; | 100 scoped_refptr<base::SequencedTaskRunner> wrapped_task_runner_; |
102 scoped_refptr<Core> core_; | 101 scoped_refptr<Core> core_; |
103 }; | 102 }; |
104 | 103 |
105 } // namespace syncer | 104 } // namespace syncer |
106 | 105 |
107 #endif // COMPONENTS_SYNC_CORE_ATTACHMENTS_ATTACHMENT_SERVICE_PROXY_H_ | 106 #endif // COMPONENTS_SYNC_CORE_ATTACHMENTS_ATTACHMENT_SERVICE_PROXY_H_ |
OLD | NEW |