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_INTERNAL_API_PUBLIC_SYNC_CONTEXT_H_ | 5 #ifndef SYNC_INTERNAL_API_PUBLIC_SYNC_CONTEXT_H_ |
6 #define SYNC_INTERNAL_API_PUBLIC_SYNC_CONTEXT_H_ | 6 #define SYNC_INTERNAL_API_PUBLIC_SYNC_CONTEXT_H_ |
7 | 7 |
8 #include "base/basictypes.h" | 8 #include "base/basictypes.h" |
9 #include "base/memory/weak_ptr.h" | 9 #include "base/memory/weak_ptr.h" |
10 #include "base/sequenced_task_runner.h" | 10 #include "base/sequenced_task_runner.h" |
11 #include "sync/base/sync_export.h" | 11 #include "sync/base/sync_export.h" |
12 #include "sync/internal_api/public/base/model_type.h" | 12 #include "sync/internal_api/public/base/model_type.h" |
13 #include "sync/internal_api/public/non_blocking_sync_common.h" | 13 #include "sync/internal_api/public/non_blocking_sync_common.h" |
14 | 14 |
15 namespace syncer { | 15 namespace syncer_v2 { |
16 class ModelTypeSyncProxyImpl; | 16 class ModelTypeSyncProxyImpl; |
17 } | |
18 | 17 |
19 namespace syncer_v2 { | |
20 // An interface of the core parts of sync. | 18 // An interface of the core parts of sync. |
21 // | 19 // |
22 // In theory, this is the component that provides off-thread sync types with | 20 // In theory, this is the component that provides off-thread sync types with |
23 // functionality to schedule and execute communication with the sync server. In | 21 // functionality to schedule and execute communication with the sync server. In |
24 // practice, this class delegates most of the responsibilty of implemeting this | 22 // practice, this class delegates most of the responsibilty of implemeting this |
25 // functionality to other classes, and most of the interface is exposed not | 23 // functionality to other classes, and most of the interface is exposed not |
26 // directly here but instead through a per-ModelType class that this class helps | 24 // directly here but instead through a per-ModelType class that this class helps |
27 // instantiate. | 25 // instantiate. |
28 class SYNC_EXPORT_PRIVATE SyncContext { | 26 class SYNC_EXPORT_PRIVATE SyncContext { |
29 public: | 27 public: |
30 SyncContext(); | 28 SyncContext(); |
31 virtual ~SyncContext(); | 29 virtual ~SyncContext(); |
32 | 30 |
33 // Initializes the connection between the sync context on the sync thread and | 31 // Initializes the connection between the sync context on the sync thread and |
34 // a proxy for the specified non-blocking sync type that lives on the data | 32 // a proxy for the specified non-blocking sync type that lives on the data |
35 // type's thread. | 33 // type's thread. |
36 virtual void ConnectSyncTypeToWorker( | 34 virtual void ConnectSyncTypeToWorker( |
37 syncer::ModelType type, | 35 syncer::ModelType type, |
38 const DataTypeState& data_type_state, | 36 const DataTypeState& data_type_state, |
39 const UpdateResponseDataList& saved_pending_updates, | 37 const UpdateResponseDataList& saved_pending_updates, |
40 const scoped_refptr<base::SequencedTaskRunner>& datatype_task_runner, | 38 const scoped_refptr<base::SequencedTaskRunner>& datatype_task_runner, |
41 const base::WeakPtr<syncer::ModelTypeSyncProxyImpl>& type_sync_proxy) = 0; | 39 const base::WeakPtr<ModelTypeSyncProxyImpl>& type_sync_proxy) = 0; |
42 | 40 |
43 // Disconnects the syncer from the model and stops syncing the type. | 41 // Disconnects the syncer from the model and stops syncing the type. |
44 // | 42 // |
45 // By the time this is called, the model thread should have already | 43 // By the time this is called, the model thread should have already |
46 // invalidated the WeakPtr it sent to us in the connect request. Any | 44 // invalidated the WeakPtr it sent to us in the connect request. Any |
47 // messages sent to that ModelTypeSyncProxy will not be recived. | 45 // messages sent to that ModelTypeSyncProxy will not be recived. |
48 // | 46 // |
49 // This is the sync thread's chance to clear state associated with the type. | 47 // This is the sync thread's chance to clear state associated with the type. |
50 // It also causes the syncer to stop requesting updates for this type, and to | 48 // It also causes the syncer to stop requesting updates for this type, and to |
51 // abort any in-progress commit requests. | 49 // abort any in-progress commit requests. |
52 virtual void DisconnectSyncWorker(syncer::ModelType type) = 0; | 50 virtual void DisconnectSyncWorker(syncer::ModelType type) = 0; |
53 }; | 51 }; |
54 | 52 |
55 } // namespace syncer | 53 } // namespace syncer |
56 | 54 |
57 #endif // SYNC_INTERNAL_API_PUBLIC_SYNC_CONTEXT_H_ | 55 #endif // SYNC_INTERNAL_API_PUBLIC_SYNC_CONTEXT_H_ |
OLD | NEW |