OLD | NEW |
| (Empty) |
1 // Copyright 2013 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 SYNC_NOTIFIER_UNACKED_INVALIDATION_SET_H_ | |
6 #define SYNC_NOTIFIER_UNACKED_INVALIDATION_SET_H_ | |
7 | |
8 #include <vector> | |
9 | |
10 #include "sync/base/sync_export.h" | |
11 #include "sync/internal_api/public/base/invalidation.h" | |
12 #include "sync/internal_api/public/util/weak_handle.h" | |
13 #include "sync/notifier/invalidation_util.h" | |
14 | |
15 namespace base { | |
16 class DictionaryValue; | |
17 } // namespace base | |
18 | |
19 namespace syncer { | |
20 | |
21 namespace test_util { | |
22 class UnackedInvalidationSetEqMatcher; | |
23 } // test_util | |
24 | |
25 class SingleObjectInvalidationSet; | |
26 class ObjectIdInvalidationMap; | |
27 class AckHandle; | |
28 | |
29 // Manages the set of invalidations that are awaiting local acknowledgement for | |
30 // a particular ObjectId. This set of invalidations will be persisted across | |
31 // restarts, though this class is not directly responsible for that. | |
32 class SYNC_EXPORT UnackedInvalidationSet { | |
33 public: | |
34 static const size_t kMaxBufferedInvalidations; | |
35 | |
36 UnackedInvalidationSet(invalidation::ObjectId id); | |
37 UnackedInvalidationSet(const UnackedInvalidationSet& other); | |
38 ~UnackedInvalidationSet(); | |
39 | |
40 // Returns the ObjectID of the invalidations this class is tracking. | |
41 const invalidation::ObjectId& object_id() const; | |
42 | |
43 // Adds a new invalidation to the set awaiting acknowledgement. | |
44 void Add(const Invalidation& invalidation); | |
45 | |
46 // Adds many new invalidations to the set awaiting acknowledgement. | |
47 void AddSet(const SingleObjectInvalidationSet& invalidations); | |
48 | |
49 // Exports the set of invalidations awaiting acknowledgement as an | |
50 // ObjectIdInvalidationMap. Each of these invalidations will be associated | |
51 // with the given |ack_handler|. | |
52 // | |
53 // The contents of the UnackedInvalidationSet are not directly modified by | |
54 // this procedure, but the AckHandles stored in those exported invalidations | |
55 // are likely to end up back here in calls to Acknowledge() or Drop(). | |
56 void ExportInvalidations(WeakHandle<AckHandler> ack_handler, | |
57 ObjectIdInvalidationMap* out) const; | |
58 | |
59 // Removes all stored invalidations from this object. | |
60 void Clear(); | |
61 | |
62 // Indicates that a handler has registered to handle these invalidations. | |
63 // | |
64 // Registrations with the invalidations server persist across restarts, but | |
65 // registrations from InvalidationHandlers to the InvalidationService are not. | |
66 // In the time immediately after a restart, it's possible that the server | |
67 // will send us invalidations, and we won't have a handler to send them to. | |
68 // | |
69 // The SetIsRegistered() call indicates that this period has come to an end. | |
70 // There is now a handler that can receive these invalidations. Once this | |
71 // function has been called, the kMaxBufferedInvalidations limit will be | |
72 // ignored. It is assumed that the handler will manage its own buffer size. | |
73 void SetHandlerIsRegistered(); | |
74 | |
75 // Indicates that the handler has now unregistered itself. | |
76 // | |
77 // This causes the object to resume enforcement of the | |
78 // kMaxBufferedInvalidations limit. | |
79 void SetHandlerIsUnregistered(); | |
80 | |
81 // Given an AckHandle belonging to one of the contained invalidations, finds | |
82 // the invalidation and drops it from the list. It is considered to be | |
83 // acknowledged, so there is no need to continue maintaining its state. | |
84 void Acknowledge(const AckHandle& handle); | |
85 | |
86 // Given an AckHandle belonging to one of the contained invalidations, finds | |
87 // the invalidation, drops it from the list, and adds additional state to | |
88 // indicate that this invalidation has been lost without being acted on. | |
89 void Drop(const AckHandle& handle); | |
90 | |
91 scoped_ptr<base::DictionaryValue> ToValue() const; | |
92 bool ResetFromValue(const base::DictionaryValue& value); | |
93 | |
94 private: | |
95 // Allow this test helper to have access to our internals. | |
96 friend class test_util::UnackedInvalidationSetEqMatcher; | |
97 | |
98 typedef std::set<Invalidation, InvalidationVersionLessThan> InvalidationsSet; | |
99 | |
100 bool ResetListFromValue(const base::ListValue& value); | |
101 | |
102 // Limits the list size to the given maximum. This function will correctly | |
103 // update this class' internal data to indicate if invalidations have been | |
104 // dropped. | |
105 void Truncate(size_t max_size); | |
106 | |
107 bool registered_; | |
108 invalidation::ObjectId object_id_; | |
109 InvalidationsSet invalidations_; | |
110 }; | |
111 | |
112 typedef std::map<invalidation::ObjectId, | |
113 UnackedInvalidationSet, | |
114 ObjectIdLessThan> UnackedInvalidationsMap; | |
115 | |
116 } // namespace syncer | |
117 | |
118 #endif // SYNC_NOTIFIER_UNACKED_INVALIDATION_SET_H_ | |
OLD | NEW |