thrift 最初是 facebook 开发使用的 rpc 通信框架,后来贡献给了 apache 基金会,出来得比较早,几乎支持所有的后端语言,使用非常广泛,是不可不知的一个网络框架。

和 grpc 一样,需要先定义通信协议,然后实现自己业务逻辑。

下面介绍其使用方法。

下载go thrift 库

$ go get git.apache.org/thrift.git/lib/go/thrift/...

注意:此时的版本库时间是2017.7,因此当时不支持context。

下载协议转换工具thrift

$ wget http://www-us.apache.org/dist/thrift/0.10.0/thrift-0.10.0.tar.gz
$ tar -xzvf thrift-0.10.tar.gz
$ cd thrift-0.10.0
$ ./configure --prefix=/usr
$ make -j8
$ [sudo] make install

thrift工具安装过程中可能会报错,关于如何安装依赖,请参看Building Apache Thrift on CentOS 6.5.

另外,一个问题,编译thrift时报错:

GOPATH=pwd /home/lanyang/work/pkgs/go/bin/go get github.com/golang/mock/gomock

package golang.org/x/net/context: unrecognized import path "golang.org/x/net/context" (https fetch: Get https://golang.org/x/net/context?go-get=1: dial tcp 216.239.37.1:443: i/o timeout)

网上各种方法都试过,无法搞定。

根据报错提示,注释掉 test/go/Makefile 文件中

#GOPATH=pwd $(GO) get github.com/golang/mock/gomock

然后,手动下载gomock。

由于gomock依赖net,所以先下载net。

直接 go get golang.org/x/net 会失败,是由于被墙。

可采用

从https://github.com/golang/net下载(可以直接 go get github.com/golang/net),然后把目录改成golang.org/x/net。

完成net下载和配置后,接着下载mock

$ go get github.com/golang/mock/gomock

最后编译通过。

定义协议文件echo.thrift

在GOPATH目录下创建thriftExample目录,在该目录创建文件echo.thrift,内容如下:

namespace go echo

struct EchoReq {
1: string msg;
} struct EchoRes {
1: string msg;
} service Echo {
EchoRes echo(1: EchoReq req);
}

协议转换

命令格式

thrift --gen <language> <Thrift filename>

至于thrift的用法,可以使用thrift -help查看帮助。

执行以下命令会生成 gen-go 文件夹,这个过程其实是将上面的协议翻译成 golang 代码。

$ thrift -r --gen go echo.thrift

生成的gen-go 文件夹包括以下文件

[lanyang@localhost thriftExample]$ ll gen-go/ -R
gen-go:
total 4
drwxrwxr-x. 3 lanyang lanyang 4096 May 13 23:18 echo gen-go/echo:
total 28
-rw-rw-r--. 1 lanyang lanyang 349 May 13 23:18 echo-consts.go
-rw-rw-r--. 1 lanyang lanyang 16161 May 13 23:18 echo.go
drwxrwxr-x. 2 lanyang lanyang 4096 May 13 23:18 echo-remote
-rw-rw-r--. 1 lanyang lanyang 159 May 13 23:18 GoUnusedProtection__.go gen-go/echo/echo-remote:
total 4
-rwxr-xr-x. 1 lanyang lanyang 4017 May 13 23:18 echo-remote.go

其中,echo.go是生成的类型和方法定义,echo-remote是client示例代码。

示例代码

下面简单举例说明其使用。

服务端代码

服务端代码server.go如下:

package main

import (

    "fmt"
"git.apache.org/thrift.git/lib/go/thrift" "thriftExample/gen-go/echo" ) type EchoServer struct {
} func (e *EchoServer) Echo(req *echo.EchoReq) (*echo.EchoRes, error) {
fmt.Printf("message from client: %v\n", req.GetMsg()) res := &echo.EchoRes{
Msg: "success",
} return res, nil
} func main() {
transport, err := thrift.NewTServerSocket(":9898")
if err != nil {
panic(err)
} handler := &EchoServer{}
processor := echo.NewEchoProcessor(handler) transportFactory := thrift.NewTBufferedTransportFactory(8192)
protocolFactory := thrift.NewTCompactProtocolFactory()
server := thrift.NewTSimpleServer4(
processor,
transport,
transportFactory,
protocolFactory,
) if err := server.Serve(); err != nil {
panic(err)
}
}

客户端代码

客户端代码client.go如下

package main

import (
"fmt"
"log"
"net"
"os" "git.apache.org/thrift.git/lib/go/thrift" "thriftExample/gen-go/echo"
) func main() {
transportFactory := thrift.NewTBufferedTransportFactory(8192)
protocolFactory := thrift.NewTCompactProtocolFactory() transport, err := thrift.NewTSocket(net.JoinHostPort("127.0.0.1", "9898"))
if err != nil {
fmt.Fprintln(os.Stderr, "error resolving address:", err)
os.Exit(1)
} useTransport, err := transportFactory.GetTransport(transport)
client := echo.NewEchoClientFactory(useTransport, protocolFactory)
if err := transport.Open(); err != nil {
fmt.Fprintln(os.Stderr, "Error opening socket to 127.0.0.1:9898", " ", err)
os.Exit(1)
}
defer transport.Close() req := &echo.EchoReq{Msg:"You are welcome."}
res, err := client.Echo(req)
if err != nil {
log.Println("Echo failed:", err)
return
} log.Println("response:", res.Msg)
fmt.Println("well done") }

server ouput:

$ ./server

message from client: You are welcome.

client output:

$ ./client

2018/05/19 11:12:37 response: success

well done

注意:服务端和客户端进行通信时使用的协议一定要相同,例如上例中的,transport factory是 buffer transport factroy,protocol factory 是compact protcol。

参考

github

https://github.com/apache/thrift/

github go thrift

https://github.com/apache/thrift/tree/master/lib/go

Building Apache Thrift on CentOS 6.5

http://thrift.apache.org/docs/install/centos

不同系统如何安装thrift工具

http://thrift.apache.org/docs/install/

go thrift example(很有参考价值)

https://github.com/apache/thrift/tree/master/tutorial/go/src

golang 网络框架之 thrift

https://segmentfault.com/a/1190000013127570

Golang通过Thrift框架完美实现跨语言调用

https://my.oschina.net/qinerg/blog/165285

安装thrift

http://www.cnblogs.com/yjf512/p/4334622.html

https://thrift.apache.org/tutorial/go

Go thrift使用举例的更多相关文章

  1. Python实现Thrift Server

    近期在项目中存在跨编程语言协作的需求,使用到了Thrift.本文将记录用python实现Thrift服务端的方法. 环境准备 根据自身实际情况下载对应的Thrift编译器,比如我在Windows系统上 ...

  2. thrift ssl 证书整理

    一.生成证书,所需机器数必须 >= 2(一台生成服务端证书,一台生成客户端证书),以下服务器以A表示服务端.B表示客户端来举例,thrift版本为0.7.01.自签名的证书的生成和测试 1)生成 ...

  3. 编写服务说明.thrift文件

    1.数据类型 基本类型: bool:布尔值,true 或 false,对应 Java 的 boolean byte:8 位有符号整数,对应 Java 的 byte i16:16 位有符号整数,对应 J ...

  4. Thrift反序列化导致OOM(转)

    概述 最近线上的日志处理服务偶尔会出现Out Of Memory的问题,从Exception的call stack中顺藤摸瓜,最终定位到是thrift反序列化的问题. 发现问题 先交代一下问题现场: ...

  5. Thrift架构介绍

    Thrift是一个跨语言的服务部署框架,最初由Facebook于2007年开发,2008年进入Apache开源项目.Thrift通过一个中间语言(IDL, 接口定义语言)来定义RPC的接口和数据类型, ...

  6. Thrift之TProcess类体系原理及源码详细解析

    我的新浪微博:http://weibo.com/freshairbrucewoo. 欢迎大家相互交流,共同提高技术. 之前对Thrift自动生成代码的实现细节做了详细的分析,下面进行处理层的实现做详细 ...

  7. Thrift 原理与使用实例

    一.Thrift 框架介绍 1.前言 Thrift是一个跨语言的服务部署框架,最初由Facebook于2007年开发,2008年进入Apache开源项目.Thrift通过一个中间语言(IDL, 接口定 ...

  8. Thrift接口简介

    参考地址:http://roclinux.cn/?p=3316 [thrift是什么] 计算机技术里一款著名的通信框架 – thrift框架 thrift的全名叫做Apache thrift,是一款软 ...

  9. Ajax 概念 分析 举例

    Ajax是结合了访问数据库,数据访问,Jquery 可以做页面局部刷新或者说是页面不刷新,我可以让页面不刷新,仅仅是数据的刷新,没有频繁的刷页面,是现在比较常用的一种方式做页面那么它是怎么实现页面无刷 ...

随机推荐

  1. Day8作业及默写

    1,有如下文件,a1.txt,里面的内容为: 老男孩是最好的培训机构, 全心全意为学生服务, 只为学生未来,不为牟利. 我说的都是真的.哈哈 分别完成以下的功能: 将原文件全部读出来并打印. with ...

  2. python 中的堆 (heapq 模块)应用:Merge K Sorted Lists

    堆是计算机科学中一类特殊的数据结构的统称.堆通常是一个可以被看做一棵树的数组对象.在队列中,调度程序反复提取队列中第一个作业并运行,因为实际情况中某些时间较短的任务将等待很长时间才能结束,或者某些不短 ...

  3. 【linux基础】V4L2介绍

    参考 1. https://www.cnblogs.com/hzhida/archive/2012/05/29/2524351.html 2. https://www.cnblogs.com/hzhi ...

  4. Ubuntu16.04通过GPT挂载硬盘

    一般而言,服务器上挂载的硬盘都是比较大的,传统的对硬盘进行分区需要在终端敲sudo fdisk进行操作,但是, 当挂载的硬盘的容量大于2T的时候,是无法通过sudo fdisk进行挂载的,这个时候必须 ...

  5. 字符串(text)格式的html代码文本转为DOM对象

    /*字符串转dom对象*/ window.strimgTurnDom = function(txt) { try //Internet Explorer { xmlDoc=new ActiveXObj ...

  6. import sys

    目录 sys模块的常见函数列表 1.sys.argv 2.sys.platform 3.sys.path 4.sys.exit(n) sys模块提供了一系列有关Python运行环境的变量和函数. 回到 ...

  7. 06 Listener,Filter,BeanUtils

    Listener 监听器,监听某一个事件的发生. 状态的改变. 内部机制其实就是接口回调. 接口回调  需求:A在执行循环,当循环到5的时候, 通知B.事先先把一个对象传递给 A , 当A 执行到5的 ...

  8. (10)MySQL触发器(同时操作两张表)

    什么是触发器 触发器是与表有关的数据库对象,在满足定义条件时触发,并执行触发器中定义的语句集合.触发器的这种特性可以协助应用在数据库端确保数据的完整性. 举个例子,比如你现在有两个表[用户表]和[日志 ...

  9. 计算机网络-数据结构-MAC帧头-IP头-TCP头-UDP头

    第0章 数据是如何进行一步步的封装的 第一章:mac帧头定义 帧头数据结构的定义: 一.MAC帧头定义 /*数据帧定义,头14个字节,尾4个字节*/ typedef struct _MAC_FRAME ...

  10. seelog 文件输出格式

    项目中用到seelog,希望每个小时的记录输入在当前小时命名的日志,配置如下: <seelog> <outputs formatid="leads"> &l ...