| // Protocol Buffers - Google's data interchange format |
| // Copyright 2008 Google Inc. All rights reserved. |
| // http://code.google.com/p/protobuf/ |
| // |
| // Redistribution and use in source and binary forms, with or without |
| // modification, are permitted provided that the following conditions are |
| // met: |
| // |
| // * Redistributions of source code must retain the above copyright |
| // notice, this list of conditions and the following disclaimer. |
| // * Redistributions in binary form must reproduce the above |
| // copyright notice, this list of conditions and the following disclaimer |
| // in the documentation and/or other materials provided with the |
| // distribution. |
| // * Neither the name of Google Inc. nor the names of its |
| // contributors may be used to endorse or promote products derived from |
| // this software without specific prior written permission. |
| // |
| // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| |
| // Author: kenton@google.com (Kenton Varda) |
| // Based on original Protocol Buffers design by |
| // Sanjay Ghemawat, Jeff Dean, and others. |
| |
| #include <algorithm> |
| #include <google/protobuf/stubs/hash.h> |
| #include <google/protobuf/compiler/java/java_message.h> |
| #include <google/protobuf/compiler/java/java_enum.h> |
| #include <google/protobuf/compiler/java/java_extension.h> |
| #include <google/protobuf/compiler/java/java_helpers.h> |
| #include <google/protobuf/stubs/strutil.h> |
| #include <google/protobuf/io/printer.h> |
| #include <google/protobuf/io/coded_stream.h> |
| #include <google/protobuf/wire_format.h> |
| #include <google/protobuf/descriptor.pb.h> |
| |
| namespace google { |
| namespace protobuf { |
| namespace compiler { |
| namespace java { |
| |
| using internal::WireFormat; |
| using internal::WireFormatLite; |
| |
| namespace { |
| |
| void PrintFieldComment(io::Printer* printer, const FieldDescriptor* field) { |
| // Print the field's proto-syntax definition as a comment. We don't want to |
| // print group bodies so we cut off after the first line. |
| string def = field->DebugString(); |
| printer->Print("// $def$\n", |
| "def", def.substr(0, def.find_first_of('\n'))); |
| } |
| |
| struct FieldOrderingByNumber { |
| inline bool operator()(const FieldDescriptor* a, |
| const FieldDescriptor* b) const { |
| return a->number() < b->number(); |
| } |
| }; |
| |
| struct ExtensionRangeOrdering { |
| bool operator()(const Descriptor::ExtensionRange* a, |
| const Descriptor::ExtensionRange* b) const { |
| return a->start < b->start; |
| } |
| }; |
| |
| // Sort the fields of the given Descriptor by number into a new[]'d array |
| // and return it. |
| const FieldDescriptor** SortFieldsByNumber(const Descriptor* descriptor) { |
| const FieldDescriptor** fields = |
| new const FieldDescriptor*[descriptor->field_count()]; |
| for (int i = 0; i < descriptor->field_count(); i++) { |
| fields[i] = descriptor->field(i); |
| } |
| sort(fields, fields + descriptor->field_count(), |
| FieldOrderingByNumber()); |
| return fields; |
| } |
| |
| // Get an identifier that uniquely identifies this type within the file. |
| // This is used to declare static variables related to this type at the |
| // outermost file scope. |
| string UniqueFileScopeIdentifier(const Descriptor* descriptor) { |
| return "static_" + StringReplace(descriptor->full_name(), ".", "_", true); |
| } |
| |
| // Returns true if the message type has any required fields. If it doesn't, |
| // we can optimize out calls to its isInitialized() method. |
| // |
| // already_seen is used to avoid checking the same type multiple times |
| // (and also to protect against recursion). |
| static bool HasRequiredFields( |
| const Descriptor* type, |
| hash_set<const Descriptor*>* already_seen) { |
| if (already_seen->count(type) > 0) { |
| // The type is already in cache. This means that either: |
| // a. The type has no required fields. |
| // b. We are in the midst of checking if the type has required fields, |
| // somewhere up the stack. In this case, we know that if the type |
| // has any required fields, they'll be found when we return to it, |
| // and the whole call to HasRequiredFields() will return true. |
| // Therefore, we don't have to check if this type has required fields |
| // here. |
| return false; |
| } |
| already_seen->insert(type); |
| |
| // If the type has extensions, an extension with message type could contain |
| // required fields, so we have to be conservative and assume such an |
| // extension exists. |
| if (type->extension_range_count() > 0) return true; |
| |
| for (int i = 0; i < type->field_count(); i++) { |
| const FieldDescriptor* field = type->field(i); |
| if (field->is_required()) { |
| return true; |
| } |
| if (GetJavaType(field) == JAVATYPE_MESSAGE) { |
| if (HasRequiredFields(field->message_type(), already_seen)) { |
| return true; |
| } |
| } |
| } |
| |
| return false; |
| } |
| |
| static bool HasRequiredFields(const Descriptor* type) { |
| hash_set<const Descriptor*> already_seen; |
| return HasRequiredFields(type, &already_seen); |
| } |
| |
| } // namespace |
| |
| // =================================================================== |
| |
| MessageGenerator::MessageGenerator(const Descriptor* descriptor) |
| : descriptor_(descriptor), |
| field_generators_(descriptor) { |
| } |
| |
| MessageGenerator::~MessageGenerator() {} |
| |
| void MessageGenerator::GenerateStaticVariables(io::Printer* printer) { |
| if (HasDescriptorMethods(descriptor_)) { |
| // Because descriptor.proto (com.google.protobuf.DescriptorProtos) is |
| // used in the construction of descriptors, we have a tricky bootstrapping |
| // problem. To help control static initialization order, we make sure all |
| // descriptors and other static data that depends on them are members of |
| // the outermost class in the file. This way, they will be initialized in |
| // a deterministic order. |
| |
| map<string, string> vars; |
| vars["identifier"] = UniqueFileScopeIdentifier(descriptor_); |
| vars["index"] = SimpleItoa(descriptor_->index()); |
| vars["classname"] = ClassName(descriptor_); |
| if (descriptor_->containing_type() != NULL) { |
| vars["parent"] = UniqueFileScopeIdentifier( |
| descriptor_->containing_type()); |
| } |
| if (descriptor_->file()->options().java_multiple_files()) { |
| // We can only make these package-private since the classes that use them |
| // are in separate files. |
| vars["private"] = ""; |
| } else { |
| vars["private"] = "private "; |
| } |
| |
| // The descriptor for this type. |
| printer->Print(vars, |
| "$private$static com.google.protobuf.Descriptors.Descriptor\n" |
| " internal_$identifier$_descriptor;\n"); |
| |
| // And the FieldAccessorTable. |
| printer->Print(vars, |
| "$private$static\n" |
| " com.google.protobuf.GeneratedMessage.FieldAccessorTable\n" |
| " internal_$identifier$_fieldAccessorTable;\n"); |
| } |
| |
| // Generate static members for all nested types. |
| for (int i = 0; i < descriptor_->nested_type_count(); i++) { |
| // TODO(kenton): Reuse MessageGenerator objects? |
| MessageGenerator(descriptor_->nested_type(i)) |
| .GenerateStaticVariables(printer); |
| } |
| } |
| |
| void MessageGenerator::GenerateStaticVariableInitializers( |
| io::Printer* printer) { |
| if (HasDescriptorMethods(descriptor_)) { |
| map<string, string> vars; |
| vars["identifier"] = UniqueFileScopeIdentifier(descriptor_); |
| vars["index"] = SimpleItoa(descriptor_->index()); |
| vars["classname"] = ClassName(descriptor_); |
| if (descriptor_->containing_type() != NULL) { |
| vars["parent"] = UniqueFileScopeIdentifier( |
| descriptor_->containing_type()); |
| } |
| |
| // The descriptor for this type. |
| if (descriptor_->containing_type() == NULL) { |
| printer->Print(vars, |
| "internal_$identifier$_descriptor =\n" |
| " getDescriptor().getMessageTypes().get($index$);\n"); |
| } else { |
| printer->Print(vars, |
| "internal_$identifier$_descriptor =\n" |
| " internal_$parent$_descriptor.getNestedTypes().get($index$);\n"); |
| } |
| |
| // And the FieldAccessorTable. |
| printer->Print(vars, |
| "internal_$identifier$_fieldAccessorTable = new\n" |
| " com.google.protobuf.GeneratedMessage.FieldAccessorTable(\n" |
| " internal_$identifier$_descriptor,\n" |
| " new java.lang.String[] { "); |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| printer->Print( |
| "\"$field_name$\", ", |
| "field_name", |
| UnderscoresToCapitalizedCamelCase(descriptor_->field(i))); |
| } |
| printer->Print("},\n" |
| " $classname$.class,\n" |
| " $classname$.Builder.class);\n", |
| "classname", ClassName(descriptor_)); |
| } |
| |
| // Generate static member initializers for all nested types. |
| for (int i = 0; i < descriptor_->nested_type_count(); i++) { |
| // TODO(kenton): Reuse MessageGenerator objects? |
| MessageGenerator(descriptor_->nested_type(i)) |
| .GenerateStaticVariableInitializers(printer); |
| } |
| } |
| |
| // =================================================================== |
| |
| void MessageGenerator::GenerateInterface(io::Printer* printer) { |
| |
| if (descriptor_->extension_range_count() > 0) { |
| if (HasDescriptorMethods(descriptor_)) { |
| printer->Print( |
| "public interface $classname$OrBuilder extends\n" |
| " com.google.protobuf.GeneratedMessage.\n" |
| " ExtendableMessageOrBuilder<$classname$> {\n", |
| "classname", descriptor_->name()); |
| } else { |
| printer->Print( |
| "public interface $classname$OrBuilder extends \n" |
| " com.google.protobuf.GeneratedMessageLite.\n" |
| " ExtendableMessageOrBuilder<$classname$> {\n", |
| "classname", descriptor_->name()); |
| } |
| } else { |
| if (HasDescriptorMethods(descriptor_)) { |
| printer->Print( |
| "public interface $classname$OrBuilder\n" |
| " extends com.google.protobuf.MessageOrBuilder {\n", |
| "classname", descriptor_->name()); |
| } else { |
| printer->Print( |
| "public interface $classname$OrBuilder\n" |
| " extends com.google.protobuf.MessageLiteOrBuilder {\n", |
| "classname", descriptor_->name()); |
| } |
| } |
| |
| printer->Indent(); |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| printer->Print("\n"); |
| PrintFieldComment(printer, descriptor_->field(i)); |
| field_generators_.get(descriptor_->field(i)) |
| .GenerateInterfaceMembers(printer); |
| } |
| printer->Outdent(); |
| |
| printer->Print("}\n"); |
| } |
| |
| // =================================================================== |
| |
| void MessageGenerator::Generate(io::Printer* printer) { |
| bool is_own_file = |
| descriptor_->containing_type() == NULL && |
| descriptor_->file()->options().java_multiple_files(); |
| |
| if (descriptor_->extension_range_count() > 0) { |
| if (HasDescriptorMethods(descriptor_)) { |
| printer->Print( |
| "public $static$ final class $classname$ extends\n" |
| " com.google.protobuf.GeneratedMessage.ExtendableMessage<\n" |
| " $classname$> implements $classname$OrBuilder {\n", |
| "static", is_own_file ? "" : "static", |
| "classname", descriptor_->name()); |
| } else { |
| printer->Print( |
| "public $static$ final class $classname$ extends\n" |
| " com.google.protobuf.GeneratedMessageLite.ExtendableMessage<\n" |
| " $classname$> implements $classname$OrBuilder {\n", |
| "static", is_own_file ? "" : "static", |
| "classname", descriptor_->name()); |
| } |
| } else { |
| if (HasDescriptorMethods(descriptor_)) { |
| printer->Print( |
| "public $static$ final class $classname$ extends\n" |
| " com.google.protobuf.GeneratedMessage\n" |
| " implements $classname$OrBuilder {\n", |
| "static", is_own_file ? "" : "static", |
| "classname", descriptor_->name()); |
| } else { |
| printer->Print( |
| "public $static$ final class $classname$ extends\n" |
| " com.google.protobuf.GeneratedMessageLite\n" |
| " implements $classname$OrBuilder {\n", |
| "static", is_own_file ? "" : "static", |
| "classname", descriptor_->name()); |
| } |
| } |
| printer->Indent(); |
| printer->Print( |
| "// Use $classname$.newBuilder() to construct.\n" |
| "private $classname$(Builder builder) {\n" |
| " super(builder);\n" |
| "}\n" |
| // Used when constructing the default instance, which cannot be initialized |
| // immediately because it may cyclically refer to other default instances. |
| "private $classname$(boolean noInit) {}\n" |
| "\n" |
| "private static final $classname$ defaultInstance;\n" |
| "public static $classname$ getDefaultInstance() {\n" |
| " return defaultInstance;\n" |
| "}\n" |
| "\n" |
| "public $classname$ getDefaultInstanceForType() {\n" |
| " return defaultInstance;\n" |
| "}\n" |
| "\n", |
| "classname", descriptor_->name()); |
| |
| GenerateDescriptorMethods(printer); |
| |
| // Nested types |
| for (int i = 0; i < descriptor_->enum_type_count(); i++) { |
| EnumGenerator(descriptor_->enum_type(i)).Generate(printer); |
| } |
| |
| for (int i = 0; i < descriptor_->nested_type_count(); i++) { |
| MessageGenerator messageGenerator(descriptor_->nested_type(i)); |
| messageGenerator.GenerateInterface(printer); |
| messageGenerator.Generate(printer); |
| } |
| |
| // Integers for bit fields. |
| int totalBits = 0; |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| totalBits += field_generators_.get(descriptor_->field(i)) |
| .GetNumBitsForMessage(); |
| } |
| int totalInts = (totalBits + 31) / 32; |
| for (int i = 0; i < totalInts; i++) { |
| printer->Print("private int $bit_field_name$;\n", |
| "bit_field_name", GetBitFieldName(i)); |
| } |
| |
| // Fields |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| PrintFieldComment(printer, descriptor_->field(i)); |
| printer->Print("public static final int $constant_name$ = $number$;\n", |
| "constant_name", FieldConstantName(descriptor_->field(i)), |
| "number", SimpleItoa(descriptor_->field(i)->number())); |
| field_generators_.get(descriptor_->field(i)).GenerateMembers(printer); |
| printer->Print("\n"); |
| } |
| |
| // Called by the constructor, except in the case of the default instance, |
| // in which case this is called by static init code later on. |
| printer->Print("private void initFields() {\n"); |
| printer->Indent(); |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| field_generators_.get(descriptor_->field(i)) |
| .GenerateInitializationCode(printer); |
| } |
| printer->Outdent(); |
| printer->Print("}\n"); |
| |
| if (HasGeneratedMethods(descriptor_)) { |
| GenerateIsInitialized(printer, MEMOIZE); |
| GenerateMessageSerializationMethods(printer); |
| } |
| |
| if (HasEqualsAndHashCode(descriptor_)) { |
| GenerateEqualsAndHashCode(printer); |
| } |
| |
| GenerateParseFromMethods(printer); |
| GenerateBuilder(printer); |
| |
| // Carefully initialize the default instance in such a way that it doesn't |
| // conflict with other initialization. |
| printer->Print( |
| "\n" |
| "static {\n" |
| " defaultInstance = new $classname$(true);\n" |
| " defaultInstance.initFields();\n" |
| "}\n" |
| "\n" |
| "// @@protoc_insertion_point(class_scope:$full_name$)\n", |
| "classname", descriptor_->name(), |
| "full_name", descriptor_->full_name()); |
| |
| // Extensions must be declared after the defaultInstance is initialized |
| // because the defaultInstance is used by the extension to lazily retrieve |
| // the outer class's FileDescriptor. |
| for (int i = 0; i < descriptor_->extension_count(); i++) { |
| ExtensionGenerator(descriptor_->extension(i)).Generate(printer); |
| } |
| |
| printer->Outdent(); |
| printer->Print("}\n\n"); |
| } |
| |
| |
| // =================================================================== |
| |
| void MessageGenerator:: |
| GenerateMessageSerializationMethods(io::Printer* printer) { |
| scoped_array<const FieldDescriptor*> sorted_fields( |
| SortFieldsByNumber(descriptor_)); |
| |
| vector<const Descriptor::ExtensionRange*> sorted_extensions; |
| for (int i = 0; i < descriptor_->extension_range_count(); ++i) { |
| sorted_extensions.push_back(descriptor_->extension_range(i)); |
| } |
| sort(sorted_extensions.begin(), sorted_extensions.end(), |
| ExtensionRangeOrdering()); |
| |
| printer->Print( |
| "public void writeTo(com.google.protobuf.CodedOutputStream output)\n" |
| " throws java.io.IOException {\n"); |
| printer->Indent(); |
| // writeTo(CodedOutputStream output) might be invoked without |
| // getSerializedSize() ever being called, but we need the memoized |
| // sizes in case this message has packed fields. Rather than emit checks for |
| // each packed field, just call getSerializedSize() up front for all messages. |
| // In most cases, getSerializedSize() will have already been called anyway by |
| // one of the wrapper writeTo() methods, making this call cheap. |
| printer->Print( |
| "getSerializedSize();\n"); |
| |
| if (descriptor_->extension_range_count() > 0) { |
| if (descriptor_->options().message_set_wire_format()) { |
| printer->Print( |
| "com.google.protobuf.GeneratedMessage$lite$\n" |
| " .ExtendableMessage<$classname$>.ExtensionWriter extensionWriter =\n" |
| " newMessageSetExtensionWriter();\n", |
| "lite", HasDescriptorMethods(descriptor_) ? "" : "Lite", |
| "classname", ClassName(descriptor_)); |
| } else { |
| printer->Print( |
| "com.google.protobuf.GeneratedMessage$lite$\n" |
| " .ExtendableMessage<$classname$>.ExtensionWriter extensionWriter =\n" |
| " newExtensionWriter();\n", |
| "lite", HasDescriptorMethods(descriptor_) ? "" : "Lite", |
| "classname", ClassName(descriptor_)); |
| } |
| } |
| |
| // Merge the fields and the extension ranges, both sorted by field number. |
| for (int i = 0, j = 0; |
| i < descriptor_->field_count() || j < sorted_extensions.size(); |
| ) { |
| if (i == descriptor_->field_count()) { |
| GenerateSerializeOneExtensionRange(printer, sorted_extensions[j++]); |
| } else if (j == sorted_extensions.size()) { |
| GenerateSerializeOneField(printer, sorted_fields[i++]); |
| } else if (sorted_fields[i]->number() < sorted_extensions[j]->start) { |
| GenerateSerializeOneField(printer, sorted_fields[i++]); |
| } else { |
| GenerateSerializeOneExtensionRange(printer, sorted_extensions[j++]); |
| } |
| } |
| |
| if (HasUnknownFields(descriptor_)) { |
| if (descriptor_->options().message_set_wire_format()) { |
| printer->Print( |
| "getUnknownFields().writeAsMessageSetTo(output);\n"); |
| } else { |
| printer->Print( |
| "getUnknownFields().writeTo(output);\n"); |
| } |
| } |
| |
| printer->Outdent(); |
| printer->Print( |
| "}\n" |
| "\n" |
| "private int memoizedSerializedSize = -1;\n" |
| "public int getSerializedSize() {\n" |
| " int size = memoizedSerializedSize;\n" |
| " if (size != -1) return size;\n" |
| "\n" |
| " size = 0;\n"); |
| printer->Indent(); |
| |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| field_generators_.get(sorted_fields[i]).GenerateSerializedSizeCode(printer); |
| } |
| |
| if (descriptor_->extension_range_count() > 0) { |
| if (descriptor_->options().message_set_wire_format()) { |
| printer->Print( |
| "size += extensionsSerializedSizeAsMessageSet();\n"); |
| } else { |
| printer->Print( |
| "size += extensionsSerializedSize();\n"); |
| } |
| } |
| |
| if (HasUnknownFields(descriptor_)) { |
| if (descriptor_->options().message_set_wire_format()) { |
| printer->Print( |
| "size += getUnknownFields().getSerializedSizeAsMessageSet();\n"); |
| } else { |
| printer->Print( |
| "size += getUnknownFields().getSerializedSize();\n"); |
| } |
| } |
| |
| printer->Outdent(); |
| printer->Print( |
| " memoizedSerializedSize = size;\n" |
| " return size;\n" |
| "}\n" |
| "\n"); |
| |
| printer->Print( |
| "private static final long serialVersionUID = 0L;\n" |
| "@java.lang.Override\n" |
| "protected java.lang.Object writeReplace()\n" |
| " throws java.io.ObjectStreamException {\n" |
| " return super.writeReplace();\n" |
| "}\n" |
| "\n"); |
| } |
| |
| void MessageGenerator:: |
| GenerateParseFromMethods(io::Printer* printer) { |
| // Note: These are separate from GenerateMessageSerializationMethods() |
| // because they need to be generated even for messages that are optimized |
| // for code size. |
| printer->Print( |
| "public static $classname$ parseFrom(\n" |
| " com.google.protobuf.ByteString data)\n" |
| " throws com.google.protobuf.InvalidProtocolBufferException {\n" |
| " return newBuilder().mergeFrom(data).buildParsed();\n" |
| "}\n" |
| "public static $classname$ parseFrom(\n" |
| " com.google.protobuf.ByteString data,\n" |
| " com.google.protobuf.ExtensionRegistryLite extensionRegistry)\n" |
| " throws com.google.protobuf.InvalidProtocolBufferException {\n" |
| " return newBuilder().mergeFrom(data, extensionRegistry)\n" |
| " .buildParsed();\n" |
| "}\n" |
| "public static $classname$ parseFrom(byte[] data)\n" |
| " throws com.google.protobuf.InvalidProtocolBufferException {\n" |
| " return newBuilder().mergeFrom(data).buildParsed();\n" |
| "}\n" |
| "public static $classname$ parseFrom(\n" |
| " byte[] data,\n" |
| " com.google.protobuf.ExtensionRegistryLite extensionRegistry)\n" |
| " throws com.google.protobuf.InvalidProtocolBufferException {\n" |
| " return newBuilder().mergeFrom(data, extensionRegistry)\n" |
| " .buildParsed();\n" |
| "}\n" |
| "public static $classname$ parseFrom(java.io.InputStream input)\n" |
| " throws java.io.IOException {\n" |
| " return newBuilder().mergeFrom(input).buildParsed();\n" |
| "}\n" |
| "public static $classname$ parseFrom(\n" |
| " java.io.InputStream input,\n" |
| " com.google.protobuf.ExtensionRegistryLite extensionRegistry)\n" |
| " throws java.io.IOException {\n" |
| " return newBuilder().mergeFrom(input, extensionRegistry)\n" |
| " .buildParsed();\n" |
| "}\n" |
| "public static $classname$ parseDelimitedFrom(java.io.InputStream input)\n" |
| " throws java.io.IOException {\n" |
| " Builder builder = newBuilder();\n" |
| " if (builder.mergeDelimitedFrom(input)) {\n" |
| " return builder.buildParsed();\n" |
| " } else {\n" |
| " return null;\n" |
| " }\n" |
| "}\n" |
| "public static $classname$ parseDelimitedFrom(\n" |
| " java.io.InputStream input,\n" |
| " com.google.protobuf.ExtensionRegistryLite extensionRegistry)\n" |
| " throws java.io.IOException {\n" |
| " Builder builder = newBuilder();\n" |
| " if (builder.mergeDelimitedFrom(input, extensionRegistry)) {\n" |
| " return builder.buildParsed();\n" |
| " } else {\n" |
| " return null;\n" |
| " }\n" |
| "}\n" |
| "public static $classname$ parseFrom(\n" |
| " com.google.protobuf.CodedInputStream input)\n" |
| " throws java.io.IOException {\n" |
| " return newBuilder().mergeFrom(input).buildParsed();\n" |
| "}\n" |
| "public static $classname$ parseFrom(\n" |
| " com.google.protobuf.CodedInputStream input,\n" |
| " com.google.protobuf.ExtensionRegistryLite extensionRegistry)\n" |
| " throws java.io.IOException {\n" |
| " return newBuilder().mergeFrom(input, extensionRegistry)\n" |
| " .buildParsed();\n" |
| "}\n" |
| "\n", |
| "classname", ClassName(descriptor_)); |
| } |
| |
| void MessageGenerator::GenerateSerializeOneField( |
| io::Printer* printer, const FieldDescriptor* field) { |
| field_generators_.get(field).GenerateSerializationCode(printer); |
| } |
| |
| void MessageGenerator::GenerateSerializeOneExtensionRange( |
| io::Printer* printer, const Descriptor::ExtensionRange* range) { |
| printer->Print( |
| "extensionWriter.writeUntil($end$, output);\n", |
| "end", SimpleItoa(range->end)); |
| } |
| |
| // =================================================================== |
| |
| void MessageGenerator::GenerateBuilder(io::Printer* printer) { |
| printer->Print( |
| "public static Builder newBuilder() { return Builder.create(); }\n" |
| "public Builder newBuilderForType() { return newBuilder(); }\n" |
| "public static Builder newBuilder($classname$ prototype) {\n" |
| " return newBuilder().mergeFrom(prototype);\n" |
| "}\n" |
| "public Builder toBuilder() { return newBuilder(this); }\n" |
| "\n", |
| "classname", ClassName(descriptor_)); |
| |
| if (HasNestedBuilders(descriptor_)) { |
| printer->Print( |
| "@java.lang.Override\n" |
| "protected Builder newBuilderForType(\n" |
| " com.google.protobuf.GeneratedMessage.BuilderParent parent) {\n" |
| " Builder builder = new Builder(parent);\n" |
| " return builder;\n" |
| "}\n"); |
| } |
| |
| if (descriptor_->extension_range_count() > 0) { |
| if (HasDescriptorMethods(descriptor_)) { |
| printer->Print( |
| "public static final class Builder extends\n" |
| " com.google.protobuf.GeneratedMessage.ExtendableBuilder<\n" |
| " $classname$, Builder> implements $classname$OrBuilder {\n", |
| "classname", ClassName(descriptor_)); |
| } else { |
| printer->Print( |
| "public static final class Builder extends\n" |
| " com.google.protobuf.GeneratedMessageLite.ExtendableBuilder<\n" |
| " $classname$, Builder> implements $classname$OrBuilder {\n", |
| "classname", ClassName(descriptor_)); |
| } |
| } else { |
| if (HasDescriptorMethods(descriptor_)) { |
| printer->Print( |
| "public static final class Builder extends\n" |
| " com.google.protobuf.GeneratedMessage.Builder<Builder>\n" |
| " implements $classname$OrBuilder {\n", |
| "classname", ClassName(descriptor_)); |
| } else { |
| printer->Print( |
| "public static final class Builder extends\n" |
| " com.google.protobuf.GeneratedMessageLite.Builder<\n" |
| " $classname$, Builder>\n" |
| " implements $classname$OrBuilder {\n", |
| "classname", ClassName(descriptor_)); |
| } |
| } |
| printer->Indent(); |
| |
| GenerateDescriptorMethods(printer); |
| GenerateCommonBuilderMethods(printer); |
| |
| if (HasGeneratedMethods(descriptor_)) { |
| GenerateIsInitialized(printer, DONT_MEMOIZE); |
| GenerateBuilderParsingMethods(printer); |
| } |
| |
| // Integers for bit fields. |
| int totalBits = 0; |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| totalBits += field_generators_.get(descriptor_->field(i)) |
| .GetNumBitsForBuilder(); |
| } |
| int totalInts = (totalBits + 31) / 32; |
| for (int i = 0; i < totalInts; i++) { |
| printer->Print("private int $bit_field_name$;\n", |
| "bit_field_name", GetBitFieldName(i)); |
| } |
| |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| printer->Print("\n"); |
| PrintFieldComment(printer, descriptor_->field(i)); |
| field_generators_.get(descriptor_->field(i)) |
| .GenerateBuilderMembers(printer); |
| } |
| |
| printer->Print( |
| "\n" |
| "// @@protoc_insertion_point(builder_scope:$full_name$)\n", |
| "full_name", descriptor_->full_name()); |
| |
| printer->Outdent(); |
| printer->Print("}\n"); |
| } |
| |
| void MessageGenerator::GenerateDescriptorMethods(io::Printer* printer) { |
| if (HasDescriptorMethods(descriptor_)) { |
| printer->Print( |
| "public static final com.google.protobuf.Descriptors.Descriptor\n" |
| " getDescriptor() {\n" |
| " return $fileclass$.internal_$identifier$_descriptor;\n" |
| "}\n" |
| "\n" |
| "protected com.google.protobuf.GeneratedMessage.FieldAccessorTable\n" |
| " internalGetFieldAccessorTable() {\n" |
| " return $fileclass$.internal_$identifier$_fieldAccessorTable;\n" |
| "}\n" |
| "\n", |
| "fileclass", ClassName(descriptor_->file()), |
| "identifier", UniqueFileScopeIdentifier(descriptor_)); |
| } |
| } |
| |
| // =================================================================== |
| |
| void MessageGenerator::GenerateCommonBuilderMethods(io::Printer* printer) { |
| printer->Print( |
| "// Construct using $classname$.newBuilder()\n" |
| "private Builder() {\n" |
| " maybeForceBuilderInitialization();\n" |
| "}\n" |
| "\n", |
| "classname", ClassName(descriptor_)); |
| |
| if (HasDescriptorMethods(descriptor_)) { |
| printer->Print( |
| "private Builder(BuilderParent parent) {\n" |
| " super(parent);\n" |
| " maybeForceBuilderInitialization();\n" |
| "}\n", |
| "classname", ClassName(descriptor_)); |
| } |
| |
| |
| if (HasNestedBuilders(descriptor_)) { |
| printer->Print( |
| "private void maybeForceBuilderInitialization() {\n" |
| " if (com.google.protobuf.GeneratedMessage.alwaysUseFieldBuilders) {\n"); |
| |
| printer->Indent(); |
| printer->Indent(); |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| field_generators_.get(descriptor_->field(i)) |
| .GenerateFieldBuilderInitializationCode(printer); |
| } |
| printer->Outdent(); |
| printer->Outdent(); |
| |
| printer->Print( |
| " }\n" |
| "}\n"); |
| } else { |
| printer->Print( |
| "private void maybeForceBuilderInitialization() {\n" |
| "}\n"); |
| } |
| |
| printer->Print( |
| "private static Builder create() {\n" |
| " return new Builder();\n" |
| "}\n" |
| "\n" |
| "public Builder clear() {\n" |
| " super.clear();\n", |
| "classname", ClassName(descriptor_)); |
| |
| printer->Indent(); |
| |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| field_generators_.get(descriptor_->field(i)) |
| .GenerateBuilderClearCode(printer); |
| } |
| |
| printer->Outdent(); |
| |
| printer->Print( |
| " return this;\n" |
| "}\n" |
| "\n" |
| "public Builder clone() {\n" |
| " return create().mergeFrom(buildPartial());\n" |
| "}\n" |
| "\n", |
| "classname", ClassName(descriptor_)); |
| if (HasDescriptorMethods(descriptor_)) { |
| printer->Print( |
| "public com.google.protobuf.Descriptors.Descriptor\n" |
| " getDescriptorForType() {\n" |
| " return $classname$.getDescriptor();\n" |
| "}\n" |
| "\n", |
| "classname", ClassName(descriptor_)); |
| } |
| printer->Print( |
| "public $classname$ getDefaultInstanceForType() {\n" |
| " return $classname$.getDefaultInstance();\n" |
| "}\n" |
| "\n", |
| "classname", ClassName(descriptor_)); |
| |
| // ----------------------------------------------------------------- |
| |
| printer->Print( |
| "public $classname$ build() {\n" |
| " $classname$ result = buildPartial();\n" |
| " if (!result.isInitialized()) {\n" |
| " throw newUninitializedMessageException(result);\n" |
| " }\n" |
| " return result;\n" |
| "}\n" |
| "\n" |
| "private $classname$ buildParsed()\n" |
| " throws com.google.protobuf.InvalidProtocolBufferException {\n" |
| " $classname$ result = buildPartial();\n" |
| " if (!result.isInitialized()) {\n" |
| " throw newUninitializedMessageException(\n" |
| " result).asInvalidProtocolBufferException();\n" |
| " }\n" |
| " return result;\n" |
| "}\n" |
| "\n" |
| "public $classname$ buildPartial() {\n" |
| " $classname$ result = new $classname$(this);\n", |
| "classname", ClassName(descriptor_)); |
| |
| printer->Indent(); |
| |
| // Local vars for from and to bit fields to avoid accessing the builder and |
| // message over and over for these fields. Seems to provide a slight |
| // perforamance improvement in micro benchmark and this is also what proto1 |
| // code does. |
| int totalBuilderBits = 0; |
| int totalMessageBits = 0; |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| const FieldGenerator& field = field_generators_.get(descriptor_->field(i)); |
| totalBuilderBits += field.GetNumBitsForBuilder(); |
| totalMessageBits += field.GetNumBitsForMessage(); |
| } |
| int totalBuilderInts = (totalBuilderBits + 31) / 32; |
| int totalMessageInts = (totalMessageBits + 31) / 32; |
| for (int i = 0; i < totalBuilderInts; i++) { |
| printer->Print("int from_$bit_field_name$ = $bit_field_name$;\n", |
| "bit_field_name", GetBitFieldName(i)); |
| } |
| for (int i = 0; i < totalMessageInts; i++) { |
| printer->Print("int to_$bit_field_name$ = 0;\n", |
| "bit_field_name", GetBitFieldName(i)); |
| } |
| |
| // Output generation code for each field. |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| field_generators_.get(descriptor_->field(i)).GenerateBuildingCode(printer); |
| } |
| |
| // Copy the bit field results to the generated message |
| for (int i = 0; i < totalMessageInts; i++) { |
| printer->Print("result.$bit_field_name$ = to_$bit_field_name$;\n", |
| "bit_field_name", GetBitFieldName(i)); |
| } |
| |
| printer->Outdent(); |
| |
| if (HasDescriptorMethods(descriptor_)) { |
| printer->Print( |
| " onBuilt();\n"); |
| } |
| |
| printer->Print( |
| " return result;\n" |
| "}\n" |
| "\n", |
| "classname", ClassName(descriptor_)); |
| |
| // ----------------------------------------------------------------- |
| |
| if (HasGeneratedMethods(descriptor_)) { |
| // MergeFrom(Message other) requires the ability to distinguish the other |
| // messages type by its descriptor. |
| if (HasDescriptorMethods(descriptor_)) { |
| printer->Print( |
| "public Builder mergeFrom(com.google.protobuf.Message other) {\n" |
| " if (other instanceof $classname$) {\n" |
| " return mergeFrom(($classname$)other);\n" |
| " } else {\n" |
| " super.mergeFrom(other);\n" |
| " return this;\n" |
| " }\n" |
| "}\n" |
| "\n", |
| "classname", ClassName(descriptor_)); |
| } |
| |
| printer->Print( |
| "public Builder mergeFrom($classname$ other) {\n" |
| // Optimization: If other is the default instance, we know none of its |
| // fields are set so we can skip the merge. |
| " if (other == $classname$.getDefaultInstance()) return this;\n", |
| "classname", ClassName(descriptor_)); |
| printer->Indent(); |
| |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| field_generators_.get(descriptor_->field(i)).GenerateMergingCode(printer); |
| } |
| |
| printer->Outdent(); |
| |
| // if message type has extensions |
| if (descriptor_->extension_range_count() > 0) { |
| printer->Print( |
| " this.mergeExtensionFields(other);\n"); |
| } |
| |
| if (HasUnknownFields(descriptor_)) { |
| printer->Print( |
| " this.mergeUnknownFields(other.getUnknownFields());\n"); |
| } |
| |
| printer->Print( |
| " return this;\n" |
| "}\n" |
| "\n"); |
| } |
| } |
| |
| // =================================================================== |
| |
| void MessageGenerator::GenerateBuilderParsingMethods(io::Printer* printer) { |
| scoped_array<const FieldDescriptor*> sorted_fields( |
| SortFieldsByNumber(descriptor_)); |
| |
| printer->Print( |
| "public Builder mergeFrom(\n" |
| " com.google.protobuf.CodedInputStream input,\n" |
| " com.google.protobuf.ExtensionRegistryLite extensionRegistry)\n" |
| " throws java.io.IOException {\n"); |
| printer->Indent(); |
| |
| if (HasUnknownFields(descriptor_)) { |
| printer->Print( |
| "com.google.protobuf.UnknownFieldSet.Builder unknownFields =\n" |
| " com.google.protobuf.UnknownFieldSet.newBuilder(\n" |
| " this.getUnknownFields());\n"); |
| } |
| |
| printer->Print( |
| "while (true) {\n"); |
| printer->Indent(); |
| |
| printer->Print( |
| "int tag = input.readTag();\n" |
| "switch (tag) {\n"); |
| printer->Indent(); |
| |
| if (HasUnknownFields(descriptor_)) { |
| printer->Print( |
| "case 0:\n" // zero signals EOF / limit reached |
| " this.setUnknownFields(unknownFields.build());\n" |
| " $on_changed$\n" |
| " return this;\n" |
| "default: {\n" |
| " if (!parseUnknownField(input, unknownFields,\n" |
| " extensionRegistry, tag)) {\n" |
| " this.setUnknownFields(unknownFields.build());\n" |
| " $on_changed$\n" |
| " return this;\n" // it's an endgroup tag |
| " }\n" |
| " break;\n" |
| "}\n", |
| "on_changed", HasDescriptorMethods(descriptor_) ? "onChanged();" : ""); |
| } else { |
| printer->Print( |
| "case 0:\n" // zero signals EOF / limit reached |
| " $on_changed$\n" |
| " return this;\n" |
| "default: {\n" |
| " if (!parseUnknownField(input, extensionRegistry, tag)) {\n" |
| " $on_changed$\n" |
| " return this;\n" // it's an endgroup tag |
| " }\n" |
| " break;\n" |
| "}\n", |
| "on_changed", HasDescriptorMethods(descriptor_) ? "onChanged();" : ""); |
| } |
| |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| const FieldDescriptor* field = sorted_fields[i]; |
| uint32 tag = WireFormatLite::MakeTag(field->number(), |
| WireFormat::WireTypeForFieldType(field->type())); |
| |
| printer->Print( |
| "case $tag$: {\n", |
| "tag", SimpleItoa(tag)); |
| printer->Indent(); |
| |
| field_generators_.get(field).GenerateParsingCode(printer); |
| |
| printer->Outdent(); |
| printer->Print( |
| " break;\n" |
| "}\n"); |
| |
| if (field->is_packable()) { |
| // To make packed = true wire compatible, we generate parsing code from a |
| // packed version of this field regardless of field->options().packed(). |
| uint32 packed_tag = WireFormatLite::MakeTag(field->number(), |
| WireFormatLite::WIRETYPE_LENGTH_DELIMITED); |
| printer->Print( |
| "case $tag$: {\n", |
| "tag", SimpleItoa(packed_tag)); |
| printer->Indent(); |
| |
| field_generators_.get(field).GenerateParsingCodeFromPacked(printer); |
| |
| printer->Outdent(); |
| printer->Print( |
| " break;\n" |
| "}\n"); |
| } |
| } |
| |
| printer->Outdent(); |
| printer->Outdent(); |
| printer->Outdent(); |
| printer->Print( |
| " }\n" // switch (tag) |
| " }\n" // while (true) |
| "}\n" |
| |
| "\n"); |
| } |
| |
| // =================================================================== |
| |
| void MessageGenerator::GenerateIsInitialized( |
| io::Printer* printer, UseMemoization useMemoization) { |
| bool memoization = useMemoization == MEMOIZE; |
| if (memoization) { |
| // Memoizes whether the protocol buffer is fully initialized (has all |
| // required fields). -1 means not yet computed. 0 means false and 1 means |
| // true. |
| printer->Print( |
| "private byte memoizedIsInitialized = -1;\n"); |
| } |
| printer->Print( |
| "public final boolean isInitialized() {\n"); |
| printer->Indent(); |
| |
| if (memoization) { |
| printer->Print( |
| "byte isInitialized = memoizedIsInitialized;\n" |
| "if (isInitialized != -1) return isInitialized == 1;\n" |
| "\n"); |
| } |
| |
| // Check that all required fields in this message are set. |
| // TODO(kenton): We can optimize this when we switch to putting all the |
| // "has" fields into a single bitfield. |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| const FieldDescriptor* field = descriptor_->field(i); |
| |
| if (field->is_required()) { |
| printer->Print( |
| "if (!has$name$()) {\n" |
| " $memoize$\n" |
| " return false;\n" |
| "}\n", |
| "name", UnderscoresToCapitalizedCamelCase(field), |
| "memoize", memoization ? "memoizedIsInitialized = 0;" : ""); |
| } |
| } |
| |
| // Now check that all embedded messages are initialized. |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| const FieldDescriptor* field = descriptor_->field(i); |
| if (GetJavaType(field) == JAVATYPE_MESSAGE && |
| HasRequiredFields(field->message_type())) { |
| switch (field->label()) { |
| case FieldDescriptor::LABEL_REQUIRED: |
| printer->Print( |
| "if (!get$name$().isInitialized()) {\n" |
| " $memoize$\n" |
| " return false;\n" |
| "}\n", |
| "type", ClassName(field->message_type()), |
| "name", UnderscoresToCapitalizedCamelCase(field), |
| "memoize", memoization ? "memoizedIsInitialized = 0;" : ""); |
| break; |
| case FieldDescriptor::LABEL_OPTIONAL: |
| printer->Print( |
| "if (has$name$()) {\n" |
| " if (!get$name$().isInitialized()) {\n" |
| " $memoize$\n" |
| " return false;\n" |
| " }\n" |
| "}\n", |
| "type", ClassName(field->message_type()), |
| "name", UnderscoresToCapitalizedCamelCase(field), |
| "memoize", memoization ? "memoizedIsInitialized = 0;" : ""); |
| break; |
| case FieldDescriptor::LABEL_REPEATED: |
| printer->Print( |
| "for (int i = 0; i < get$name$Count(); i++) {\n" |
| " if (!get$name$(i).isInitialized()) {\n" |
| " $memoize$\n" |
| " return false;\n" |
| " }\n" |
| "}\n", |
| "type", ClassName(field->message_type()), |
| "name", UnderscoresToCapitalizedCamelCase(field), |
| "memoize", memoization ? "memoizedIsInitialized = 0;" : ""); |
| break; |
| } |
| } |
| } |
| |
| if (descriptor_->extension_range_count() > 0) { |
| printer->Print( |
| "if (!extensionsAreInitialized()) {\n" |
| " $memoize$\n" |
| " return false;\n" |
| "}\n", |
| "memoize", memoization ? "memoizedIsInitialized = 0;" : ""); |
| } |
| |
| printer->Outdent(); |
| |
| if (memoization) { |
| printer->Print( |
| " memoizedIsInitialized = 1;\n"); |
| } |
| |
| printer->Print( |
| " return true;\n" |
| "}\n" |
| "\n"); |
| } |
| |
| // =================================================================== |
| |
| void MessageGenerator::GenerateEqualsAndHashCode(io::Printer* printer) { |
| printer->Print( |
| "@java.lang.Override\n" |
| "public boolean equals(final java.lang.Object obj) {\n"); |
| printer->Indent(); |
| printer->Print( |
| "if (obj == this) {\n" |
| " return true;\n" |
| "}\n" |
| "if (!(obj instanceof $classname$)) {\n" |
| " return super.equals(obj);\n" |
| "}\n" |
| "$classname$ other = ($classname$) obj;\n" |
| "\n", |
| "classname", ClassName(descriptor_)); |
| |
| printer->Print("boolean result = true;\n"); |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| const FieldDescriptor* field = descriptor_->field(i); |
| if (!field->is_repeated()) { |
| printer->Print( |
| "result = result && (has$name$() == other.has$name$());\n" |
| "if (has$name$()) {\n", |
| "name", UnderscoresToCapitalizedCamelCase(field)); |
| printer->Indent(); |
| } |
| field_generators_.get(field).GenerateEqualsCode(printer); |
| if (!field->is_repeated()) { |
| printer->Outdent(); |
| printer->Print( |
| "}\n"); |
| } |
| } |
| if (HasDescriptorMethods(descriptor_)) { |
| printer->Print( |
| "result = result &&\n" |
| " getUnknownFields().equals(other.getUnknownFields());\n"); |
| if (descriptor_->extension_range_count() > 0) { |
| printer->Print( |
| "result = result &&\n" |
| " getExtensionFields().equals(other.getExtensionFields());\n"); |
| } |
| } |
| printer->Print( |
| "return result;\n"); |
| printer->Outdent(); |
| printer->Print( |
| "}\n" |
| "\n"); |
| |
| printer->Print( |
| "@java.lang.Override\n" |
| "public int hashCode() {\n"); |
| printer->Indent(); |
| printer->Print( |
| "int hash = 41;\n" |
| "hash = (19 * hash) + getDescriptorForType().hashCode();\n"); |
| for (int i = 0; i < descriptor_->field_count(); i++) { |
| const FieldDescriptor* field = descriptor_->field(i); |
| if (!field->is_repeated()) { |
| printer->Print( |
| "if (has$name$()) {\n", |
| "name", UnderscoresToCapitalizedCamelCase(field)); |
| printer->Indent(); |
| } |
| field_generators_.get(field).GenerateHashCode(printer); |
| if (!field->is_repeated()) { |
| printer->Outdent(); |
| printer->Print("}\n"); |
| } |
| } |
| if (HasDescriptorMethods(descriptor_)) { |
| if (descriptor_->extension_range_count() > 0) { |
| printer->Print( |
| "hash = hashFields(hash, getExtensionFields());\n"); |
| } |
| } |
| printer->Print( |
| "hash = (29 * hash) + getUnknownFields().hashCode();\n" |
| "return hash;\n"); |
| printer->Outdent(); |
| printer->Print( |
| "}\n" |
| "\n"); |
| } |
| |
| // =================================================================== |
| |
| void MessageGenerator::GenerateExtensionRegistrationCode(io::Printer* printer) { |
| for (int i = 0; i < descriptor_->extension_count(); i++) { |
| ExtensionGenerator(descriptor_->extension(i)) |
| .GenerateRegistrationCode(printer); |
| } |
| |
| for (int i = 0; i < descriptor_->nested_type_count(); i++) { |
| MessageGenerator(descriptor_->nested_type(i)) |
| .GenerateExtensionRegistrationCode(printer); |
| } |
| } |
| |
| } // namespace java |
| } // namespace compiler |
| } // namespace protobuf |
| } // namespace google |