mock-api

原理

基于 OkHttpInterceptor如果目标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 name
suite.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

StandardMockApi用来声明一个需要mock的api,其中第一个参数表示需要mock的 HTTP Method(支持GET、POST、PUT、DELETE),第二个参数表示需要mock的url(支持正则);通过这两个构造参数,我们基本上就定义出一个mock api的大体框架,之后我们可以通过:

Mock数据