Implement features needed for local ack handling in InvalidationStateTracker.

sync/internal_api/public/base/invalidation.h

 // Copyright (c) 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.
 
 #ifndef SYNC_INTERNAL_API_PUBLIC_BASE_INVALIDATION_H_
 #define SYNC_INTERNAL_API_PUBLIC_BASE_INVALIDATION_H_
 
 #include <string>
 
+#include "base/basictypes.h"
 #include "base/memory/scoped_ptr.h"
 
 namespace base {
 class DictionaryValue;
-class Value;
 }  // namespace
 
 namespace syncer {
 
-// Opaque class that represents an ack handle.
-// TODO(dcheng): This is just a refactoring change, so the class is empty for
-// the moment. It will be filled once we start implementing 'reminders'.
+// Opaque class that represents a local ack handle. We don't reuse the
+// invalidation ack handles to avoid unnecessary dependencies.
 class AckHandle {
  public:
+  static AckHandle CreateUnique();
+  static AckHandle InvalidAckHandle();
+

[akalin, 2012/11/28 00:11:42]

comment somewhere that default constructor creates an invalid ack handle

[dcheng, 2012/11/30 01:42:54]

There is no default constructor =)

[akalin, 2012/11/30 02:45:15]

isn't there an implicit one?  or does the private constructor prevent it from
being instantiated?

Aren't we stuffing these in STL containers?

[dcheng, 2012/11/30 02:48:30]

We define a constructor which suppress the generation of the default
constructor.
Yes, we do. That's why I use insert() instead of [].

   bool Equals(const AckHandle& other) const;
 
-  scoped_ptr<base::Value> ToValue() const;
+  scoped_ptr<base::DictionaryValue> ToValue() const;
+  bool ResetFromValue(const base::DictionaryValue& value);
 
-  bool ResetFromValue(const base::Value& value);
+  bool IsValid() const;
+
+ private:
+  // Explicitly copyable and assignable for STL containers.
+  AckHandle(const std::string& state);
+
+  std::string state_;
 };
 
 // Represents a local invalidation, and is roughly analogous to
 // invalidation::Invalidation. It contains a payload (which may be empty) and an
 // associated ack handle that an InvalidationHandler implementation can use to
 // acknowledge receipt of the invalidation. It does not embed the object ID,
 // since it is typically associated with it through ObjectIdInvalidationMap.
 struct Invalidation {
-  std::string payload;
-  AckHandle ack_handle;
+  Invalidation();
 
   bool Equals(const Invalidation& other) const;
 
-  // Caller owns the returned DictionaryValue.
   scoped_ptr<base::DictionaryValue> ToValue() const;
+  bool ResetFromValue(const base::DictionaryValue& value);
 
-  bool ResetFromValue(const base::DictionaryValue& value);
+  std::string payload;
+  AckHandle ack_handle;
 };
 
 }  // namespace syncer
 
 #endif  // SYNC_INTERNAL_API_PUBLIC_BASE_INVALIDATION_H_