Any

注：内容翻译自官网文档 Language Guide (proto3) 中的 Any 一节

Any 消息类型可以让你使用消息作为嵌入类型而不必持有他们的.proto定义. Any把任意序列化后的消息作为bytes包含, 带有一个URL, 工作起来类似一个全局唯一的标识符. 为了使用Any类型, 需要导入google/protobuf/any.proto.

  1. import "google/protobuf/any.proto";
  3. message ErrorStatus {
  4.   string message = 1;
  5.   repeated Any details = 2;
  6. }

给定消息类型的 default type URL 是 type.googleapis.com/packagename.messagename.

不同语言实现将提供运行时类库来帮助以类型安全的方式封包和解包Any的内容 - 例如, 在java中, Any类型将有特别的pack()和unpark()访问器, 而在c++中有PackFrom() 和 PackTo()方法:

  1. // 在Any中存储任务消息类型
  2. NetworkErrorDetails details = ...;
  3. ErrorStatus status;
  4. status.add_details()->PackFrom(details);
  6. // 从Any中读取任意消息
  7. ErrorStatus status = ...;
  8. for (const Any& detail : status.details()) {
  9.   if (detail.IsType<NetworkErrorDetails>()) {
  10.     NetworkErrorDetails network_error;
  11.     detail.UnpackTo(&network_error);
  12.     ... processing network_error ...
  13.   }
  14. }

目前用于处理Any类型的运行时类库正在开发中.

如果你熟悉proto2语法, Any 类型替代了extensions.