golang httptest用法是什么

胖明大大_6315

胖明大大_6315

2023-04-14

1265人浏览

原创

近年来,随着 golang 语言的普及和高效性,它越来越受到开发者们的关注和喜爱。golang 提供了一套简单易用的测试框架,其中就包括了 httptest 库。在本文章中,我将会介绍 httptest 的基本概念、用法和注意事项,希望能对 golang 开发者们在接下来的测试工作中有所帮助。

  1. httptest 简介

在 Golang 的测试框架中,httptest 的主要作用就是帮助测试者模拟 HTTP 请求和响应,从而方便地对服务端的 API 接口进行测试。它不依赖于网络和实际的 HTTP 服务器,而是使用 Golang 提供的 net/http 包中的功能,模拟出请求和响应的整个流程。

  1. httptest 常用方法

(1)创建测试服务器

在 httptest 中,我们需要通过 NewServer 方法创建一个测试服务器。该方法的参数需要传入一个实现了 http.Handler 接口的 HandlerFunc。例如,我们可以创建一个处理 GET 请求的 HandlerFunc,并通过它创建一个测试服务器:

func TestGetFoo(t *testing.T) {
    srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        w.WriteHeader(http.StatusOK)
        fmt.Fprintln(w, "Hello, World!")
    }))
    defer srv.Close()

    resp, err := http.Get(srv.URL)
    if err != nil {
        t.Fatal(err)
    }
    defer resp.Body.Close()

    if resp.StatusCode != http.StatusOK {
        t.Errorf("expected %d but got %d", http.StatusOK, resp.StatusCode)
    }
}

(2)发送请求

有了测试服务器之后,我们就可以通过 Client 来向服务器发送请求。Client 是 Golang 提供的一个 HTTP 请求客户端。例如,我们可以创建一个处理 POST 请求的 HandlerFunc,并通过它创建一个测试服务器。然后发送一个 POST 请求,包含 Json 数据:

func TestPostJson(t *testing.T) {
    srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        body, _ := ioutil.ReadAll(r.Body)
        w.WriteHeader(http.StatusOK)
        fmt.Fprintln(w, string(body))
    }))
    defer srv.Close()

    payload := struct {
        Name string `json:"name"`
        Age  int    `json:"age"`
    }{
        Name: "Robert",
        Age:  30,
    }
    buf, _ := json.Marshal(payload)
    resp, err := http.Post(srv.URL, "application/json", bytes.NewReader(buf))
    if err != nil {
        t.Fatal(err)
    }
    defer resp.Body.Close()

    if resp.StatusCode != http.StatusOK {
        t.Errorf("expected %d but got %d", http.StatusOK, resp.StatusCode)
    }
    body, _ := ioutil.ReadAll(resp.Body)
    if string(body) != `{"name":"Robert","age":30}` {
        t.Errorf("expected %s but got %s", `{"name":"Robert","age":30}`, string(body))
    }
}

(3)设置请求头和响应头

在测试中,请求头和响应头也是很重要的一部分。我们可以通过 Header 方法来设置请求头和响应头。例如,我们可以创建一个处理 GET 请求的 HandlerFunc,并通过它创建一个测试服务器。然后设置请求头和响应头:

func TestHeader(t *testing.T) {
    srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("X-test", "hello")
        w.WriteHeader(http.StatusOK)
        fmt.Fprintln(w, "Hello, World!")
    }))
    defer srv.Close()

    req, err := http.NewRequest("GET", srv.URL, nil)
    if err != nil {
        t.Fatal(err)
    }
    req.Header.Add("X-test", "world")
    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        t.Fatal(err)
    }
    defer resp.Body.Close()

    if resp.StatusCode != http.StatusOK {
        t.Errorf("expected %d but got %d", http.StatusOK, resp.StatusCode)
    }
    if resp.Header.Get("X-test") != "hello" {
        t.Errorf("expected %s but got %s", "hello", resp.Header.Get("X-test"))
    }
}

(4)处理 HTTPS 请求

在实际的项目中,很多 HTTP 接口都需要通过 HTTPS 进行安全传输。在 httptest 中,我们也可以通过 NewTLSServer 方法来创建一个支持 HTTPS 的测试服务器。新建的服务器使用自签名证书,因此不应该在生产环境中使用。例如,我们可以创建一个处理 POST 请求的 HandlerFunc,并通过它创建一个支持 HTTPS 的测试服务器。然后发送一个 POST 请求,包含 Json 数据:

func TestTlsPostJson(t *testing.T) {
    srv := httptest.NewTLSServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        body, _ := ioutil.ReadAll(r.Body)
        w.WriteHeader(http.StatusOK)
        fmt.Fprintln(w, string(body))
    }))
    defer srv.Close()

    payload := struct {
        Name string `json:"name"`
        Age  int    `json:"age"`
    }{
        Name: "Robert",
        Age:  30,
    }
    buf, _ := json.Marshal(payload)
    client := srv.Client()

    resp, err := client.Post(srv.URL, "application/json", bytes.NewReader(buf))
    if err != nil {
        t.Fatal(err)
    }
    defer resp.Body.Close()

    if resp.StatusCode != http.StatusOK {
        t.Errorf("expected %d but got %d", http.StatusOK, resp.StatusCode)
    }
    body, _ := ioutil.ReadAll(resp.Body)
    if string(body) != `{"name":"Robert","age":30}` {
        t.Errorf("expected %s but got %s", `{"name":"Robert","age":30}`, string(body))
    }
}
  1. httptest 的注意事项

尽管 httptest 在 Golang 测试框架中很方便实用,但使用不当仍然可能会导致测试结果不准确。我们需要注意以下几点:

(1)httptest 不应当被用作生产环境下的 HTTP 或 HTTPS 服务器,仅用于测试目的。

(2)如果测试服务器没有被正确关闭,可能会因为测试套件过多而导致资源耗尽。

(3)如果使用 httptest 提交到的数据和你所提交的数据不匹配,你将无法得到正确的测试结果。

  1. 总结

在 Golang 的测试过程中,httptest 是一个非常有用的工具,可以帮助我们模拟 HTTP 请求和响应,从而方便地对服务端的 API 接口进行测试。本文中,我们详细介绍了 httptest 的基本概念、用法和注意事项,希望能对 Golang 开发者们在接下来的测试工作中有所帮助。

golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

539

5

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

616

5

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

1336

5

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.05

811

5

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.05.21

1946

6

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

2025.06.09

5594

18

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

2025.06.10

2614

13

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

2025.06.17

4426

17

golang数组大全
golang数组大全

本专题整合了golang数组相关问题解决方法,想了解更多相关内容,请阅读下面的文章。

2025.06.20

5846

22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习