MockWebServer是一个可脚本化的用于测试HTTP客户端的Web服务器。
主要用于测试你的应用在进行HTTP、HTTPS请求时是否按照预期的行为动作。使用该工具,你可以验证应用的请求是否符合预期,你可以选择返回的响应。
MockWebServer包含了所有的HTTP栈,所以可以测试所有的事。甚至可以直接将真实Web服务器中的HTTP响应内容复制过来,以创建相应的测试用例。此外,还可以测试应用在糟糕的网络环境下的表现,比如500错误或者响应返回缓慢。
http://blog.csdn.net/shensky711/article/details/52771797
mockwebserver包进行网络测试,关于该包的详细资料见 https://github.com/square/okhttp/tree/master/mockwebserver
官方文档中对http的使用方式给出了详细的说明,在此只记录https的使用方式:
MockWebServer serverhttps = new MockWebServer();
serverhttps.useHttps(SslContextBuilder.localhost().getSocketFactory(), false);
// Schedule some responses.
serverhttps.enqueue(new MockResponse()
.setResponseCode(200)
.addHeader("Content-Type", "application/json;charset=UTF-8")
.setBody("bodystring"));
// Start the server.
serverhttps.start();
注意在使用此包时需要对bcprov-jdk15on-154.jar包进行配置,网上搜一下有很多配置方法
---------------------
MockWebServer使用方法和Mockito类似,按照如下步骤。
编写模拟脚本
运行应用程序代码
验证做出的请求是否符合预期
下面是官方给的示例代码:
public void test() throws Exception() {
// 创建一个 MockWebServer
MockWebServer server = new MockWebServer();
// 设置响应
server.enqueue(new MockResponse().setBody("hello, world!"));
server.enqueue(new MockResponse().setBody("sup, bra?"));
server.enqueue(new MockResponse().setBody("yo dog"));
// 启动服务
// Start the server.
server.start();
// 设置服务端的URL,客户端请求中使用
HttpUrl baseUrl = server.url("/v1/chat");
// 运行你的应用程序代码,进行HTTP请求
// 响应会按照上面设置中放入队列的顺序被返回
Chat chat = new Chat(baseUrl);
chat.loadMore();
assertEquals("hello, world!", chat.message());
chat.loadMore();
chat.loadMore();
assertEquals(""
+ "hello, world!\n"
+ "sup, bra?\n"
+ "yo dog", chat.message());
// 可选:确认你的应用做出了正确的请求
RecordedRequest request1 = server.takeRequst();
assertEquals("/v1/chat/messages/", request1.getPath());
assertNotNull(request1.getHeader("Authorization"));
RecordedRequest request2 = server.takeRequest();
assertEquals("/v1/chat/message/2", request.getPath());
RecordedRequest request3 = server.takeRequest();
assertEquals("/v1/chat/message/3", request.getPath());
// 关闭服务,因为不能重用
server.shutdown();
}
单元测试时候,可以把 server 作为一个字段,然后在 tearDown() 方法中关闭服务。
Api接口
模拟Response(MockResponse)
MockResponse 可以默认返回http code是200的response,相依可以设置字符串、输入流、字节数组,设置可以设置Header。
MockResponse response = new MockResponse()
.addHeader("Content-Type", "application/json,charset=utf-8")
.addHeader("Cache-Control", "no-cache")
.setBody("{}");
MockResponse还可以模拟低速率网络的情况。这一点在测试超时和交互式测试时非常有用。
response.throttleBody(1024, 1, TimeUnit.SECONDS);
记录请求(RecordedRequest)
校验请求的请求方法、路径、HTTP版本、请求体、请求头。
RecordedRequest request = server.takeRequest();
assertEquals("POST /v1/chat/send HTTP/1.1", request.getRequestLine());
assertEquals("application/json; charset=utf-8", request.getHeader("Content-Type"));
assertEquals("{}", request.getUtf8Body());
转发器(Dispatcher)
默认情况下 MockWebServer 使用队列来指定响应。另外,可以根据需要使用另外一种响应策略,可以通过转发器来处理器,可以通过请求的路径来选择转发策略。比如,我们可以过滤请求替代 server.enqueue()。
final Dispatcher dispatcher = new Dispatcher() {
@Override
public MockResponse dispatch(RecordedRequest request) throws InterruptedException {
if (request.getPath().equals("/v1/login/auth/")){
return new MockResponse().setResponseCode(200);
} else if (request.getPath().equals("v1/check/version/")){
return new MockResponse().setResponseCode(200).setBody("version=9");
} else if (request.getPath().equals("/v1/profile/info")) {
return new MockResponse().setResponseCode(200).setBody("{\\\"info\\\":{\\\"name\":\"Lucas Albuquerque\",\"age\":\"21\",\"gender\":\"male\"}}");
}
return new MockResponse().setResponseCode(404);
}
};
server.setDispatcher(dispatcher);
集成
Gradle
testCompile 'com.squareup.okhttp3:mockwebserver:(insert latest version)'
Maven
<dependency>
<groupId>com.squareup.okhttp3</groupId>
<artifactId>mockwebserver</artifactId>
<version>(insert latest version)</version>
<scope>test</scope>
</dependency>
1.为什么要搭建mock-server?
为了更好的分工合作,让前端能在不依赖后端环境的情况下进行开发,其中一种手段就是为前端开发者提供一个 web 容器,这个本地环境就是 mock-server。
目前很多前端 mock 数据的方案的基本流程都是使用 node.js 来模拟 http 请求,配置 router 返回 mock 数据。
一个比较好的 mock-server 该有的能力:
1.与线上环境一致的接口地址,每次构建前端代码时不需要修改调用接口的代码
2.所改即所得,具有热更新的能力,每次增加 /修改 mock 接口时不需要重启 mock 服务,更不用重启前端构建服务
3.能配合 Webpack
4.mock 数据可以由工具生成不需要自己手动写
5.能模拟 POST、GET 请求
6.简单(包括:文件结构简单、编写代码简单)
2.我们mock server 服务器
1.就是一个基于Node的 Express web 搭建的一个本地server。
2.数据mock的思路就是在这个本地server端进行,Promise 发出http请求,通过 router 返回mock数据。
3.与线上环境一致,前端代码构建和接口服务是分开独立的
app.listen(3001, () => {
debug(`The fake API server is listening on ${'3001'.rainbow}.`)
}) //启动一个服务并监听从 3001 端口进入的所有API连接请求
在webpack 配置中, 比较简单:
proxy: {
'/api/*': {
target: `http://${host}:3001`,
secure: false,
},
将匹配 ‘/api/*’ 这种格式的API的域名重定向为 http://${host}:3001
4.具有热更新的能力,每次增加 /修改 mock 接口(入口api/index.js)时自动重启 mock 服务
nodemon 自动重启的工具 启动 mock server
5.mock 数据可以由工具生成不需要自己手动写,还能模拟 POST、GET 请求
用到LowDB,LowDB 基于Lo-Dash 中间件, 基于Node的纯Json文件数据库,LowDB支持 JSON Server 和 JSONPlaceholder.
dbs[entry] = low(`${entries[i]}/data.json`)
返回或者创建一个Lo-Dash包裹数组。然后,您可以使用这些方法: where, find, filter, sortBy, groupBy, ...和来自Underscore.db的方法
目录结构,根据大模块划分了mock数据目录结构,
每一个模块下,都有个schemas/*.js Object类型 default 数据定义,然后JSON.stringify(data)转为JSON 字符串,同步写入data.json文件中。用到Faker.js 的一些API。 (mock一些不变的数据)
每一个模块下,都有routes/*.js , 每个模块都对应创建了 express.Router() 实例,在具体app.get(‘/’, (req, res)) 对应的URL 或 路由 来模拟POST 或者GET 请求 以及PUT和DELETE请求,固定的status code 对应了不同的error。
6.简单(包括:文件结构简单、编写代码简单)
如何在src (业务代码) 中调用mock server呢?
在src 下modules/*.js 中定义Promise 请求
export const myFun = () => ({
type: MYFUN,
promise: (dispatch, getStore, api) => api.get(URL.myFun)
})
URL 对应配置了不同环境的url 请求, 生产环境(真实),开发环境 (mock server 路由),测试环境(unit test)