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
|
// Copyright (c) 2011 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 CHROME_BROWSER_METRICS_METRICS_LOG_SERIALIZER_H_
#define CHROME_BROWSER_METRICS_METRICS_LOG_SERIALIZER_H_
#pragma once
#include "base/basictypes.h"
#include "base/gtest_prod_util.h"
#include "chrome/common/metrics_log_manager.h"
namespace base {
class ListValue;
}
// Serializer for persisting metrics logs to prefs.
class MetricsLogSerializer : public MetricsLogManager::LogSerializer {
public:
// Used to produce a historgram that keeps track of the status of recalling
// persisted per logs.
enum LogReadStatus {
RECALL_SUCCESS, // We were able to correctly recall a persisted log.
LIST_EMPTY, // Attempting to recall from an empty list.
LIST_SIZE_MISSING, // Failed to recover list size using GetAsInteger().
LIST_SIZE_TOO_SMALL, // Too few elements in the list (less than 3).
LIST_SIZE_CORRUPTION, // List size is not as expected.
LOG_STRING_CORRUPTION, // Failed to recover log string using GetAsString().
CHECKSUM_CORRUPTION, // Failed to verify checksum.
CHECKSUM_STRING_CORRUPTION, // Failed to recover checksum string using
// GetAsString().
DECODE_FAIL, // Failed to decode log.
END_RECALL_STATUS // Number of bins to use to create the histogram.
};
MetricsLogSerializer();
virtual ~MetricsLogSerializer();
// Implementation of MetricsLogManager::LogSerializer
virtual void SerializeLogs(const std::vector<std::string>& logs,
MetricsLogManager::LogType log_type);
virtual void DeserializeLogs(MetricsLogManager::LogType log_type,
std::vector<std::string>* logs);
private:
// Encodes the textual log data from |local_list| and writes it to the given
// pref list, along with list size and checksum.
static void WriteLogsToPrefList(const std::vector<std::string>& local_list,
const size_t kMaxLocalListSize,
base::ListValue* list);
// Decodes and verifies the textual log data from |list|, populating
// |local_list| and returning a status code.
static LogReadStatus ReadLogsFromPrefList(
const base::ListValue& list,
std::vector<std::string>* local_list);
FRIEND_TEST_ALL_PREFIXES(MetricsLogSerializerTest, EmptyLogList);
FRIEND_TEST_ALL_PREFIXES(MetricsLogSerializerTest, SingleElementLogList);
FRIEND_TEST_ALL_PREFIXES(MetricsLogSerializerTest, OverLimitLogList);
FRIEND_TEST_ALL_PREFIXES(MetricsLogSerializerTest, SmallRecoveredListSize);
FRIEND_TEST_ALL_PREFIXES(MetricsLogSerializerTest, RemoveSizeFromLogList);
FRIEND_TEST_ALL_PREFIXES(MetricsLogSerializerTest, CorruptSizeOfLogList);
FRIEND_TEST_ALL_PREFIXES(MetricsLogSerializerTest, CorruptChecksumOfLogList);
DISALLOW_COPY_AND_ASSIGN(MetricsLogSerializer);
};
#endif // CHROME_BROWSER_METRICS_METRICS_LOG_SERIALIZER_H_
|
