gRPC及gRPC-Web

一、gRPC

官方指南
由 google 开发，是一款语言中立、平台中立、开源的远程过程调用(RPC)系统。

• 优势
  gRPC 客户端和服务端可以在多种环境中运行和交互，例如从 google 内部的服务器到你自己的笔记本，并且可以用任何 gRPC 支持的语言来编写。所以，你可以很容易地用 Java 创建一个 gRPC 服务端，用 Go、Python、Ruby 来创建客户端。

• 生成 gRPC 代码——Node.js
  Node.js库从运行时加载的 .proto 文件动态生成服务描述和客户端存根的定义，所以使用此语言时没必要生成任何特殊代码。而是在例子客户端和服务端里，我们 require gRPC 库，然后用它的 load() 方法：

var grpc = require('grpc');
var hello_proto = grpc.load(PROTO_PATH).helloworld;

二、proto-buf

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)

三、gRPC-Web

云原生计算基金会（CNCF）正式发布 GA 版本的 gRPC-Web，这是一个 JavaScript 客户端库，使 Web 应用程序能够直接与后端 gRPC 服务通信，不需要 HTTP 服务器充当中介。

1. 与 REST 的区别
   gRPC：一个客户端应用程序通过 Protocol Buffers 与一个 gRPC 后端服务器通信，然后这个服务器也通过 Protocol Buffers 与其他的 gRPC 后端服务器通信。
   REST：Web 应用程序通过 HTTP 与后端 REST API 服务器通信，然后这个服务器又通过 Protocol Buffers 与其他后端服务通信。

2. 产生的原因
   gRPC是一个基于HTTP/2实现的高性能远程过程调用框架，但是由于浏览器没有直接暴露HTTP/2，所以Web应用程序不能直接使用gRPC。gRPC-Web是一个标准化协议，它解决了这个问题，可以在浏览器中使用gRPC。
   
   
   

3. JS中使用gRPC
   Windows系统在JS中使用.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

JS中使用.proto文件教程