README
¶
Here is a generated GitHub README.md based on the provided Go code:
Go HTTP Client Builder
Go HTTP Client Builder is a Go package for building HTTP clients with fluent interface. It provides an easy way to configure HTTP requests and handle responses.
Installation
go get github.com/catnovel/builder
Usage
Create a new client
client := builder.NewClient()
Configure the client
client.SetBaseUrl("https://api.example.com")
.SetTimeout(30)
.SetUserAgent("my-app/1.0")
Make a request
req := client.R()
resp, err := req.Get("/users")
Handle response
if err != nil {
// handle error
}
fmt.Println(resp.GetStatusCode())
fmt.Println(resp.String())
Post form data
req.SetFormData(map[string]string{
"name": "John",
"email": "john@email.com",
})
resp, err := req.Post("/users")
Request builder
The R() method creates a new Request object that can be used to configure an HTTP request.
Set request body
req.SetBody(map[string]interface{}{
"name": "John",
"age": 30,
})
Supports body types: string, []byte, map[string]interface{}, etc.
Set request headers
req.SetHeader("Content-Type", "application/json")
.SetHeader("Authorization", "Bearer token")
Set query parameters
req.SetQueryParam("sort", "desc")
.SetQueryParam("limit", 100)
Set cookies
req.SetCookies([]*http.Cookie{
{Name: "session", Value: "1234"},
})
Response builder
The Response object contains the HTTP response and useful methods to handle it.
Get response as string
resp.String()
Get response as JSON
var data struct{}
resp.Json(&data)
Get response as HTML document
doc := resp.Html()
Get response headers
headers := resp.GetHeader()
Full Example
client := builder.NewClient()
req := client.R()
req.SetQueryParam("page", 1)
.SetHeader("Authorization", "token")
resp, err := req.Get("/users")
if err != nil {
// handle error
}
var result []User
resp.Json(&result)
Contributing
Pull requests are welcome. Feel free to open an issue for any bugs or feature requests.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Documentation
¶
Index ¶
- Constants
- type Client
- func (client *Client) GetClientBaseURL() string
- func (client *Client) GetClientBody() interface{}
- func (client *Client) GetClientCookie() string
- func (client *Client) GetClientDebug() bool
- func (client *Client) GetClientQueryParams() map[string]any
- func (client *Client) GetClientRetryNumber() int
- func (client *Client) GetClientTimeout() int
- func (client *Client) LogDebug(info string)
- func (client *Client) LogError(err any, query any, fileName, funcName string)
- func (client *Client) LogFatal(err error, query any, fileName string, funcName string)
- func (client *Client) LogInfo(err any, query any, funcName string)
- func (client *Client) R() *Request
- func (client *Client) SetAuthorizationKey(authToken string) *Client
- func (client *Client) SetBaseURL(baseUrl string) *Client
- func (client *Client) SetBasicAuth(username, password string) *Client
- func (client *Client) SetContentType(contentType string) *Client
- func (client *Client) SetCookie(cookie *http.Cookie) *Client
- func (client *Client) SetCookieJar(cookieJar http.CookieJar) *Client
- func (client *Client) SetCookieString(cookieStr string) *Client
- func (client *Client) SetCookies(cookie []*http.Cookie) *Client
- func (client *Client) SetDebug() *Client
- func (client *Client) SetDebugFile(name string) *Client
- func (client *Client) SetHeader(key string, value interface{}) *Client
- func (client *Client) SetHeaders(headers map[string]interface{}) *Client
- func (client *Client) SetProxy(proxy string) *Client
- func (client *Client) SetQueryParam(key string, value any) *Client
- func (client *Client) SetQueryParamString(query string) *Client
- func (client *Client) SetQueryParams(params map[string]any) *Client
- func (client *Client) SetResultFunc(f func(v string) (string, error)) *Client
- func (client *Client) SetRetryCount(count int) *Client
- func (client *Client) SetTimeout(timeout int) *Client
- func (client *Client) SetUserAgent(userAgent string) *Client
- type Request
- func (request *Request) Delete(url string) (*Response, error)
- func (request *Request) Get(url string) (*Response, error)
- func (request *Request) GetHeaderContentType() string
- func (request *Request) GetHost() string
- func (request *Request) GetMethod() string
- func (request *Request) GetPath() string
- func (request *Request) GetQueryParamsEncode() string
- func (request *Request) GetQueryParamsNopCloser() io.ReadCloser
- func (request *Request) GetRequestHeader() http.Header
- func (request *Request) GetUrl() string
- func (request *Request) Head(url string) (*Response, error)
- func (request *Request) Options(url string) (*Response, error)
- func (request *Request) Patch(url string) (*Response, error)
- func (request *Request) Post(url string) (*Response, error)
- func (request *Request) Put(url string) (*Response, error)
- func (request *Request) SetBody(v interface{}) *Request
- func (request *Request) SetCookie(cookie *http.Cookie) *Request
- func (request *Request) SetCookies(cookie []*http.Cookie) *Request
- func (request *Request) SetHeader(key, value string) *Request
- func (request *Request) SetHeaderContentType(contentType string) *Request
- func (request *Request) SetHeaders(headers map[string]string) *Request
- func (request *Request) SetQueryParam(key string, value any) *Request
- func (request *Request) SetQueryParams(query map[string]any) *Request
- func (request *Request) SetQueryString(query string) *Request
- type Response
- func (response *Response) GetByte() []byte
- func (response *Response) GetCookieString() string
- func (response *Response) GetCookies() []*http.Cookie
- func (response *Response) GetHeader() http.Header
- func (response *Response) GetProto() string
- func (response *Response) GetStatus() string
- func (response *Response) GetStatusCode() int
- func (response *Response) Gjson() gjson.Result
- func (response *Response) Html() *goquery.Document
- func (response *Response) HtmlGbk() *goquery.Document
- func (response *Response) IsStatusOk() bool
- func (response *Response) Json(v any) error
- func (response *Response) String() string
- func (response *Response) StringGbk() string
Constants ¶
const ( // MethodGet HTTP method MethodGet = "GET" // MethodPost HTTP method MethodPost = "POST" // MethodPut HTTP method MethodPut = "PUT" // MethodDelete HTTP method MethodDelete = "DELETE" // MethodPatch HTTP method MethodPatch = "PATCH" // MethodHead HTTP method MethodHead = "HEAD" // MethodOptions HTTP method MethodOptions = "OPTIONS" )
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Client ¶
type Client struct {
sync.RWMutex // 用于保证线程安全
MaxConcurrent chan struct{} // 用于限制并发数
Header map[string]string // Header 用于存储 HTTP 请求的 Header 部分
QueryParam map[string]any // QueryParam 用于存储 HTTP 请求的 Query 部分
Token string
AuthScheme string
Cookies []*http.Cookie
Debug bool
AllowGetMethodPayload bool
RetryCount int
JSONMarshal func(v interface{}) ([]byte, error)
JSONUnmarshal func(data []byte, v interface{}) error
XMLMarshal func(v interface{}) ([]byte, error)
XMLUnmarshal func(data []byte, v interface{}) error
HeaderAuthorizationKey string
// contains filtered or unexported fields
}
Client 类型用于存储 HTTP 请求的相关信息。
func (*Client) GetClientBaseURL ¶ added in v0.0.8
GetClientBaseURL 方法用于获取 HTTP 请求的 BaseUrl 部分。它返回一个 string 类型的参数。
func (*Client) GetClientBody ¶
func (client *Client) GetClientBody() interface{}
GetClientBody 方法用于获取 HTTP 请求的 Body 部分。它返回一个 interface{} 类型的参数。
func (*Client) GetClientCookie ¶
GetClientCookie 方法用于获取 HTTP 请求的 Cookie 部分。它返回一个 string 类型的参数。
func (*Client) GetClientDebug ¶
GetClientDebug 方法用于获取 HTTP 请求的 Debug 部分。它返回一个 bool 类型的参数。
func (*Client) GetClientQueryParams ¶
GetClientQueryParams 方法用于获取 HTTP 请求的 Query 部分。它返回一个
func (*Client) GetClientRetryNumber ¶
GetClientRetryNumber 方法用于获取 HTTP 请求的 RetryNumber 部分。它返回一个 int 类型的参数。
func (*Client) GetClientTimeout ¶
GetClientTimeout 方法用于获取 HTTP 请求的 Timeout 部分。它返回一个 int 类型的参数。
func (*Client) SetAuthorizationKey ¶ added in v0.3.1
SetAuthorizationKey 方法用于设置 HTTP 请求的 Authorization 部分。它接收一个 string 类型的参数，该参数表示 Authorization 的值。
func (*Client) SetBaseURL ¶
SetBaseURL 方法用于设置HTTP请求的 BaseUrl 部分。它接收一个 string 类型的参数，该参数表示 BaseUrl 的值。
func (*Client) SetBasicAuth ¶
SetBasicAuth 方法用于设置 HTTP 请求的 BasicAuth 部分。它接收两个 string 类型的参数，分别表示用户名和密码。
func (*Client) SetContentType ¶ added in v0.1.0
SetContentType 方法用于设置 HTTP 请求的 ContentType 部分。它接收一个 string 类型的参数，该参数表示 ContentType 的值。
func (*Client) SetCookieJar ¶
SetCookieJar 方法用于设置 HTTP 请求的 CookieJar 部分。它接收一个 http.CookieJar 类型的参数，该参数表示 CookieJar 的值。
func (*Client) SetCookieString ¶ added in v0.4.5
SetCookieString 方法用于设置 HTTP 请求的 Cookie 部分。它接收一个 string 类型的参数，该参数表示 Cookie 的值。
func (*Client) SetCookies ¶ added in v0.4.5
func (*Client) SetDebugFile ¶
SetDebugFile 方法用于设置输出调试信息的文件。它接收一个 string 类型的参数，该参数表示文件名。
func (*Client) SetHeaders ¶
SetHeaders 方法用于设置 HTTP 请求的 Header 部分。它接收一个 map[string]interface{} 类型的参数，
func (*Client) SetQueryParam ¶
SetQueryParam 方法用于设置 HTTP 请求的 Query 部分。它接收两个 string 类型的参数，
func (*Client) SetQueryParamString ¶
SetQueryParamString 方法用于设置 HTTP 请求的 Query 部分。它接收一个 string 类型的参数，
func (*Client) SetQueryParams ¶
SetQueryParams 方法用于设置 HTTP 请求的 Query 部分。它接收一个 map[string]interface{} 类型的参数，
func (*Client) SetResultFunc ¶ added in v0.1.0
func (*Client) SetRetryCount ¶ added in v0.1.0
SetRetryCount 方法用于设置重试次数。它接收一个 int 类型的参数，该参数表示重试次数。
func (*Client) SetTimeout ¶
SetTimeout 方法用于设置 HTTP 请求的 Timeout 部分, timeout 单位为秒。它接收一个 int 类型的参数，该参数表示 Timeout 的值。
func (*Client) SetUserAgent ¶
SetUserAgent 方法用于设置 HTTP 请求的 User-Agent 部分。它接收一个 string 类型的参数，该参数表示 User-Agent 的值。
type Request ¶
type Request struct {
URL *url.URL
Method string // HTTP 请求的 Method 部分
Body any
Header sync.Map
QueryParam sync.Map
Cookies []*http.Cookie
NewRequest *http.Request
// contains filtered or unexported fields
}
func (*Request) GetHeaderContentType ¶ added in v0.3.1
func (*Request) GetQueryParamsEncode ¶
GetQueryParamsEncode 方法用于获取 HTTP 请求的 Query 部分的 URL 编码字符串。
func (*Request) GetQueryParamsNopCloser ¶
func (request *Request) GetQueryParamsNopCloser() io.ReadCloser
GetQueryParamsNopCloser 方法用于获取 HTTP 请求的 Query 部分的 ReadCloser。
func (*Request) GetRequestHeader ¶
GetRequestHeader 方法用于获取 HTTP 请求的 Header 部分的 http.Header。
func (*Request) SetCookies ¶
SetCookies 方法用于设置 HTTP 请求的 Cookies 部分。它接收一个 []*http.Cookie 类型的参数，
func (*Request) SetHeaderContentType ¶ added in v0.3.1
func (*Request) SetHeaders ¶ added in v0.0.8
func (*Request) SetQueryParam ¶
SetQueryParam 方法用于设置 HTTP 请求的 Query 部分。它接收两个 string 类型的参数，
func (*Request) SetQueryParams ¶
SetQueryParams 方法用于设置 HTTP 请求的 Query 部分。它接收一个 map[string]interface{} 类型的参数，
func (*Request) SetQueryString ¶
SetQueryString 方法用于设置 HTTP 请求的 Query 部分。它接收一个 string 类型的参数，
type Response ¶
type Response struct {
Request *http.Request
Result string // 响应体字符串结果
ResponseRaw *http.Response // 指向 http.Response 的指针
RequestSource *Request // 指向 Request 的指针
}
func (*Response) GetCookieString ¶ added in v0.4.5
func (*Response) GetCookies ¶
GetCookies 方法用于获取 HTTP 响应的 Cookies 部分。
func (*Response) GetStatusCode ¶
GetStatusCode 方法用于获取 HTTP 响应的状态码。
Source Files
Directories