// Copyright GoFrame Author(https://goframe.org). All Rights Reserved. // // This Source Code Form is subject to the terms of the MIT License. // If a copy of the MIT was not distributed with this file, // You can obtain one at https://github.com/gogf/gf. package ghttp import ( "github.com/gogf/gf/container/gvar" "github.com/gogf/gf/net/ghttp/internal/client" ) type ( Client = client.Client ClientResponse = client.Response ClientHandlerFunc = client.HandlerFunc ) // NewClient creates and returns a new HTTP client object. func NewClient() *Client { return client.New() } // Get is a convenience method for sending GET request. // NOTE that remembers CLOSING the response object when it'll never be used. // Deprecated, please use g.Client().Get or NewClient().Get instead. func Get(url string, data ...interface{}) (*ClientResponse, error) { return DoRequest("GET", url, data...) } // Put is a convenience method for sending PUT request. // NOTE that remembers CLOSING the response object when it'll never be used. // Deprecated, please use g.Client().Put or NewClient().Put instead. func Put(url string, data ...interface{}) (*ClientResponse, error) { return DoRequest("PUT", url, data...) } // Post is a convenience method for sending POST request. // NOTE that remembers CLOSING the response object when it'll never be used. // Deprecated, please use g.Client().Post or NewClient().Post instead. func Post(url string, data ...interface{}) (*ClientResponse, error) { return DoRequest("POST", url, data...) } // Delete is a convenience method for sending DELETE request. // NOTE that remembers CLOSING the response object when it'll never be used. // Deprecated, please use g.Client().Delete or NewClient().Delete instead. func Delete(url string, data ...interface{}) (*ClientResponse, error) { return DoRequest("DELETE", url, data...) } // Head is a convenience method for sending HEAD request. // NOTE that remembers CLOSING the response object when it'll never be used. // Deprecated, please use g.Client().Head or NewClient().Head instead. func Head(url string, data ...interface{}) (*ClientResponse, error) { return DoRequest("HEAD", url, data...) } // Patch is a convenience method for sending PATCH request. // NOTE that remembers CLOSING the response object when it'll never be used. // Deprecated, please use g.Client().Patch or NewClient().Patch instead. func Patch(url string, data ...interface{}) (*ClientResponse, error) { return DoRequest("PATCH", url, data...) } // Connect is a convenience method for sending CONNECT request. // NOTE that remembers CLOSING the response object when it'll never be used. // Deprecated, please use g.Client().Connect or NewClient().Connect instead. func Connect(url string, data ...interface{}) (*ClientResponse, error) { return DoRequest("CONNECT", url, data...) } // Options is a convenience method for sending OPTIONS request. // NOTE that remembers CLOSING the response object when it'll never be used. // Deprecated, please use g.Client().Options or NewClient().Options instead. func Options(url string, data ...interface{}) (*ClientResponse, error) { return DoRequest("OPTIONS", url, data...) } // Trace is a convenience method for sending TRACE request. // NOTE that remembers CLOSING the response object when it'll never be used. // Deprecated, please use g.Client().Trace or NewClient().Trace instead. func Trace(url string, data ...interface{}) (*ClientResponse, error) { return DoRequest("TRACE", url, data...) } // DoRequest is a convenience method for sending custom http method request. // NOTE that remembers CLOSING the response object when it'll never be used. // Deprecated, please use g.Client().DoRequest or NewClient().DoRequest instead. func DoRequest(method, url string, data ...interface{}) (*ClientResponse, error) { return client.New().DoRequest(method, url, data...) } // GetContent is a convenience method for sending GET request, which retrieves and returns // the result content and automatically closes response object. // Deprecated, please use g.Client().GetContent or NewClient().GetContent instead. func GetContent(url string, data ...interface{}) string { return RequestContent("GET", url, data...) } // PutContent is a convenience method for sending PUT request, which retrieves and returns // the result content and automatically closes response object. // Deprecated, please use g.Client().PutContent or NewClient().PutContent instead. func PutContent(url string, data ...interface{}) string { return RequestContent("PUT", url, data...) } // PostContent is a convenience method for sending POST request, which retrieves and returns // the result content and automatically closes response object. // Deprecated, please use g.Client().PostContent or NewClient().PostContent instead. func PostContent(url string, data ...interface{}) string { return RequestContent("POST", url, data...) } // DeleteContent is a convenience method for sending DELETE request, which retrieves and returns // the result content and automatically closes response object. // Deprecated, please use g.Client().DeleteContent or NewClient().DeleteContent instead. func DeleteContent(url string, data ...interface{}) string { return RequestContent("DELETE", url, data...) } // HeadContent is a convenience method for sending HEAD request, which retrieves and returns // the result content and automatically closes response object. // Deprecated, please use g.Client().HeadContent or NewClient().HeadContent instead. func HeadContent(url string, data ...interface{}) string { return RequestContent("HEAD", url, data...) } // PatchContent is a convenience method for sending PATCH request, which retrieves and returns // the result content and automatically closes response object. // Deprecated, please use g.Client().PatchContent or NewClient().PatchContent instead. func PatchContent(url string, data ...interface{}) string { return RequestContent("PATCH", url, data...) } // ConnectContent is a convenience method for sending CONNECT request, which retrieves and returns // the result content and automatically closes response object. // Deprecated, please use g.Client().ConnectContent or NewClient().ConnectContent instead. func ConnectContent(url string, data ...interface{}) string { return RequestContent("CONNECT", url, data...) } // OptionsContent is a convenience method for sending OPTIONS request, which retrieves and returns // the result content and automatically closes response object. // Deprecated, please use g.Client().OptionsContent or NewClient().OptionsContent instead. func OptionsContent(url string, data ...interface{}) string { return RequestContent("OPTIONS", url, data...) } // TraceContent is a convenience method for sending TRACE request, which retrieves and returns // the result content and automatically closes response object. // Deprecated, please use g.Client().TraceContent or NewClient().TraceContent instead. func TraceContent(url string, data ...interface{}) string { return RequestContent("TRACE", url, data...) } // RequestContent is a convenience method for sending custom http method request, which // retrieves and returns the result content and automatically closes response object. // Deprecated, please use g.Client().RequestContent or NewClient().RequestContent instead. func RequestContent(method string, url string, data ...interface{}) string { return client.New().RequestContent(method, url, data...) } // GetBytes is a convenience method for sending GET request, which retrieves and returns // the result content as bytes and automatically closes response object. // Deprecated, please use g.Client().GetBytes or NewClient().GetBytes instead. func GetBytes(url string, data ...interface{}) []byte { return RequestBytes("GET", url, data...) } // PutBytes is a convenience method for sending PUT request, which retrieves and returns // the result content as bytes and automatically closes response object. // Deprecated, please use g.Client().PutBytes or NewClient().PutBytes instead. func PutBytes(url string, data ...interface{}) []byte { return RequestBytes("PUT", url, data...) } // PostBytes is a convenience method for sending POST request, which retrieves and returns // the result content as bytes and automatically closes response object. // Deprecated, please use g.Client().PostBytes or NewClient().PostBytes instead. func PostBytes(url string, data ...interface{}) []byte { return RequestBytes("POST", url, data...) } // DeleteBytes is a convenience method for sending DELETE request, which retrieves and returns // the result content as bytes and automatically closes response object. // Deprecated, please use g.Client().DeleteBytes or NewClient().DeleteBytes instead. func DeleteBytes(url string, data ...interface{}) []byte { return RequestBytes("DELETE", url, data...) } // HeadBytes is a convenience method for sending HEAD request, which retrieves and returns // the result content as bytes and automatically closes response object. // Deprecated, please use g.Client().HeadBytes or NewClient().HeadBytes instead. func HeadBytes(url string, data ...interface{}) []byte { return RequestBytes("HEAD", url, data...) } // PatchBytes is a convenience method for sending PATCH request, which retrieves and returns // the result content as bytes and automatically closes response object. // Deprecated, please use g.Client().PatchBytes or NewClient().PatchBytes instead. func PatchBytes(url string, data ...interface{}) []byte { return RequestBytes("PATCH", url, data...) } // ConnectBytes is a convenience method for sending CONNECT request, which retrieves and returns // the result content as bytes and automatically closes response object. // Deprecated, please use g.Client().ConnectBytes or NewClient().ConnectBytes instead. func ConnectBytes(url string, data ...interface{}) []byte { return RequestBytes("CONNECT", url, data...) } // OptionsBytes is a convenience method for sending OPTIONS request, which retrieves and returns // the result content as bytes and automatically closes response object. // Deprecated, please use g.Client().OptionsBytes or NewClient().OptionsBytes instead. func OptionsBytes(url string, data ...interface{}) []byte { return RequestBytes("OPTIONS", url, data...) } // TraceBytes is a convenience method for sending TRACE request, which retrieves and returns // the result content as bytes and automatically closes response object. // Deprecated, please use g.Client().TraceBytes or NewClient().TraceBytes instead. func TraceBytes(url string, data ...interface{}) []byte { return RequestBytes("TRACE", url, data...) } // RequestBytes is a convenience method for sending custom http method request, which // retrieves and returns the result content as bytes and automatically closes response object. // Deprecated, please use g.Client().RequestBytes or NewClient().RequestBytes instead. func RequestBytes(method string, url string, data ...interface{}) []byte { return client.New().RequestBytes(method, url, data...) } // GetVar sends a GET request, retrieves and converts the result content to specified pointer. // The parameter can be type of: struct/*struct/**struct/[]struct/[]*struct/*[]struct, et // Deprecated, please use g.Client().GetVar or NewClient().GetVar instead. func GetVar(url string, data ...interface{}) *gvar.Var { return RequestVar("GET", url, data...) } // PutVar sends a PUT request, retrieves and converts the result content to specified pointer. // The parameter can be type of: struct/*struct/**struct/[]struct/[]*struct/*[]struct, et // Deprecated, please use g.Client().PutVar or NewClient().PutVar instead. func PutVar(url string, data ...interface{}) *gvar.Var { return RequestVar("PUT", url, data...) } // PostVar sends a POST request, retrieves and converts the result content to specified pointer. // The parameter can be type of: struct/*struct/**struct/[]struct/[]*struct/*[]struct, et // Deprecated, please use g.Client().PostVar or NewClient().PostVar instead. func PostVar(url string, data ...interface{}) *gvar.Var { return RequestVar("POST", url, data...) } // DeleteVar sends a DELETE request, retrieves and converts the result content to specified pointer. // The parameter can be type of: struct/*struct/**struct/[]struct/[]*struct/*[]struct, et // Deprecated, please use g.Client().DeleteVar or NewClient().DeleteVar instead. func DeleteVar(url string, data ...interface{}) *gvar.Var { return RequestVar("DELETE", url, data...) } // HeadVar sends a HEAD request, retrieves and converts the result content to specified pointer. // The parameter can be type of: struct/*struct/**struct/[]struct/[]*struct/*[]struct, et // Deprecated, please use g.Client().HeadVar or NewClient().HeadVar instead. func HeadVar(url string, data ...interface{}) *gvar.Var { return RequestVar("HEAD", url, data...) } // PatchVar sends a PATCH request, retrieves and converts the result content to specified pointer. // The parameter can be type of: struct/*struct/**struct/[]struct/[]*struct/*[]struct, et // Deprecated, please use g.Client().PatchVar or NewClient().PatchVar instead. func PatchVar(url string, data ...interface{}) *gvar.Var { return RequestVar("PATCH", url, data...) } // ConnectVar sends a CONNECT request, retrieves and converts the result content to specified pointer. // The parameter can be type of: struct/*struct/**struct/[]struct/[]*struct/*[]struct, et // Deprecated, please use g.Client().ConnectVar or NewClient().ConnectVar instead. func ConnectVar(url string, data ...interface{}) *gvar.Var { return RequestVar("CONNECT", url, data...) } // OptionsVar sends a OPTIONS request, retrieves and converts the result content to specified pointer. // The parameter can be type of: struct/*struct/**struct/[]struct/[]*struct/*[]struct, et // Deprecated, please use g.Client().OptionsVar or NewClient().OptionsVar instead. func OptionsVar(url string, data ...interface{}) *gvar.Var { return RequestVar("OPTIONS", url, data...) } // TraceVar sends a TRACE request, retrieves and converts the result content to specified pointer. // The parameter can be type of: struct/*struct/**struct/[]struct/[]*struct/*[]struct, et // Deprecated, please use g.Client().TraceVar or NewClient().TraceVar instead. func TraceVar(url string, data ...interface{}) *gvar.Var { return RequestVar("TRACE", url, data...) } // RequestVar sends request using given HTTP method and data, retrieves converts the result // to specified pointer. It reads and closes the response object internally automatically. // The parameter can be type of: struct/*struct/**struct/[]struct/[]*struct/*[]struct, et // Deprecated, please use g.Client().RequestVar or NewClient().RequestVar instead. func RequestVar(method string, url string, data ...interface{}) *gvar.Var { response, err := DoRequest(method, url, data...) if err != nil { return gvar.New(nil) } defer response.Close() return gvar.New(response.ReadAll()) }