1// Copyright (c) 2011 The Chromium Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5#ifndef CHROME_BROWSER_SYNC_GLUE_MODEL_ASSOCIATOR_H_
6#define CHROME_BROWSER_SYNC_GLUE_MODEL_ASSOCIATOR_H_
7#pragma once
8
9#include "base/basictypes.h"
10#include "chrome/browser/sync/syncable/model_type.h"
11
12namespace sync_api {
13class BaseNode;
14}
15
16namespace browser_sync {
17
18// This represents the fundamental operations used for model association that
19// are common to all ModelAssociators and do not depend on types of the models
20// being associated.
21class AssociatorInterface {
22 public:
23  virtual ~AssociatorInterface() {}
24
25  // Iterates through both the sync and the chrome model looking for
26  // matched pairs of items. After successful completion, the models
27  // should be identical and corresponding. Returns true on
28  // success. On failure of this step, we should abort the sync
29  // operation and report an error to the user.
30  virtual bool AssociateModels() = 0;
31
32  // Clears all the associations between the chrome and sync models.
33  virtual bool DisassociateModels() = 0;
34
35  // The has_nodes out parameter is set to true if the sync model has
36  // nodes other than the permanent tagged nodes.  The method may
37  // return false if an error occurred.
38  virtual bool SyncModelHasUserCreatedNodes(bool* has_nodes) = 0;
39
40  // Calling this method while AssociateModels() is in progress will
41  // cause the method to exit early with a "false" return value.  This
42  // is useful for aborting model associations for shutdown.  This
43  // method is only implemented for model associators that are invoked
44  // off the main thread.
45  virtual void AbortAssociation() = 0;
46
47  // Returns whether the datatype is ready for encryption/decryption if the
48  // sync service requires it.
49  // TODO(zea): This should be implemented automatically for each datatype, see
50  // http://crbug.com/76232.
51  virtual bool CryptoReadyIfNecessary() = 0;
52};
53
54// In addition to the generic methods, association can refer to operations
55// that depend on the types of the actual IDs we are associating and the
56// underlying node type in the browser.  We collect these into a templatized
57// interface that encapsulates everything you need to implement to have a model
58// associator for a specific data type.
59// This template is appropriate for data types where a Node* makes sense for
60// referring to a particular item.  If we encounter a type that does not fit
61// in this world, we may want to have several PerDataType templates.
62template <class Node, class IDType>
63class PerDataTypeAssociatorInterface : public AssociatorInterface {
64 public:
65  virtual ~PerDataTypeAssociatorInterface() {}
66  // Returns sync id for the given chrome model id.
67  // Returns sync_api::kInvalidId if the sync node is not found for the given
68  // chrome id.
69  virtual int64 GetSyncIdFromChromeId(const IDType& id) = 0;
70
71  // Returns the chrome node for the given sync id.
72  // Returns NULL if no node is found for the given sync id.
73  virtual const Node* GetChromeNodeFromSyncId(int64 sync_id) = 0;
74
75  // Initializes the given sync node from the given chrome node id.
76  // Returns false if no sync node was found for the given chrome node id or
77  // if the initialization of sync node fails.
78  virtual bool InitSyncNodeFromChromeId(const IDType& node_id,
79                                        sync_api::BaseNode* sync_node) = 0;
80
81  // Associates the given chrome node with the given sync id.
82  virtual void Associate(const Node* node, int64 sync_id) = 0;
83
84  // Remove the association that corresponds to the given sync id.
85  virtual void Disassociate(int64 sync_id) = 0;
86};
87
88}  // namespace browser_sync
89
90#endif  // CHROME_BROWSER_SYNC_GLUE_MODEL_ASSOCIATOR_H_
91