Golang如何实现单元测试中的接口层

其他教程   发布日期:2023年08月18日   浏览次数:557

这篇文章主要介绍“Golang如何实现单元测试中的接口层”,在日常操作中,相信很多人在Golang如何实现单元测试中的接口层问题上存在疑惑,小编查阅了各式资料,整理出简单好用的操作方法,希望对大家解答”Golang如何实现单元测试中的接口层”的疑惑有所帮助!接下来,请跟着小编一起来学习吧!

    环境

    本文以常用的

    1. gin
    框架为例,使用一种个人比较喜欢也非常简单的方式来实现单元测试。特点主要有:
    • 不需要启动路由服务

    • 复用已有的项目内的请求结构

    代码

    由于之前已经贴过,所以 service 层的 代码这里就不赘述了

    base case

    1. package controller
    2. import (
    3. "context"
    4. "github.com/gin-gonic/gin"
    5. "go-demo/m/unit-test/entity"
    6. )
    7. //go:generate mockgen -source=./user.go -destination=../mock/user_service_mock.go -package=mock
    8. type UserService interface {
    9. AddUser(ctx context.Context, username string) (err error)
    10. GetUser(ctx context.Context, userID int) (user *entity.User, err error)
    11. }
    12. type AddUserRequest struct {
    13. Username string `json:"username" binding:"required"`
    14. }
    15. type GetUserRequest struct {
    16. UserID int `form:"user_id" binding:"required"`
    17. }
    18. type GetUserResponse struct {
    19. Username string `json:"username"`
    20. }
    21. type UserController struct {
    22. UserService UserService
    23. }
    24. func NewUserController(userService UserService) *UserController {
    25. return &UserController{UserService: userService}
    26. }
    27. func (uc *UserController) AddUser(ctx *gin.Context) {
    28. req := &AddUserRequest{}
    29. if err := ctx.BindJSON(req); err != nil {
    30. return
    31. }
    32. if err := uc.UserService.AddUser(ctx, req.Username); err != nil {
    33. ctx.JSON(400, gin.H{"error": err.Error()})
    34. return
    35. }
    36. ctx.JSON(200, gin.H{"message": "success"})
    37. }
    38. func (uc *UserController) GetUser(ctx *gin.Context) {
    39. req := &GetUserRequest{}
    40. if err := ctx.BindQuery(req); err != nil {
    41. return
    42. }
    43. user, err := uc.UserService.GetUser(ctx, req.UserID)
    44. if err != nil {
    45. ctx.JSON(400, gin.H{"error": err.Error()})
    46. return
    47. }
    48. ctx.JSON(200, &GetUserResponse{Username: user.Username})
    49. }
    • 既然之前我们 service 的单元测试已经通过,这次我们就需要 mock 的是 service 层的接口

      1. mockgen -source=./user.go -destination=../mock/user_service_mock.go -package=mock
    • 这里我将请求和返回的结构 如:GetUserRequest、GetUserResponse 放在了这里仅仅是为了方便展示代码

    单元测试

    基础代码非常简单,就是我们常见的,最重要的让我们来看看单元测试应该怎么写

    工具方法

    在编写实际单元测试之前,我们需要一些工具方法来帮助我们构建一些请求。

    1. func createGetReqCtx(req interface{}, handlerFunc gin.HandlerFunc) (isSuccess bool, resp string) {
    2. w := httptest.NewRecorder()
    3. c, _ := gin.CreateTestContext(w)
    4. encode := structToURLValues(req).Encode()
    5. c.Request, _ = http.NewRequest("GET", "/?"+encode, nil)
    6. handlerFunc(c)
    7. return w.Code == http.StatusOK, w.Body.String()
    8. }
    9. func createPostReqCtx(req interface{}, handlerFunc gin.HandlerFunc) (isSuccess bool, resp string) {
    10. responseRecorder := httptest.NewRecorder()
    11. ctx, _ := gin.CreateTestContext(responseRecorder)
    12. body, _ := json.Marshal(req)
    13. ctx.Request, _ = http.NewRequest("POST", "/", bytes.NewBuffer(body))
    14. ctx.Request.Header.Set("Content-Type", "application/json")
    15. handlerFunc(ctx)
    16. return responseRecorder.Code == http.StatusOK, responseRecorder.Body.String()
    17. }
    18. // 将结构体转换为 URL 参数
    19. func structToURLValues(s interface{}) url.Values {
    20. v := reflect.ValueOf(s)
    21. if v.Kind() == reflect.Ptr {
    22. v = v.Elem()
    23. }
    24. t := v.Type()
    25. values := url.Values{}
    26. for i := 0; i < t.NumField(); i++ {
    27. field := t.Field(i)
    28. tag := field.Tag.Get("form")
    29. if tag == "" {
    30. continue
    31. }
    32. value := v.Field(i).Interface()
    33. values.Set(tag, valueToString(value))
    34. }
    35. return values
    36. }
    37. // 由于 get 请求常常参数并不会特别复杂,通常的几种类型就应该可以包括,有需要可以继续添加
    38. func valueToString(v interface{}) string {
    39. switch v := v.(type) {
    40. case int:
    41. return strconv.Itoa(v)
    42. case string:
    43. return v
    44. default:
    45. return ""
    46. }
    47. }

    既然我们不想启动路由,其实最关键的问题就在如何构建一个 gin.Context 来模拟正常的请求。

    • 通过

      1. gin.CreateTestContext
      创建一个我们需要模拟的 context
    • 通过

      1. http.NewRequest
      来创建我们需要的请求结构

    单元测试

    有了我们的工具方法,那么编写单元测试的时候就非常方便了,mock 方法和之前类似,剩下要调用对应的方法就可以了。并且这里可以复用我们已经在原有程序中使用的 请求结构 如

    1. GetUserRequest
    这样就可以不需要重新劳动了。
    1. package controller
    2. import (
    3. "fmt"
    4. "testing"
    5. "github.com/golang/mock/gomock"
    6. "github.com/stretchr/testify/assert"
    7. "go-demo/m/unit-test/entity"
    8. "go-demo/m/unit-test/mock"
    9. )
    10. func TestUserController_AddUser(t *testing.T) {
    11. ctl := gomock.NewController(t)
    12. defer ctl.Finish()
    13. req := &AddUserRequest{Username: "LinkinStar"}
    14. mockUserService := mock.NewMockUserService(ctl)
    15. mockUserService.EXPECT().AddUser(gomock.Any(), gomock.Any()).Return(nil)
    16. userController := NewUserController(mockUserService)
    17. success, resp := createPostReqCtx(req, userController.AddUser)
    18. assert.True(t, success)
    19. fmt.Println(resp)
    20. }
    21. func TestUserController_GetUser(t *testing.T) {
    22. ctl := gomock.NewController(t)
    23. defer ctl.Finish()
    24. req := &GetUserRequest{UserID: 1}
    25. user := &entity.User{Username: "LinkinStar"}
    26. mockUserService := mock.NewMockUserService(ctl)
    27. mockUserService.EXPECT().GetUser(gomock.Any(), gomock.Any()).Return(user, nil)
    28. userController := NewUserController(mockUserService)
    29. success, resp := createGetReqCtx(req, userController.GetUser)
    30. assert.True(t, success)
    31. fmt.Println(resp)
    32. }

    可以看到测试方法如出一辙,再详细的话只需要对请求的返回值做解析然后进行断言即可。

    问题

    当然以上述方式来实现单元测试的话,是会遗漏一些问题,毕竟偷懒是要有代价的。

    • 路由路径的问题:可以看到上述的单元测试中并没有注册对应的 url 地址,那么实际中可能会由于代码路由的书写错误而导致 404 的情况

    • 请求结构字段错误:由于我们复用了原有代码中的请求结构,即使单词拼写错误依然能成功,因为两边都一样错,所以即使字段名称与接口文档不一致也无法发现。

    针对这两个问题,我觉得可以由更加上层的测试来保证,由于这里仅仅是单元测试,我觉得这些代价还是可以接受的。并且,如果是使用 swagger 生成文档的情况下,也能保证文档和代码的统一性。但在此还是要出来提个醒,毕竟实际问题我还是遇到过的。

    优化点

    当然,这里的举例还是过于简单,实际中的请求往往会比较复杂。

    • 实际场景往往一些请求需要鉴权,这个可以在根据实际你的鉴权方式在前面添加中间件统一来处理登录就可以

    • 其他类型的请求也是类似的如 PUT、DELETE 等

    • 当前只是简单的处理了正常的 200 HTTP Code 还会出现其他异常的情况也需要按实际接口进行处理

    以上就是Golang如何实现单元测试中的接口层的详细内容,更多关于Golang如何实现单元测试中的接口层的资料请关注九品源码其它相关文章!