sync: Report GetUpdate triggers to the server

sync/engine/sync_scheduler.h

 // Copyright 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 //
 // A class to schedule syncer tasks intelligently.
 #ifndef SYNC_ENGINE_SYNC_SCHEDULER_H_
 #define SYNC_ENGINE_SYNC_SCHEDULER_H_
 
 #include <string>
 
@@ skipping 65 matching lines @@
   virtual bool ScheduleConfiguration(const ConfigurationParams& params) = 0;
 
   // Request that any running syncer task stop as soon as possible and
   // cancel all scheduled tasks. This function can be called from any thread,
   // and should in fact be called from a thread that isn't the sync loop to
   // allow preempting ongoing sync cycles.
   // Invokes |callback| from the sync loop once syncer is idle and all tasks
   // are cancelled.
   virtual void RequestStop(const base::Closure& callback) = 0;
 
-  // The meat and potatoes. Both of these methods will post a delayed task
-  // to attempt the actual nudge (see ScheduleNudgeImpl).
+  // The meat and potatoes. All three of the following methods will post a
+  // delayed task to attempt the actual nudge (see ScheduleNudgeImpl).
+  //
   // NOTE: |desired_delay| is best-effort. If a nudge is already scheduled to
   // depart earlier than Now() + delay, the scheduler can and will prefer to
   // batch the two so that only one nudge is sent (at the earlier time). Also,
   // as always with delayed tasks and timers, it's possible the task gets run
   // any time after |desired_delay|.
-  virtual void ScheduleNudgeAsync(
+
+  // The LocalNudge indicates that we've made a local change, and that the
+  // syncer should plan to commit this to the server some time soon.
+  virtual void ScheduleLocalNudge(
       const base::TimeDelta& desired_delay,
-      NudgeSource source,
       ModelTypeSet types,
       const tracked_objects::Location& nudge_location) = 0;
-  virtual void ScheduleNudgeWithStatesAsync(
-      const base::TimeDelta& desired_delay, NudgeSource source,
+
+  // The LocalRefreshRequest occurs when we decide for some reason to manually
+  // request updates.  This should be used sparingly.  For example, one of its
+  // uses is to fetch the latest tab sync data when it's relevant to the UI on
+  // platforms where tab sync is not registered for invalidations.
+  virtual void ScheduleLocalRefreshRequest(
+      const base::TimeDelta& desired_delay,
+      ModelTypeSet types,
+      const tracked_objects::Location& nudge_location) = 0;
+
+  // Invalidations are notifications the server sends to let us know when other
+  // clients have committed data.  We need to contact the sync server (being
+  // careful to pass along the "hints" delivered with those invalidations) in
+  // order to fetch the update.
+  virtual void ScheduleInvalidationNudge(
+      const base::TimeDelta& desired_delay,
       const ModelTypeInvalidationMap& invalidation_map,
       const tracked_objects::Location& nudge_location) = 0;
 
   // Change status of notifications in the SyncSessionContext.
   virtual void SetNotificationsEnabled(bool notifications_enabled) = 0;
 
   virtual base::TimeDelta GetSessionsCommitDelay() const = 0;
 
   // Called when credentials are updated by the user.
   virtual void OnCredentialsUpdated() = 0;
 
   // Called when the network layer detects a connection status change.
   virtual void OnConnectionStatusChange() = 0;
 };
 
 }  // namespace syncer
 
 #endif  // SYNC_ENGINE_SYNC_SCHEDULER_H_