| Index: components/metrics/chromeos/serialization_utils.h
|
| diff --git a/components/metrics/chromeos/serialization_utils.h b/components/metrics/chromeos/serialization_utils.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..372e686c70f71e580a3f5283a70e0a67f0406ec1
|
| --- /dev/null
|
| +++ b/components/metrics/chromeos/serialization_utils.h
|
| @@ -0,0 +1,57 @@
|
| +// Copyright 2014 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 COMPONENTS_METRICS_CHROMEOS_SERIALIZATION_UTILS_H_
|
| +#define COMPONENTS_METRICS_CHROMEOS_SERIALIZATION_UTILS_H_
|
| +
|
| +#include <string>
|
| +
|
| +#include "base/memory/scoped_ptr.h"
|
| +#include "base/memory/scoped_vector.h"
|
| +
|
| +namespace metrics {
|
| +
|
| +class MetricSample;
|
| +
|
| +// Metrics helpers to serialize and deserialize metrics collected by
|
| +// ChromeOS.
|
| +namespace SerializationUtils {
|
| +
|
| +// Deserializes a sample passed as a string and return a sample.
|
| +// The return value will either be a scoped_ptr to a Metric sample (if the
|
| +// deserialization was successful) or a NULL scoped_ptr.
|
| +scoped_ptr<MetricSample> ParseSample(const std::string& sample);
|
| +
|
| +// Reads all samples from a file and truncate the file when done.
|
| +void ReadAndTruncateMetricsFromFile(const std::string& filename,
|
| + ScopedVector<MetricSample>* metrics);
|
| +
|
| +// Reads the next message from |file_descriptor| into |message|.
|
| +//
|
| +// |message| will be set to the empty string if no message could be read (EOF)
|
| +// or the message was badly constructed.
|
| +//
|
| +// Returns false if no message can be read from this file anymore (EOF or
|
| +// unrecoverable error).
|
| +bool ReadMessage(int file_descriptor, std::string* message);
|
| +
|
| +// Serializes a sample and write it to filename.
|
| +// The format for the message is:
|
| +// message_size, serialized_message
|
| +// where
|
| +// * message_size is the total length of the message (message_size +
|
| +// serialized_message) on 4 bytes
|
| +// * serialized_message is the serialized version of sample (using ToString)
|
| +//
|
| +// NB: the file will never leave the device so message_size will be written
|
| +// with the architecture's endianness.
|
| +bool WriteMetricToFile(const MetricSample& sample, const std::string& filename);
|
| +
|
| +// Maximum length of a serialized message
|
| +const int kMessageMaxLength = 1024;
|
| +
|
| +} // namespace SerializationUtils
|
| +} // namespace metrics
|
| +
|
| +#endif // COMPONENTS_METRICS_CHROMEOS_SERIALIZATION_UTILS_H_
|
|
|