如何在Java中将Protobuf的map类型打包到google.protobuf.Any中？

这个问题我之前做项目时也碰到过，确实protobuf-java库没有给原生的map类型提供对应的Message包装类，不过咱们可以用一个很实用的小技巧解决——自己定义一个包含map的包装型proto消息，然后把这个包装消息打包进google.protobuf.Any就可以了，具体步骤如下：

• 第一步：定义包装map的proto消息
  你需要先写一个自定义的proto文件，里面包含你需要的map字段。比如如果你要存<string, string>类型的map，可以这么写：

  syntax = "proto3";
  import "google/protobuf/any.proto";
  
  message MapWrapper {
    // 这里定义你需要的map类型，比如<string, string>
    map<string, string> string_key_value_map = 1;
    // 如果需要其他类型的map，直接加字段就行，比如<int32, bool>
    map<int32, bool> int_bool_map = 2;
  }
  
  // 原来的Msg消息可以保留
  message Msg {
    google.protobuf.Any value = 1;
  }
  

  如果想支持更通用的map（比如value可以是任意protobuf类型），可以结合google.protobuf.Value来定义：

  import "google/protobuf/struct.proto";
  
  message GenericMapWrapper {
    map<string, google.protobuf.Value> generic_map = 1;
  }
  

  这样generic_map的value可以是字符串、数字、列表甚至嵌套结构体，灵活性更高。

• 第二步：编译proto生成Java代码
  用protoc工具把这个proto文件编译成Java类，之后你就能在代码里使用MapWrapper或者GenericMapWrapper这些类了。

• 第三步：打包map到Any并组装Msg
  现在就和你打包StringValue这些类型一样简单了，先把数据填充到包装类里，再用Any.pack()打包：

  // 示例：填充<string, string>类型的map
  MapWrapper mapWrapper = MapWrapper.newBuilder()
      .putStringKeyValueMap("name", "Alice")
      .putStringKeyValueMap("age", "25")
      .build();
  
  // 打包进Any，然后组装成Msg
  Msg msg = Msg.newBuilder()
      .setValue(Any.pack(mapWrapper))
      .build();
  

• 第四步：解析Any中的map
  读取的时候也很直接，用Any.unpack()方法把包装类取出来，再获取里面的map：

  if (msg.getValue().is(MapWrapper.class)) {
      MapWrapper wrapper = msg.getValue().unpack(MapWrapper.class);
      // 获取<string, string>的map
      Map<String, String> stringMap = wrapper.getStringKeyValueMapMap();
      // 如果是其他类型的map，比如int_bool_map，就用wrapper.getIntBoolMapMap()
  }
  

这种方法本质上是给map套了一个合法的protobuf消息外壳，让它能被Any正常打包和解析，是社区里比较常用的解决方案，亲测好用~

备注：内容来源于stack exchange，提问作者bszwej