Thrift Go语言包使用技术文档

1. 安装指南

在开始使用Thrift Go语言包之前，您需要确保您的环境中已经安装了Go语言环境。以下是安装Thrift Go语言包的步骤：

go get github.com/samuel/go-thrift

确保您在 $GOPATH 环境变量指定的目录下执行上述命令。

2. 项目的使用说明

Thrift Go语言包提供了客户端和服务器端的编解码器、序列化以及代码生成器，用于Go语言。此包旨在为Go语言提供更加自然的映射。

类型映射

大部分Thrift类型直接映射到Go的原生类型，但有一些需要注意的细节：

• Go对映射键的类型支持比Thrift更加有限。
• 若要使用集合，您需要定义一个类型为 []type 的字段，并提供一个 set 标签。
• []byte 在编码/解码时会被当作字符串处理，因为Thrift的二进制类型在网络上与字符串相同。

RPC

此包使用标准的Go net/rpc 包来提供RPC功能。但请注意，net/rpc 使用 ServiceName.Method 作为RPC方法的命名方式，为了解决这个兼容性问题，Thrift ServerCodec 会对方法名添加 "Thrift" 前缀。

传输

此包中没有特定的传输“类”，而是使用了标准的 io.ReadWriteCloser 接口。如果该值还实现了 thrift.Flusher 接口，则在 protocol.WriteMessageEnd 之后调用 Flush() error。

“帧传输”是通过包装实现 io.ReadWriteCloser 接口的对象来支持的，使用 thrift.NewFramedReadWriteCloser(value)。

###单向请求

客户端

要启用客户端的单向请求支持，需要在RPC编解码器上显式启用。由于Go RPC包默认不支持单向请求，因此需要使用一些特殊的技巧来实现。

服务器端

服务器端的单向请求功能尚未实现。

3. 项目API使用文档

有关API文档，请参考Go语言包的标准文档生成方式，使用 godoc 工具查看。

godoc -http=:6060

在浏览器中访问 http://localhost:6060 查看API文档。

4. 项目安装方式

项目的安装方式已在安装指南中描述，简要概括如下：

确保安装了Go语言环境后，使用 go get 命令即可安装Thrift Go语言包。

go get github.com/samuel/go-thrift

此命令会自动下载并安装所需的包到您的Go工作空间。