官方指南 由 google 开发,是一款语言中立、平台中立、开源的远程过程调用(RPC)系统。
var grpc = require('grpc');
var hello_proto = grpc.load(PROTO_PATH).helloworld;
Google 开源的一套成熟的结构数据序列化机制(也可以使用其他数据格式如 JSON),推荐版本:proto3 。 用 proto files 创建 gRPC 服务,用 protocol buffers 消息类型来定义方法参数和返回类型。 protobuf 规范参考
syntax = "proto3";
package admin;
// 用户信息类型
message User {
int64 id = 1;
string name = 4;
string email = 5;
string phone = 6;
int64 create_at = 7;
int64 update_at = 8;
int64 last_login_at = 9;
}
// 约定服务getUser
service Admin {
rpc getUser (getUserRequest) returns (getUserReply) {}
}
// 约定服务入参
message getUserRequest {
}
// 约定服务出参
message getUserReply {
User user = 1;
}
[Protocol Buffers安装]教程(https://zhuanlan.zhihu.com/p/42379354)
云原生计算基金会(CNCF)正式发布 GA 版本的 gRPC-Web,这是一个 JavaScript 客户端库,使 Web 应用程序能够直接与后端 gRPC 服务通信,不需要 HTTP 服务器充当中介。
.proto
文件需要有.protoc-gen-grpc-web.exe
(生成web js文件的工具)、protoc.exe
(Protocol Buffers工具)和.proto
文件,在使用时需要npm
安装grpc-web
。之后执行如下命令即可:
// 会生成{proto_name}_pb.js和{proto_name}_grpc_pb.js
{路径}protoc -I=./ {路径下的proto文件} --js_out=import_style=commonjs:./ --plugin=protoc-gen-grpc={路径}/protoc-gen-grpc-web.exe --grpc-web_out=import_style=commonjs,mode=grpcwebtext:./
在Vue中使用gRPC Client示例如下,向后台发起register的gRPC请求:
import * as grpc_web from '../proto/admin_grpc_web_pb'
import {AdminClient} from '../proto/admin_grpc_web_pb'
export const rpcWeb = grpc_web
export const client = new AdminClient('http://127.0.0.1:8081')
----------------------------------------
let send = new rpcWeb.registerRequest()
send.setName('huang')
...
const metaData = {authorization: '...'}
// client.register(registerRequest, metadata, (err,response)=>{})
client[register](send, metaData, (err, resp) => {
...
}
// service端代码参考:https://github.com/grpc/grpc-web/blob/master/net/grpc/gateway/examples/echo/node-server/server.js