一个Android的json-api-mock框架

一个Android的json-api-mock框架

mock-api

原理

基于 OkHttp 的 Interceptor ：如果目标url需要mock，则从本地（assets或sdcard）读取数据，否则继续向外发送请求。

使用

首先，在 build.gradle 中添加以下依赖：

compile 'com.shanbay.android:mock-api:0.0.1'

然后，准备mock数据，比如对于请求：/api/user/ 我们期望返回：

{ username: "shanbay"}

我们将上述内容保存为user.json，然后放在assets目录下的mockdata/account/目录中（这里的account是suite-name，后面会介绍）;

接着，创建Client，增加以下配置：

MockApiSuite suite = new MockApiSuite("account"); // account 表示 suite namesuite.addMockApi(new StandardMockApi(MockHttpMethod.GET, "/api/user/").setSuccessDataFile("user.json"))MockApiInterceptor mockApiInterceptor = new MockApiInterceptor(context);mockApiInterceptor.addMockApiSuite(suite);OkHttpClient.Builder clientBuilder = new OkHttpClient.Builder() .addInterceptor(mockApiInterceptor) // 注入mock api interceptor .addInterceptor(new UserAgentInterceptor(context)); ....

这时候请求/api/user/，你会发现返回了我们刚才mock的数据 ;-)

更多

MockApiSuite

当我们mock很多api的时候，如果只是简单聚合这些api，将会非常的凌乱&难以管理，所以我们建立了Suite的概念：把相同业务场景的api放到一个suite中（比如分为account模块、purchase模块），这样对于之后的更新、维护都非常方便。

StandardMockApi

setSuccessDataFile 设置api调用成功返回的数据结果；setErrorDataFile 设置api调用失败返回的数据结果；setState 设置这次是模拟api调用成功还是失败（默认模拟调用成功）；setRequestTime 设置api请求时间（可以用来模拟请求慢的情况）；

Mock数据

约定mock数据存放路径： mockdata/[suite_name]/；MockApiInterceptor的第二个构造参数用来指定：mock数据是放在sdcard根目录，还是assets根目录（默认）；推荐把Mock数据存放在sdcard中，这样我们可以通过adb命令动态修改mock数据（而不需要重启App），提高开发效率；

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。