Documentation ¶
Overview ¶
gclient 包提供了便捷的 HTTP 客户端功能。 md5:e1b459f6ec089b4e
Index ¶
- func X创建TLS配置(crt路径, key路径 string) (*tls.Config, error)
- type HandlerFunc
- type Response
- func (r *Response) X关闭() error
- func (r *Response) X取Cookie(名称 string) string
- func (r *Response) X取CookieMap() map[string]string
- func (r *Response) X取响应原始文本() string
- func (r *Response) X取响应字节集() []byte
- func (r *Response) X取响应文本() string
- func (r *Response) X取请求原始文本() string
- func (r *Response) X取请求和响应原始文本() string
- func (r *Response) X覆盖响应内容(字节集 []byte)
- func (r *Response) X请求和响应输出终端()
- type WebSocketClient
- type X结构_网页
- func (c *X结构_网页) Connect响应对象(上下文 context.Context, url string, 参数 ...interface{}) (*Response, error)
- func (c *X结构_网页) Connect字节集(上下文 context.Context, url string, 参数 ...interface{}) []byte
- func (c *X结构_网页) Connect文本(上下文 context.Context, url string, 参数 ...interface{}) string
- func (c *X结构_网页) Connect泛型类(上下文 context.Context, url string, 参数 ...interface{}) *gvar.X结构_泛型类
- func (c *X结构_网页) Cookie(MapCookie map[string]string) *X结构_网页
- func (c *X结构_网页) Delete响应对象(上下文 context.Context, url string, 参数 ...interface{}) (*Response, error)
- func (c *X结构_网页) Delete字节集(上下文 context.Context, url string, 参数 ...interface{}) []byte
- func (c *X结构_网页) Delete文本(上下文 context.Context, url string, 参数 ...interface{}) string
- func (c *X结构_网页) Delete泛型类(上下文 context.Context, url string, 参数 ...interface{}) *gvar.X结构_泛型类
- func (c *X结构_网页) Discovery(discovery gsvc.Discovery) *X结构_网页
- func (c *X结构_网页) DoRequestObj(ctx context.Context, req, res interface{}) error
- func (c *X结构_网页) Get响应对象(上下文 context.Context, url string, 参数 ...interface{}) (*Response, error)
- func (c *X结构_网页) Get字节集(上下文 context.Context, url string, 参数 ...interface{}) []byte
- func (c *X结构_网页) Get文本(上下文 context.Context, url string, 参数 ...interface{}) string
- func (c *X结构_网页) Get泛型类(上下文 context.Context, url string, 参数 ...interface{}) *gvar.X结构_泛型类
- func (c *X结构_网页) Head响应对象(上下文 context.Context, url string, 参数 ...interface{}) (*Response, error)
- func (c *X结构_网页) Head字节集(上下文 context.Context, url string, 参数 ...interface{}) []byte
- func (c *X结构_网页) Head文本(上下文 context.Context, url string, 参数 ...interface{}) string
- func (c *X结构_网页) Head泛型类(上下文 context.Context, url string, 参数 ...interface{}) *gvar.X结构_泛型类
- func (c *X结构_网页) Next(req *http.Request) (*Response, error)
- func (c *X结构_网页) Options响应对象(上下文 context.Context, url string, 参数 ...interface{}) (*Response, error)
- func (c *X结构_网页) Options字节集(上下文 context.Context, url string, 参数 ...interface{}) []byte
- func (c *X结构_网页) Options文本(上下文 context.Context, url string, 参数 ...interface{}) string
- func (c *X结构_网页) Options泛型类(上下文 context.Context, url string, 参数 ...interface{}) *gvar.X结构_泛型类
- func (c *X结构_网页) Patch响应对象(上下文 context.Context, url string, 参数 ...interface{}) (*Response, error)
- func (c *X结构_网页) Patch字节集(上下文 context.Context, url string, 参数 ...interface{}) []byte
- func (c *X结构_网页) Patch文本(上下文 context.Context, url string, 参数 ...interface{}) string
- func (c *X结构_网页) Patch泛型类(上下文 context.Context, url string, 参数 ...interface{}) *gvar.X结构_泛型类
- func (c *X结构_网页) Post响应对象(上下文 context.Context, url string, 参数 ...interface{}) (*Response, error)
- func (c *X结构_网页) Post字节集(上下文 context.Context, url string, 参数 ...interface{}) []byte
- func (c *X结构_网页) Post文本(上下文 context.Context, url string, 参数 ...interface{}) string
- func (c *X结构_网页) Post泛型类(上下文 context.Context, url string, 参数 ...interface{}) *gvar.X结构_泛型类
- func (c *X结构_网页) Post表单响应对象(上下文 context.Context, url string, Map参数 map[string]string) (响应 *Response, 错误 error)
- func (c *X结构_网页) Put响应对象(上下文 context.Context, url string, 参数 ...interface{}) (*Response, error)
- func (c *X结构_网页) Put字节集(上下文 context.Context, url string, 参数 ...interface{}) []byte
- func (c *X结构_网页) Put文本(上下文 context.Context, url string, 参数 ...interface{}) string
- func (c *X结构_网页) Put泛型类(上下文 context.Context, url string, 参数 ...interface{}) *gvar.X结构_泛型类
- func (c *X结构_网页) SetBuilder(builder gsel.Builder)
- func (c *X结构_网页) SetDiscovery(discovery gsvc.Discovery)
- func (c *X结构_网页) Trace响应对象(上下文 context.Context, url string, 参数 ...interface{}) (*Response, error)
- func (c *X结构_网页) Trace字节集(上下文 context.Context, url string, 参数 ...interface{}) []byte
- func (c *X结构_网页) Trace文本(上下文 context.Context, url string, 参数 ...interface{}) string
- func (c *X结构_网页) Trace泛型类(上下文 context.Context, url string, 参数 ...interface{}) *gvar.X结构_泛型类
- func (c *X结构_网页) Url前缀(前缀 string) *X结构_网页
- func (c *X结构_网页) X中间件(中间件s ...HandlerFunc) *X结构_网页
- func (c *X结构_网页) X代理(代理地址 string) *X结构_网页
- func (c *X结构_网页) X内容类型(contentType string) *X结构_网页
- func (c *X结构_网页) X内容类型json() *X结构_网页
- func (c *X结构_网页) X内容类型xml() *X结构_网页
- func (c *X结构_网页) X协议头(map协议头 map[string]string) *X结构_网页
- func (c *X结构_网页) X原始协议头(原始协议头 string) *X结构_网页
- func (c *X结构_网页) X启用浏览器模式(启用 bool) *X结构_网页
- func (c *X结构_网页) X深拷贝对象() *X结构_网页
- func (c *X结构_网页) X设置CookieMap(MapCookie map[string]string) *X结构_网页
- func (c *X结构_网页) X设置Map协议头(map协议头 map[string]string) *X结构_网页
- func (c *X结构_网页) X设置TLS配置(TLS配置 *tls.Config) error
- func (c *X结构_网页) X设置UA(UA值 string) *X结构_网页
- func (c *X结构_网页) X设置cookie(名称, 值 string) *X结构_网页
- func (c *X结构_网页) X设置url前缀(前缀 string) *X结构_网页
- func (c *X结构_网页) X设置代理(代理地址 string)
- func (c *X结构_网页) X设置内容类型(内容类型 string) *X结构_网页
- func (c *X结构_网页) X设置协议头(名称, 值 string) *X结构_网页
- func (c *X结构_网页) X设置原始协议头(原始协议头 string) *X结构_网页
- func (c *X结构_网页) X设置证书(crt路径, key路径 string) error
- func (c *X结构_网页) X设置请求参数禁止URL编码(禁止编码 bool) *X结构_网页
- func (c *X结构_网页) X设置账号密码(账号, 密码 string) *X结构_网页
- func (c *X结构_网页) X设置超时(时长 time.Duration) *X结构_网页
- func (c *X结构_网页) X设置重定向次数限制(次数 int) *X结构_网页
- func (c *X结构_网页) X设置重试与间隔(重试计数 int, 重试间隔时长 time.Duration) *X结构_网页
- func (c *X结构_网页) X请求参数禁止URL编码() *X结构_网页
- func (c *X结构_网页) X请求响应对象(ctx context.Context, method, url string, data ...interface{}) (resp *Response, err error)
- func (c *X结构_网页) X请求字节集(上下文 context.Context, 方法 string, url string, 参数 ...interface{}) []byte
- func (c *X结构_网页) X请求文本(上下文 context.Context, 方法 string, url string, 参数 ...interface{}) string
- func (c *X结构_网页) X请求泛型类(上下文 context.Context, 方法 string, url string, 参数 ...interface{}) *gvar.X结构_泛型类
- func (c *X结构_网页) X账号密码(账号, 密码 string) *X结构_网页
- func (c *X结构_网页) X超时(时长 time.Duration) *X结构_网页
- func (c *X结构_网页) X重定向次数限制(次数 int) *X结构_网页
- func (c *X结构_网页) X重试与间隔(重试次数 int, 重试间隔时长 time.Duration) *X结构_网页
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type HandlerFunc ¶
HandlerFunc 是用于处理中间件的处理器函数. md5:1e0565dffbfa907c
type Response ¶
type Response struct { *http.Response // Response是某些请求的底层http.Response对象。 md5:a2ccaed0095f8487 // contains filtered or unexported fields }
Response 是客户端请求响应的结构体。 md5:3dcf67f589d2cb7d
func (*Response) X取CookieMap ¶
X取CookieMap 获取并返回当前cookie值映射的副本。 md5:b1a4ecf0af8f77bd
func (*Response) X取请求和响应原始文本 ¶
X取请求和响应原始文本返回请求和响应的原始文本。 md5:68a1f59b34b9e33a
func (*Response) X请求和响应输出终端 ¶
func (r *Response) X请求和响应输出终端()
X请求和响应输出终端 将请求和响应的原始文本输出到stdout。 md5:aa9a7a2cc5e60970
type WebSocketClient ¶
WebSocketClient 封装了底层的websocket客户端连接, 并提供了便捷的功能方法。 md5:82e7259d43b0aaee
func X创建WebSocket ¶
func X创建WebSocket() *WebSocketClient
X创建WebSocket 创建并返回一个新的WebSocket客户端对象。 md5:03f6812fa459ed81
type X结构_网页 ¶
type X结构_网页 struct { http.Client // 基础的HTTP客户端。 md5:c6441b0ac3b9a383 // contains filtered or unexported fields }
X结构_网页 是用于HTTP请求管理的HTTP客户端。 md5:4ad1e09a685144a3
func (*X结构_网页) Connect响应对象 ¶
Connect响应对象 发送CONNECT请求并返回响应对象。 注意,如果响应对象永远不会使用,必须关闭它。 md5:cb5555f2c2a7a29d
func (*X结构_网页) Connect字节集 ¶
Connect字节集 发送一个CONNECT请求,获取并返回结果内容作为字节。 md5:32db7a6df27fca73
func (*X结构_网页) Connect文本 ¶
Connect文本 是一个方便的方法,用于发送CONNECT请求,它会检索并返回结果内容,并自动关闭响应对象。 md5:8c261a851ce9854d
func (*X结构_网页) Connect泛型类 ¶
Connect泛型类 发送一个 CONNECT 请求,获取并转换结果内容为 *gvar.Var。 客户端会自动内部读取并关闭响应对象。 得到的 *gvar.Var 可以方便地转换为你想要的任何类型。 md5:152bf738c9672ae0
func (*X结构_网页) Delete响应对象 ¶
Delete响应对象 发送DELETE请求并返回响应对象。 注意,如果响应对象将永远不会被使用,那么必须关闭它。 md5:4dde007718fff7a6
func (*X结构_网页) Delete文本 ¶
Delete文本 是一个便捷方法,用于发送 DELETE 请求,它会获取并返回 结果内容,并自动关闭响应对象。 md5:06595eb1a948e524
func (*X结构_网页) Delete泛型类 ¶
Delete泛型类 发送一个 DELETE 请求,获取并把结果内容转换为 *gvar.Var。 客户端会自动内部读取并关闭响应对象。 结果 *gvar.Var 可以方便地转换为你需要的任何类型。 md5:1954cc9f6686cac5
func (*X结构_网页) Discovery ¶
Discovery 是一个链式函数,用于设置客户端的发现机制。 你可以使用 `Discovery(nil)` 来禁用当前客户端的发现功能。 md5:75d0bac47755ed2a
func (*X结构_网页) DoRequestObj ¶
DoRequestObj 使用标准的请求/响应对象进行HTTP请求。 请求对象 `req` 的定义如下:
类型 UseCreateReq 结构体 { g.Meta `path:"/user" method:"put"` // 其他字段... }
响应对象 `res` 应该是指针类型。如果请求成功,它会自动将结果转换为给定的对象 `res`。
示例: 变量:
req = UseCreateReq{} res *UseCreateRes
使用 DoRequestObj 函数,传入 ctx、req 和 res 指针,执行请求并获取可能的错误:
err := DoRequestObj(ctx, req, &res)
md5:a9b1690353dd26b2
func (*X结构_网页) Get泛型类 ¶
Get泛型类 发送一个GET请求,获取并转换结果内容为*gvar.Var。 客户端会自动内部读取并关闭响应对象。 结果*gvar.Var可以方便地转换为你想要的任何类型。 md5:47d99fdd051eb344
func (*X结构_网页) Head泛型类 ¶
Head泛型类 发送一个HEAD请求,获取并转换结果内容为*gvar.Var。 客户端会自动内部读取并关闭响应对象。 结果*gvar.Var可以方便地转换为你想要的任何类型。 md5:d4338600d66a6acf
func (*X结构_网页) Options响应对象 ¶
Options响应对象 发送OPTIONS请求并返回响应对象。 注意,如果响应对象将永远不会被使用,那么必须关闭它。 md5:3a2d4fbe5e9f5e31
func (*X结构_网页) Options字节集 ¶
Options字节集 发送一个OPTIONS请求,获取并返回结果内容作为字节。 md5:34e2f77f73d41f0d
func (*X结构_网页) Options文本 ¶
Options文本 是一个便捷方法,用于发送 OPTIONS 请求,它会获取并返回结果内容, 并自动关闭响应对象。 md5:9d3090c51505c963
func (*X结构_网页) Options泛型类 ¶
Options泛型类 发送一个 OPTIONS 请求,获取并转换结果内容为 *gvar.Var。 客户端会自动读取并关闭响应对象。 结果 *gvar.Var 可以方便地转换为你需要的任何类型。 md5:9ab65dcef0e9422e
func (*X结构_网页) Patch泛型类 ¶
Patch泛型类 发送一个PATCH请求,获取并转换结果内容为*gvar.Var类型。 客户端会自动内部读取并关闭响应对象。 结果*gvar.Var可以方便地转换为你想要的任何类型。 md5:9786881ed5fc525d
func (*X结构_网页) Post响应对象 ¶
Post响应对象 使用HTTP POST方法发送请求,并返回响应对象。 注意,如果响应对象将永远不会使用,必须关闭它。 md5:9ba8d1283ba032cb
func (*X结构_网页) Post泛型类 ¶
Post泛型类 发送一个POST请求,获取并转换结果内容为*gvar.Var。 客户端内部会自动读取并关闭响应对象。 返回的*gvar.Var可以方便地转换为你想要的任何类型。 md5:51e0af70f2e10306
func (*X结构_网页) Post表单响应对象 ¶
func (c *X结构_网页) Post表单响应对象(上下文 context.Context, url string, Map参数 map[string]string) (响应 *Response, 错误 error)
Post表单响应对象 与 net/http.Post表单响应对象 不同。它是一个 Post 方法的包装器,会将 Content-Type 设置为 "multipart/form-data;"。 它会自动为请求体和 Content-Type 设置边界字符。
类似于下面的情况:
Content-Type: multipart/form-data; boundary=----Boundarye4Ghaog6giyQ9ncN
表单数据如下: ------Boundarye4Ghaog6giyQ9ncN Content-Disposition: form-data; name="checkType"
none
它用于发送表单数据。请注意,如果响应对象永远不会使用,必须关闭它。 md5:bd2237aaca8f2a89
func (*X结构_网页) Put泛型类 ¶
Put泛型类 发送一个PUT请求,获取并转换结果内容为*gvar.Var类型。 客户端会自动内部读取并关闭响应对象。 结果*gvar.Var可以方便地转换为你想要的任何类型。 md5:cb882faeaad7615d
func (*X结构_网页) SetBuilder ¶
SetBuilder 设置客户端的负载均衡构建器。 md5:1f374a9a600309bb
func (*X结构_网页) SetDiscovery ¶
SetDiscovery 为客户端设置负载均衡构建器。 md5:0ea9a7eaf5c235e7
func (*X结构_网页) Trace响应对象 ¶
Trace响应对象 发送TRACE请求并返回响应对象。 请注意,如果响应对象将永远不会被使用,必须关闭它。 md5:82834b110d843156
func (*X结构_网页) Trace泛型类 ¶
Trace泛型类 发送一个 TRACE 请求,获取并转换结果内容为 *gvar.Var 类型。 客户端会自动内部读取并关闭响应对象。 结果的 *gvar.Var 可以方便地转换为你想要的任何类型。 md5:560c30dddc223d10
func (*X结构_网页) Url前缀 ¶
Url前缀是一个链式函数, 它为该客户端的下一个请求设置URL前缀。例如: Url前缀("http://127.0.0.1:8199/api/v1") Url前缀("http://127.0.0.1:8199/api/v2") md5:223b00b33201dec6
func (*X结构_网页) X中间件 ¶
func (c *X结构_网页) X中间件(中间件s ...HandlerFunc) *X结构_网页
X中间件 向客户端添加一个或多个中间件处理器。 md5:92665269b902692e
func (*X结构_网页) X代理 ¶
X代理 是一个链式函数, 用于为下一个请求设置代理。 确保传递正确的 `proxyURL`。 正确的格式应为 `http://USER:PASSWORD@IP:PORT` 或 `socks5://USER:PASSWORD@IP:PORT`。 目前仅支持 `http` 和 `socks5` 类型的代理。 md5:d8c660f7a12e72ea
func (*X结构_网页) X内容类型json ¶
X内容类型json 是一个链式函数, 用于为下一个请求将HTTP内容类型设置为 "application/json"。
注意,它还会自动检查并以JSON格式对参数进行编码。 md5:3b265101262bf8be
func (*X结构_网页) X内容类型xml ¶
X内容类型xml是一个链式函数, 它将下一个请求的HTTP内容类型设置为"application/xml"。
请注意,它还会自动检查并把参数编码为XML格式。 md5:b6e6ad51561fa7a6
func (*X结构_网页) X启用浏览器模式 ¶
X启用浏览器模式 启用客户端的浏览器模式。 当浏览器模式启用时,它会自动保存并从客户端向服务器发送cookie内容以及从服务器接收cookie内容。 md5:00d8775b045e9c09
func (*X结构_网页) X设置CookieMap ¶
X设置CookieMap 使用映射设置Cookie项。 md5:3abd18bc89684efb
func (*X结构_网页) X设置代理 ¶
X设置代理 为客户端设置代理。 当参数 `proxyURL` 为空或格式不正确时,此函数将不会执行任何操作。 正确的格式应为 `http://用户名:密码@IP:端口` 或 `socks5://用户名:密码@IP:端口`。 目前仅支持 `http` 和 `socks5` 类型的代理。 md5:aa3f2b21308c7bec
func (*X结构_网页) X设置请求参数禁止URL编码 ¶
X设置请求参数禁止URL编码 设置标记,表示在发送请求之前不编码参数。 md5:6dd55f5543918206
func (*X结构_网页) X设置重定向次数限制 ¶
X设置重定向次数限制 限制跳转次数。 md5:14e010f8e3d003b5
func (*X结构_网页) X请求参数禁止URL编码 ¶
X请求参数禁止URL编码 设置一个标记,表示在发送请求之前不进行参数编码。 md5:0f78cc83f0909b0e
func (*X结构_网页) X请求响应对象 ¶
func (c *X结构_网页) X请求响应对象( ctx context.Context, method, url string, data ...interface{}, ) (resp *Response, err error)
X请求响应对象 发送给定HTTP方法和数据的请求,并返回响应对象。 注意,如果响应对象永远不会使用,必须关闭它。
如果包含文件上传,它将使用"multipart/form-data"作为Content-Type,否则使用"application/x-www-form-urlencoded"。它还能自动检测POST内容的JSON格式,并为此自动设置Content-Type为"application/json"。 md5:09c1fd65446e9a2e
func (*X结构_网页) X请求泛型类 ¶
func (c *X结构_网页) X请求泛型类(上下文 context.Context, 方法 string, url string, 参数 ...interface{}) *gvar.X结构_泛型类
X请求泛型类 使用给定的HTTP方法和数据发送请求,然后将结果转换为*gvar.Var类型。 客户端会自动内部读取并关闭响应对象。 结果*gvar.Var可以方便地转换为你想要的任何类型。 md5:4f9fa2909af65cbb
Source Files ¶
- gclient.go
- gclient_bytes.go
- gclient_chain.go
- gclient_config.go
- gclient_content.go
- gclient_discovery.go
- gclient_dump.go
- gclient_metrics.go
- gclient_middleware.go
- gclient_observability.go
- gclient_request.go
- gclient_request_obj.go
- gclient_response.go
- gclient_tracer.go
- gclient_tracer_metrics.go
- gclient_tracer_noop.go
- gclient_tracer_tracing.go
- gclient_var.go
- gclient_websocket.go