接口测试之Moco框架

Moco 简介

Moco 的作者是郑晔,该框架还在 JavaOne 2013 大会上获过奖。
简单的说,Moco 是一个搭建模拟服务器的工具,其支持 API 和独立运行两种方式,前者通常是在 junit 等测试框架中使用,后者则是通过运行一个 jar 包开启服务。
Moco 能帮助解决开发中的哪些问题?作者的回答如下:

Moco是针对HTTP集成而生的,不过,现在也有人把它用在其它需要一个模拟服务器的场景中。比如,在移动开发中,有人开发一个移动应用,需要有一个远端服务,但在开发时,这个服务还不存在,他就用Moco模拟了一个服务,保证移动应用可以顺利的开发。同样,也有人把它用在Web前端开发里,当我们的页面需要通过与服务器交互时,就可以用Moco模拟这样一个服务。这种做法在开发一个页面原型时,非常有用,因为那个时候,我们还来不及开发一个完整的服务。

Moco 用于接口测试

既然开发人员可以通过 Moco 模拟一个还不存在的服务来进行开发、调试,那对于接口测试来说,也可以模拟一个服务进行测试。
一般而言,在项目的接口文档输出后,开发人员会进行接口开发工作,测人员会进行接口用例的设计,但往往完成用例设计会先于接口开发工作,此时如果要进行接口用例的执行,则前提是开发人员完成接口开发工作。
而通过 Moco 框架,就可以在接口文档输出后,在接口开发、接口用例设计的同时,使用 Moco 搭建一个模拟服务器,这样在用例设计完成后,即使接口开发工作还未完成,也可以立即进行执行接口用例,在这个过程中可以修改、补充用例,如此的话,在接口开发完成以后,只需要简单的去执行所有的用例就 OK,省去了很大的工作量,并且这些完善的用例,用自动化去执行,效果更佳。

开始使用 Moco

  • github 地址:moco
  • 在项目的 readme 中找到 Quick Start,Download Standalone Moco Runner
  • 新建一个 test.json:

    1
    2
    3
    4
    5
    6
    7
    [
    {
    "response": {
    "text": "Hello, Moco"
    }

    }

    ]
  • 启动服务,端口号可自己设置

    1
    2
    3
    java -jar moco-runner-0.10.2-standalone.jar http -p 12306 -c test.json
    29 一月 2016 14:25:20 [main] INFO Server is started at 12306
    29 一月 2016 14:25:20 [main] INFO Shutdown port is 63643
  • 在浏览器中访问 http://localhost:12306, 将会在页面上显示 Hello,Moco

配置 json 文件

做了一个 demo,demo 的目录结构:

1
2
3
4
5
6
7
8
9
10
11
.
│ global.json
│ moco-runner-0.10.2-standalone.jar
│ test.json

└─api
├─book
│ book.json

└─person
person.json

global.json 作为全局配置文件,里面定义了将会用到的 json 配置文件:

1
2
3
4
5
6
7
8
9
[
{ "file_root":"api/book",
"include": "book.json"
},

{
"file_root":"api/person",
"include":"person.json"
}

]

book.json 中配置了书籍数据信息:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
[
{
"request": {
"method": "get",
"uri": "/book_list"
}
,

"response": {
"json": {
"books": [
"Python基础编程",
"wxPython实战",
"Java核心编程",
"Java编程思想"
]
}

}

},

{
"request": {
"method": "get",
"uri": "/book",
"queries": {
"book_name": "java_hxbc"
}

}
,

"response": {
"json": {
"name": "Java核心编程",
"price": 50
}

}

}

]

person.json 配置了人物信息:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
[
{
"request": {
"method": "get",
"uri": "/person",
"queries": {
"name": "Jack"
}

}
,

"response": {
"json": {
"country": "USA",
"age": 18
}

}

}

]

使用 Postman 测试接口

  • 开启服务,当使用全局配置时,需要使用-g选项,而非之前的-c

    1
    java -jar moco-runner-0.10.2-standalone.jar http -p 12306 -g global.json
  • Chrome 安装 Postman 的话需要翻墙,可以通过离线安装的方式进行安装,具体自行百度。建议使用 VPN。

  • 测试获取书籍列表:
    book_list

  • 获取 Java 核心编程的信息:
    java_hxbc

  • 获取 Jack 的信息:
    jack

其它配置方法

  • 通过配置不同的 json 文件,使得接口请求方式、返回的数据满足接口文档,这样就可以在完成接口用例的同时进行调试用例、用例完成后可以立即对接口进行测试。另外前端开发人员也可以使用这些模拟数据进行调试,这样就让测试人员、前端开发人员不用依赖于接口开发人员对接口的开发。

  • Moco 除了支持 get,还支持 post、put 、delete 等请求方式

  • 前面 demo 中配置的返回数据类型都是 json,Moco 当然也支持 text、file 等类型
  • 可以在 request 中设置 Headers , Cookies , StatusCode
  • Moco 的其它特性可参考 Moco 的 API 文档