| Index: net/base/backoff_entry_serializer.h
|
| diff --git a/net/base/backoff_entry_serializer.h b/net/base/backoff_entry_serializer.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..837265727fb4d4d768a61999df4dd6f192615d8f
|
| --- /dev/null
|
| +++ b/net/base/backoff_entry_serializer.h
|
| @@ -0,0 +1,55 @@
|
| +// Copyright 2015 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 NET_BASE_BACKOFF_ENTRY_SERIALIZER_H_
|
| +#define NET_BASE_BACKOFF_ENTRY_SERIALIZER_H_
|
| +
|
| +#include "base/macros.h"
|
| +#include "base/memory/scoped_ptr.h"
|
| +#include "base/time/time.h"
|
| +#include "net/base/backoff_entry.h"
|
| +#include "net/base/net_export.h"
|
| +
|
| +namespace base {
|
| +class Value;
|
| +class TickClock;
|
| +}
|
| +
|
| +namespace net {
|
| +
|
| +// Serialize or deserialize a BackoffEntry, so it can persist beyond the
|
| +// lifetime of the browser.
|
| +class NET_EXPORT BackoffEntrySerializer {
|
| + public:
|
| + // Serializes the release time and failure count into a ListValue that can
|
| + // later be passed to Deserialize to re-create the given BackoffEntry. The
|
| + // Policy is not serialized, instead callers must pass an identical Policy*
|
| + // when deserializing. |time_now| should be base::Time::Now(), except for
|
| + // tests that want to simulate time changes. The release time TimeTicks will
|
| + // be converted to an absolute timestamp, thus the time will continue counting
|
| + // down even whilst the device is powered off, and will be partially
|
| + // vulnerable to changes in the system clock time.
|
| + static scoped_ptr<base::Value> SerializeToValue(const BackoffEntry& entry,
|
| + base::Time time_now);
|
| +
|
| + // Deserializes a ListValue back to a BackoffEntry. |policy| MUST be the same
|
| + // Policy as the serialized entry had. |clock| may be NULL. Both |policy| and
|
| + // |clock| (if not NULL) must enclose lifetime of the returned BackoffEntry.
|
| + // |time_now| should be base::Time::Now(), except for tests that want to
|
| + // simulate time changes. The absolute timestamp that was serialized will be
|
| + // converted back to TimeTicks as best as possible. Returns NULL if
|
| + // deserialization was unsuccessful.
|
| + static scoped_ptr<BackoffEntry> DeserializeFromValue(
|
| + const base::Value& serialized,
|
| + const BackoffEntry::Policy* policy,
|
| + base::TickClock* clock,
|
| + base::Time time_now);
|
| +
|
| + private:
|
| + DISALLOW_IMPLICIT_CONSTRUCTORS(BackoffEntrySerializer);
|
| +};
|
| +
|
| +} // namespace net
|
| +
|
| +#endif // NET_BASE_BACKOFF_ENTRY_SERIALIZER_H_
|
|
|