OLD | NEW |
1 // Copyright 2012 The Chromium Authors. All rights reserved. | 1 // Copyright 2012 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 // A class representing an attempt to synchronize the local syncable data | 5 // A class representing an attempt to synchronize the local syncable data |
6 // store with a sync server. A SyncSession instance is passed as a stateful | 6 // store with a sync server. A SyncSession instance is passed as a stateful |
7 // bundle to and from various SyncerCommands with the goal of converging the | 7 // bundle to and from various SyncerCommands with the goal of converging the |
8 // client view of data with that of the server. The commands twiddle with | 8 // client view of data with that of the server. The commands twiddle with |
9 // session status in response to events and hiccups along the way, set and | 9 // session status in response to events and hiccups along the way, set and |
10 // query session progress with regards to conflict resolution and applying | 10 // query session progress with regards to conflict resolution and applying |
(...skipping 59 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
70 | 70 |
71 // The client has been instructed to change its long poll interval. | 71 // The client has been instructed to change its long poll interval. |
72 virtual void OnReceivedLongPollIntervalUpdate( | 72 virtual void OnReceivedLongPollIntervalUpdate( |
73 const base::TimeDelta& new_interval) = 0; | 73 const base::TimeDelta& new_interval) = 0; |
74 | 74 |
75 // The client has been instructed to change its sessions commit | 75 // The client has been instructed to change its sessions commit |
76 // delay. | 76 // delay. |
77 virtual void OnReceivedSessionsCommitDelay( | 77 virtual void OnReceivedSessionsCommitDelay( |
78 const base::TimeDelta& new_delay) = 0; | 78 const base::TimeDelta& new_delay) = 0; |
79 | 79 |
80 // The client needs to cease and desist syncing at once. This occurs when | |
81 // the Syncer detects that the backend store has fundamentally changed or | |
82 // is a different instance altogether (e.g. swapping from a test instance | |
83 // to production, or a global stop syncing operation has wiped the store). | |
84 // TODO(lipalani) : Replace this function with the one below. This function | |
85 // stops the current sync cycle and purges the client. In the new model | |
86 // the former would be done by the |SyncProtocolError| and | |
87 // the latter(which is an action) would be done in ProfileSyncService | |
88 // along with the rest of the actions. | |
89 virtual void OnShouldStopSyncingPermanently() = 0; | |
90 | |
91 // Called for the syncer to respond to the error sent by the server. | 80 // Called for the syncer to respond to the error sent by the server. |
92 virtual void OnSyncProtocolError( | 81 virtual void OnSyncProtocolError( |
93 const sessions::SyncSessionSnapshot& snapshot) = 0; | 82 const sessions::SyncSessionSnapshot& snapshot) = 0; |
94 | 83 |
95 // Called when the server wants to change the number of hints the client | 84 // Called when the server wants to change the number of hints the client |
96 // will buffer locally. | 85 // will buffer locally. |
97 virtual void OnReceivedClientInvalidationHintBufferSize(int size) = 0; | 86 virtual void OnReceivedClientInvalidationHintBufferSize(int size) = 0; |
98 | 87 |
99 protected: | 88 protected: |
100 virtual ~Delegate() {} | 89 virtual ~Delegate() {} |
(...skipping 38 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
139 // Our controller for various status and error counters. | 128 // Our controller for various status and error counters. |
140 scoped_ptr<StatusController> status_controller_; | 129 scoped_ptr<StatusController> status_controller_; |
141 | 130 |
142 DISALLOW_COPY_AND_ASSIGN(SyncSession); | 131 DISALLOW_COPY_AND_ASSIGN(SyncSession); |
143 }; | 132 }; |
144 | 133 |
145 } // namespace sessions | 134 } // namespace sessions |
146 } // namespace syncer | 135 } // namespace syncer |
147 | 136 |
148 #endif // SYNC_SESSIONS_SYNC_SESSION_H_ | 137 #endif // SYNC_SESSIONS_SYNC_SESSION_H_ |
OLD | NEW |