直连访问

在明确要访问某个下游地址时,Kitex 可以选择直连访问的方式,不需要经过服务发现。

指定 IP 和 Port 进行调用

在进行调用时,可以通过 callopt.WithHostPort 指定,支持两种参数:

  • 普通 IP 地址,形式为 “host:port”,支持 IPv6
  • sock 文件地址,通过 UDS (Unix Domain Socket) 通信
import "github.com/cloudwego/kitex/client/callopt"
...
resp, err := cli.Echo(context.Background(), req, callopt.WithHostPort("127.0.0.1:8888"))
if err != nil {
   log.Fatal(err)
}

指定 URL 进行调用

在进行调用时,可以通过 callopt.WithURL 指定,通过该 option 指定的 URL,会经过默认的 DNS resolver 解析后拿到 host 和 port,此时其等效于 callopt.WithHostPort

import "github.com/cloudwego/kitex/client/callopt"
...
url := callopt.WithURL("http://myserverdomain.com:8888")
resp, err := cli.Echo(context.Background(), req, url)
if err != nil {
   log.Fatal(err)
}

自定义 DNS resolver

此外也可以自定义 DNS resolver

resolver 定义如下 (pkg/http):

type Resolver interface {
   Resolve(string) (string, error)
}

参数为 URL,返回值为访问的 server 的 “host:port”。

通过 client.WithHTTPResolver 指定用于 DNS 解析的 resolver。

import "github.com/cloudwego/kitex/client/callopt"
...
dr := client.WithHTTPResolver(myResolver)
cli, err := echo.NewClient("echo", dr)
if err != nil {
   log.Fatal(err)
}

最后修改 August 2, 2023 : docs: add document http3 (#737) (5cdb2f3)