Go 每日一库之 twirp

最新推荐文章于 2024-05-08 09:30:41 发布

darjun

最新推荐文章于 2024-05-08 09:30:41 发布

阅读量425

点赞数

分类专栏： Go 每日一库文章标签： golang 每日一库 rpc twirp grpc

本文链接：https://blog.csdn.net/darjun/article/details/106866601

版权

本文详细介绍了基于Google Protobuf的RPC框架twirp，它与gRPC的区别在于使用标准库和HTTP/1.1支持。文章涵盖了twirp的快速入门，包括安装、代码生成、服务器和客户端的编写。此外，还讨论了JSON客户端、与其他HTTP服务共存、发送自定义Header、请求路由等特性，展示了twirp的灵活性和实用性。

摘要由CSDN通过智能技术生成

简介

twirp是一个基于 Google Protobuf 的 RPC 框架。twirp通过在.proto文件中定义服务，然后自动生产服务器和客户端的代码。让我们可以将更多的精力放在业务逻辑上。咦？这不就是 gRPC 吗？不同的是，gRPC 自己实现了一套 HTTP 服务器和网络传输层，twirp 使用标准库net/http。另外 gRPC 只支持 HTTP/2 协议，twirp 还可以运行在 HTTP 1.1 之上。同时 twirp 还可以使用 JSON 格式交互。当然并不是说 twirp 比 gRPC 好，只是多了解一种框架也就多了一个选择????

快速使用

首先需要安装 twirp 的代码生成插件：

$ go get github.com/twitchtv/twirp/protoc-gen-twirp

上面命令会在$GOPATH/bin目录下生成可执行程序protoc-gen-twirp。我的习惯是将$GOPATH/bin放到 PATH 中，所以可在任何地方执行该命令。

接下来安装 protobuf 编译器，直接到 GitHub 上https://github.com/protocolbuffers/protobuf/releases下载编译好的二进制程序放到 PATH 目录即可。

最后是 Go 语言的 protobuf 生成插件：

$ go get github.com/golang/protobuf/protoc-gen-go

同样地，命令protoc-gen-go会安装到$GOPATH/bin目录中。

本文代码采用Go Modules。先创建目录，然后初始化：

$ mkdir twirp && cd twirp
$ go mod init github.com/darjun/go-daily-lib/twirp

接下来，我们开始代码编写。先编写.proto文件：

syntax = "proto3";
option go_package = "proto";

service Echo {
  rpc Say(Request) returns (Response);
}

message Request {
  string text = 1;
}

message Response {
  string text = 2;
}

我们定义一个service实现echo功能，即发送什么就返回什么。切换到echo.proto所在目录，使用protoc命令生成代码：

$ protoc --twirp_out=. --go_out=. ./echo.proto

上面命令会生成echo.pb.go和echo.twirp.go两个文件。前一个是 Go Protobuf 文件，后一个文件中包含了twirp的服务器和客户端代码。

然后我们就可以编写服务器和客户端程序了。服务器：

package main

import (
  "context"
  "net/http"

  "github.com/darjun/go-daily-lib/twirp/get-started/proto"
)

type Server struct{}

func (s *Server) Say(ctx context.Context, request *proto.Request) (*proto.Response, erro