| OLD | NEW |
| 1 // Protocol Buffers - Google's data interchange format | 1 // Protocol Buffers - Google's data interchange format |
| 2 // Copyright 2008 Google Inc. All rights reserved. | 2 // Copyright 2008 Google Inc. All rights reserved. |
| 3 // http://code.google.com/p/protobuf/ | 3 // https://developers.google.com/protocol-buffers/ |
| 4 // | 4 // |
| 5 // Redistribution and use in source and binary forms, with or without | 5 // Redistribution and use in source and binary forms, with or without |
| 6 // modification, are permitted provided that the following conditions are | 6 // modification, are permitted provided that the following conditions are |
| 7 // met: | 7 // met: |
| 8 // | 8 // |
| 9 // * Redistributions of source code must retain the above copyright | 9 // * Redistributions of source code must retain the above copyright |
| 10 // notice, this list of conditions and the following disclaimer. | 10 // notice, this list of conditions and the following disclaimer. |
| 11 // * Redistributions in binary form must reproduce the above | 11 // * Redistributions in binary form must reproduce the above |
| 12 // copyright notice, this list of conditions and the following disclaimer | 12 // copyright notice, this list of conditions and the following disclaimer |
| 13 // in the documentation and/or other materials provided with the | 13 // in the documentation and/or other materials provided with the |
| 14 // distribution. | 14 // distribution. |
| 15 // * Neither the name of Google Inc. nor the names of its | 15 // * Neither the name of Google Inc. nor the names of its |
| 16 // contributors may be used to endorse or promote products derived from | 16 // contributors may be used to endorse or promote products derived from |
| 17 // this software without specific prior written permission. | 17 // this software without specific prior written permission. |
| 18 // | 18 // |
| 19 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | 19 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| 20 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | 20 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| 21 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR | 21 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| 22 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | 22 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| 23 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | 23 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| 24 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | 24 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| 25 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | 25 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| 26 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | 26 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| 27 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | 27 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| 28 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | 28 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| 29 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 29 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| 30 | 30 |
| 31 // Author: kenton@google.com (Kenton Varda) | 31 // FieldMask related utility methods. |
| 32 // Based on original Protocol Buffers design by | |
| 33 // Sanjay Ghemawat, Jeff Dean, and others. | |
| 34 | 32 |
| 35 #ifndef GOOGLE_PROTOBUF_COMPILER_CPP_EXTENSION_H__ | 33 #ifndef GOOGLE_PROTOBUF_UTIL_CONVERTER_FIELD_MASK_UTILITY_H__ |
| 36 #define GOOGLE_PROTOBUF_COMPILER_CPP_EXTENSION_H__ | 34 #define GOOGLE_PROTOBUF_UTIL_CONVERTER_FIELD_MASK_UTILITY_H__ |
| 37 | 35 |
| 38 #include <string> | 36 #include <functional> |
| 37 #include <stack> |
| 38 |
| 39 #include <google/protobuf/stubs/common.h> | 39 #include <google/protobuf/stubs/common.h> |
| 40 #include <google/protobuf/compiler/cpp/cpp_options.h> | 40 #include <google/protobuf/stubs/stringpiece.h> |
| 41 #include <google/protobuf/stubs/status.h> |
| 41 | 42 |
| 42 namespace google { | 43 namespace google { |
| 43 namespace protobuf { | 44 namespace protobuf { |
| 44 class FieldDescriptor; // descriptor.h | 45 namespace util { |
| 45 namespace io { | 46 namespace converter { |
| 46 class Printer; // printer.h | |
| 47 } | |
| 48 } | |
| 49 | 47 |
| 50 namespace protobuf { | 48 typedef string (*ConverterCallback)(StringPiece); |
| 51 namespace compiler { | 49 typedef ResultCallback1<util::Status, StringPiece>* PathSinkCallback; |
| 52 namespace cpp { | |
| 53 | 50 |
| 54 // Generates code for an extension, which may be within the scope of some | 51 // Applies a 'converter' to each segment of a FieldMask path and returns the |
| 55 // message or may be at file scope. This is much simpler than FieldGenerator | 52 // result. Quoted strings in the 'path' are copied to the output as-is without |
| 56 // since extensions are just simple identifiers with interesting types. | 53 // converting their content. Escaping is supported within quoted strings. |
| 57 class ExtensionGenerator { | 54 // For example, "ab\"_c" will be returned as "ab\"_c" without any changes. |
| 58 public: | 55 string ConvertFieldMaskPath(const StringPiece path, |
| 59 // See generator.cc for the meaning of dllexport_decl. | 56 ConverterCallback converter); |
| 60 explicit ExtensionGenerator(const FieldDescriptor* desycriptor, | |
| 61 const Options& options); | |
| 62 ~ExtensionGenerator(); | |
| 63 | 57 |
| 64 // Header stuff. | 58 // Decodes a compact list of FieldMasks. For example, "a.b,a.c.d,a.c.e" will be |
| 65 void GenerateDeclaration(io::Printer* printer); | 59 // decoded into a list of field paths - "a.b", "a.c.d", "a.c.e". And the results |
| 60 // will be sent to 'path_sink', i.e. 'path_sink' will be called once per |
| 61 // resulting path. |
| 62 // Note that we also support Apiary style FieldMask form. The above example in |
| 63 // the Apiary style will look like "a.b,a.c(d,e)". |
| 64 util::Status DecodeCompactFieldMaskPaths(StringPiece paths, |
| 65 PathSinkCallback path_sink); |
| 66 | 66 |
| 67 // Source file stuff. | 67 } // namespace converter |
| 68 void GenerateDefinition(io::Printer* printer); | 68 } // namespace util |
| 69 | |
| 70 // Generate code to register the extension. | |
| 71 void GenerateRegistration(io::Printer* printer); | |
| 72 | |
| 73 private: | |
| 74 const FieldDescriptor* descriptor_; | |
| 75 string type_traits_; | |
| 76 Options options_; | |
| 77 | |
| 78 GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(ExtensionGenerator); | |
| 79 }; | |
| 80 | |
| 81 } // namespace cpp | |
| 82 } // namespace compiler | |
| 83 } // namespace protobuf | 69 } // namespace protobuf |
| 84 | 70 |
| 85 } // namespace google | 71 } // namespace google |
| 86 #endif // GOOGLE_PROTOBUF_COMPILER_CPP_MESSAGE_H__ | 72 #endif // GOOGLE_PROTOBUF_UTIL_CONVERTER_FIELD_MASK_UTILITY_H__ |
| OLD | NEW |