以小见大——那些基于 protobuf 的五花八门的 RPC（3）

赖勇浩（http://laiyonghao.com ）

protobuf-remote

嘎~再来一枚 C++ 系的 RPC，它的简介是 RPC implementation for C# and C++ using Protocol Buffers，比之前的几个 rpc 实现都要复杂。基本格式见：http://code.google.com/p/protobuf-remote/source/browse/Cpp/Source/ProtoBufRemote/RpcMessage.proto ，全文如下：

package ProtoBufRemote; message RpcMessage { required int32 id = 1; optional Call call_message = 2; optional Result result_message = 3; message Call { required string service = 1; required string method = 2; repeated Parameter parameters = 3; required bool expects_result = 4; } message Result { optional bool is_failed = 1; optional string error_message = 2; optional Parameter call_result = 3; } message Parameter { optional bytes proto_param = 1; optional string string_param = 2; optional sint32 int_param = 3; optional uint32 uint_param = 4; optional sint64 int64_param = 5; optional uint64 uint64_param = 6; optional bool bool_param = 7; optional float float_param = 8; optional double double_param = 9; optional bool is_null = 10; } }

只有一个大定义：message RpcMessage，它即是 request 又是 response，这一点跟之前的 protobuf-rpc 的 Rpc 相同；但不同的是它把 id 从 call/result（对应常用的 request/response）中抽取出来作为 RpcMessage 的共有属性，不过我没看到它的做法的时候，还真没想过要抽取出来，看来我重构能力有待加强。
从 Call 来看，采用了 service 和 method 分开两个字段的设计，所以 multi-service 是没有问题的。repeated Parameter parameters 让我有点困惑，因为之前所看的设计，应该都是使用 bytes 存储序列化好的 message 对象，那么这个 parameters 是否有独到之处，有的话又是什么呢？抱着这样的疑惑，我翻开了它的代码（额，测试代码，因为简单好懂，见：http://code.google.com/p/protobuf-remote/source/browse/Cpp/Source/ProtoBufRemoteTest/RpcClientTest.cpp#76 ）：
TEST_F(RpcClientTest, Call) { EXPECT_CALL(m_controller, Send(AllOf(Truly(IsCallMessageCorrect), Property(&RpcMessage::call_message, Property(&RpcMessage::Call::expects_result, Eq(true)))))) .WillOnce(Invoke(this, &RpcClientTest::SendResult)); RpcMessage message; MutableParameterList parameters(&message); parameters.Add().SetInt(42); PendingCall* call = m_client->Call("ServiceName", "MethodName", parameters); call->Wait(); EXPECT_EQ(43, call->GetResult()->GetInt()); m_client->ReleaseCall(call); }
可以看到声明了一个 RpcMessage 变量，然后用它实例化了一个 MutableParameterList（这个 MutablePararmeterList 可以看作是 Call.parameters 的适配器），然后往里加入了一个整型参数 42，然后再调用 Call 方法把请求发送到服务器端。至此我们可以明白 parameters 的作用是让我们声明 rpc 的时候，不再需要详细定义相应的参数和返回值类型了，统一写成：
rpc XXXX(RpcMessage)returns(RpcMessage);
即可，唯一需要变化的是用真正的方法名替换掉 XXXX。而 repeated Parameter parameters 中 repeated 的作用是为了传入复合参数，比如按常规传入 protobuf 官方示例中的 message Person 参数的话，可能在这里是这样的：
parameters.Add().SetString(name); parameters.Add().SetInt(id); parameters.Add().SetString(email);
不过如果有定义 message Person 的话，也可以这样：
parameters.Add().SetProto(person);
可见各种方案都有利弊，获得了 rpc 声明的简洁，就需要牺牲代码的简洁为代价。虽然说作者的思路的确是如同天马行空般开阔，但如果是我的话，我不会采用这种方案，换作你呢，又会如何？
Call.expects_result 字段是告诉服务器端要不要把结果（包括是否出错）返回给客户端，很好理解。不过 Result.call_result 是 optional，而不是 repeated，让我觉得怪怪地，难道只准多个参数，不许多个返回值？

=====未完待续=====