从 C# 中读取 protobuf3 自定义选项

Reading a protobuf3 custom option from C#

TL;DR

根据文档,如果我使用 C++,我可以使用 string value = MyMessage::descriptor()->options().GetExtension(my_option); 读取自定义选项的值。 Java 和 Python 也有类似的例子。但我正在做 C#,我可以找到一个等价物。我可以做吗?如果可以,怎么做?

更多详情

我正在操纵用 protobuf3. The schemas are declaring a custom option 生成的 类。它看起来像这样:

import "google/protobuf/descriptor.proto";

extend google.protobuf.MessageOptions {
  string my_option = 51234;
}

message MyMessage {
  option (my_option) = "Hello world!";
}

正在为我的代码提供一个从 MyMessage 生成的对象,我想阅读此选项的值(此处 Hello world!


更新:我没有使用 protobuf-net。现在 protobuf 原生支持 C#,我正在使用 Google 的 protobuf3 C# 库。

看起来该功能尚未实现:https://github.com/google/protobuf/issues/1603

这看起来也只是时间问题,他们对拉取请求持开放态度。因此,根据您需要它的时间,您可以成为实施者:)

您现在可以在 C# 中访问自定义选项。首先,在你的 .proto 中定义自定义选项:

import "google/protobuf/descriptor.proto";
extend google.protobuf.FieldOptions {
  string objectReferenceType = 1000; //Custom options are 1000 and up.
}

接下来,将自定义选项应用于某些内容。在这里,我将它附加到一个字段:

message Item
{
  string name = 1;
  int32 id = 2;
  string email = 3;
  ObjectReference prefab = 4 [(objectReferenceType) = "UnityEngine.GameObject"];
}

然后您需要查找自定义选项字段编号。没有很好的方法可以做到这一点,所以只需从您定义自定义选项扩展名的文件的 FileDescriptor 中查找扩展名。您将生成一个名为 protoFileNameReflection 的 C# class。从那里,您可以找到分机号,然后找到字段号。这是一个示例,假设原型被称为 "Item.proto",因此生成的 class 被称为 ItemReflection:

foreach (FieldDescriptor extensionFieldDescriptor in ItemReflection.Descriptor.Extensions.UnorderedExtensions)
    {   
        if (extensionFieldDescriptor.ExtendeeType.FullName == "google.protobuf.FieldOptions")
        {
            objectReferenceTypeFieldNumber = extensionFieldDescriptor.FieldNumber;
            break;
        }
    }

然后使用 protobuf 反射访问代码中的自定义选项:

FieldDescriptor fieldDescriptor = prefabFieldDescriptor;
CustomOptions customOptions = fieldDescriptor.CustomOptions;
if (customOptions.TryGetString(objectReferenceTypeFieldNumber, out string objectReferenceTypeText))
{
   Console.Log(objectReferenceTypeText); //logs: "UnityEngine.GameObject"
}

正在更新 Protobuf 3.11.4 的答案,因为这是处理该问题的唯一线程。使用与 DoomGoober 类似的原型:

// Foo.proto
Package foo
import "google/protobuf/descriptor.proto";
extend google.protobuf.FieldOptions {
  string objectReferenceType = 1000; //Custom options are 1000 and up.
}
// Bar.proto
import "Foo.proto"
message Item
{
  string name = 1;
  int32 id = 2;
  string email = 3;
  ObjectReference prefab = 4 [(foo.objectReferenceType) = "UnityEngine.GameObject"];
}

您可以使用新生成的 class 从 Item Proto 对象中读取自定义选项。在这种情况下,它称为 FooExtensions(参见 Foo.protos):

public void LogFieldOptions(Item item)
{
  // Get the list of fields in the message (name, id, etc...)
  var fieldDescriptors = item.Descriptor.Fields.InFieldNumberOrder();

  foreach (var fieldDescriptor in fieldDescriptors)
  {
    // Fetch value of this item instance for current field
    var fieldValue = fieldDescriptor.Accessor.GetValue(item);

    // Fetch name of field
    var fieldName = fieldDescriptor.Name;

    // if we are not in the correct field: Skip    
    if(!fieldName.Equals("prefab")) continue;

    // Fetch the option set in this field in the proto
    // (note that this is not related to the instance 
    // of item but to the general item message descriptor)
    var optionObjectReferenceType = fieldDescriptor.GetOption(FooExtensions.objectReferenceType); 
    Console.Log(optionObjectReferenceType ); //logs: "UnityEngine.GameObject";
  }
}

您可以用相同的方式获取所有类型的选项(MessageOptions、FileOptions)。只需确保您使用的是正确的描述符(对于 MessageOptions 使用 MessageDescriptors 等等...)

正在阅读自定义消息选项(扩展)

  • 假设文件名为 foobar.proto

message.Descriptor.GetOptions().GetExtension(FoobarExtensions.MyOption);

访问描述符数据的简单版本:

public void LogFieldOptions(Item item)
{
   var fieldDescriptors = item.Descriptor.Fields.InDeclarationOrder(); // or .InFieldNumberOrder()
   var fieldDescriptor = fieldDescriptors.FirstOrDefault(fd => fd.Name == "prefab")

   if (fieldDescriptor != null)
   {
       var objectReferenceType = fieldDescriptor.GetOptions().GetExtension(FooExtensions.objectReferenceType); 
       // use result
   }
}