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 地址。