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_ |