Index: third_party/protobuf/csharp/src/Google.Protobuf/Reflection/MessageDescriptor.cs |
diff --git a/third_party/protobuf/csharp/src/Google.Protobuf/Reflection/MessageDescriptor.cs b/third_party/protobuf/csharp/src/Google.Protobuf/Reflection/MessageDescriptor.cs |
new file mode 100644 |
index 0000000000000000000000000000000000000000..82901f1b2b1b452b761e6b6e678d0c7db374d1b9 |
--- /dev/null |
+++ b/third_party/protobuf/csharp/src/Google.Protobuf/Reflection/MessageDescriptor.cs |
@@ -0,0 +1,299 @@ |
+#region Copyright notice and license |
+// Protocol Buffers - Google's data interchange format |
+// Copyright 2008 Google Inc. All rights reserved. |
+// https://developers.google.com/protocol-buffers/ |
+// |
+// 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. |
+#endregion |
+ |
+using System; |
+using System.Collections.Generic; |
+using System.Collections.ObjectModel; |
+using System.Linq; |
+ |
+namespace Google.Protobuf.Reflection |
+{ |
+ /// <summary> |
+ /// Describes a message type. |
+ /// </summary> |
+ public sealed class MessageDescriptor : DescriptorBase |
+ { |
+ private static readonly HashSet<string> WellKnownTypeNames = new HashSet<string> |
+ { |
+ "google/protobuf/any.proto", |
+ "google/protobuf/api.proto", |
+ "google/protobuf/duration.proto", |
+ "google/protobuf/empty.proto", |
+ "google/protobuf/wrappers.proto", |
+ "google/protobuf/timestamp.proto", |
+ "google/protobuf/field_mask.proto", |
+ "google/protobuf/source_context.proto", |
+ "google/protobuf/struct.proto", |
+ "google/protobuf/type.proto", |
+ }; |
+ |
+ private readonly DescriptorProto proto; |
+ private readonly MessageDescriptor containingType; |
+ private readonly IList<MessageDescriptor> nestedTypes; |
+ private readonly IList<EnumDescriptor> enumTypes; |
+ private readonly IList<FieldDescriptor> fieldsInDeclarationOrder; |
+ private readonly IList<FieldDescriptor> fieldsInNumberOrder; |
+ private readonly FieldCollection fields; |
+ private readonly IList<OneofDescriptor> oneofs; |
+ // CLR representation of the type described by this descriptor, if any. |
+ private readonly Type generatedType; |
+ |
+ internal MessageDescriptor(DescriptorProto proto, FileDescriptor file, MessageDescriptor parent, int typeIndex, GeneratedCodeInfo generatedCodeInfo) |
+ : base(file, file.ComputeFullName(parent, proto.Name), typeIndex) |
+ { |
+ this.proto = proto; |
+ generatedType = generatedCodeInfo == null ? null : generatedCodeInfo.ClrType; |
+ |
+ containingType = parent; |
+ |
+ oneofs = DescriptorUtil.ConvertAndMakeReadOnly( |
+ proto.OneofDecl, |
+ (oneof, index) => |
+ new OneofDescriptor(oneof, file, this, index, generatedCodeInfo == null ? null : generatedCodeInfo.OneofNames[index])); |
+ |
+ nestedTypes = DescriptorUtil.ConvertAndMakeReadOnly( |
+ proto.NestedType, |
+ (type, index) => |
+ new MessageDescriptor(type, file, this, index, generatedCodeInfo == null ? null : generatedCodeInfo.NestedTypes[index])); |
+ |
+ enumTypes = DescriptorUtil.ConvertAndMakeReadOnly( |
+ proto.EnumType, |
+ (type, index) => |
+ new EnumDescriptor(type, file, this, index, generatedCodeInfo == null ? null : generatedCodeInfo.NestedEnums[index])); |
+ |
+ fieldsInDeclarationOrder = DescriptorUtil.ConvertAndMakeReadOnly( |
+ proto.Field, |
+ (field, index) => |
+ new FieldDescriptor(field, file, this, index, generatedCodeInfo == null ? null : generatedCodeInfo.PropertyNames[index])); |
+ fieldsInNumberOrder = new ReadOnlyCollection<FieldDescriptor>(fieldsInDeclarationOrder.OrderBy(field => field.FieldNumber).ToArray()); |
+ file.DescriptorPool.AddSymbol(this); |
+ fields = new FieldCollection(this); |
+ } |
+ |
+ /// <summary> |
+ /// Returns the total number of nested types and enums, recursively. |
+ /// </summary> |
+ private int CountTotalGeneratedTypes() |
+ { |
+ return nestedTypes.Sum(nested => nested.CountTotalGeneratedTypes()) + enumTypes.Count; |
+ } |
+ |
+ /// <summary> |
+ /// The brief name of the descriptor's target. |
+ /// </summary> |
+ public override string Name { get { return proto.Name; } } |
+ |
+ internal DescriptorProto Proto { get { return proto; } } |
+ |
+ /// <summary> |
+ /// The generated type for this message, or <c>null</c> if the descriptor does not represent a generated type. |
+ /// </summary> |
+ public Type GeneratedType { get { return generatedType; } } |
+ |
+ /// <summary> |
+ /// Returns whether this message is one of the "well known types" which may have runtime/protoc support. |
+ /// </summary> |
+ internal bool IsWellKnownType |
+ { |
+ get |
+ { |
+ return File.Package == "google.protobuf" && WellKnownTypeNames.Contains(File.Name); |
+ } |
+ } |
+ |
+ /// <value> |
+ /// If this is a nested type, get the outer descriptor, otherwise null. |
+ /// </value> |
+ public MessageDescriptor ContainingType |
+ { |
+ get { return containingType; } |
+ } |
+ |
+ /// <value> |
+ /// A collection of fields, which can be retrieved by name or field number. |
+ /// </value> |
+ public FieldCollection Fields |
+ { |
+ get { return fields; } |
+ } |
+ |
+ /// <value> |
+ /// An unmodifiable list of this message type's nested types. |
+ /// </value> |
+ public IList<MessageDescriptor> NestedTypes |
+ { |
+ get { return nestedTypes; } |
+ } |
+ |
+ /// <value> |
+ /// An unmodifiable list of this message type's enum types. |
+ /// </value> |
+ public IList<EnumDescriptor> EnumTypes |
+ { |
+ get { return enumTypes; } |
+ } |
+ |
+ /// <value> |
+ /// An unmodifiable list of the "oneof" field collections in this message type. |
+ /// </value> |
+ public IList<OneofDescriptor> Oneofs |
+ { |
+ get { return oneofs; } |
+ } |
+ |
+ /// <summary> |
+ /// Finds a field by field name. |
+ /// </summary> |
+ /// <param name="name">The unqualified name of the field (e.g. "foo").</param> |
+ /// <returns>The field's descriptor, or null if not found.</returns> |
+ public FieldDescriptor FindFieldByName(String name) |
+ { |
+ return File.DescriptorPool.FindSymbol<FieldDescriptor>(FullName + "." + name); |
+ } |
+ |
+ /// <summary> |
+ /// Finds a field by field number. |
+ /// </summary> |
+ /// <param name="number">The field number within this message type.</param> |
+ /// <returns>The field's descriptor, or null if not found.</returns> |
+ public FieldDescriptor FindFieldByNumber(int number) |
+ { |
+ return File.DescriptorPool.FindFieldByNumber(this, number); |
+ } |
+ |
+ /// <summary> |
+ /// Finds a nested descriptor by name. The is valid for fields, nested |
+ /// message types, oneofs and enums. |
+ /// </summary> |
+ /// <param name="name">The unqualified name of the descriptor, e.g. "Foo"</param> |
+ /// <returns>The descriptor, or null if not found.</returns> |
+ public T FindDescriptor<T>(string name) |
+ where T : class, IDescriptor |
+ { |
+ return File.DescriptorPool.FindSymbol<T>(FullName + "." + name); |
+ } |
+ |
+ /// <summary> |
+ /// Looks up and cross-links all fields and nested types. |
+ /// </summary> |
+ internal void CrossLink() |
+ { |
+ foreach (MessageDescriptor message in nestedTypes) |
+ { |
+ message.CrossLink(); |
+ } |
+ |
+ foreach (FieldDescriptor field in fieldsInDeclarationOrder) |
+ { |
+ field.CrossLink(); |
+ } |
+ |
+ foreach (OneofDescriptor oneof in oneofs) |
+ { |
+ oneof.CrossLink(); |
+ } |
+ } |
+ |
+ /// <summary> |
+ /// A collection to simplify retrieving the field accessor for a particular field. |
+ /// </summary> |
+ public sealed class FieldCollection |
+ { |
+ private readonly MessageDescriptor messageDescriptor; |
+ |
+ internal FieldCollection(MessageDescriptor messageDescriptor) |
+ { |
+ this.messageDescriptor = messageDescriptor; |
+ } |
+ |
+ /// <value> |
+ /// Returns the fields in the message as an immutable list, in the order in which they |
+ /// are declared in the source .proto file. |
+ /// </value> |
+ public IList<FieldDescriptor> InDeclarationOrder() |
+ { |
+ return messageDescriptor.fieldsInDeclarationOrder; |
+ } |
+ |
+ /// <value> |
+ /// Returns the fields in the message as an immutable list, in ascending field number |
+ /// order. Field numbers need not be contiguous, so there is no direct mapping from the |
+ /// index in the list to the field number; to retrieve a field by field number, it is better |
+ /// to use the <see cref="FieldCollection"/> indexer. |
+ /// </value> |
+ public IList<FieldDescriptor> InFieldNumberOrder() |
+ { |
+ return messageDescriptor.fieldsInNumberOrder; |
+ } |
+ |
+ /// <summary> |
+ /// Retrieves the descriptor for the field with the given number. |
+ /// </summary> |
+ /// <param name="number">Number of the field to retrieve the descriptor for</param> |
+ /// <returns>The accessor for the given field</returns> |
+ /// <exception cref="KeyNotFoundException">The message descriptor does not contain a field |
+ /// with the given number</exception> |
+ public FieldDescriptor this[int number] |
+ { |
+ get |
+ { |
+ var fieldDescriptor = messageDescriptor.FindFieldByNumber(number); |
+ if (fieldDescriptor == null) |
+ { |
+ throw new KeyNotFoundException("No such field number"); |
+ } |
+ return fieldDescriptor; |
+ } |
+ } |
+ |
+ /// <summary> |
+ /// Retrieves the descriptor for the field with the given name. |
+ /// </summary> |
+ /// <param name="name">Name of the field to retrieve the descriptor for</param> |
+ /// <returns>The descriptor for the given field</returns> |
+ /// <exception cref="KeyNotFoundException">The message descriptor does not contain a field |
+ /// with the given name</exception> |
+ public FieldDescriptor this[string name] |
+ { |
+ get |
+ { |
+ var fieldDescriptor = messageDescriptor.FindFieldByName(name); |
+ if (fieldDescriptor == null) |
+ { |
+ throw new KeyNotFoundException("No such field name"); |
+ } |
+ return fieldDescriptor; |
+ } |
+ } |
+ } |
+ } |
+} |