| OLD | NEW |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef BASE_JSON_JSON_WRITER_H_ | 5 #ifndef BASE_JSON_JSON_WRITER_H_ |
| 6 #define BASE_JSON_JSON_WRITER_H_ | 6 #define BASE_JSON_JSON_WRITER_H_ |
| 7 | 7 |
| 8 #include <string> | 8 #include <string> |
| 9 | 9 |
| 10 #include "base/base_export.h" | 10 #include "base/base_export.h" |
| 11 #include "base/basictypes.h" | 11 #include "base/basictypes.h" |
| 12 | 12 |
| 13 namespace base { | 13 namespace base { |
| 14 | 14 |
| 15 class Value; | 15 class Value; |
| 16 | 16 |
| 17 class BASE_EXPORT JSONWriter { | 17 class BASE_EXPORT JSONWriter { |
| 18 public: | 18 public: |
| 19 enum Options { | 19 enum Options { |
| 20 // Do not escape the string, preserving its UTF8 characters. It is useful | |
| 21 // if you can pass the resulting string to the JSON parser in binary form | |
| 22 // (as UTF8). | |
| 23 OPTIONS_DO_NOT_ESCAPE = 1 << 0, | |
| 24 | |
| 25 // For values of binary type, the value (and key if within a dictionary) | 20 // For values of binary type, the value (and key if within a dictionary) |
| 26 // will be omitted from the output. | 21 // will be omitted from the output. |
| 27 OPTIONS_OMIT_BINARY_VALUES = 1 << 1, | 22 OPTIONS_OMIT_BINARY_VALUES = 1 << 0, |
| 28 | 23 |
| 29 // This option instructs the writer to write doubles that have no fractional | 24 // This option instructs the writer to write doubles that have no fractional |
| 30 // part as a normal integer (i.e., without using exponential notation | 25 // part as a normal integer (i.e., without using exponential notation |
| 31 // or appending a '.0') as long as the value is within the range of a | 26 // or appending a '.0') as long as the value is within the range of a |
| 32 // 64-bit int. | 27 // 64-bit int. |
| 33 OPTIONS_OMIT_DOUBLE_TYPE_PRESERVATION = 1 << 2, | 28 OPTIONS_OMIT_DOUBLE_TYPE_PRESERVATION = 1 << 1, |
| 34 | 29 |
| 35 // Return a slightly nicer formatted json string (pads with whitespace to | 30 // Return a slightly nicer formatted json string (pads with whitespace to |
| 36 // help with readability). | 31 // help with readability). |
| 37 OPTIONS_PRETTY_PRINT = 1 << 3 | 32 OPTIONS_PRETTY_PRINT = 1 << 2, |
| 38 }; | 33 }; |
| 39 | 34 |
| 40 // Given a root node, generates a JSON string and puts it into |json|. | 35 // Given a root node, generates a JSON string and puts it into |json|. |
| 41 // TODO(tc): Should we generate json if it would be invalid json (e.g., | 36 // TODO(tc): Should we generate json if it would be invalid json (e.g., |
| 42 // |node| is not a DictionaryValue/ListValue or if there are inf/-inf float | 37 // |node| is not a DictionaryValue/ListValue or if there are inf/-inf float |
| 43 // values)? | 38 // values)? |
| 44 static void Write(const Value* const node, std::string* json); | 39 static void Write(const Value* const node, std::string* json); |
| 45 | 40 |
| 46 // Same as above but with |options| which is a bunch of JSONWriter::Options | 41 // Same as above but with |options| which is a bunch of JSONWriter::Options |
| 47 // bitwise ORed together. | 42 // bitwise ORed together. |
| 48 static void WriteWithOptions(const Value* const node, int options, | 43 static void WriteWithOptions(const Value* const node, int options, |
| 49 std::string* json); | 44 std::string* json); |
| 50 | 45 |
| 51 // A static, constant JSON string representing an empty array. Useful | |
| 52 // for empty JSON argument passing. | |
| 53 static const char* kEmptyArray; | |
| 54 | |
| 55 private: | 46 private: |
| 56 JSONWriter(bool escape, bool omit_binary_values, | 47 JSONWriter(bool omit_binary_values, |
| 57 bool omit_double_type_preservation, bool pretty_print, | 48 bool omit_double_type_preservation, bool pretty_print, |
| 58 std::string* json); | 49 std::string* json); |
| 59 | 50 |
| 60 // Called recursively to build the JSON string. Whe completed, value is | 51 // Called recursively to build the JSON string. Whe completed, value is |
| 61 // json_string_ will contain the JSON. | 52 // json_string_ will contain the JSON. |
| 62 void BuildJSONString(const Value* const node, int depth); | 53 void BuildJSONString(const Value* const node, int depth); |
| 63 | 54 |
| 64 // Appends a quoted, escaped, version of (UTF-8) str to json_string_. | |
| 65 void AppendQuotedString(const std::string& str); | |
| 66 | |
| 67 // Adds space to json_string_ for the indent level. | 55 // Adds space to json_string_ for the indent level. |
| 68 void IndentLine(int depth); | 56 void IndentLine(int depth); |
| 69 | 57 |
| 70 bool escape_; | |
| 71 bool omit_binary_values_; | 58 bool omit_binary_values_; |
| 72 bool omit_double_type_preservation_; | 59 bool omit_double_type_preservation_; |
| 73 bool pretty_print_; | 60 bool pretty_print_; |
| 74 | 61 |
| 75 // Where we write JSON data as we generate it. | 62 // Where we write JSON data as we generate it. |
| 76 std::string* json_string_; | 63 std::string* json_string_; |
| 77 | 64 |
| 78 DISALLOW_COPY_AND_ASSIGN(JSONWriter); | 65 DISALLOW_COPY_AND_ASSIGN(JSONWriter); |
| 79 }; | 66 }; |
| 80 | 67 |
| 81 } // namespace base | 68 } // namespace base |
| 82 | 69 |
| 83 #endif // BASE_JSON_JSON_WRITER_H_ | 70 #endif // BASE_JSON_JSON_WRITER_H_ |
| OLD | NEW |