手把手教你用TARS

在中国,有一个简单的方法可以用来判断一个互联网公司够不够大,那就是看其是否开源过 rpc 框架!比如阿里巴巴的 dubbo,或者腾讯的 tars,小公司往往会对这些大公司的产品趋之若鹜,不过一个可悲的现实是大公司自己往往并不用他们开源的版本,这就好比皇帝总是把自己看不上眼的女人赏赐给臣民,不过能得到皇帝的赏赐总是好事,下面让我手把手教你用 tars,更具体的说是 tarsgo,也就是 tars 的 golang 实现。

实际动手前,最好熟读官方文档,特别是基础概念基础通讯协议部分,假设你已经了解了这些内容,那么不妨让我们虚拟一个例子:给商城里的用户加积分!然后我们要构建一个 Shop(App),其中有一个 User(Server),其中有一个 Credit(Servant),可以简单的把 App、Server、Servant 这些概念理解成命名空间的几个层级,下面让我们用 tarsgo 内置的 create_tars_server_gomod.sh 脚本来生成项目!

shell> export GOPATH=$(go env GOPATH)
shell> go env -w GO111MODULE=auto
shell> go get -u github.com/TarsCloud/TarsGo/tars
shell> $GOPATH/src/github.com/TarsCloud/TarsGo/tars/tools/create_tars_server_gomod.sh Shop User Credit foo

因为 tarsgo 依赖 GOPATH 和 GO111MODULE,所以务必按照上面的步骤来操作,完成后会生成一个名为 User 的目录,其中的大概内容如下:

shell> tree ./User
./User
├── Credit.tars
├── Credit_imp.go
├── client
│   └── client.go
├── config.conf
├── debugtool
│   └── dumpstack.go
├── go.mod
├── main.go
├── makefile
└── start.sh

编辑 Credit.tars 文件,定义好我们加积分的 Add 方法:

module Shop
{
    interface Credit
    {
        int Add(int a,int b,out int c); // Some example function
    };
};

接下来就可以通过 tars 文件来生成 golang 文件了(其中调用了 tars2go 工具):

shell> cd User
shell> go mod tidy
shell> make TARSBUILD

文件生成好之后,编辑 Credit_imp.go 文件,加入我们的业务逻辑:

func (imp *CreditImp) Add(ctx context.Context, a int32, b int32, c *int32) (int32, error) {
	log.Println("call add")
	return 100, nil
}

编译服务端和客户端代码,运行就能看到效果了:

shell> go build -o user_server
shell> go build -o user_client ./client/client.go
shell> ./user_server -config config.conf
shell> ./user_client

BTW:缺省生成的客户端代码 client.go 导入的包路径不正确,需要手动调整一下。

总结一下,tarsgo 的开发过程比较简单,基本上就是:编写 tars 文件;用 tars2go 生成代码;实现业务逻辑。当然了,实际部署的时候会有一个管理平台,服务治理等复杂的问题都隐藏在平台里,这些细节就不是本文所考虑的了,再见。

手把手教你用TARS》上有1个想法

发表评论

您的电子邮箱地址不会被公开。 必填项已用*标注