Call Option

Kitex Call Option 使用说明。

用法

客户端发起 RPC 调用时,额外添加一些 Option,优先级比 Client Option 高,会覆盖某些配置:

resp, err := client.Call(ctx, req, callopt.WithXXX....)

Option 说明

IP 端口 - WithHostPort

func WithHostPort(hostport string) Option

在本次调用阶段直接指定一个具体的 HostPort ,会覆盖掉 Resolver 的结果进行直接访问,详见直连访问-指定 IP 和 Port 进行调用

指定 URL - WithURL

func WithURL(url string) Option

在本次调用阶段重新指定一个指定 URL 发起调用,详见直连访问-指定 URL 进行调用

添加标签 - WithTag

func WithTag(key, val string) Option

为本次 RPC 调用设置一些 Tag 元信息,以 key-value 的形式添加,例如希望在元信息中加入 cluster、idc 等字段用来做服务治理,可以像下面这样写:

resp, err := client.Call(ctx, req,callopt.WithTag("cluster", cluster),callopt.WithTag("idc", idc))

超时设置 - WithRPCTimeout

func WithRPCTimeout(d time.Duration) Option

指定本次 RPC 调用的超时时间,详见超时控制

超时设置 - WithConnectTimeout

func WithConnectTimeout(d time.Duration) Option

为本次 RPC 调用设置连接超时时间,详见超时控制

HTTP Host 设置 - WithHTTPHost

func WithHTTPHost(host string) Option

当使用 HTTP 连接的场景时,该 Option 会在 HTTP Header 中指定 Host 地址。


最后修改 July 24, 2024 : docs: fix error in render (#1110) (34e4f87)