http.go 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641
  1. package utils
  2. import (
  3. "bytes"
  4. "compress/gzip"
  5. "context"
  6. "crypto/tls"
  7. "encoding/json"
  8. "encoding/xml"
  9. "fmt"
  10. "io"
  11. "io/ioutil"
  12. "log"
  13. "mime/multipart"
  14. "net"
  15. "net/http"
  16. "net/http/cookiejar"
  17. "net/http/httputil"
  18. "net/url"
  19. "os"
  20. "path"
  21. "strings"
  22. "sync"
  23. "time"
  24. "gopkg.in/yaml.v2"
  25. )
  26. var defaultSetting = HTTPSettings{
  27. UserAgent: "beegoServer",
  28. ConnectTimeout: 60 * time.Second,
  29. ReadWriteTimeout: 60 * time.Second,
  30. Gzip: true,
  31. DumpBody: true,
  32. }
  33. var defaultCookieJar http.CookieJar
  34. var settingMutex sync.Mutex
  35. // it will be the last filter and execute request.Do
  36. var doRequestFilter = func(ctx context.Context, req *HTTPRequest) (*http.Response, error) {
  37. return req.doRequest(ctx)
  38. }
  39. // createDefaultCookie creates a global cookiejar to store cookies.
  40. func createDefaultCookie() {
  41. settingMutex.Lock()
  42. defer settingMutex.Unlock()
  43. defaultCookieJar, _ = cookiejar.New(nil)
  44. }
  45. // SetDefaultSetting overwrites default settings
  46. func SetDefaultSetting(setting HTTPSettings) {
  47. settingMutex.Lock()
  48. defer settingMutex.Unlock()
  49. defaultSetting = setting
  50. }
  51. // NewRequest returns *HTTPRequest with specific method
  52. func NewRequest(rawurl, method string) *HTTPRequest {
  53. var resp http.Response
  54. u, err := url.Parse(rawurl)
  55. fmt.Println("====", u)
  56. if err != nil {
  57. log.Println("Httplib:", err)
  58. }
  59. req := http.Request{
  60. URL: u,
  61. Method: method,
  62. Header: make(http.Header),
  63. Proto: "HTTP/1.1",
  64. ProtoMajor: 1,
  65. ProtoMinor: 1,
  66. }
  67. return &HTTPRequest{
  68. url: rawurl,
  69. req: &req,
  70. params: map[string][]string{},
  71. files: map[string]string{},
  72. setting: defaultSetting,
  73. resp: &resp,
  74. }
  75. }
  76. // Get returns *HTTPRequest with GET method.
  77. func Get(url string) *HTTPRequest {
  78. return NewRequest(url, "GET")
  79. }
  80. // Post returns *HTTPRequest with POST method.
  81. func Post(url string) *HTTPRequest {
  82. return NewRequest(url, "POST")
  83. }
  84. // Put returns *HTTPRequest with PUT method.
  85. func Put(url string) *HTTPRequest {
  86. return NewRequest(url, "PUT")
  87. }
  88. // Delete returns *HTTPRequest DELETE method.
  89. func Delete(url string) *HTTPRequest {
  90. return NewRequest(url, "DELETE")
  91. }
  92. // Head returns *HTTPRequest with HEAD method.
  93. func Head(url string) *HTTPRequest {
  94. return NewRequest(url, "HEAD")
  95. }
  96. // HTTPSettings is the http.Client setting
  97. type HTTPSettings struct {
  98. ShowDebug bool
  99. UserAgent string
  100. ConnectTimeout time.Duration
  101. ReadWriteTimeout time.Duration
  102. TLSClientConfig *tls.Config
  103. Proxy func(*http.Request) (*url.URL, error)
  104. Transport http.RoundTripper
  105. CheckRedirect func(req *http.Request, via []*http.Request) error
  106. EnableCookie bool
  107. Gzip bool
  108. DumpBody bool
  109. Retries int // if set to -1 means will retry forever
  110. RetryDelay time.Duration
  111. }
  112. // HTTPRequest provides more useful methods than http.Request for requesting a url.
  113. type HTTPRequest struct {
  114. url string
  115. req *http.Request
  116. params map[string][]string
  117. files map[string]string
  118. setting HTTPSettings
  119. resp *http.Response
  120. body []byte
  121. dump []byte
  122. }
  123. // GetRequest returns the request object
  124. func (b *HTTPRequest) GetRequest() *http.Request {
  125. return b.req
  126. }
  127. // Setting changes request settings
  128. func (b *HTTPRequest) Setting(setting HTTPSettings) *HTTPRequest {
  129. b.setting = setting
  130. return b
  131. }
  132. // SetBasicAuth sets the request's Authorization header to use HTTP Basic Authentication with the provided username and password.
  133. func (b *HTTPRequest) SetBasicAuth(username, password string) *HTTPRequest {
  134. b.req.SetBasicAuth(username, password)
  135. return b
  136. }
  137. // SetEnableCookie sets enable/disable cookiejar
  138. func (b *HTTPRequest) SetEnableCookie(enable bool) *HTTPRequest {
  139. b.setting.EnableCookie = enable
  140. return b
  141. }
  142. // SetUserAgent sets User-Agent header field
  143. func (b *HTTPRequest) SetUserAgent(useragent string) *HTTPRequest {
  144. b.setting.UserAgent = useragent
  145. return b
  146. }
  147. // Debug sets show debug or not when executing request.
  148. func (b *HTTPRequest) Debug(isdebug bool) *HTTPRequest {
  149. b.setting.ShowDebug = isdebug
  150. return b
  151. }
  152. // Retries sets Retries times.
  153. // default is 0 (never retry)
  154. // -1 retry indefinitely (forever)
  155. // Other numbers specify the exact retry amount
  156. func (b *HTTPRequest) Retries(times int) *HTTPRequest {
  157. b.setting.Retries = times
  158. return b
  159. }
  160. // RetryDelay sets the time to sleep between reconnection attempts
  161. func (b *HTTPRequest) RetryDelay(delay time.Duration) *HTTPRequest {
  162. b.setting.RetryDelay = delay
  163. return b
  164. }
  165. // DumpBody sets the DumbBody field
  166. func (b *HTTPRequest) DumpBody(isdump bool) *HTTPRequest {
  167. b.setting.DumpBody = isdump
  168. return b
  169. }
  170. // DumpRequest returns the DumpRequest
  171. func (b *HTTPRequest) DumpRequest() []byte {
  172. return b.dump
  173. }
  174. // SetTimeout sets connect time out and read-write time out for BeegoRequest.
  175. func (b *HTTPRequest) SetTimeout(connectTimeout, readWriteTimeout time.Duration) *HTTPRequest {
  176. b.setting.ConnectTimeout = connectTimeout
  177. b.setting.ReadWriteTimeout = readWriteTimeout
  178. return b
  179. }
  180. // SetTLSClientConfig sets TLS connection configuration if visiting HTTPS url.
  181. func (b *HTTPRequest) SetTLSClientConfig(config *tls.Config) *HTTPRequest {
  182. b.setting.TLSClientConfig = config
  183. return b
  184. }
  185. // Header adds header item string in request.
  186. func (b *HTTPRequest) Header(key, value string) *HTTPRequest {
  187. b.req.Header.Set(key, value)
  188. return b
  189. }
  190. // SetHost set the request host
  191. func (b *HTTPRequest) SetHost(host string) *HTTPRequest {
  192. b.req.Host = host
  193. return b
  194. }
  195. // SetProtocolVersion sets the protocol version for incoming requests.
  196. // Client requests always use HTTP/1.1.
  197. func (b *HTTPRequest) SetProtocolVersion(vers string) *HTTPRequest {
  198. if len(vers) == 0 {
  199. vers = "HTTP/1.1"
  200. }
  201. major, minor, ok := http.ParseHTTPVersion(vers)
  202. if ok {
  203. b.req.Proto = vers
  204. b.req.ProtoMajor = major
  205. b.req.ProtoMinor = minor
  206. }
  207. return b
  208. }
  209. // SetCookie adds a cookie to the request.
  210. func (b *HTTPRequest) SetCookie(cookie *http.Cookie) *HTTPRequest {
  211. b.req.Header.Add("Cookie", cookie.String())
  212. return b
  213. }
  214. // SetTransport sets the transport field
  215. func (b *HTTPRequest) SetTransport(transport http.RoundTripper) *HTTPRequest {
  216. b.setting.Transport = transport
  217. return b
  218. }
  219. // SetProxy sets the HTTP proxy
  220. // example:
  221. //
  222. // func(req *http.Request) (*url.URL, error) {
  223. // u, _ := url.ParseRequestURI("http://127.0.0.1:8118")
  224. // return u, nil
  225. // }
  226. func (b *HTTPRequest) SetProxy(proxy func(*http.Request) (*url.URL, error)) *HTTPRequest {
  227. b.setting.Proxy = proxy
  228. return b
  229. }
  230. // SetCheckRedirect specifies the policy for handling redirects.
  231. //
  232. // If CheckRedirect is nil, the Client uses its default policy,
  233. // which is to stop after 10 consecutive requests.
  234. func (b *HTTPRequest) SetCheckRedirect(redirect func(req *http.Request, via []*http.Request) error) *HTTPRequest {
  235. b.setting.CheckRedirect = redirect
  236. return b
  237. }
  238. // Param adds query param in to request.
  239. // params build query string as ?key1=value1&key2=value2...
  240. func (b *HTTPRequest) Param(key, value string) *HTTPRequest {
  241. if param, ok := b.params[key]; ok {
  242. b.params[key] = append(param, value)
  243. } else {
  244. b.params[key] = []string{value}
  245. }
  246. return b
  247. }
  248. // PostFile adds a post file to the request
  249. func (b *HTTPRequest) PostFile(formname, filename string) *HTTPRequest {
  250. b.files[formname] = filename
  251. return b
  252. }
  253. // Body adds request raw body.
  254. // Supports string and []byte.
  255. func (b *HTTPRequest) Body(data interface{}) *HTTPRequest {
  256. switch t := data.(type) {
  257. case string:
  258. bf := bytes.NewBufferString(t)
  259. b.req.Body = ioutil.NopCloser(bf)
  260. b.req.ContentLength = int64(len(t))
  261. case []byte:
  262. bf := bytes.NewBuffer(t)
  263. b.req.Body = ioutil.NopCloser(bf)
  264. b.req.ContentLength = int64(len(t))
  265. }
  266. return b
  267. }
  268. // XMLBody adds the request raw body encoded in XML.
  269. func (b *HTTPRequest) XMLBody(obj interface{}) (*HTTPRequest, error) {
  270. if b.req.Body == nil && obj != nil {
  271. byts, err := xml.Marshal(obj)
  272. if err != nil {
  273. return b, err
  274. }
  275. b.req.Body = ioutil.NopCloser(bytes.NewReader(byts))
  276. b.req.ContentLength = int64(len(byts))
  277. b.req.Header.Set("Content-Type", "application/xml")
  278. }
  279. return b, nil
  280. }
  281. // YAMLBody adds the request raw body encoded in YAML.
  282. func (b *HTTPRequest) YAMLBody(obj interface{}) (*HTTPRequest, error) {
  283. if b.req.Body == nil && obj != nil {
  284. byts, err := yaml.Marshal(obj)
  285. if err != nil {
  286. return b, err
  287. }
  288. b.req.Body = ioutil.NopCloser(bytes.NewReader(byts))
  289. b.req.ContentLength = int64(len(byts))
  290. b.req.Header.Set("Content-Type", "application/x+yaml")
  291. }
  292. return b, nil
  293. }
  294. // JSONBody adds the request raw body encoded in JSON.
  295. func (b *HTTPRequest) JSONBody(obj interface{}) (*HTTPRequest, error) {
  296. if b.req.Body == nil && obj != nil {
  297. byts, err := json.Marshal(obj)
  298. if err != nil {
  299. return b, err
  300. }
  301. b.req.Body = ioutil.NopCloser(bytes.NewReader(byts))
  302. b.req.ContentLength = int64(len(byts))
  303. b.req.Header.Set("Content-Type", "application/json")
  304. }
  305. return b, nil
  306. }
  307. func (b *HTTPRequest) buildURL(paramBody string) {
  308. // build GET url with query string
  309. if b.req.Method == "GET" && len(paramBody) > 0 {
  310. if strings.Contains(b.url, "?") {
  311. b.url += "&" + paramBody
  312. } else {
  313. b.url = b.url + "?" + paramBody
  314. }
  315. return
  316. }
  317. // build POST/PUT/PATCH url and body
  318. if (b.req.Method == "POST" || b.req.Method == "PUT" || b.req.Method == "PATCH" || b.req.Method == "DELETE") && b.req.Body == nil {
  319. // with files
  320. if len(b.files) > 0 {
  321. pr, pw := io.Pipe()
  322. bodyWriter := multipart.NewWriter(pw)
  323. go func() {
  324. for formname, filename := range b.files {
  325. fileWriter, err := bodyWriter.CreateFormFile(formname, filename)
  326. if err != nil {
  327. log.Println("Httplib:", err)
  328. }
  329. fh, err := os.Open(filename)
  330. if err != nil {
  331. log.Println("Httplib:", err)
  332. }
  333. // iocopy
  334. _, err = io.Copy(fileWriter, fh)
  335. fh.Close()
  336. if err != nil {
  337. log.Println("Httplib:", err)
  338. }
  339. }
  340. for k, v := range b.params {
  341. for _, vv := range v {
  342. bodyWriter.WriteField(k, vv)
  343. }
  344. }
  345. bodyWriter.Close()
  346. pw.Close()
  347. }()
  348. b.Header("Content-Type", bodyWriter.FormDataContentType())
  349. b.req.Body = ioutil.NopCloser(pr)
  350. b.Header("Transfer-Encoding", "chunked")
  351. return
  352. }
  353. // with params
  354. if len(paramBody) > 0 {
  355. b.Header("Content-Type", "application/x-www-form-urlencoded")
  356. b.Body(paramBody)
  357. }
  358. }
  359. }
  360. func (b *HTTPRequest) getResponse() (*http.Response, error) {
  361. if b.resp.StatusCode != 0 {
  362. return b.resp, nil
  363. }
  364. fmt.Println(b.req.URL)
  365. resp, err := b.DoRequest()
  366. if err != nil {
  367. return nil, err
  368. }
  369. b.resp = resp
  370. return resp, nil
  371. }
  372. // DoRequest executes client.Do
  373. func (b *HTTPRequest) DoRequest() (resp *http.Response, err error) {
  374. return b.DoRequestWithCtx(context.Background())
  375. }
  376. func (b *HTTPRequest) DoRequestWithCtx(ctx context.Context) (resp *http.Response, err error) {
  377. root := doRequestFilter
  378. return root(ctx, b)
  379. }
  380. func (b *HTTPRequest) doRequest(ctx context.Context) (resp *http.Response, err error) {
  381. var paramBody string
  382. if len(b.params) > 0 {
  383. var buf bytes.Buffer
  384. for k, v := range b.params {
  385. for _, vv := range v {
  386. buf.WriteString(url.QueryEscape(k))
  387. buf.WriteByte('=')
  388. buf.WriteString(url.QueryEscape(vv))
  389. buf.WriteByte('&')
  390. }
  391. }
  392. paramBody = buf.String()
  393. paramBody = paramBody[0 : len(paramBody)-1]
  394. }
  395. b.buildURL(paramBody)
  396. urlParsed, err := url.Parse(b.url)
  397. if err != nil {
  398. return nil, err
  399. }
  400. b.req.URL = urlParsed
  401. trans := b.setting.Transport
  402. if trans == nil {
  403. // create default transport
  404. trans = &http.Transport{
  405. TLSClientConfig: b.setting.TLSClientConfig,
  406. Proxy: b.setting.Proxy,
  407. Dial: TimeoutDialer(b.setting.ConnectTimeout, b.setting.ReadWriteTimeout),
  408. MaxIdleConnsPerHost: 100,
  409. }
  410. } else {
  411. // if b.transport is *http.Transport then set the settings.
  412. if t, ok := trans.(*http.Transport); ok {
  413. if t.TLSClientConfig == nil {
  414. t.TLSClientConfig = b.setting.TLSClientConfig
  415. }
  416. if t.Proxy == nil {
  417. t.Proxy = b.setting.Proxy
  418. }
  419. if t.Dial == nil {
  420. t.Dial = TimeoutDialer(b.setting.ConnectTimeout, b.setting.ReadWriteTimeout)
  421. }
  422. }
  423. }
  424. var jar http.CookieJar
  425. if b.setting.EnableCookie {
  426. if defaultCookieJar == nil {
  427. createDefaultCookie()
  428. }
  429. jar = defaultCookieJar
  430. }
  431. client := &http.Client{
  432. Transport: trans,
  433. Jar: jar,
  434. }
  435. if b.setting.UserAgent != "" && b.req.Header.Get("User-Agent") == "" {
  436. b.req.Header.Set("User-Agent", b.setting.UserAgent)
  437. }
  438. if b.setting.CheckRedirect != nil {
  439. client.CheckRedirect = b.setting.CheckRedirect
  440. }
  441. if b.setting.ShowDebug {
  442. dump, err := httputil.DumpRequest(b.req, b.setting.DumpBody)
  443. if err != nil {
  444. log.Println(err.Error())
  445. }
  446. b.dump = dump
  447. }
  448. // retries default value is 0, it will run once.
  449. // retries equal to -1, it will run forever until success
  450. // retries is setted, it will retries fixed times.
  451. // Sleeps for a 400ms inbetween calls to reduce spam
  452. for i := 0; b.setting.Retries == -1 || i <= b.setting.Retries; i++ {
  453. resp, err = client.Do(b.req)
  454. if err == nil {
  455. break
  456. }
  457. time.Sleep(b.setting.RetryDelay)
  458. }
  459. return resp, err
  460. }
  461. // String returns the body string in response.
  462. // Calls Response inner.
  463. func (b *HTTPRequest) String() (string, error) {
  464. data, err := b.Bytes()
  465. if err != nil {
  466. return "", err
  467. }
  468. return string(data), nil
  469. }
  470. // Bytes returns the body []byte in response.
  471. // Calls Response inner.
  472. func (b *HTTPRequest) Bytes() ([]byte, error) {
  473. if b.body != nil {
  474. return b.body, nil
  475. }
  476. resp, err := b.getResponse()
  477. if err != nil {
  478. return nil, err
  479. }
  480. if resp.Body == nil {
  481. return nil, nil
  482. }
  483. defer resp.Body.Close()
  484. if b.setting.Gzip && resp.Header.Get("Content-Encoding") == "gzip" {
  485. reader, err := gzip.NewReader(resp.Body)
  486. if err != nil {
  487. return nil, err
  488. }
  489. b.body, err = ioutil.ReadAll(reader)
  490. return b.body, err
  491. }
  492. b.body, err = ioutil.ReadAll(resp.Body)
  493. return b.body, err
  494. }
  495. // ToFile saves the body data in response to one file.
  496. // Calls Response inner.
  497. func (b *HTTPRequest) ToFile(filename string) error {
  498. resp, err := b.getResponse()
  499. if err != nil {
  500. return err
  501. }
  502. if resp.Body == nil {
  503. return nil
  504. }
  505. defer resp.Body.Close()
  506. err = pathExistAndMkdir(filename)
  507. if err != nil {
  508. return err
  509. }
  510. f, err := os.Create(filename)
  511. if err != nil {
  512. return err
  513. }
  514. defer f.Close()
  515. _, err = io.Copy(f, resp.Body)
  516. return err
  517. }
  518. // Check if the file directory exists. If it doesn't then it's created
  519. func pathExistAndMkdir(filename string) (err error) {
  520. filename = path.Dir(filename)
  521. _, err = os.Stat(filename)
  522. if err == nil {
  523. return nil
  524. }
  525. if os.IsNotExist(err) {
  526. err = os.MkdirAll(filename, os.ModePerm)
  527. if err == nil {
  528. return nil
  529. }
  530. }
  531. return err
  532. }
  533. // ToJSON returns the map that marshals from the body bytes as json in response.
  534. // Calls Response inner.
  535. func (b *HTTPRequest) ToJSON(v interface{}) error {
  536. data, err := b.Bytes()
  537. if err != nil {
  538. return err
  539. }
  540. return json.Unmarshal(data, v)
  541. }
  542. // ToXML returns the map that marshals from the body bytes as xml in response .
  543. // Calls Response inner.
  544. func (b *HTTPRequest) ToXML(v interface{}) error {
  545. data, err := b.Bytes()
  546. if err != nil {
  547. return err
  548. }
  549. return xml.Unmarshal(data, v)
  550. }
  551. // ToYAML returns the map that marshals from the body bytes as yaml in response .
  552. // Calls Response inner.
  553. func (b *HTTPRequest) ToYAML(v interface{}) error {
  554. data, err := b.Bytes()
  555. if err != nil {
  556. return err
  557. }
  558. return yaml.Unmarshal(data, v)
  559. }
  560. // Response executes request client gets response manually.
  561. func (b *HTTPRequest) Response() (*http.Response, error) {
  562. return b.getResponse()
  563. }
  564. // TimeoutDialer returns functions of connection dialer with timeout settings for http.Transport Dial field.
  565. func TimeoutDialer(cTimeout time.Duration, rwTimeout time.Duration) func(net, addr string) (c net.Conn, err error) {
  566. return func(netw, addr string) (net.Conn, error) {
  567. conn, err := net.DialTimeout(netw, addr, cTimeout)
  568. if err != nil {
  569. return nil, err
  570. }
  571. err = conn.SetDeadline(time.Now().Add(rwTimeout))
  572. return conn, err
  573. }
  574. }