目前主流的 Java 开发框架 Spring Boot,为了更方便集成 gRPC,自己开发了 spring-boot-starter-grpc
,仅需简单的几行配置即可使用。相关使用文档如下:
1、服务定义 (Service definition)
默认情况下,grpc 使用 protocol buffers 作为接口定义语言(IDL)来描述服务接口和消息结构。以下为 spring-boot-starter-grpc
中定义的通用的 IDL:
syntax = "proto3";
option java_package = "com.anoyi.rpc";
option java_outer_classname = "GrpcService";
option java_multiple_files = false;
// 定义通用的 Grpc 服务
service CommonService {
// 处理请求
rpc handle ( Request ) returns ( Response ) {}
}
// 定义通用的 Grpc 请求体
message Request {
bytes request = 1;
}
// 定义通用的 Grpc 响应体
message Response {
bytes response = 1;
}
文件地址:service.proto
grpc 提供了多种语言对此类 IDL 的支持,包括:C++、 C#、Dart、Go、Java、Node.js、 Objective-C、 PHP、Python、Ruby
作为服务提供方,需要实现 CommonService
的 handle
方法;作为服务调用方,直接使用 CommonService
的 handle
方法即可。
2、序列化与反序列化 (serialize / deserialize)
上述 service.proto
文件中定义了请求体和响应体的数据类型为 bytes ,在多语言编程环境下,远程方法调用都需要将要发送的数据序列化为 bytes,将接收到的数据反序列化为所需的对象。
目前,grpc 支持的语言都支持了 JSON 文本和 XML 文本的解析,个人认为 JSON 比较简洁,所以优先考虑将请求体和响应体转为 JSON 字符串,然后中间层再做序列化和反序列化。
3、反射 (reflect)
上述序列化与反序列化解决了数据传输的问题,服务提供方接收到信息后就需要处理调用方的请求,以 Java 为例,调用远程方法时,会提供 类名、方法名、方法参数 等信息,有了这些信息,服务提供方就能通过反射调用该方法的具体实现。下面列举各种语言反射的实现:
此处未展示 Java 和 JavaScript 的反射机制,下文将以实例说明。
示例:服务提供方 (Node.js)、服务调用方(Java)
中间依赖 service.proto 定义的通用服务