File: loopback_server_entity.h

package info (click to toggle)
chromium 138.0.7204.183-1~deb12u1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm-proposed-updates
  • size: 6,080,960 kB
  • sloc: cpp: 34,937,079; ansic: 7,176,967; javascript: 4,110,704; python: 1,419,954; asm: 946,768; xml: 739,971; pascal: 187,324; sh: 89,623; perl: 88,663; objc: 79,944; sql: 50,304; cs: 41,786; fortran: 24,137; makefile: 21,811; php: 13,980; tcl: 13,166; yacc: 8,925; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (103 lines) | stat: -rw-r--r-- 3,439 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
// Copyright 2014 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef COMPONENTS_SYNC_ENGINE_LOOPBACK_SERVER_LOOPBACK_SERVER_ENTITY_H_
#define COMPONENTS_SYNC_ENGINE_LOOPBACK_SERVER_LOOPBACK_SERVER_ENTITY_H_

#include <stdint.h>

#include <map>
#include <memory>
#include <string>

#include "components/sync/base/data_type.h"
#include "components/sync/protocol/entity_specifics.pb.h"

namespace sync_pb {
class SyncEntity;
class LoopbackServerEntity;
enum LoopbackServerEntity_Type : int;
}  // namespace sync_pb

namespace syncer {

// The representation of a Sync entity for the loopback server.
class LoopbackServerEntity {
 public:
  // Creates an ID of the form <type><separator><inner-id> where
  // <type> is the EntitySpecifics field number for `data_type`, <separator>
  // is kIdSeparator, and <inner-id> is `inner_id`.
  //
  // If `inner_id` is globally unique, then the returned ID will also be
  // globally unique.
  static std::string CreateId(const syncer::DataType& data_type,
                              const std::string& inner_id);

  // Returns the ID string of the top level node for the specified type.
  static std::string GetTopLevelId(const syncer::DataType& data_type);

  static std::unique_ptr<LoopbackServerEntity> CreateEntityFromProto(
      const sync_pb::LoopbackServerEntity& entity);

  virtual ~LoopbackServerEntity();
  const std::string& GetId() const;
  syncer::DataType GetDataType() const;
  int64_t GetVersion() const;
  void SetVersion(int64_t version);
  const std::string& GetName() const;
  void SetName(const std::string& name);

  // Replaces `specifics_` with `updated_specifics`. This method is meant to be
  // used to mimic a client commit.
  void SetSpecifics(const sync_pb::EntitySpecifics& updated_specifics);
  sync_pb::EntitySpecifics GetSpecifics() const;

  // Common data items needed by server
  virtual bool RequiresParentId() const = 0;
  virtual std::string GetParentId() const = 0;
  virtual void SerializeAsProto(sync_pb::SyncEntity* proto) const = 0;
  virtual sync_pb::LoopbackServerEntity_Type GetLoopbackServerEntityType()
      const;
  virtual bool IsDeleted() const;
  virtual bool IsFolder() const;
  virtual bool IsPermanent() const;

  virtual void SerializeAsLoopbackServerEntity(
      sync_pb::LoopbackServerEntity* entity) const;

  // Extracts the DataType from `id`. If `id` is malformed or does not contain
  // a valid DataType, UNSPECIFIED is returned.
  static syncer::DataType GetDataTypeFromId(const std::string& id);

  // Extracts the inner ID as specified in the constructor from `id`.
  static std::string GetInnerIdFromId(const std::string& id);

 protected:
  LoopbackServerEntity(const std::string& id,
                       const syncer::DataType& data_type,
                       int64_t version,
                       const std::string& name);

  void SerializeBaseProtoFields(sync_pb::SyncEntity* sync_entity) const;

 private:
  // The entity's ID.
  const std::string id_;

  // The DataType that categorizes this entity.
  const syncer::DataType data_type_;

  // The version of this entity.
  int64_t version_;

  // The name of the entity.
  std::string name_;

  // The EntitySpecifics for the entity.
  sync_pb::EntitySpecifics specifics_;
};

}  // namespace syncer

#endif  // COMPONENTS_SYNC_ENGINE_LOOPBACK_SERVER_LOOPBACK_SERVER_ENTITY_H_