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 SYNC_API_ATTACHMENTS_ATTACHMENT_SERVICE_PROXY_H_ | 5 #ifndef SYNC_API_ATTACHMENTS_ATTACHMENT_SERVICE_PROXY_H_ |
6 #define SYNC_API_ATTACHMENTS_ATTACHMENT_SERVICE_PROXY_H_ | 6 #define SYNC_API_ATTACHMENTS_ATTACHMENT_SERVICE_PROXY_H_ |
7 | 7 |
8 #include "base/basictypes.h" | 8 #include "base/basictypes.h" |
9 #include "base/callback.h" | 9 #include "base/callback.h" |
10 #include "base/memory/scoped_ptr.h" | 10 #include "base/memory/scoped_ptr.h" |
11 #include "base/memory/weak_ptr.h" | 11 #include "base/memory/weak_ptr.h" |
12 #include "base/sequenced_task_runner.h" | 12 #include "base/sequenced_task_runner.h" |
13 #include "base/task_runner.h" | 13 #include "base/task_runner.h" |
14 #include "sync/api/attachments/attachment.h" | 14 #include "sync/api/attachments/attachment.h" |
15 #include "sync/api/attachments/attachment_service.h" | 15 #include "sync/api/attachments/attachment_service.h" |
16 #include "sync/base/sync_export.h" | 16 #include "sync/base/sync_export.h" |
17 | 17 |
18 namespace syncer { | 18 namespace syncer { |
19 | 19 |
20 class SyncData; | 20 class SyncData; |
21 | 21 |
22 // AttachmentServiceProxy wraps an AttachmentService allowing multiple threads | 22 // AttachmentServiceProxy wraps an AttachmentService allowing multiple threads |
23 // to share the wrapped AttachmentService. | 23 // to share the wrapped AttachmentService and invoked its methods in the |
| 24 // appropriate thread. |
24 // | 25 // |
25 // Callbacks passed to methods on this class will be invoked in the same thread | 26 // Callbacks passed to methods on this class will be invoked in the same thread |
26 // from which the method was called. | 27 // from which the method was called. |
27 // | 28 // |
28 // This class does not own its wrapped AttachmentService object. This class | 29 // This class does not own its wrapped AttachmentService object. This class |
29 // holds a WeakPtr to the wrapped object. Once the the wrapped object is | 30 // holds a WeakPtr to the wrapped object. Once the the wrapped object is |
30 // destroyed, method calls on this object will be no-ops. | 31 // destroyed, method calls on this object will be no-ops. |
31 // | 32 // |
32 // Users of this class should take care to destroy the wrapped object on the | 33 // Users of this class should take care to destroy the wrapped object on the |
33 // correct thread (wrapped_task_runner). | 34 // correct thread (wrapped_task_runner). |
34 // | 35 // |
35 // This class is thread-safe. | 36 // This class is thread-safe. |
36 class SYNC_EXPORT AttachmentServiceProxy : public AttachmentService { | 37 class SYNC_EXPORT AttachmentServiceProxy : public AttachmentService { |
37 public: | 38 public: |
38 // Default copy and assignment are welcome. | 39 // Default copy and assignment are welcome. |
39 | 40 |
40 // Construct an invalid AttachmentServiceProxy. | 41 // Construct an invalid AttachmentServiceProxy. |
41 AttachmentServiceProxy(); | 42 AttachmentServiceProxy(); |
42 | 43 |
43 // Construct an AttachmentServiceProxy that forwards calls to |wrapped| on the | 44 // Construct an AttachmentServiceProxy that forwards calls to |wrapped| on the |
44 // |wrapped_task_runner| thread. | 45 // |wrapped_task_runner| thread. |
| 46 // |
| 47 // Note, this object does not own |wrapped|. When |wrapped| is destroyed, |
| 48 // calls to this object become no-ops. |
45 AttachmentServiceProxy( | 49 AttachmentServiceProxy( |
46 const scoped_refptr<base::SequencedTaskRunner>& wrapped_task_runner, | 50 const scoped_refptr<base::SequencedTaskRunner>& wrapped_task_runner, |
47 base::WeakPtr<syncer::AttachmentService> wrapped); | 51 base::WeakPtr<syncer::AttachmentService> wrapped); |
48 | 52 |
49 virtual ~AttachmentServiceProxy(); | 53 virtual ~AttachmentServiceProxy(); |
50 | 54 |
51 // AttachmentService implementation. | 55 // AttachmentService implementation. |
52 virtual void GetOrDownloadAttachments(const AttachmentIdList& attachment_ids, | 56 virtual void GetOrDownloadAttachments(const AttachmentIdList& attachment_ids, |
53 const GetOrDownloadCallback& callback) | 57 const GetOrDownloadCallback& callback) |
54 OVERRIDE; | 58 OVERRIDE; |
55 virtual void DropAttachments(const AttachmentIdList& attachment_ids, | 59 virtual void DropAttachments(const AttachmentIdList& attachment_ids, |
56 const DropCallback& callback) OVERRIDE; | 60 const DropCallback& callback) OVERRIDE; |
57 virtual void OnSyncDataAdd(const SyncData& sync_data) OVERRIDE; | 61 virtual void OnSyncDataAdd(const SyncData& sync_data) OVERRIDE; |
58 virtual void OnSyncDataDelete(const SyncData& sync_data) OVERRIDE; | 62 virtual void OnSyncDataDelete(const SyncData& sync_data) OVERRIDE; |
59 virtual void OnSyncDataUpdate(const AttachmentIdList& old_attachment_ids, | 63 virtual void OnSyncDataUpdate(const AttachmentIdList& old_attachment_ids, |
60 const SyncData& updated_sync_data) OVERRIDE; | 64 const SyncData& updated_sync_data) OVERRIDE; |
61 | 65 |
| 66 protected: |
| 67 // A ref-counted AttachmentService that forwards to a wrapped |
| 68 // AttachmentService. |
| 69 // |
| 70 // This class is ref-counted because we want to allow AttachmentServiceProxy |
| 71 // to be copy-constructable while allowing for different implementations of |
| 72 // ForwardingCore (e.g. one type of core might own the wrapped |
| 73 // AttachmentService). |
| 74 // |
| 75 // Calls to objects of this class become no-ops once its wrapped object is |
| 76 // destroyed. |
| 77 class SYNC_EXPORT ForwardingCore |
| 78 : public AttachmentService, |
| 79 public base::RefCountedThreadSafe<ForwardingCore> { |
| 80 public: |
| 81 // Construct an AttachmentServiceProxyCore that forwards calls to |wrapped|. |
| 82 ForwardingCore(const base::WeakPtr<syncer::AttachmentService>& wrapped); |
| 83 |
| 84 // AttachmentService implementation. |
| 85 virtual void GetOrDownloadAttachments( |
| 86 const AttachmentIdList& attachment_ids, |
| 87 const GetOrDownloadCallback& callback) OVERRIDE; |
| 88 virtual void DropAttachments(const AttachmentIdList& attachment_ids, |
| 89 const DropCallback& callback) OVERRIDE; |
| 90 virtual void OnSyncDataAdd(const SyncData& sync_data) OVERRIDE; |
| 91 virtual void OnSyncDataDelete(const SyncData& sync_data) OVERRIDE; |
| 92 virtual void OnSyncDataUpdate(const AttachmentIdList& old_attachment_ids, |
| 93 const SyncData& updated_sync_data) OVERRIDE; |
| 94 |
| 95 protected: |
| 96 friend class base::RefCountedThreadSafe<ForwardingCore>; |
| 97 virtual ~ForwardingCore(); |
| 98 |
| 99 private: |
| 100 base::WeakPtr<AttachmentService> wrapped_; |
| 101 |
| 102 DISALLOW_COPY_AND_ASSIGN(ForwardingCore); |
| 103 }; |
| 104 |
| 105 AttachmentServiceProxy( |
| 106 const scoped_refptr<base::SequencedTaskRunner>& wrapped_task_runner, |
| 107 const scoped_refptr<ForwardingCore>& core); |
| 108 |
62 private: | 109 private: |
63 scoped_refptr<base::SequencedTaskRunner> wrapped_task_runner_; | 110 scoped_refptr<base::SequencedTaskRunner> wrapped_task_runner_; |
64 // wrapped_ must only be dereferenced on the wrapped_task_runner_ thread. | 111 scoped_refptr<ForwardingCore> core_; |
65 base::WeakPtr<AttachmentService> wrapped_; | |
66 }; | 112 }; |
67 | 113 |
68 } // namespace syncer | 114 } // namespace syncer |
69 | 115 |
70 #endif // SYNC_API_ATTACHMENTS_ATTACHMENT_SERVICE_PROXY_H_ | 116 #endif // SYNC_API_ATTACHMENTS_ATTACHMENT_SERVICE_PROXY_H_ |
OLD | NEW |