blob: 83e4c7ca1aa8cb58d576979062664f22101d0a91 [file] [log] [blame]
// Copyright 2014 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.
#include <vector>
#include "components/sync/base/syncer_error.h"
namespace sync_pb {
class DataTypeContext;
class DataTypeProgressMarker;
class SyncEntity;
using SyncEntityList = std::vector<const sync_pb::SyncEntity*>;
namespace syncer {
class StatusController;
// This class represents an entity that can request, receive, and apply updates
// from the sync server.
class UpdateHandler {
virtual ~UpdateHandler() = 0;
// Returns true if initial sync was performed for this type.
virtual bool IsInitialSyncEnded() const = 0;
// Fills the given parameter with the stored progress marker for this type.
virtual void GetDownloadProgress(
sync_pb::DataTypeProgressMarker* progress_marker) const = 0;
// Fills |context| with the per-client datatype context, if one exists. Clears
// |context| otherwise.
virtual void GetDataTypeContext(sync_pb::DataTypeContext* context) const = 0;
// Processes the contents of a GetUpdates response message.
// Should be invoked with the progress marker and set of SyncEntities from a
// single GetUpdates response message. The progress marker's type must match
// this update handler's type, and the set of SyncEntities must include all
// entities of this type found in the response message.
// In this context, "applicable_updates" means the set of updates belonging to
// this type.
// Returns SYNCER_OK if the all data was processed successfully, a syncer
// error otherwise.
virtual SyncerError ProcessGetUpdatesResponse(
const sync_pb::DataTypeProgressMarker& progress_marker,
const sync_pb::DataTypeContext& mutated_context,
const SyncEntityList& applicable_updates,
StatusController* status) = 0;
// Called at the end of a non-configure GetUpdates loop to apply any unapplied
// updates.
virtual void ApplyUpdates(StatusController* status) = 0;
// Called at the end of a configure GetUpdates loop to perform any required
// post-initial-download update application.
virtual void PassiveApplyUpdates(StatusController* status) = 0;
} // namespace syncer