protobuf 2.2.5-java
Sign up to get free protection for your applications and to get access to all the features.
- data/.gitignore +17 -0
- data/.travis.yml +9 -0
- data/.yardopts +5 -0
- data/Gemfile +3 -0
- data/README.md +316 -0
- data/Rakefile +29 -0
- data/UPGRADING.md +60 -0
- data/bin/rpc_server +5 -0
- data/bin/rprotoc +62 -0
- data/examples/addressbook.pb.rb +55 -0
- data/examples/addressbook.proto +24 -0
- data/examples/reading_a_message.rb +32 -0
- data/examples/writing_a_message.rb +46 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/code_generator.h +142 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/command_line_interface.h +318 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_enum.h +99 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_enum_field.h +103 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_extension.h +85 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_field.h +167 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_file.h +98 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_generator.h +72 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_helpers.h +159 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_message.h +170 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_message_field.h +102 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_primitive_field.h +103 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_service.h +118 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_string_field.h +104 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_test_bad_identifiers.pb.h +2721 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/importer.h +303 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_enum.h +84 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_enum_field.h +121 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_extension.h +77 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_field.h +108 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_file.h +101 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_generator.h +72 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_helpers.h +213 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_message.h +109 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_message_field.h +134 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_primitive_field.h +121 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_service.h +113 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_string_field.h +120 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/mock_code_generator.h +113 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/package_info.h +64 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/parser.h +434 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/plugin.h +73 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/plugin.pb.h +790 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/python/python_generator.h +156 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/subprocess.h +108 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/compiler/zip_writer.h +93 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/descriptor.h +1367 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/descriptor.pb.h +5223 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/descriptor_database.h +366 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/dynamic_message.h +136 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/extension_set.h +904 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/generated_message_reflection.h +424 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/generated_message_util.h +82 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/io/coded_stream.h +1102 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/io/coded_stream_inl.h +64 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/io/gzip_stream.h +207 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/io/package_info.h +54 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/io/printer.h +136 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/io/tokenizer.h +313 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/io/zero_copy_stream.h +238 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/io/zero_copy_stream_impl.h +357 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/io/zero_copy_stream_impl_lite.h +340 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/message.h +692 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/message_lite.h +239 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/package_info.h +64 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/reflection_ops.h +80 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/repeated_field.h +1295 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/service.h +291 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/stubs/common.h +1211 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/stubs/hash.h +220 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/stubs/map-util.h +119 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/stubs/once.h +123 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/stubs/stl_util-inl.h +121 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/stubs/strutil.h +457 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/stubs/substitute.h +170 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/test_util.h +174 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/test_util_lite.h +101 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/testing/file.h +83 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/testing/googletest.h +98 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/text_format.h +285 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/unittest.pb.h +11915 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/unittest_custom_options.pb.h +2895 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/unittest_embed_optimize_for.pb.h +211 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/unittest_empty.pb.h +56 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/unittest_import.pb.h +188 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/unittest_import_lite.pb.h +151 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/unittest_lite.pb.h +4752 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/unittest_lite_imports_nonlite.pb.h +150 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/unittest_mset.pb.h +816 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/unittest_no_generic_services.pb.h +197 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/unittest_optimize_for.pb.h +403 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/unknown_field_set.h +268 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/wire_format.h +304 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/wire_format_lite.h +620 -0
- data/ext/protobuf-2.4.1/src/google/protobuf/wire_format_lite_inl.h +774 -0
- data/ext/ruby_generator/Makefile +10 -0
- data/ext/ruby_generator/RubyGenerator.cpp +450 -0
- data/ext/ruby_generator/RubyGenerator.h +199 -0
- data/ext/ruby_generator/extconf.rb +36 -0
- data/ext/ruby_generator/protoc-ruby +0 -0
- data/lib/protobuf/cli.rb +188 -0
- data/lib/protobuf/enum.rb +58 -0
- data/lib/protobuf/enum_value.rb +59 -0
- data/lib/protobuf/evented.rb +22 -0
- data/lib/protobuf/exceptions.rb +11 -0
- data/lib/protobuf/ext/eventmachine.rb +14 -0
- data/lib/protobuf/field/base_field.rb +240 -0
- data/lib/protobuf/field/bool_field.rb +36 -0
- data/lib/protobuf/field/bytes_field.rb +38 -0
- data/lib/protobuf/field/double_field.rb +19 -0
- data/lib/protobuf/field/enum_field.rb +50 -0
- data/lib/protobuf/field/extension_fields.rb +32 -0
- data/lib/protobuf/field/field_array.rb +65 -0
- data/lib/protobuf/field/fixed32_field.rb +19 -0
- data/lib/protobuf/field/fixed64_field.rb +22 -0
- data/lib/protobuf/field/float_field.rb +31 -0
- data/lib/protobuf/field/int32_field.rb +12 -0
- data/lib/protobuf/field/int64_field.rb +12 -0
- data/lib/protobuf/field/integer_field.rb +19 -0
- data/lib/protobuf/field/message_field.rb +53 -0
- data/lib/protobuf/field/sfixed32_field.rb +21 -0
- data/lib/protobuf/field/sfixed64_field.rb +24 -0
- data/lib/protobuf/field/signed_integer_field.rb +23 -0
- data/lib/protobuf/field/sint32_field.rb +12 -0
- data/lib/protobuf/field/sint64_field.rb +12 -0
- data/lib/protobuf/field/string_field.rb +14 -0
- data/lib/protobuf/field/uint32_field.rb +12 -0
- data/lib/protobuf/field/uint64_field.rb +12 -0
- data/lib/protobuf/field/varint_field.rb +61 -0
- data/lib/protobuf/field.rb +57 -0
- data/lib/protobuf/logger.rb +86 -0
- data/lib/protobuf/message/decoder.rb +83 -0
- data/lib/protobuf/message/encoder.rb +48 -0
- data/lib/protobuf/message/extend.rb +8 -0
- data/lib/protobuf/message/message.rb +1 -0
- data/lib/protobuf/message.rb +320 -0
- data/lib/protobuf/rpc/buffer.rb +79 -0
- data/lib/protobuf/rpc/client.rb +166 -0
- data/lib/protobuf/rpc/connector.rb +19 -0
- data/lib/protobuf/rpc/connectors/base.rb +38 -0
- data/lib/protobuf/rpc/connectors/common.rb +156 -0
- data/lib/protobuf/rpc/connectors/em_client.rb +84 -0
- data/lib/protobuf/rpc/connectors/eventmachine.rb +87 -0
- data/lib/protobuf/rpc/connectors/socket.rb +73 -0
- data/lib/protobuf/rpc/connectors/zmq.rb +69 -0
- data/lib/protobuf/rpc/error/client_error.rb +31 -0
- data/lib/protobuf/rpc/error/server_error.rb +43 -0
- data/lib/protobuf/rpc/error.rb +25 -0
- data/lib/protobuf/rpc/rpc.pb.rb +118 -0
- data/lib/protobuf/rpc/server.rb +89 -0
- data/lib/protobuf/rpc/servers/evented/server.rb +41 -0
- data/lib/protobuf/rpc/servers/evented_runner.rb +21 -0
- data/lib/protobuf/rpc/servers/socket/server.rb +111 -0
- data/lib/protobuf/rpc/servers/socket/worker.rb +66 -0
- data/lib/protobuf/rpc/servers/socket_runner.rb +27 -0
- data/lib/protobuf/rpc/servers/zmq/broker.rb +87 -0
- data/lib/protobuf/rpc/servers/zmq/server.rb +50 -0
- data/lib/protobuf/rpc/servers/zmq/util.rb +27 -0
- data/lib/protobuf/rpc/servers/zmq/worker.rb +60 -0
- data/lib/protobuf/rpc/servers/zmq_runner.rb +25 -0
- data/lib/protobuf/rpc/service.rb +173 -0
- data/lib/protobuf/rpc/service_dispatcher.rb +130 -0
- data/lib/protobuf/rpc/service_filters.rb +267 -0
- data/lib/protobuf/rpc/stat.rb +83 -0
- data/lib/protobuf/socket.rb +22 -0
- data/lib/protobuf/version.rb +4 -0
- data/lib/protobuf/wire_type.rb +10 -0
- data/lib/protobuf/zmq.rb +21 -0
- data/lib/protobuf.rb +86 -0
- data/proto/rpc.pb.rb +48 -0
- data/proto/rpc.proto +73 -0
- data/protobuf.gemspec +44 -0
- data/spec/benchmark/tasks.rb +179 -0
- data/spec/functional/embedded_service_spec.rb +7 -0
- data/spec/functional/evented_server_spec.rb +64 -0
- data/spec/functional/socket_server_spec.rb +58 -0
- data/spec/functional/zmq_server_spec.rb +58 -0
- data/spec/lib/protobuf/cli_spec.rb +212 -0
- data/spec/lib/protobuf/enum_spec.rb +98 -0
- data/spec/lib/protobuf/enum_value_spec.rb +15 -0
- data/spec/lib/protobuf/logger_spec.rb +131 -0
- data/spec/lib/protobuf/message/encoder_spec.rb +19 -0
- data/spec/lib/protobuf/message_spec.rb +209 -0
- data/spec/lib/protobuf/rpc/client_spec.rb +158 -0
- data/spec/lib/protobuf/rpc/connector_spec.rb +32 -0
- data/spec/lib/protobuf/rpc/connectors/base_spec.rb +50 -0
- data/spec/lib/protobuf/rpc/connectors/common_spec.rb +128 -0
- data/spec/lib/protobuf/rpc/connectors/socket_spec.rb +36 -0
- data/spec/lib/protobuf/rpc/connectors/zmq_spec.rb +22 -0
- data/spec/lib/protobuf/rpc/servers/evented_server_spec.rb +18 -0
- data/spec/lib/protobuf/rpc/servers/socket_server_spec.rb +43 -0
- data/spec/lib/protobuf/rpc/servers/zmq/broker_spec.rb +35 -0
- data/spec/lib/protobuf/rpc/servers/zmq/server_spec.rb +41 -0
- data/spec/lib/protobuf/rpc/servers/zmq/util_spec.rb +45 -0
- data/spec/lib/protobuf/rpc/servers/zmq/worker_spec.rb +44 -0
- data/spec/lib/protobuf/rpc/service_dispatcher_spec.rb +116 -0
- data/spec/lib/protobuf/rpc/service_filters_spec.rb +451 -0
- data/spec/lib/protobuf/rpc/service_spec.rb +165 -0
- data/spec/lib/protobuf_spec.rb +62 -0
- data/spec/spec_helper.rb +51 -0
- data/spec/support/all.rb +6 -0
- data/spec/support/server.rb +101 -0
- data/spec/support/test/enum.pb.rb +34 -0
- data/spec/support/test/enum.proto +12 -0
- data/spec/support/test/resource.pb.rb +58 -0
- data/spec/support/test/resource.proto +31 -0
- data/spec/support/test/resource_service.rb +14 -0
- data/spec/support/test_app_file.rb +2 -0
- data/spec/support/tolerance_matcher.rb +40 -0
- data/test/data/data.bin +3 -0
- data/test/data/data_source.py +14 -0
- data/test/data/types.bin +0 -0
- data/test/data/types_source.py +22 -0
- data/test/data/unk.png +0 -0
- data/test/proto/addressbook.pb.rb +66 -0
- data/test/proto/addressbook.proto +33 -0
- data/test/proto/addressbook_base.pb.rb +58 -0
- data/test/proto/addressbook_base.proto +26 -0
- data/test/proto/addressbook_ext.pb.rb +20 -0
- data/test/proto/addressbook_ext.proto +6 -0
- data/test/proto/collision.pb.rb +17 -0
- data/test/proto/collision.proto +5 -0
- data/test/proto/ext_collision.pb.rb +24 -0
- data/test/proto/ext_collision.proto +8 -0
- data/test/proto/ext_range.pb.rb +22 -0
- data/test/proto/ext_range.proto +7 -0
- data/test/proto/float_default.proto +10 -0
- data/test/proto/lowercase.pb.rb +30 -0
- data/test/proto/lowercase.proto +9 -0
- data/test/proto/merge.pb.rb +39 -0
- data/test/proto/merge.proto +15 -0
- data/test/proto/nested.pb.rb +30 -0
- data/test/proto/nested.proto +9 -0
- data/test/proto/optional_field.pb.rb +35 -0
- data/test/proto/optional_field.proto +12 -0
- data/test/proto/packed.pb.rb +22 -0
- data/test/proto/packed.proto +6 -0
- data/test/proto/rpc.proto +6 -0
- data/test/proto/types.pb.rb +84 -0
- data/test/proto/types.proto +37 -0
- data/test/test_addressbook.rb +56 -0
- data/test/test_enum_value.rb +41 -0
- data/test/test_extension.rb +36 -0
- data/test/test_lowercase.rb +11 -0
- data/test/test_message.rb +128 -0
- data/test/test_optional_field.rb +103 -0
- data/test/test_packed_field.rb +40 -0
- data/test/test_parse.rb +15 -0
- data/test/test_repeated_types.rb +132 -0
- data/test/test_serialize.rb +61 -0
- data/test/test_standard_message.rb +96 -0
- data/test/test_types.rb +226 -0
- metadata +461 -0
@@ -0,0 +1,142 @@
|
|
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
|
+
// Defines the abstract interface implemented by each of the language-specific
|
36
|
+
// code generators.
|
37
|
+
|
38
|
+
#ifndef GOOGLE_PROTOBUF_COMPILER_CODE_GENERATOR_H__
|
39
|
+
#define GOOGLE_PROTOBUF_COMPILER_CODE_GENERATOR_H__
|
40
|
+
|
41
|
+
#include <google/protobuf/stubs/common.h>
|
42
|
+
#include <string>
|
43
|
+
#include <vector>
|
44
|
+
#include <utility>
|
45
|
+
|
46
|
+
namespace google {
|
47
|
+
namespace protobuf {
|
48
|
+
|
49
|
+
namespace io { class ZeroCopyOutputStream; }
|
50
|
+
class FileDescriptor;
|
51
|
+
|
52
|
+
namespace compiler {
|
53
|
+
|
54
|
+
// Defined in this file.
|
55
|
+
class CodeGenerator;
|
56
|
+
class GeneratorContext;
|
57
|
+
|
58
|
+
// The abstract interface to a class which generates code implementing a
|
59
|
+
// particular proto file in a particular language. A number of these may
|
60
|
+
// be registered with CommandLineInterface to support various languages.
|
61
|
+
class LIBPROTOC_EXPORT CodeGenerator {
|
62
|
+
public:
|
63
|
+
inline CodeGenerator() {}
|
64
|
+
virtual ~CodeGenerator();
|
65
|
+
|
66
|
+
// Generates code for the given proto file, generating one or more files in
|
67
|
+
// the given output directory.
|
68
|
+
//
|
69
|
+
// A parameter to be passed to the generator can be specified on the
|
70
|
+
// command line. This is intended to be used by Java and similar languages
|
71
|
+
// to specify which specific class from the proto file is to be generated,
|
72
|
+
// though it could have other uses as well. It is empty if no parameter was
|
73
|
+
// given.
|
74
|
+
//
|
75
|
+
// Returns true if successful. Otherwise, sets *error to a description of
|
76
|
+
// the problem (e.g. "invalid parameter") and returns false.
|
77
|
+
virtual bool Generate(const FileDescriptor* file,
|
78
|
+
const string& parameter,
|
79
|
+
GeneratorContext* generator_context,
|
80
|
+
string* error) const = 0;
|
81
|
+
|
82
|
+
private:
|
83
|
+
GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(CodeGenerator);
|
84
|
+
};
|
85
|
+
|
86
|
+
// CodeGenerators generate one or more files in a given directory. This
|
87
|
+
// abstract interface represents the directory to which the CodeGenerator is
|
88
|
+
// to write and other information about the context in which the Generator
|
89
|
+
// runs.
|
90
|
+
class LIBPROTOC_EXPORT GeneratorContext {
|
91
|
+
public:
|
92
|
+
inline GeneratorContext() {}
|
93
|
+
virtual ~GeneratorContext();
|
94
|
+
|
95
|
+
// Opens the given file, truncating it if it exists, and returns a
|
96
|
+
// ZeroCopyOutputStream that writes to the file. The caller takes ownership
|
97
|
+
// of the returned object. This method never fails (a dummy stream will be
|
98
|
+
// returned instead).
|
99
|
+
//
|
100
|
+
// The filename given should be relative to the root of the source tree.
|
101
|
+
// E.g. the C++ generator, when generating code for "foo/bar.proto", will
|
102
|
+
// generate the files "foo/bar.pb.h" and "foo/bar.pb.cc"; note that
|
103
|
+
// "foo/" is included in these filenames. The filename is not allowed to
|
104
|
+
// contain "." or ".." components.
|
105
|
+
virtual io::ZeroCopyOutputStream* Open(const string& filename) = 0;
|
106
|
+
|
107
|
+
// Creates a ZeroCopyOutputStream which will insert code into the given file
|
108
|
+
// at the given insertion point. See plugin.proto (plugin.pb.h) for more
|
109
|
+
// information on insertion points. The default implementation
|
110
|
+
// assert-fails -- it exists only for backwards-compatibility.
|
111
|
+
//
|
112
|
+
// WARNING: This feature is currently EXPERIMENTAL and is subject to change.
|
113
|
+
virtual io::ZeroCopyOutputStream* OpenForInsert(
|
114
|
+
const string& filename, const string& insertion_point);
|
115
|
+
|
116
|
+
// Returns a vector of FileDescriptors for all the files being compiled
|
117
|
+
// in this run. Useful for languages, such as Go, that treat files
|
118
|
+
// differently when compiled as a set rather than individually.
|
119
|
+
virtual void ListParsedFiles(vector<const FileDescriptor*>* output);
|
120
|
+
|
121
|
+
private:
|
122
|
+
GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(GeneratorContext);
|
123
|
+
};
|
124
|
+
|
125
|
+
// The type GeneratorContext was once called OutputDirectory. This typedef
|
126
|
+
// provides backward compatibility.
|
127
|
+
typedef GeneratorContext OutputDirectory;
|
128
|
+
|
129
|
+
// Several code generators treat the parameter argument as holding a
|
130
|
+
// list of options separated by commas. This helper function parses
|
131
|
+
// a set of comma-delimited name/value pairs: e.g.,
|
132
|
+
// "foo=bar,baz,qux=corge"
|
133
|
+
// parses to the pairs:
|
134
|
+
// ("foo", "bar"), ("baz", ""), ("qux", "corge")
|
135
|
+
extern void ParseGeneratorParameter(const string&,
|
136
|
+
vector<pair<string, string> >*);
|
137
|
+
|
138
|
+
} // namespace compiler
|
139
|
+
} // namespace protobuf
|
140
|
+
|
141
|
+
} // namespace google
|
142
|
+
#endif // GOOGLE_PROTOBUF_COMPILER_CODE_GENERATOR_H__
|
@@ -0,0 +1,318 @@
|
|
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
|
+
// Implements the Protocol Compiler front-end such that it may be reused by
|
36
|
+
// custom compilers written to support other languages.
|
37
|
+
|
38
|
+
#ifndef GOOGLE_PROTOBUF_COMPILER_COMMAND_LINE_INTERFACE_H__
|
39
|
+
#define GOOGLE_PROTOBUF_COMPILER_COMMAND_LINE_INTERFACE_H__
|
40
|
+
|
41
|
+
#include <google/protobuf/stubs/common.h>
|
42
|
+
#include <string>
|
43
|
+
#include <vector>
|
44
|
+
#include <map>
|
45
|
+
#include <set>
|
46
|
+
#include <utility>
|
47
|
+
|
48
|
+
namespace google {
|
49
|
+
namespace protobuf {
|
50
|
+
|
51
|
+
class FileDescriptor; // descriptor.h
|
52
|
+
class DescriptorPool; // descriptor.h
|
53
|
+
class FileDescriptorProto; // descriptor.pb.h
|
54
|
+
template<typename T> class RepeatedPtrField; // repeated_field.h
|
55
|
+
|
56
|
+
namespace compiler {
|
57
|
+
|
58
|
+
class CodeGenerator; // code_generator.h
|
59
|
+
class GeneratorContext; // code_generator.h
|
60
|
+
class DiskSourceTree; // importer.h
|
61
|
+
|
62
|
+
// This class implements the command-line interface to the protocol compiler.
|
63
|
+
// It is designed to make it very easy to create a custom protocol compiler
|
64
|
+
// supporting the languages of your choice. For example, if you wanted to
|
65
|
+
// create a custom protocol compiler binary which includes both the regular
|
66
|
+
// C++ support plus support for your own custom output "Foo", you would
|
67
|
+
// write a class "FooGenerator" which implements the CodeGenerator interface,
|
68
|
+
// then write a main() procedure like this:
|
69
|
+
//
|
70
|
+
// int main(int argc, char* argv[]) {
|
71
|
+
// google::protobuf::compiler::CommandLineInterface cli;
|
72
|
+
//
|
73
|
+
// // Support generation of C++ source and headers.
|
74
|
+
// google::protobuf::compiler::cpp::CppGenerator cpp_generator;
|
75
|
+
// cli.RegisterGenerator("--cpp_out", &cpp_generator,
|
76
|
+
// "Generate C++ source and header.");
|
77
|
+
//
|
78
|
+
// // Support generation of Foo code.
|
79
|
+
// FooGenerator foo_generator;
|
80
|
+
// cli.RegisterGenerator("--foo_out", &foo_generator,
|
81
|
+
// "Generate Foo file.");
|
82
|
+
//
|
83
|
+
// return cli.Run(argc, argv);
|
84
|
+
// }
|
85
|
+
//
|
86
|
+
// The compiler is invoked with syntax like:
|
87
|
+
// protoc --cpp_out=outdir --foo_out=outdir --proto_path=src src/foo.proto
|
88
|
+
//
|
89
|
+
// For a full description of the command-line syntax, invoke it with --help.
|
90
|
+
class LIBPROTOC_EXPORT CommandLineInterface {
|
91
|
+
public:
|
92
|
+
CommandLineInterface();
|
93
|
+
~CommandLineInterface();
|
94
|
+
|
95
|
+
// Register a code generator for a language.
|
96
|
+
//
|
97
|
+
// Parameters:
|
98
|
+
// * flag_name: The command-line flag used to specify an output file of
|
99
|
+
// this type. The name must start with a '-'. If the name is longer
|
100
|
+
// than one letter, it must start with two '-'s.
|
101
|
+
// * generator: The CodeGenerator which will be called to generate files
|
102
|
+
// of this type.
|
103
|
+
// * help_text: Text describing this flag in the --help output.
|
104
|
+
//
|
105
|
+
// Some generators accept extra parameters. You can specify this parameter
|
106
|
+
// on the command-line by placing it before the output directory, separated
|
107
|
+
// by a colon:
|
108
|
+
// protoc --foo_out=enable_bar:outdir
|
109
|
+
// The text before the colon is passed to CodeGenerator::Generate() as the
|
110
|
+
// "parameter".
|
111
|
+
void RegisterGenerator(const string& flag_name,
|
112
|
+
CodeGenerator* generator,
|
113
|
+
const string& help_text);
|
114
|
+
|
115
|
+
// Enables "plugins". In this mode, if a command-line flag ends with "_out"
|
116
|
+
// but does not match any registered generator, the compiler will attempt to
|
117
|
+
// find a "plugin" to implement the generator. Plugins are just executables.
|
118
|
+
// They should live somewhere in the PATH.
|
119
|
+
//
|
120
|
+
// The compiler determines the executable name to search for by concatenating
|
121
|
+
// exe_name_prefix with the unrecognized flag name, removing "_out". So, for
|
122
|
+
// example, if exe_name_prefix is "protoc-" and you pass the flag --foo_out,
|
123
|
+
// the compiler will try to run the program "protoc-foo".
|
124
|
+
//
|
125
|
+
// The plugin program should implement the following usage:
|
126
|
+
// plugin [--out=OUTDIR] [--parameter=PARAMETER] PROTO_FILES < DESCRIPTORS
|
127
|
+
// --out indicates the output directory (as passed to the --foo_out
|
128
|
+
// parameter); if omitted, the current directory should be used. --parameter
|
129
|
+
// gives the generator parameter, if any was provided. The PROTO_FILES list
|
130
|
+
// the .proto files which were given on the compiler command-line; these are
|
131
|
+
// the files for which the plugin is expected to generate output code.
|
132
|
+
// Finally, DESCRIPTORS is an encoded FileDescriptorSet (as defined in
|
133
|
+
// descriptor.proto). This is piped to the plugin's stdin. The set will
|
134
|
+
// include descriptors for all the files listed in PROTO_FILES as well as
|
135
|
+
// all files that they import. The plugin MUST NOT attempt to read the
|
136
|
+
// PROTO_FILES directly -- it must use the FileDescriptorSet.
|
137
|
+
//
|
138
|
+
// The plugin should generate whatever files are necessary, as code generators
|
139
|
+
// normally do. It should write the names of all files it generates to
|
140
|
+
// stdout. The names should be relative to the output directory, NOT absolute
|
141
|
+
// names or relative to the current directory. If any errors occur, error
|
142
|
+
// messages should be written to stderr. If an error is fatal, the plugin
|
143
|
+
// should exit with a non-zero exit code.
|
144
|
+
void AllowPlugins(const string& exe_name_prefix);
|
145
|
+
|
146
|
+
// Run the Protocol Compiler with the given command-line parameters.
|
147
|
+
// Returns the error code which should be returned by main().
|
148
|
+
//
|
149
|
+
// It may not be safe to call Run() in a multi-threaded environment because
|
150
|
+
// it calls strerror(). I'm not sure why you'd want to do this anyway.
|
151
|
+
int Run(int argc, const char* const argv[]);
|
152
|
+
|
153
|
+
// Call SetInputsAreCwdRelative(true) if the input files given on the command
|
154
|
+
// line should be interpreted relative to the proto import path specified
|
155
|
+
// using --proto_path or -I flags. Otherwise, input file names will be
|
156
|
+
// interpreted relative to the current working directory (or as absolute
|
157
|
+
// paths if they start with '/'), though they must still reside inside
|
158
|
+
// a directory given by --proto_path or the compiler will fail. The latter
|
159
|
+
// mode is generally more intuitive and easier to use, especially e.g. when
|
160
|
+
// defining implicit rules in Makefiles.
|
161
|
+
void SetInputsAreProtoPathRelative(bool enable) {
|
162
|
+
inputs_are_proto_path_relative_ = enable;
|
163
|
+
}
|
164
|
+
|
165
|
+
// Provides some text which will be printed when the --version flag is
|
166
|
+
// used. The version of libprotoc will also be printed on the next line
|
167
|
+
// after this text.
|
168
|
+
void SetVersionInfo(const string& text) {
|
169
|
+
version_info_ = text;
|
170
|
+
}
|
171
|
+
|
172
|
+
|
173
|
+
private:
|
174
|
+
// -----------------------------------------------------------------
|
175
|
+
|
176
|
+
class ErrorPrinter;
|
177
|
+
class GeneratorContextImpl;
|
178
|
+
class MemoryOutputStream;
|
179
|
+
|
180
|
+
// Clear state from previous Run().
|
181
|
+
void Clear();
|
182
|
+
|
183
|
+
// Remaps each file in input_files_ so that it is relative to one of the
|
184
|
+
// directories in proto_path_. Returns false if an error occurred. This
|
185
|
+
// is only used if inputs_are_proto_path_relative_ is false.
|
186
|
+
bool MakeInputsBeProtoPathRelative(
|
187
|
+
DiskSourceTree* source_tree);
|
188
|
+
|
189
|
+
// Parse all command-line arguments.
|
190
|
+
bool ParseArguments(int argc, const char* const argv[]);
|
191
|
+
|
192
|
+
// Parses a command-line argument into a name/value pair. Returns
|
193
|
+
// true if the next argument in the argv should be used as the value,
|
194
|
+
// false otherwise.
|
195
|
+
//
|
196
|
+
// Exmaples:
|
197
|
+
// "-Isrc/protos" ->
|
198
|
+
// name = "-I", value = "src/protos"
|
199
|
+
// "--cpp_out=src/foo.pb2.cc" ->
|
200
|
+
// name = "--cpp_out", value = "src/foo.pb2.cc"
|
201
|
+
// "foo.proto" ->
|
202
|
+
// name = "", value = "foo.proto"
|
203
|
+
bool ParseArgument(const char* arg, string* name, string* value);
|
204
|
+
|
205
|
+
// Interprets arguments parsed with ParseArgument.
|
206
|
+
bool InterpretArgument(const string& name, const string& value);
|
207
|
+
|
208
|
+
// Print the --help text to stderr.
|
209
|
+
void PrintHelpText();
|
210
|
+
|
211
|
+
// Generate the given output file from the given input.
|
212
|
+
struct OutputDirective; // see below
|
213
|
+
bool GenerateOutput(const vector<const FileDescriptor*>& parsed_files,
|
214
|
+
const OutputDirective& output_directive,
|
215
|
+
GeneratorContext* generator_context);
|
216
|
+
bool GeneratePluginOutput(const vector<const FileDescriptor*>& parsed_files,
|
217
|
+
const string& plugin_name,
|
218
|
+
const string& parameter,
|
219
|
+
GeneratorContext* generator_context,
|
220
|
+
string* error);
|
221
|
+
|
222
|
+
// Implements --encode and --decode.
|
223
|
+
bool EncodeOrDecode(const DescriptorPool* pool);
|
224
|
+
|
225
|
+
// Implements the --descriptor_set_out option.
|
226
|
+
bool WriteDescriptorSet(const vector<const FileDescriptor*> parsed_files);
|
227
|
+
|
228
|
+
// Get all transitive dependencies of the given file (including the file
|
229
|
+
// itself), adding them to the given list of FileDescriptorProtos. The
|
230
|
+
// protos will be ordered such that every file is listed before any file that
|
231
|
+
// depends on it, so that you can call DescriptorPool::BuildFile() on them
|
232
|
+
// in order. Any files in *already_seen will not be added, and each file
|
233
|
+
// added will be inserted into *already_seen.
|
234
|
+
static void GetTransitiveDependencies(
|
235
|
+
const FileDescriptor* file,
|
236
|
+
set<const FileDescriptor*>* already_seen,
|
237
|
+
RepeatedPtrField<FileDescriptorProto>* output);
|
238
|
+
|
239
|
+
// -----------------------------------------------------------------
|
240
|
+
|
241
|
+
// The name of the executable as invoked (i.e. argv[0]).
|
242
|
+
string executable_name_;
|
243
|
+
|
244
|
+
// Version info set with SetVersionInfo().
|
245
|
+
string version_info_;
|
246
|
+
|
247
|
+
// Map from flag names to registered generators.
|
248
|
+
struct GeneratorInfo {
|
249
|
+
CodeGenerator* generator;
|
250
|
+
string help_text;
|
251
|
+
};
|
252
|
+
typedef map<string, GeneratorInfo> GeneratorMap;
|
253
|
+
GeneratorMap generators_;
|
254
|
+
|
255
|
+
// See AllowPlugins(). If this is empty, plugins aren't allowed.
|
256
|
+
string plugin_prefix_;
|
257
|
+
|
258
|
+
// Maps specific plugin names to files. When executing a plugin, this map
|
259
|
+
// is searched first to find the plugin executable. If not found here, the
|
260
|
+
// PATH (or other OS-specific search strategy) is searched.
|
261
|
+
map<string, string> plugins_;
|
262
|
+
|
263
|
+
// Stuff parsed from command line.
|
264
|
+
enum Mode {
|
265
|
+
MODE_COMPILE, // Normal mode: parse .proto files and compile them.
|
266
|
+
MODE_ENCODE, // --encode: read text from stdin, write binary to stdout.
|
267
|
+
MODE_DECODE // --decode: read binary from stdin, write text to stdout.
|
268
|
+
};
|
269
|
+
|
270
|
+
Mode mode_;
|
271
|
+
|
272
|
+
enum ErrorFormat {
|
273
|
+
ERROR_FORMAT_GCC, // GCC error output format (default).
|
274
|
+
ERROR_FORMAT_MSVS // Visual Studio output (--error_format=msvs).
|
275
|
+
};
|
276
|
+
|
277
|
+
ErrorFormat error_format_;
|
278
|
+
|
279
|
+
vector<pair<string, string> > proto_path_; // Search path for proto files.
|
280
|
+
vector<string> input_files_; // Names of the input proto files.
|
281
|
+
|
282
|
+
// output_directives_ lists all the files we are supposed to output and what
|
283
|
+
// generator to use for each.
|
284
|
+
struct OutputDirective {
|
285
|
+
string name; // E.g. "--foo_out"
|
286
|
+
CodeGenerator* generator; // NULL for plugins
|
287
|
+
string parameter;
|
288
|
+
string output_location;
|
289
|
+
};
|
290
|
+
vector<OutputDirective> output_directives_;
|
291
|
+
|
292
|
+
// When using --encode or --decode, this names the type we are encoding or
|
293
|
+
// decoding. (Empty string indicates --decode_raw.)
|
294
|
+
string codec_type_;
|
295
|
+
|
296
|
+
// If --descriptor_set_out was given, this is the filename to which the
|
297
|
+
// FileDescriptorSet should be written. Otherwise, empty.
|
298
|
+
string descriptor_set_name_;
|
299
|
+
|
300
|
+
// True if --include_imports was given, meaning that we should
|
301
|
+
// write all transitive dependencies to the DescriptorSet. Otherwise, only
|
302
|
+
// the .proto files listed on the command-line are added.
|
303
|
+
bool imports_in_descriptor_set_;
|
304
|
+
|
305
|
+
// Was the --disallow_services flag used?
|
306
|
+
bool disallow_services_;
|
307
|
+
|
308
|
+
// See SetInputsAreProtoPathRelative().
|
309
|
+
bool inputs_are_proto_path_relative_;
|
310
|
+
|
311
|
+
GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(CommandLineInterface);
|
312
|
+
};
|
313
|
+
|
314
|
+
} // namespace compiler
|
315
|
+
} // namespace protobuf
|
316
|
+
|
317
|
+
} // namespace google
|
318
|
+
#endif // GOOGLE_PROTOBUF_COMPILER_COMMAND_LINE_INTERFACE_H__
|
@@ -0,0 +1,99 @@
|
|
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_CPP_ENUM_H__
|
36
|
+
#define GOOGLE_PROTOBUF_COMPILER_CPP_ENUM_H__
|
37
|
+
|
38
|
+
#include <string>
|
39
|
+
#include <google/protobuf/descriptor.h>
|
40
|
+
|
41
|
+
namespace google {
|
42
|
+
namespace protobuf {
|
43
|
+
namespace io {
|
44
|
+
class Printer; // printer.h
|
45
|
+
}
|
46
|
+
}
|
47
|
+
|
48
|
+
namespace protobuf {
|
49
|
+
namespace compiler {
|
50
|
+
namespace cpp {
|
51
|
+
|
52
|
+
class EnumGenerator {
|
53
|
+
public:
|
54
|
+
// See generator.cc for the meaning of dllexport_decl.
|
55
|
+
explicit EnumGenerator(const EnumDescriptor* descriptor,
|
56
|
+
const string& dllexport_decl);
|
57
|
+
~EnumGenerator();
|
58
|
+
|
59
|
+
// Header stuff.
|
60
|
+
|
61
|
+
// Generate header code defining the enum. This code should be placed
|
62
|
+
// within the enum's package namespace, but NOT within any class, even for
|
63
|
+
// nested enums.
|
64
|
+
void GenerateDefinition(io::Printer* printer);
|
65
|
+
|
66
|
+
// Generate specialization of GetEnumDescriptor<MyEnum>().
|
67
|
+
// Precondition: in ::google::protobuf namespace.
|
68
|
+
void GenerateGetEnumDescriptorSpecializations(io::Printer* printer);
|
69
|
+
|
70
|
+
// For enums nested within a message, generate code to import all the enum's
|
71
|
+
// symbols (e.g. the enum type name, all its values, etc.) into the class's
|
72
|
+
// namespace. This should be placed inside the class definition in the
|
73
|
+
// header.
|
74
|
+
void GenerateSymbolImports(io::Printer* printer);
|
75
|
+
|
76
|
+
// Source file stuff.
|
77
|
+
|
78
|
+
// Generate code that initializes the global variable storing the enum's
|
79
|
+
// descriptor.
|
80
|
+
void GenerateDescriptorInitializer(io::Printer* printer, int index);
|
81
|
+
|
82
|
+
// Generate non-inline methods related to the enum, such as IsValidValue().
|
83
|
+
// Goes in the .cc file.
|
84
|
+
void GenerateMethods(io::Printer* printer);
|
85
|
+
|
86
|
+
private:
|
87
|
+
const EnumDescriptor* descriptor_;
|
88
|
+
string classname_;
|
89
|
+
string dllexport_decl_;
|
90
|
+
|
91
|
+
GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(EnumGenerator);
|
92
|
+
};
|
93
|
+
|
94
|
+
} // namespace cpp
|
95
|
+
} // namespace compiler
|
96
|
+
} // namespace protobuf
|
97
|
+
|
98
|
+
} // namespace google
|
99
|
+
#endif // GOOGLE_PROTOBUF_COMPILER_CPP_ENUM_H__
|
@@ -0,0 +1,103 @@
|
|
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_CPP_ENUM_FIELD_H__
|
36
|
+
#define GOOGLE_PROTOBUF_COMPILER_CPP_ENUM_FIELD_H__
|
37
|
+
|
38
|
+
#include <map>
|
39
|
+
#include <string>
|
40
|
+
#include <google/protobuf/compiler/cpp/cpp_field.h>
|
41
|
+
|
42
|
+
namespace google {
|
43
|
+
namespace protobuf {
|
44
|
+
namespace compiler {
|
45
|
+
namespace cpp {
|
46
|
+
|
47
|
+
class EnumFieldGenerator : public FieldGenerator {
|
48
|
+
public:
|
49
|
+
explicit EnumFieldGenerator(const FieldDescriptor* descriptor);
|
50
|
+
~EnumFieldGenerator();
|
51
|
+
|
52
|
+
// implements FieldGenerator ---------------------------------------
|
53
|
+
void GeneratePrivateMembers(io::Printer* printer) const;
|
54
|
+
void GenerateAccessorDeclarations(io::Printer* printer) const;
|
55
|
+
void GenerateInlineAccessorDefinitions(io::Printer* printer) const;
|
56
|
+
void GenerateClearingCode(io::Printer* printer) const;
|
57
|
+
void GenerateMergingCode(io::Printer* printer) const;
|
58
|
+
void GenerateSwappingCode(io::Printer* printer) const;
|
59
|
+
void GenerateConstructorCode(io::Printer* printer) const;
|
60
|
+
void GenerateMergeFromCodedStream(io::Printer* printer) const;
|
61
|
+
void GenerateSerializeWithCachedSizes(io::Printer* printer) const;
|
62
|
+
void GenerateSerializeWithCachedSizesToArray(io::Printer* printer) const;
|
63
|
+
void GenerateByteSize(io::Printer* printer) const;
|
64
|
+
|
65
|
+
private:
|
66
|
+
const FieldDescriptor* descriptor_;
|
67
|
+
map<string, string> variables_;
|
68
|
+
|
69
|
+
GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(EnumFieldGenerator);
|
70
|
+
};
|
71
|
+
|
72
|
+
class RepeatedEnumFieldGenerator : public FieldGenerator {
|
73
|
+
public:
|
74
|
+
explicit RepeatedEnumFieldGenerator(const FieldDescriptor* descriptor);
|
75
|
+
~RepeatedEnumFieldGenerator();
|
76
|
+
|
77
|
+
// implements FieldGenerator ---------------------------------------
|
78
|
+
void GeneratePrivateMembers(io::Printer* printer) const;
|
79
|
+
void GenerateAccessorDeclarations(io::Printer* printer) const;
|
80
|
+
void GenerateInlineAccessorDefinitions(io::Printer* printer) const;
|
81
|
+
void GenerateClearingCode(io::Printer* printer) const;
|
82
|
+
void GenerateMergingCode(io::Printer* printer) const;
|
83
|
+
void GenerateSwappingCode(io::Printer* printer) const;
|
84
|
+
void GenerateConstructorCode(io::Printer* printer) const;
|
85
|
+
void GenerateMergeFromCodedStream(io::Printer* printer) const;
|
86
|
+
void GenerateMergeFromCodedStreamWithPacking(io::Printer* printer) const;
|
87
|
+
void GenerateSerializeWithCachedSizes(io::Printer* printer) const;
|
88
|
+
void GenerateSerializeWithCachedSizesToArray(io::Printer* printer) const;
|
89
|
+
void GenerateByteSize(io::Printer* printer) const;
|
90
|
+
|
91
|
+
private:
|
92
|
+
const FieldDescriptor* descriptor_;
|
93
|
+
map<string, string> variables_;
|
94
|
+
|
95
|
+
GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(RepeatedEnumFieldGenerator);
|
96
|
+
};
|
97
|
+
|
98
|
+
} // namespace cpp
|
99
|
+
} // namespace compiler
|
100
|
+
} // namespace protobuf
|
101
|
+
|
102
|
+
} // namespace google
|
103
|
+
#endif // GOOGLE_PROTOBUF_COMPILER_CPP_ENUM_FIELD_H__
|