Kitex|青训营笔记

这是我参与「第五届青训营 」伴学笔记创作活动的第 8 天

Kitex-安装

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

kitex-特点

• 高性能

  使用自研的高性能网络库 Netpoll，性能相较 go net 具有显著优势。

• 扩展性

  提供了较多的扩展接口以及默认扩展实现，使用者也可以根据需要自行定制扩展。

• 多消息协议

  RPC 消息协议默认支持 Thrift、Kitex Protobuf、gRPC。使用者也可以扩展自己的消息协议。

• 多传输协议

  传输协议封装消息协议进行 RPC 互通，传输协议可以额外透传元信息，用于服务治理，Kitex 支持的传输协议有 TTHeader、HTTP2。

• 多种消息类型

  支持 PingPong、Oneway、双向 Streaming。其中 Oneway 目前只对 Thrift 协议支持，双向 Streaming 只对 gRPC 支持，后续会考虑支持 Thrift 的双向 Streaming。

• 服务治理

  支持服务注册/发现、负载均衡、熔断、限流、重试、监控、链路跟踪、日志、诊断等服务治理模块，大部分均已提供默认扩展。

• 代码生成

  Kitex 内置代码生成工具，可支持生成 Thrift、Protobuf 以及脚手架代码。

kitex-消息类型

• Pingpong:客户端发起一个请求后会等待一个响应才可以进行下一次请求
• Oneway:客户端发起一个请求后不等待一个响应
• Streaming:客户端发起一个或多个请求，等待一个或多个响应

IDL定义

namespace go echo

struct Request {
    1: string Msg
}

struct Response {
    1: string Msg
}

service EchoService {
    Response Echo(1: Request req); // pingpong method
    oneway void VisitOneway(1: Request req); // oneway method
}

生成组织代码：

.
└── kitex_gen
    └── echo
        ├── echo.go
        ├── echoservice
        │   ├── client.go
        │   ├── echoservice.go
        │   ├── invoker.go
        │   └── server.go
        └── k-echo.go

kitex-基本使用

packemage main

import (
"context"
"example/kitex-gen/api"
)
//服务默认监听端口8888
//EchoImpl最后实现服务接口中的定义
type EchoImpl struct{}
//实现接口
func (s *EchoImpl) Echo(ctx context.Context, req *api.Request)(resp *api.Resposn,err error){
//代码...
return 
}

kitex-发起请求（客户端）

创建Client

import(
"example/kitex-gen/api/echo"
"github.com/cloudwego/kitex/client"
)
c,err :=echo.NewClient("example",client.WithHostPorts("0.0.0.0:8888"))
//错误处理
if err != nil{
log.Fatal(err)
}

发起请求

import "example/kitex-gen/api"
//返回的消息
req := &api.Request(Message:"my request")

resp, err := c.Echo(context.Background(),req,callopt.WithRPCTimeout(3*time.Second))
//错误处理
if err != nil{
log.Fatal(err)
}
log.Println(resp)

参考文献：Kitex