DevTools: Introduce lightweight version of JSON serialization.

base/json_writer.h

 // Copyright (c) 2006-2008 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 BASE_JSON_WRITER_H_
 #define BASE_JSON_WRITER_H_
 
 #include <string>
 
 #include "base/basictypes.h"
 
 class Value;
 
 class JSONWriter {
  public:
   // Given a root node, generates a JSON string and puts it into |json|.
   // If |pretty_print| is true, return a slightly nicer formated json string
   // (pads with whitespace to help readability).  If |pretty_print| is false,
   // we try to generate as compact a string as possible.
   // TODO(tc): Should we generate json if it would be invalid json (e.g.,
   // |node| is not a DictionaryValue/ListValue or if there are inf/-inf float
   // values)?
   static void Write(const Value* const node, bool pretty_print,
                     std::string* json);
 
+  // Same as above, but has an option to not escape the string, preserving its
+  // UTF8 characters. It is useful if you can pass resulting string to the
+  // JSON parser in binary form (as UTF8).
+  static void WriteWithOptionalEscape(const Value* const node,
+                                      bool pretty_print,
+                                      bool escape,
+                                      std::string* json);
+
  private:
   JSONWriter(bool pretty_print, std::string* json);
 
   // Called recursively to build the JSON string.  Whe completed, value is
   // json_string_ will contain the JSON.
-  void BuildJSONString(const Value* const node, int depth);
+  void BuildJSONString(const Value* const node, int depth, bool escape);
 
   // Appends a quoted, escaped, version of str to json_string_.
   void AppendQuotedString(const std::wstring& str);
 
   // Adds space to json_string_ for the indent level.
   void IndentLine(int depth);
 
   // Where we write JSON data as we generate it.
   std::string* json_string_;
 
   bool pretty_print_;
 
   DISALLOW_COPY_AND_ASSIGN(JSONWriter);
 };
 
 #endif  // BASE_JSON_WRITER_H_