protobuf 1.4.2 → 2.0.0.rc1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (198) hide show
  1. data/.gitignore +4 -0
  2. data/Rakefile +7 -7
  3. data/bin/rpc_server +2 -188
  4. data/bin/rprotoc +44 -38
  5. data/examples/addressbook.pb.rb +2 -2
  6. data/ext/Makefile +11 -0
  7. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/code_generator.h +142 -0
  8. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/command_line_interface.h +318 -0
  9. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_enum.h +99 -0
  10. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_enum_field.h +103 -0
  11. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_extension.h +85 -0
  12. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_field.h +167 -0
  13. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_file.h +98 -0
  14. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_generator.h +72 -0
  15. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_helpers.h +159 -0
  16. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_message.h +170 -0
  17. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_message_field.h +102 -0
  18. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_primitive_field.h +103 -0
  19. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_service.h +118 -0
  20. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_string_field.h +104 -0
  21. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_test_bad_identifiers.pb.h +2721 -0
  22. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/importer.h +303 -0
  23. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_enum.h +84 -0
  24. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_enum_field.h +121 -0
  25. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_extension.h +77 -0
  26. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_field.h +108 -0
  27. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_file.h +101 -0
  28. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_generator.h +72 -0
  29. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_helpers.h +213 -0
  30. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_message.h +109 -0
  31. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_message_field.h +134 -0
  32. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_primitive_field.h +121 -0
  33. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_service.h +113 -0
  34. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_string_field.h +120 -0
  35. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/mock_code_generator.h +113 -0
  36. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/package_info.h +64 -0
  37. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/parser.h +434 -0
  38. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/plugin.h +73 -0
  39. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/plugin.pb.h +790 -0
  40. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/python/python_generator.h +156 -0
  41. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/subprocess.h +108 -0
  42. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/zip_writer.h +93 -0
  43. data/ext/protobuf-2.4.1/src/google/protobuf/descriptor.h +1367 -0
  44. data/ext/protobuf-2.4.1/src/google/protobuf/descriptor.pb.h +5223 -0
  45. data/ext/protobuf-2.4.1/src/google/protobuf/descriptor_database.h +366 -0
  46. data/ext/protobuf-2.4.1/src/google/protobuf/dynamic_message.h +136 -0
  47. data/ext/protobuf-2.4.1/src/google/protobuf/extension_set.h +904 -0
  48. data/ext/protobuf-2.4.1/src/google/protobuf/generated_message_reflection.h +424 -0
  49. data/ext/protobuf-2.4.1/src/google/protobuf/generated_message_util.h +82 -0
  50. data/ext/protobuf-2.4.1/src/google/protobuf/io/coded_stream.h +1102 -0
  51. data/ext/protobuf-2.4.1/src/google/protobuf/io/coded_stream_inl.h +64 -0
  52. data/ext/protobuf-2.4.1/src/google/protobuf/io/gzip_stream.h +207 -0
  53. data/ext/protobuf-2.4.1/src/google/protobuf/io/package_info.h +54 -0
  54. data/ext/protobuf-2.4.1/src/google/protobuf/io/printer.h +136 -0
  55. data/ext/protobuf-2.4.1/src/google/protobuf/io/tokenizer.h +313 -0
  56. data/ext/protobuf-2.4.1/src/google/protobuf/io/zero_copy_stream.h +238 -0
  57. data/ext/protobuf-2.4.1/src/google/protobuf/io/zero_copy_stream_impl.h +357 -0
  58. data/ext/protobuf-2.4.1/src/google/protobuf/io/zero_copy_stream_impl_lite.h +340 -0
  59. data/ext/protobuf-2.4.1/src/google/protobuf/message.h +692 -0
  60. data/ext/protobuf-2.4.1/src/google/protobuf/message_lite.h +239 -0
  61. data/ext/protobuf-2.4.1/src/google/protobuf/package_info.h +64 -0
  62. data/ext/protobuf-2.4.1/src/google/protobuf/reflection_ops.h +80 -0
  63. data/ext/protobuf-2.4.1/src/google/protobuf/repeated_field.h +1295 -0
  64. data/ext/protobuf-2.4.1/src/google/protobuf/service.h +291 -0
  65. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/common.h +1211 -0
  66. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/hash.h +220 -0
  67. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/map-util.h +119 -0
  68. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/once.h +123 -0
  69. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/stl_util-inl.h +121 -0
  70. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/strutil.h +457 -0
  71. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/substitute.h +170 -0
  72. data/ext/protobuf-2.4.1/src/google/protobuf/test_util.h +174 -0
  73. data/ext/protobuf-2.4.1/src/google/protobuf/test_util_lite.h +101 -0
  74. data/ext/protobuf-2.4.1/src/google/protobuf/testing/file.h +83 -0
  75. data/ext/protobuf-2.4.1/src/google/protobuf/testing/googletest.h +98 -0
  76. data/ext/protobuf-2.4.1/src/google/protobuf/text_format.h +285 -0
  77. data/ext/protobuf-2.4.1/src/google/protobuf/unittest.pb.h +11915 -0
  78. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_custom_options.pb.h +2895 -0
  79. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_embed_optimize_for.pb.h +211 -0
  80. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_empty.pb.h +56 -0
  81. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_import.pb.h +188 -0
  82. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_import_lite.pb.h +151 -0
  83. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_lite.pb.h +4752 -0
  84. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_lite_imports_nonlite.pb.h +150 -0
  85. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_mset.pb.h +816 -0
  86. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_no_generic_services.pb.h +197 -0
  87. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_optimize_for.pb.h +403 -0
  88. data/ext/protobuf-2.4.1/src/google/protobuf/unknown_field_set.h +268 -0
  89. data/ext/protobuf-2.4.1/src/google/protobuf/wire_format.h +304 -0
  90. data/ext/protobuf-2.4.1/src/google/protobuf/wire_format_lite.h +620 -0
  91. data/ext/protobuf-2.4.1/src/google/protobuf/wire_format_lite_inl.h +774 -0
  92. data/ext/ruby_generator/RubyGenerator.cpp +435 -0
  93. data/ext/ruby_generator/RubyGenerator.h +180 -0
  94. data/ext/ruby_generator/extconf.rb +24 -0
  95. data/lib/protobuf.rb +55 -33
  96. data/lib/protobuf/cli.rb +176 -0
  97. data/lib/protobuf/common/logger.rb +11 -11
  98. data/lib/protobuf/{message/enum.rb → enum.rb} +0 -10
  99. data/lib/protobuf/evented.rb +22 -0
  100. data/lib/protobuf/field.rb +57 -0
  101. data/lib/protobuf/field/base_field.rb +210 -0
  102. data/lib/protobuf/field/bool_field.rb +24 -0
  103. data/lib/protobuf/field/bytes_field.rb +38 -0
  104. data/lib/protobuf/field/double_field.rb +19 -0
  105. data/lib/protobuf/field/enum_field.rb +58 -0
  106. data/lib/protobuf/field/extension_fields.rb +24 -0
  107. data/lib/protobuf/field/field_array.rb +55 -0
  108. data/lib/protobuf/field/fixed32_field.rb +19 -0
  109. data/lib/protobuf/field/fixed64_field.rb +22 -0
  110. data/lib/protobuf/field/float_field.rb +29 -0
  111. data/lib/protobuf/field/int32_field.rb +10 -0
  112. data/lib/protobuf/field/int64_field.rb +10 -0
  113. data/lib/protobuf/field/integer_field.rb +19 -0
  114. data/lib/protobuf/field/message_field.rb +51 -0
  115. data/lib/protobuf/field/sfixed32_field.rb +21 -0
  116. data/lib/protobuf/field/sfixed64_field.rb +24 -0
  117. data/lib/protobuf/field/signed_integer_field.rb +23 -0
  118. data/lib/protobuf/field/sint32_field.rb +10 -0
  119. data/lib/protobuf/field/sint64_field.rb +10 -0
  120. data/lib/protobuf/field/string_field.rb +14 -0
  121. data/lib/protobuf/field/uint32_field.rb +10 -0
  122. data/lib/protobuf/field/uint64_field.rb +10 -0
  123. data/lib/protobuf/field/varint_field.rb +63 -0
  124. data/lib/protobuf/message.rb +376 -0
  125. data/lib/protobuf/message/message.rb +1 -475
  126. data/lib/protobuf/rpc/buffer.rb +1 -1
  127. data/lib/protobuf/rpc/client.rb +26 -26
  128. data/lib/protobuf/rpc/connector.rb +15 -14
  129. data/lib/protobuf/rpc/connectors/eventmachine.rb +13 -13
  130. data/lib/protobuf/rpc/rpc.pb.rb +39 -28
  131. data/lib/protobuf/rpc/server.rb +7 -28
  132. data/lib/protobuf/rpc/servers/evented_runner.rb +15 -15
  133. data/lib/protobuf/rpc/servers/socket/server.rb +2 -1
  134. data/lib/protobuf/rpc/servers/socket_runner.rb +5 -6
  135. data/lib/protobuf/rpc/servers/zmq_runner.rb +4 -5
  136. data/lib/protobuf/socket.rb +22 -0
  137. data/lib/protobuf/version.rb +2 -1
  138. data/lib/protobuf/zmq.rb +21 -0
  139. data/proto/rpc.pb.rb +48 -0
  140. data/protobuf.gemspec +14 -6
  141. data/spec/benchmark/tasks.rb +42 -23
  142. data/spec/functional/evented_server_spec.rb +2 -0
  143. data/spec/functional/socket_server_spec.rb +22 -26
  144. data/spec/functional/zmq_server_spec.rb +22 -26
  145. data/spec/lib/protobuf/cli_spec.rb +182 -0
  146. data/spec/{unit → lib/protobuf}/common/logger_spec.rb +0 -0
  147. data/spec/{unit → lib/protobuf/message}/enum_spec.rb +0 -0
  148. data/spec/{unit → lib/protobuf/message}/message_spec.rb +0 -0
  149. data/spec/{unit → lib/protobuf}/rpc/client_spec.rb +6 -4
  150. data/spec/lib/protobuf/rpc/connector_spec.rb +41 -0
  151. data/spec/{unit → lib/protobuf}/rpc/connectors/base_spec.rb +18 -18
  152. data/spec/{unit → lib/protobuf}/rpc/connectors/common_spec.rb +20 -20
  153. data/spec/{unit → lib/protobuf}/rpc/connectors/socket_spec.rb +9 -8
  154. data/spec/{unit → lib/protobuf}/rpc/connectors/zmq_spec.rb +1 -1
  155. data/spec/{unit → lib/protobuf}/rpc/servers/evented_server_spec.rb +4 -4
  156. data/spec/{unit → lib/protobuf}/rpc/servers/socket_server_spec.rb +11 -23
  157. data/spec/{unit → lib/protobuf}/rpc/servers/zmq/broker_spec.rb +5 -0
  158. data/spec/{unit → lib/protobuf}/rpc/servers/zmq/server_spec.rb +5 -0
  159. data/spec/{unit → lib/protobuf}/rpc/servers/zmq/util_spec.rb +5 -0
  160. data/spec/{unit → lib/protobuf}/rpc/servers/zmq/worker_spec.rb +5 -0
  161. data/spec/{unit → lib/protobuf}/rpc/service_spec.rb +0 -0
  162. data/spec/proto/test.pb.rb +48 -25
  163. data/spec/spec_helper.rb +9 -15
  164. data/spec/support/all.rb +7 -0
  165. data/spec/{helper → support}/server.rb +5 -7
  166. data/spec/{helper → support}/silent_constants.rb +4 -0
  167. data/spec/support/test_app_file.rb +2 -0
  168. data/spec/{helper → support}/tolerance_matcher.rb +0 -0
  169. data/test/proto/types.pb.rb +1 -1
  170. data/test/test_addressbook.rb +1 -1
  171. data/test/test_enum_value.rb +1 -1
  172. data/test/test_standard_message.rb +1 -1
  173. metadata +243 -107
  174. data/lib/protobuf/common/util.rb +0 -59
  175. data/lib/protobuf/compiler/compiler.rb +0 -52
  176. data/lib/protobuf/compiler/nodes.rb +0 -323
  177. data/lib/protobuf/compiler/proto.y +0 -216
  178. data/lib/protobuf/compiler/proto2.ebnf +0 -79
  179. data/lib/protobuf/compiler/proto_parser.rb +0 -1425
  180. data/lib/protobuf/compiler/template/rpc_service_implementation.erb +0 -42
  181. data/lib/protobuf/compiler/visitors.rb +0 -282
  182. data/lib/protobuf/descriptor/descriptor.proto +0 -286
  183. data/lib/protobuf/descriptor/descriptor.rb +0 -55
  184. data/lib/protobuf/descriptor/descriptor_builder.rb +0 -143
  185. data/lib/protobuf/descriptor/descriptor_proto.rb +0 -138
  186. data/lib/protobuf/descriptor/enum_descriptor.rb +0 -33
  187. data/lib/protobuf/descriptor/field_descriptor.rb +0 -49
  188. data/lib/protobuf/descriptor/file_descriptor.rb +0 -37
  189. data/lib/protobuf/message/field.rb +0 -684
  190. data/lib/protobuf/message/protoable.rb +0 -38
  191. data/spec/helper/all.rb +0 -7
  192. data/spec/unit/common/util_spec.rb +0 -17
  193. data/spec/unit/rpc/connector_spec.rb +0 -31
  194. data/spec/unit/rpc/connectors/eventmachine_client_spec.rb +0 -32
  195. data/spec/unit/rpc/connectors/eventmachine_spec.rb +0 -0
  196. data/test/check_unbuild.rb +0 -30
  197. data/test/test_compiler.rb +0 -325
  198. data/test/test_descriptor.rb +0 -122
@@ -0,0 +1,303 @@
1
+ // Protocol Buffers - Google's data interchange format
2
+ // Copyright 2008 Google Inc. All rights reserved.
3
+ // http://code.google.com/p/protobuf/
4
+ //
5
+ // Redistribution and use in source and binary forms, with or without
6
+ // modification, are permitted provided that the following conditions are
7
+ // met:
8
+ //
9
+ // * Redistributions of source code must retain the above copyright
10
+ // notice, this list of conditions and the following disclaimer.
11
+ // * Redistributions in binary form must reproduce the above
12
+ // copyright notice, this list of conditions and the following disclaimer
13
+ // in the documentation and/or other materials provided with the
14
+ // distribution.
15
+ // * Neither the name of Google Inc. nor the names of its
16
+ // contributors may be used to endorse or promote products derived from
17
+ // this software without specific prior written permission.
18
+ //
19
+ // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20
+ // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21
+ // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22
+ // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23
+ // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24
+ // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25
+ // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26
+ // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27
+ // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
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.
30
+
31
+ // Author: kenton@google.com (Kenton Varda)
32
+ // Based on original Protocol Buffers design by
33
+ // Sanjay Ghemawat, Jeff Dean, and others.
34
+ //
35
+ // This file is the public interface to the .proto file parser.
36
+
37
+ #ifndef GOOGLE_PROTOBUF_COMPILER_IMPORTER_H__
38
+ #define GOOGLE_PROTOBUF_COMPILER_IMPORTER_H__
39
+
40
+ #include <string>
41
+ #include <vector>
42
+ #include <set>
43
+ #include <utility>
44
+ #include <google/protobuf/descriptor.h>
45
+ #include <google/protobuf/descriptor_database.h>
46
+ #include <google/protobuf/compiler/parser.h>
47
+
48
+ namespace google {
49
+ namespace protobuf {
50
+
51
+ namespace io { class ZeroCopyInputStream; }
52
+
53
+ namespace compiler {
54
+
55
+ // Defined in this file.
56
+ class Importer;
57
+ class MultiFileErrorCollector;
58
+ class SourceTree;
59
+ class DiskSourceTree;
60
+
61
+ // TODO(kenton): Move all SourceTree stuff to a separate file?
62
+
63
+ // An implementation of DescriptorDatabase which loads files from a SourceTree
64
+ // and parses them.
65
+ //
66
+ // Note: This class is not thread-safe since it maintains a table of source
67
+ // code locations for error reporting. However, when a DescriptorPool wraps
68
+ // a DescriptorDatabase, it uses mutex locking to make sure only one method
69
+ // of the database is called at a time, even if the DescriptorPool is used
70
+ // from multiple threads. Therefore, there is only a problem if you create
71
+ // multiple DescriptorPools wrapping the same SourceTreeDescriptorDatabase
72
+ // and use them from multiple threads.
73
+ //
74
+ // Note: This class does not implement FindFileContainingSymbol() or
75
+ // FindFileContainingExtension(); these will always return false.
76
+ class LIBPROTOBUF_EXPORT SourceTreeDescriptorDatabase : public DescriptorDatabase {
77
+ public:
78
+ SourceTreeDescriptorDatabase(SourceTree* source_tree);
79
+ ~SourceTreeDescriptorDatabase();
80
+
81
+ // Instructs the SourceTreeDescriptorDatabase to report any parse errors
82
+ // to the given MultiFileErrorCollector. This should be called before
83
+ // parsing. error_collector must remain valid until either this method
84
+ // is called again or the SourceTreeDescriptorDatabase is destroyed.
85
+ void RecordErrorsTo(MultiFileErrorCollector* error_collector) {
86
+ error_collector_ = error_collector;
87
+ }
88
+
89
+ // Gets a DescriptorPool::ErrorCollector which records errors to the
90
+ // MultiFileErrorCollector specified with RecordErrorsTo(). This collector
91
+ // has the ability to determine exact line and column numbers of errors
92
+ // from the information given to it by the DescriptorPool.
93
+ DescriptorPool::ErrorCollector* GetValidationErrorCollector() {
94
+ using_validation_error_collector_ = true;
95
+ return &validation_error_collector_;
96
+ }
97
+
98
+ // implements DescriptorDatabase -----------------------------------
99
+ bool FindFileByName(const string& filename, FileDescriptorProto* output);
100
+ bool FindFileContainingSymbol(const string& symbol_name,
101
+ FileDescriptorProto* output);
102
+ bool FindFileContainingExtension(const string& containing_type,
103
+ int field_number,
104
+ FileDescriptorProto* output);
105
+
106
+ private:
107
+ class SingleFileErrorCollector;
108
+
109
+ SourceTree* source_tree_;
110
+ MultiFileErrorCollector* error_collector_;
111
+
112
+ class LIBPROTOBUF_EXPORT ValidationErrorCollector : public DescriptorPool::ErrorCollector {
113
+ public:
114
+ ValidationErrorCollector(SourceTreeDescriptorDatabase* owner);
115
+ ~ValidationErrorCollector();
116
+
117
+ // implements ErrorCollector ---------------------------------------
118
+ void AddError(const string& filename,
119
+ const string& element_name,
120
+ const Message* descriptor,
121
+ ErrorLocation location,
122
+ const string& message);
123
+
124
+ private:
125
+ SourceTreeDescriptorDatabase* owner_;
126
+ };
127
+ friend class ValidationErrorCollector;
128
+
129
+ bool using_validation_error_collector_;
130
+ SourceLocationTable source_locations_;
131
+ ValidationErrorCollector validation_error_collector_;
132
+ };
133
+
134
+ // Simple interface for parsing .proto files. This wraps the process
135
+ // of opening the file, parsing it with a Parser, recursively parsing all its
136
+ // imports, and then cross-linking the results to produce a FileDescriptor.
137
+ //
138
+ // This is really just a thin wrapper around SourceTreeDescriptorDatabase.
139
+ // You may find that SourceTreeDescriptorDatabase is more flexible.
140
+ //
141
+ // TODO(kenton): I feel like this class is not well-named.
142
+ class LIBPROTOBUF_EXPORT Importer {
143
+ public:
144
+ Importer(SourceTree* source_tree,
145
+ MultiFileErrorCollector* error_collector);
146
+ ~Importer();
147
+
148
+ // Import the given file and build a FileDescriptor representing it. If
149
+ // the file is already in the DescriptorPool, the existing FileDescriptor
150
+ // will be returned. The FileDescriptor is property of the DescriptorPool,
151
+ // and will remain valid until it is destroyed. If any errors occur, they
152
+ // will be reported using the error collector and Import() will return NULL.
153
+ //
154
+ // A particular Importer object will only report errors for a particular
155
+ // file once. All future attempts to import the same file will return NULL
156
+ // without reporting any errors. The idea is that you might want to import
157
+ // a lot of files without seeing the same errors over and over again. If
158
+ // you want to see errors for the same files repeatedly, you can use a
159
+ // separate Importer object to import each one (but use the same
160
+ // DescriptorPool so that they can be cross-linked).
161
+ const FileDescriptor* Import(const string& filename);
162
+
163
+ // The DescriptorPool in which all imported FileDescriptors and their
164
+ // contents are stored.
165
+ inline const DescriptorPool* pool() const {
166
+ return &pool_;
167
+ }
168
+
169
+ private:
170
+ SourceTreeDescriptorDatabase database_;
171
+ DescriptorPool pool_;
172
+
173
+ GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(Importer);
174
+ };
175
+
176
+ // If the importer encounters problems while trying to import the proto files,
177
+ // it reports them to a MultiFileErrorCollector.
178
+ class LIBPROTOBUF_EXPORT MultiFileErrorCollector {
179
+ public:
180
+ inline MultiFileErrorCollector() {}
181
+ virtual ~MultiFileErrorCollector();
182
+
183
+ // Line and column numbers are zero-based. A line number of -1 indicates
184
+ // an error with the entire file (e.g. "not found").
185
+ virtual void AddError(const string& filename, int line, int column,
186
+ const string& message) = 0;
187
+
188
+ private:
189
+ GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(MultiFileErrorCollector);
190
+ };
191
+
192
+ // Abstract interface which represents a directory tree containing proto files.
193
+ // Used by the default implementation of Importer to resolve import statements
194
+ // Most users will probably want to use the DiskSourceTree implementation,
195
+ // below.
196
+ class LIBPROTOBUF_EXPORT SourceTree {
197
+ public:
198
+ inline SourceTree() {}
199
+ virtual ~SourceTree();
200
+
201
+ // Open the given file and return a stream that reads it, or NULL if not
202
+ // found. The caller takes ownership of the returned object. The filename
203
+ // must be a path relative to the root of the source tree and must not
204
+ // contain "." or ".." components.
205
+ virtual io::ZeroCopyInputStream* Open(const string& filename) = 0;
206
+
207
+ private:
208
+ GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(SourceTree);
209
+ };
210
+
211
+ // An implementation of SourceTree which loads files from locations on disk.
212
+ // Multiple mappings can be set up to map locations in the DiskSourceTree to
213
+ // locations in the physical filesystem.
214
+ class LIBPROTOBUF_EXPORT DiskSourceTree : public SourceTree {
215
+ public:
216
+ DiskSourceTree();
217
+ ~DiskSourceTree();
218
+
219
+ // Map a path on disk to a location in the SourceTree. The path may be
220
+ // either a file or a directory. If it is a directory, the entire tree
221
+ // under it will be mapped to the given virtual location. To map a directory
222
+ // to the root of the source tree, pass an empty string for virtual_path.
223
+ //
224
+ // If multiple mapped paths apply when opening a file, they will be searched
225
+ // in order. For example, if you do:
226
+ // MapPath("bar", "foo/bar");
227
+ // MapPath("", "baz");
228
+ // and then you do:
229
+ // Open("bar/qux");
230
+ // the DiskSourceTree will first try to open foo/bar/qux, then baz/bar/qux,
231
+ // returning the first one that opens successfuly.
232
+ //
233
+ // disk_path may be an absolute path or relative to the current directory,
234
+ // just like a path you'd pass to open().
235
+ void MapPath(const string& virtual_path, const string& disk_path);
236
+
237
+ // Return type for DiskFileToVirtualFile().
238
+ enum DiskFileToVirtualFileResult {
239
+ SUCCESS,
240
+ SHADOWED,
241
+ CANNOT_OPEN,
242
+ NO_MAPPING
243
+ };
244
+
245
+ // Given a path to a file on disk, find a virtual path mapping to that
246
+ // file. The first mapping created with MapPath() whose disk_path contains
247
+ // the filename is used. However, that virtual path may not actually be
248
+ // usable to open the given file. Possible return values are:
249
+ // * SUCCESS: The mapping was found. *virtual_file is filled in so that
250
+ // calling Open(*virtual_file) will open the file named by disk_file.
251
+ // * SHADOWED: A mapping was found, but using Open() to open this virtual
252
+ // path will end up returning some different file. This is because some
253
+ // other mapping with a higher precedence also matches this virtual path
254
+ // and maps it to a different file that exists on disk. *virtual_file
255
+ // is filled in as it would be in the SUCCESS case. *shadowing_disk_file
256
+ // is filled in with the disk path of the file which would be opened if
257
+ // you were to call Open(*virtual_file).
258
+ // * CANNOT_OPEN: The mapping was found and was not shadowed, but the
259
+ // file specified cannot be opened. When this value is returned,
260
+ // errno will indicate the reason the file cannot be opened. *virtual_file
261
+ // will be set to the virtual path as in the SUCCESS case, even though
262
+ // it is not useful.
263
+ // * NO_MAPPING: Indicates that no mapping was found which contains this
264
+ // file.
265
+ DiskFileToVirtualFileResult
266
+ DiskFileToVirtualFile(const string& disk_file,
267
+ string* virtual_file,
268
+ string* shadowing_disk_file);
269
+
270
+ // Given a virtual path, find the path to the file on disk.
271
+ // Return true and update disk_file with the on-disk path if the file exists.
272
+ // Return false and leave disk_file untouched if the file doesn't exist.
273
+ bool VirtualFileToDiskFile(const string& virtual_file, string* disk_file);
274
+
275
+ // implements SourceTree -------------------------------------------
276
+ io::ZeroCopyInputStream* Open(const string& filename);
277
+
278
+ private:
279
+ struct Mapping {
280
+ string virtual_path;
281
+ string disk_path;
282
+
283
+ inline Mapping(const string& virtual_path, const string& disk_path)
284
+ : virtual_path(virtual_path), disk_path(disk_path) {}
285
+ };
286
+ vector<Mapping> mappings_;
287
+
288
+ // Like Open(), but returns the on-disk path in disk_file if disk_file is
289
+ // non-NULL and the file could be successfully opened.
290
+ io::ZeroCopyInputStream* OpenVirtualFile(const string& virtual_file,
291
+ string* disk_file);
292
+
293
+ // Like Open() but given the actual on-disk path.
294
+ io::ZeroCopyInputStream* OpenDiskFile(const string& filename);
295
+
296
+ GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(DiskSourceTree);
297
+ };
298
+
299
+ } // namespace compiler
300
+ } // namespace protobuf
301
+
302
+ } // namespace google
303
+ #endif // GOOGLE_PROTOBUF_COMPILER_IMPORTER_H__
@@ -0,0 +1,84 @@
1
+ // Protocol Buffers - Google's data interchange format
2
+ // Copyright 2008 Google Inc. All rights reserved.
3
+ // http://code.google.com/p/protobuf/
4
+ //
5
+ // Redistribution and use in source and binary forms, with or without
6
+ // modification, are permitted provided that the following conditions are
7
+ // met:
8
+ //
9
+ // * Redistributions of source code must retain the above copyright
10
+ // notice, this list of conditions and the following disclaimer.
11
+ // * Redistributions in binary form must reproduce the above
12
+ // copyright notice, this list of conditions and the following disclaimer
13
+ // in the documentation and/or other materials provided with the
14
+ // distribution.
15
+ // * Neither the name of Google Inc. nor the names of its
16
+ // contributors may be used to endorse or promote products derived from
17
+ // this software without specific prior written permission.
18
+ //
19
+ // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20
+ // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21
+ // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22
+ // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23
+ // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24
+ // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25
+ // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26
+ // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27
+ // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
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.
30
+
31
+ // Author: kenton@google.com (Kenton Varda)
32
+ // Based on original Protocol Buffers design by
33
+ // Sanjay Ghemawat, Jeff Dean, and others.
34
+
35
+ #ifndef GOOGLE_PROTOBUF_COMPILER_JAVA_ENUM_H__
36
+ #define GOOGLE_PROTOBUF_COMPILER_JAVA_ENUM_H__
37
+
38
+ #include <string>
39
+ #include <vector>
40
+ #include <google/protobuf/descriptor.h>
41
+
42
+ namespace google {
43
+ namespace protobuf {
44
+ namespace io {
45
+ class Printer; // printer.h
46
+ }
47
+ }
48
+
49
+ namespace protobuf {
50
+ namespace compiler {
51
+ namespace java {
52
+
53
+ class EnumGenerator {
54
+ public:
55
+ explicit EnumGenerator(const EnumDescriptor* descriptor);
56
+ ~EnumGenerator();
57
+
58
+ void Generate(io::Printer* printer);
59
+
60
+ private:
61
+ const EnumDescriptor* descriptor_;
62
+
63
+ // The proto language allows multiple enum constants to have the same numeric
64
+ // value. Java, however, does not allow multiple enum constants to be
65
+ // considered equivalent. We treat the first defined constant for any
66
+ // given numeric value as "canonical" and the rest as aliases of that
67
+ // canonical value.
68
+ vector<const EnumValueDescriptor*> canonical_values_;
69
+
70
+ struct Alias {
71
+ const EnumValueDescriptor* value;
72
+ const EnumValueDescriptor* canonical_value;
73
+ };
74
+ vector<Alias> aliases_;
75
+
76
+ GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(EnumGenerator);
77
+ };
78
+
79
+ } // namespace java
80
+ } // namespace compiler
81
+ } // namespace protobuf
82
+
83
+ } // namespace google
84
+ #endif // GOOGLE_PROTOBUF_COMPILER_JAVA_ENUM_H__
@@ -0,0 +1,121 @@
1
+ // Protocol Buffers - Google's data interchange format
2
+ // Copyright 2008 Google Inc. All rights reserved.
3
+ // http://code.google.com/p/protobuf/
4
+ //
5
+ // Redistribution and use in source and binary forms, with or without
6
+ // modification, are permitted provided that the following conditions are
7
+ // met:
8
+ //
9
+ // * Redistributions of source code must retain the above copyright
10
+ // notice, this list of conditions and the following disclaimer.
11
+ // * Redistributions in binary form must reproduce the above
12
+ // copyright notice, this list of conditions and the following disclaimer
13
+ // in the documentation and/or other materials provided with the
14
+ // distribution.
15
+ // * Neither the name of Google Inc. nor the names of its
16
+ // contributors may be used to endorse or promote products derived from
17
+ // this software without specific prior written permission.
18
+ //
19
+ // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20
+ // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21
+ // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22
+ // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23
+ // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24
+ // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25
+ // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26
+ // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27
+ // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
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.
30
+
31
+ // Author: kenton@google.com (Kenton Varda)
32
+ // Based on original Protocol Buffers design by
33
+ // Sanjay Ghemawat, Jeff Dean, and others.
34
+
35
+ #ifndef GOOGLE_PROTOBUF_COMPILER_JAVA_ENUM_FIELD_H__
36
+ #define GOOGLE_PROTOBUF_COMPILER_JAVA_ENUM_FIELD_H__
37
+
38
+ #include <map>
39
+ #include <string>
40
+ #include <google/protobuf/compiler/java/java_field.h>
41
+
42
+ namespace google {
43
+ namespace protobuf {
44
+ namespace compiler {
45
+ namespace java {
46
+
47
+ class EnumFieldGenerator : public FieldGenerator {
48
+ public:
49
+ explicit EnumFieldGenerator(const FieldDescriptor* descriptor,
50
+ int messageBitIndex, int builderBitIndex);
51
+ ~EnumFieldGenerator();
52
+
53
+ // implements FieldGenerator ---------------------------------------
54
+ int GetNumBitsForMessage() const;
55
+ int GetNumBitsForBuilder() const;
56
+ void GenerateInterfaceMembers(io::Printer* printer) const;
57
+ void GenerateMembers(io::Printer* printer) const;
58
+ void GenerateBuilderMembers(io::Printer* printer) const;
59
+ void GenerateInitializationCode(io::Printer* printer) const;
60
+ void GenerateBuilderClearCode(io::Printer* printer) const;
61
+ void GenerateMergingCode(io::Printer* printer) const;
62
+ void GenerateBuildingCode(io::Printer* printer) const;
63
+ void GenerateParsingCode(io::Printer* printer) const;
64
+ void GenerateSerializationCode(io::Printer* printer) const;
65
+ void GenerateSerializedSizeCode(io::Printer* printer) const;
66
+ void GenerateFieldBuilderInitializationCode(io::Printer* printer) const;
67
+ void GenerateEqualsCode(io::Printer* printer) const;
68
+ void GenerateHashCode(io::Printer* printer) const;
69
+
70
+ string GetBoxedType() const;
71
+
72
+ private:
73
+ const FieldDescriptor* descriptor_;
74
+ map<string, string> variables_;
75
+ const int messageBitIndex_;
76
+ const int builderBitIndex_;
77
+
78
+ GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(EnumFieldGenerator);
79
+ };
80
+
81
+ class RepeatedEnumFieldGenerator : public FieldGenerator {
82
+ public:
83
+ explicit RepeatedEnumFieldGenerator(const FieldDescriptor* descriptor,
84
+ int messageBitIndex, int builderBitIndex);
85
+ ~RepeatedEnumFieldGenerator();
86
+
87
+ // implements FieldGenerator ---------------------------------------
88
+ int GetNumBitsForMessage() const;
89
+ int GetNumBitsForBuilder() const;
90
+ void GenerateInterfaceMembers(io::Printer* printer) const;
91
+ void GenerateMembers(io::Printer* printer) const;
92
+ void GenerateBuilderMembers(io::Printer* printer) const;
93
+ void GenerateInitializationCode(io::Printer* printer) const;
94
+ void GenerateBuilderClearCode(io::Printer* printer) const;
95
+ void GenerateMergingCode(io::Printer* printer) const;
96
+ void GenerateBuildingCode(io::Printer* printer) const;
97
+ void GenerateParsingCode(io::Printer* printer) const;
98
+ void GenerateParsingCodeFromPacked(io::Printer* printer) const;
99
+ void GenerateSerializationCode(io::Printer* printer) const;
100
+ void GenerateSerializedSizeCode(io::Printer* printer) const;
101
+ void GenerateFieldBuilderInitializationCode(io::Printer* printer) const;
102
+ void GenerateEqualsCode(io::Printer* printer) const;
103
+ void GenerateHashCode(io::Printer* printer) const;
104
+
105
+ string GetBoxedType() const;
106
+
107
+ private:
108
+ const FieldDescriptor* descriptor_;
109
+ map<string, string> variables_;
110
+ const int messageBitIndex_;
111
+ const int builderBitIndex_;
112
+
113
+ GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(RepeatedEnumFieldGenerator);
114
+ };
115
+
116
+ } // namespace java
117
+ } // namespace compiler
118
+ } // namespace protobuf
119
+
120
+ } // namespace google
121
+ #endif // GOOGLE_PROTOBUF_COMPILER_JAVA_ENUM_FIELD_H__