kitex学习笔记(1)

1、安装依赖

安装 kitex和thriftgo

go install github.com/cloudwego/kitex/tool/cmd/kitex@latest​
​go install github.com/cloudwego/thriftgo@latest

  

2、相关概念

(1)Kitex 框架及命令行工具,默认支持 ​thrift ​和 ​proto3 ​两种 IDL(全称是 Interface Definition Language,接口定义语言),对应的 Kitex 支持 ​thrift ​和 ​protobuf ​两种序列化协议。

注:Kitex 在 v0.4.0 版本已支持在 Windows 环境下编译运行了。但代码生成工具暂未支持 Windows 环境。

(2)语法

 

3、运行一个简单的示例

(1)创建一个名为 ​echo.thrift​ 的 thrift IDL 文件,内容如下:

namespace go api

struct Request {
  1: string message
}

struct Response {
  1: string message
}

service Echo {
    Response echo(1: Request req)
}

(2)通过 kitex 工具生成项目代码了,执行如下命令:

kitex -module example -service example echo.thrifts

参数说明:

  • -module​ 表示生成的该项目的 go module 名,如果项目不是mod管理的,则不必写该参数;
  • -service​ 表明我们要生成一个服务端项目,后面紧跟的 ​example​ 为该服务的名字;
  • 最后一个参数则为该服务的 IDL 文件。

(3)运行go mod tidy整理依赖,如果报错,运行如下命令:

go mod edit -droprequire=github.com/apache/thrift/lib/go/thrift
go mod edit -replace=github.com/apache/thrift=github.com/apache/thrift@v0.13.0

(4)在handler.go中编辑服务端逻辑,最终handler.go文件代码如下:

package main

import (
	"log"

	"kitexDemo/kitex_gen/api/echo"
)

func main() {
	svr := echo.NewServer(new(EchoImpl))

	err := svr.Run()

	if err != nil {
		log.Println(err.Error())
	}
}

(5)客户端代码如下:

package main

import (
	"context"
	"log"

	"github.com/cloudwego/kitex/client"
	"kitexDemo/kitex_gen/api"
	"kitexDemo/kitex_gen/api/echo"
)

func main() {
	//创建client
	c, err := echo.NewClient("example", client.WithHostPorts("0.0.0.0:8888"))
	if err != nil {
		log.Fatal(err)
	}

	//发起调用
	req := &api.Request{Message: "my request"}
	resp, err := c.Echo(context.Background(), req)
	if err != nil {
		log.Fatal(err)
	}
	log.Println(resp)
}

  

参考:Kitex 基础教程_w3cschool

posted @ 2022-10-26 14:22  ☞@_@  阅读(81)  评论(0编辑  收藏  举报