Bootstrap

Golang语言HTTP客户端实践

最近在学习Golang语言,中间遇到一个前辈指点,有一个学习原则:Learning By Doing。跟我之前学习Java的经验高度契合。在前一段时间学习洼坑中挣扎了好几天,差点就忘记这个重要的成功经验。

那么那什么来做练习呢?当然结合当下的工作啦,所以我列了一个路线给自己,那就是从接口测试开始学起来,从功能测试到性能测试,然后掌握基本Server开发技能。

首先,得先把HTTP接口测试常用的几个功能实现了,主要是获取HTTPrequest对象,发送请求解析响应以及HttpClient的基本配置。

这里实现比较简单和粗浅,让我想起FunTester测试框架一开始的时候,也是从封装HttpClient.jar提供的API开始的,感慨万千。

这里我从了Golang SDK自带的包提供的HTTP相关API,虽然本身提供了、以及封装好的方法,但是在处理HTTPrequest的header和cookie处理缺乏灵活性,所以我重新将封装的API进行第二次封装。其中存在几处遗漏,比如HTTPstatus的判断以及header中自动处理,这个以后再丰富,暂时的目标就是能用。

HTTP客户端封装

package task

import (
  "bytes"
  "encoding/json"
  "fmt"
  "io/ioutil"
  "net/http"
  "net/url"
  "strings"
  "time"
)

var Client http.Client = clients()

// Res 模拟响应结构
// @Description:
type Res struct {
  Have string `json:"Have"`
}

// Get 获取GET请求
// @Description:
// @param uri
// @param args
// @return *http.Request
func Get(uri string, args map[string]interface{}) *http.Request {
  uri = uri + ToValues(args)
  request, _ := http.NewRequest("get", uri, nil)
  return request
}

// PostForm POST接口form表单
// @Description:
// @param path
// @param args
// @return *http.Request
func PostForm(path string, args map[string]interface{}) *http.Request {
  request, _ := http.NewRequest("post", path, strings.NewReader(ToValues(args)))
  return request
}

// PostJson POST请求,JSON参数
// @Description:
// @param path
// @param args
// @return *http.Request
func PostJson(path string, args map[string]interface{}) *http.Request {
  marshal, _ := json.Marshal(args)
  request, _ := http.NewRequest("post", path, bytes.NewReader(marshal))

  return request
}

// ToValues 将map解析成HTTP参数,用于GET和POST form表单
// @Description:
// @param args
// @return string
func ToValues(args map[string]interface{}) string {
  if args != nil && len(args) > 0 {
    params := url.Values{}
    for k, v := range args {
      params.Set(k, fmt.Sprintf("%v", v))
    }
    return params.Encode()
  }
  return ""
}

// Response 获取响应详情,默认[]byte格式
// @Description:
// @param request
// @return []byte
func Response(request *http.Request) []byte {
  res, err := Client.Do(request)
  if err != nil {
    return nil
  }
  body, _ := ioutil.ReadAll(res.Body) // 读取响应 body, 返回为 []byte
  defer res.Body.Close()
  return body
}

// clients 初始化请求客户端
// @Description:
// @return http.Client
func clients() http.Client {
  return http.Client{
    Timeout: time.Duration(5) * time.Second, //超时时间
    Transport: &http.Transport{
      MaxIdleConnsPerHost:   5,   //单个路由最大空闲连接数
      MaxConnsPerHost:       100, //单个路由最大连接数
      IdleConnTimeout:       90 * time.Second,
      TLSHandshakeTimeout:   10 * time.Second,
      ExpectContinueTimeout: 1 * time.Second,
    },
  }
}

// ParseRes 解析响应
// @Description:
// @receiver r
// @param res
func (r *Res) ParseRes(res []byte) {
  json.Unmarshal(res, r)
}

// ParseRes 解析响应,将[]byte转成传入对象
// @Description:
// @param res
// @param r
//
func ParseRes(res []byte, r interface{}) {
  json.Unmarshal(res, r)
}

测试脚本

package main

import (
  "fmt"
  "funtester/src/task"
  "io"
  "log"
  "net/http"
  "os"
  "time"
)

const (
  a = iota
  b
  c
  d
  e
)

func init() {
  os.Mkdir("./log/", 0777)
  os.Mkdir("./long/", 0777)
  file := "./log/" + string(time.Now().Format("20060102")) + ".log"
  openFile, _ := os.OpenFile(file, os.O_RDWR|os.O_CREATE|os.O_APPEND, 0666)
  writer := io.MultiWriter(os.Stdout, openFile)
  log.SetOutput(writer)
  log.SetFlags(log.LstdFlags | log.Lshortfile | log.Ldate)
}

func main() {

  url := "http://localhost:12345/test"
  args := map[string]interface{}{
    "name": "FunTester",
    "fun":  "fdsafj",
  }
  cookie := &http.Cookie{
    Name:  "token",
    Value: "fsjej09u0934jtej",
  }
  get := task.Get(url, args)
  get.Header.Add("user_agent", "FunTester")
  get.AddCookie(cookie)
  response := task.Response(get)
  fmt.Println(string(response))
  form := task.PostForm(url, args)
  bytes := task.Response(form)
  fmt.Println(string(bytes))
  json := task.PostJson(url, args)
  res := task.Response(json)
  fmt.Println(string(res))

}

控制台输出

GOROOT=/usr/local/go #gosetup
GOPATH=/Users/oker/go #gosetup
/usr/local/go/bin/go build -o /private/var/folders/7b/0djfgf7j7p9ch_hgm9wx9n6w0000gn/T/GoLand/___go_build_funtester_src_m funtester/src/m #gosetup
/private/var/folders/7b/0djfgf7j7p9ch_hgm9wx9n6w0000gn/T/GoLand/___go_build_funtester_src_m
get请求
post请求form表单
post请求json表单

Process finished with the exit code 0

测试服务

依旧采用了测试框架实现。

package com.mocofun.moco.main

import com.funtester.utils.ArgsUtil
import com.mocofun.moco.MocoServer

class Share extends MocoServer {

    static void main(String[] args) {
        def util = new ArgsUtil(args)
        //                def server = getServerNoLog(util.getIntOrdefault(0,12345))
        def server = getServer(util.getIntOrdefault(0, 12345))
        server.get(urlStartsWith("/test")).response("get请求")
        server.post(both(urlStartsWith("/test"), existForm("fun"))).response("post请求form表单")
        server.post(both(urlStartsWith("/test"), existParams("fun"))).response("post请求json表单")
        server.get(urlStartsWith("/qps")).response(qps(textRes("恭喜到达QPS!"), 1))
//        server.response(delay(jsonRes(getJson("Have=Fun ~ Tester !")), 1000))
        server.response("Have Fun ~ Tester !")
        def run = run(server)
        waitForKey("fan")
        run.stop()
    }
}

Have Fun ~ Tester !