103

使用方形改造框架时,模拟服务器进行测试的最佳方法是什么。

潜在途径:

  1. 创建一个新的改造客户端并将其设置在 RestAdapter.Builder().setClient() 中。这涉及解析 Request 对象并将 json 作为 Response 对象返回。

  2. 将此带注释的接口实现为模拟类并使用它代替 RestAdapter.create() 提供的版本(不会测试 gson 序列化)

  3. ?

理想情况下,我想让模拟服务器提供 json 响应,这样我就可以同时测试 gson 序列化。

任何示例将不胜感激。

4

11 回答 11

111

模拟改造 2.0 测试请求

由于像创建MockClient类和实现它这样的旧机制Client不再适用于 Retrofit 2.0,所以我在这里描述了一种新的方法。您现在需要做的就是为 OkHttpClient 添加自定义拦截器,如下所示FakeInterceptor类只是覆盖intercept方法,如果应用程序处于DEBUG模式返回给定的 JSON。

RestClient.java

public final class RestClient {

    private static IRestService mRestService = null;

    public static IRestService getClient() {
        if(mRestService == null) {
            final OkHttpClient client = new OkHttpClient();
            // ***YOUR CUSTOM INTERCEPTOR GOES HERE***
            client.interceptors().add(new FakeInterceptor());

            final Retrofit retrofit = new Retrofit.Builder()
                            // Using custom Jackson Converter to parse JSON
                            // Add dependencies:
                            // com.squareup.retrofit:converter-jackson:2.0.0-beta2
                    .addConverterFactory(JacksonConverterFactory.create())
                            // Endpoint
                    .baseUrl(IRestService.ENDPOINT)
                    .client(client)
                    .build();

            mRestService = retrofit.create(IRestService.class);
        }
        return mRestService;
    }
}

IRestService.java

public interface IRestService {

    String ENDPOINT = "http://www.vavian.com/";

    @GET("/")
    Call<Teacher> getTeacherById(@Query("id") final String id);
}

FakeInterceptor.java

public class FakeInterceptor implements Interceptor { 
    // FAKE RESPONSES.
    private final static String TEACHER_ID_1 = "{\"id\":1,\"age\":28,\"name\":\"Victor Apoyan\"}";
    private final static String TEACHER_ID_2 = "{\"id\":1,\"age\":16,\"name\":\"Tovmas Apoyan\"}";

    @Override
    public Response intercept(Chain chain) throws IOException {
        Response response = null;
        if(BuildConfig.DEBUG) {
            String responseString;
            // Get Request URI.
            final URI uri = chain.request().url().uri();
            // Get Query String.
            final String query = uri.getQuery();
            // Parse the Query String.
            final String[] parsedQuery = query.split("=");
            if(parsedQuery[0].equalsIgnoreCase("id") && parsedQuery[1].equalsIgnoreCase("1")) {
                responseString = TEACHER_ID_1;
            }
            else if(parsedQuery[0].equalsIgnoreCase("id") && parsedQuery[1].equalsIgnoreCase("2")){
                responseString = TEACHER_ID_2;
            }
            else {
                responseString = "";
            }

            response = new Response.Builder()
                    .code(200)
                    .message(responseString)
                    .request(chain.request())
                    .protocol(Protocol.HTTP_1_0)
                    .body(ResponseBody.create(MediaType.parse("application/json"), responseString.getBytes()))
                    .addHeader("content-type", "application/json")
                    .build();
        }
        else {
            response = chain.proceed(chain.request());
        }

        return response;
    }
}

GitHub上的项目源代码

于 2015-12-19T21:06:36.320 回答
86

我决定尝试方法1如下

public class MockClient implements Client {

    @Override
    public Response execute(Request request) throws IOException {
        Uri uri = Uri.parse(request.getUrl());

        Log.d("MOCK SERVER", "fetching uri: " + uri.toString());

        String responseString = "";

        if(uri.getPath().equals("/path/of/interest")) {
            responseString = "JSON STRING HERE";
        } else {
            responseString = "OTHER JSON RESPONSE STRING";
        }

        return new Response(request.getUrl(), 200, "nothing", Collections.EMPTY_LIST, new TypedByteArray("application/json", responseString.getBytes()));
    }
}

并通过以下方式使用它:

RestAdapter.Builder builder = new RestAdapter.Builder();
builder.setClient(new MockClient());

它运行良好,允许您测试您的 json 字符串,而无需联系真实的服务器!

于 2013-07-11T10:04:50.237 回答
22

测试对象的 JSON 反序列化(可能使用TypeAdapters?)似乎是一个单独的问题,需要单独的单元测试。

我个人使用版本 2。它提供了可以轻松调试和更改的类型安全、重构友好的代码。毕竟,如果您不创建 API 的替代版本进行测试,那么将您的 API 声明为接口有什么好处!多态为赢。

另一种选择是使用 Java Proxy. 这实际上是 Retrofit(当前)实现其底层 HTTP 交互的方式。诚然,这将需要更多的工作,但会允许更多的动态模拟。

于 2013-10-15T04:29:22.893 回答
10

你也可以使用 Squareup 的 Webservermock 之类的东西!--> https://github.com/square/okhttp/tree/master/mockwebserver

于 2014-03-10T13:43:06.010 回答
8

我是Apiary.io的忠实粉丝,因为我在迁移到真实服务器之前模拟了一个 API。

您还可以使用平面 .json 文件并从文件系统中读取它们。

您还可以使用可公开访问的 API,例如 Twitter、Flickr 等。

以下是有关改造的其他一些重要资源。

幻灯片:https ://docs.google.com/presentation/d/12Eb8OPI0PDisCjWne9-0qlXvp_-R4HmqVCjigOIgwfY/edit#slide=id.p

视频:http ://www.youtube.com/watch?v=UtM06W51pPw&feature=g-user-u

示例项目:https ://github.com/dustin-graham/ucad_twitter_retrofit_sample

于 2013-08-28T00:51:08.277 回答
7
  1. 首先,创建你的改造界面。

    public interface LifeKitServerService {
        /**
         * query event list from server,convert Retrofit's Call to RxJava's Observerable
         *
         * @return Observable<HttpResult<List<Event>>> event list from server,and it has been convert to Obseverable
         */
        @GET("api/event")
        Observable<HttpResult<List<Event>>> getEventList();
    }
    
  2. 您的请求者如下:

    public final class HomeDataRequester {
        public static final String TAG = HomeDataRequester.class.getSimpleName();
        public static final String SERVER_ADDRESS = BuildConfig.DATA_SERVER_ADDR + "/";
        private LifeKitServerService mServerService;
    
        private HomeDataRequester() {
            OkHttpClient okHttpClient = new OkHttpClient.Builder()
                    //using okhttp3 interceptor fake response.
                    .addInterceptor(new MockHomeDataInterceptor())
                    .build();
    
            Retrofit retrofit = new Retrofit.Builder()
                    .client(okHttpClient)
                    .baseUrl(SERVER_ADDRESS)
                    .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
                    .addConverterFactory(GsonConverterFactory.create(new Gson()))
                    .build();
    
            //using okhttp3 inteception to fake response.
            mServerService = retrofit.create(LifeKitServerService.class);
    
            //Second choice,use MockRetrofit to fake data.
            //NetworkBehavior behavior = NetworkBehavior.create();
            //MockRetrofit mockRetrofit = new MockRetrofit.Builder(retrofit)
            //        .networkBehavior(behavior)
            //        .build();
            //mServerService = new MockLifeKitServerService(
            //                    mockRetrofit.create(LifeKitServerService.class));
        }
    
        public static HomeDataRequester getInstance() {
            return InstanceHolder.sInstance;
        }
    
        public void getEventList(Subscriber<HttpResult<List<Event>>> subscriber) {
            mServerService.getEventList()
                    .subscribeOn(Schedulers.io())
                    .unsubscribeOn(Schedulers.io())
                    .observeOn(AndroidSchedulers.mainThread())
                    .subscribe(subscriber);
        }
    }
    
  3. 如果您使用第二种选择(使用 Retrofit 接口来模拟服务器数据),则需要 MockRetrofit,使用代码如下:

    public final class MockLifeKitServerService implements LifeKitServerService {
    public static final String TAG = MockLifeKitServerService.class.getSimpleName();
    private BehaviorDelegate<LifeKitServerService> mDelegate;
    private Gson mGson = new Gson();
    
    public MockLifeKitServerService(BehaviorDelegate<LifeKitServerService> delegate) {
        mDelegate = delegate;
    }
    
    @Override
    public Observable<HttpResult<List<Event>>> getEventList() {
        List<Event> eventList = MockDataGenerator.generateEventList();
        HttpResult<List<Event>> httpResult = new HttpResult<>();
        httpResult.setCode(200);
        httpResult.setData(eventList);
    
        LogUtil.json(TAG, mGson.toJson(httpResult));
    
        String text = MockDataGenerator.getMockDataFromJsonFile("server/EventList.json");
        if (TextUtils.isEmpty(text)) {
            text = mGson.toJson(httpResult);
        }
        LogUtil.d(TAG, "Text:\n" + text);
    
        text = mGson.toJson(httpResult);
    
        return mDelegate.returningResponse(text).getEventList();
    }
    

4.我的数据来自资产文件(Asset/server/EventList.json),这个文件内容是:

    {
      "code": 200,
      "data": [
        {
          "uuid": "e4beb3c8-3468-11e6-a07d-005056a05722",
          "title": "title",
          "image": "http://image.jpg",
          "goal": 1500000,
          "current": 51233,
          "hot": true,
          "completed": false,
          "createdAt": "2016-06-15T04:00:00.000Z"
        }
      ]
    }

5.如果你使用okhttp3拦截器,你需要自定义拦截器,像这样:

public final class MockHomeDataInterceptor implements Interceptor {
    public static final String TAG = MockHomeDataInterceptor.class.getSimpleName();

    @Override
    public Response intercept(Chain chain) throws IOException {
        Response response = null;

        String path = chain.request().url().uri().getPath();
        LogUtil.d(TAG, "intercept: path=" + path);

        response = interceptRequestWhenDebug(chain, path);
        if (null == response) {
            LogUtil.i(TAG, "intercept: null == response");
            response = chain.proceed(chain.request());
        }
        return response;
    }

    private Response interceptRequestWhenDebug(Chain chain, String path) {
        Response response = null;
        if (BuildConfig.DEBUG) {
            Request request = chain.request();
            if (path.equalsIgnoreCase("/api/event")) {
                //get event list
                response = getMockEventListResponse(request);
            }
    }

    private Response getMockEventListResponse(Request request) {
        Response response;

        String data = MockDataGenerator.getMockDataFromJsonFile("server/EventList.json");
        response = getHttpSuccessResponse(request, data);
        return response;
    }

    private Response getHttpSuccessResponse(Request request, String dataJson) {
        Response response;
        if (TextUtils.isEmpty(dataJson)) {
            LogUtil.w(TAG, "getHttpSuccessResponse: dataJson is empty!");
            response = new Response.Builder()
                    .code(500)
                    .protocol(Protocol.HTTP_1_0)
                    .request(request)
                    //protocol&request be set,otherwise will be exception.
                    .build();
        } else {
            response = new Response.Builder()
                    .code(200)
                    .message(dataJson)
                    .request(request)
                    .protocol(Protocol.HTTP_1_0)
                    .addHeader("Content-Type", "application/json")
                    .body(ResponseBody.create(MediaType.parse("application/json"), dataJson))
                    .build();
        }
        return response;
    }
}

6.最后,您可以使用代码请求您的服务器:

mHomeDataRequester.getEventList(new Subscriber<HttpResult<List<Event>>>() {
    @Override
    public void onCompleted() {

    }

    @Override
    public void onError(Throwable e) {
        LogUtil.e(TAG, "onError: ", e);
        if (mView != null) {
            mView.onEventListLoadFailed();
        }
    }

    @Override
    public void onNext(HttpResult<List<Event>> httpResult) {
        //Your json result will be convert by Gson and return in here!!!
    });
}

谢谢阅读。

于 2016-07-29T07:37:27.670 回答
7

Mockery(免责声明:我是作者)专为这项任务而设计。

Mockery 是一个模拟/测试库,专注于验证网络层,内置对 Retrofit 的支持。它根据给定 Api 的规范自动生成 JUnit 测试。这个想法是不必手动编写任何测试;既没有实现模拟服务器响应的接口。

于 2016-07-13T08:56:59.170 回答
5

添加到@Alec 的答案中,我扩展了模拟客户端以根据请求 URL 直接从资产文件夹中的文本文件中获取响应。

前任

@POST("/activate")
public void activate(@Body Request reqdata, Callback callback);

在这里,模拟客户端知道被触发的 URL 是激活的,并在 assets 文件夹中查找名为 activate.txt 的文件。它从 assets/activate.txt 文件中读取内容并将其作为 API 的响应发送。

这是扩展的MockClient

public class MockClient implements Client {
    Context context;

    MockClient(Context context) {
        this.context = context;
    }

    @Override
    public Response execute(Request request) throws IOException {
        Uri uri = Uri.parse(request.getUrl());

        Log.d("MOCK SERVER", "fetching uri: " + uri.toString());

        String filename = uri.getPath();
        filename = filename.substring(filename.lastIndexOf('/') + 1).split("?")[0];

        try {
            Thread.sleep(2500);
        } catch (InterruptedException e) {
            e.printStackTrace();
        }

        InputStream is = context.getAssets().open(filename.toLowerCase() + ".txt");
        int size = is.available();
        byte[] buffer = new byte[size];
        is.read(buffer);
        is.close();
        String responseString = new String(buffer);

        return new Response(request.getUrl(), 200, "nothing", Collections.EMPTY_LIST, new TypedByteArray("application/json", responseString.getBytes()));
    }
}

有关详细说明,您可以查看我的博客
http://www.cumulations.com/blogs/13/Mock-API-response-in-Retrofit-using-custom-clients

于 2015-05-06T12:12:11.200 回答
2

使用 Retrofit 模拟 api 调用现在使用 Mockingizer 变得更加容易,使得使用 MockWebServer 变得非常简单:

import com.appham.mockinizer.RequestFilter
import okhttp3.mockwebserver.MockResponse

val mocks: Map<RequestFilter, MockResponse> = mapOf(

    RequestFilter("/mocked") to MockResponse().apply {
        setResponseCode(200)
        setBody("""{"title": "Banana Mock"}""")
    },

    RequestFilter("/mockedError") to MockResponse().apply {
        setResponseCode(400)
    }

)

只需创建RequestFilter 和 MockResponses的映射,然后将其插入 OkHttpClient 构建器链:

OkHttpClient.Builder()
            .addInterceptor(loggingInterceptor)
            .mockinize(mocks) // <-- just plug in your custom mocks here
            .build()

您不必担心配置 MockWebServer 等。只需添加您的模拟,其余的都由 Mockingizer 为您完成。

(免责声明:我是 Mockingizer 的作者)

于 2019-08-20T19:30:20.703 回答
1

JSONPlaceholder:用于测试和原型设计的假在线 REST API

https://jsonplaceholder.typicode.com/

ReqresIn:另一个在线 REST API

https://reqres.in/

邮递员模拟服务器

如果你想测试自定义的响应负载,上面两个可能不适合你的要求,那么你可以试试 postman mock server。它很容易设置并且可以灵活地定义您自己的请求和响应负载。

在此处输入图像描述 https://learning.getpostman.com/docs/postman/mock_servers/intro_to_mock_servers/ https://youtu.be/shYn3Ys3ygE

于 2019-07-17T06:54:07.463 回答
0

对我来说,自定义 Retrofit Client 非常棒,因为它具有灵活性。特别是当您使用任何 DI 框架时,您可以快速简单地打开/关闭模拟。我也在单元和集成测试中使用 Dagger 提供的自定义客户端。

编辑:在这里你可以找到模拟改造的例子 https://github.com/pawelByszewski/retrofitmock

于 2014-02-26T01:19:06.773 回答