Question 1

How do I set up RESTMock for Android instrumentation tests?

Accepted Answer

Add the dependency via JitPack, configure a custom test runner like RESTMockTestRunner, and point your API client's base URL to RESTMockServer.getUrl(). The README provides specific steps for integration with Retrofit or similar clients.

Question 2

What's the difference between RESTMock and okhttp's MockWebServer?

Accepted Answer

RESTMock wraps MockWebServer to add Hamcrest-based matchers, response chaining, delays, and Android-specific integrations like RESTMockTestRunner. It simplifies mocking for Android tests compared to using MockWebServer directly with more boilerplate.

Question 3

How can I simulate a slow network response with RESTMock?

Accepted Answer

Use the delayBody() or delayHeaders() methods in your mock definitions, specifying time units and durations. For example, .delayBody(TimeUnit.SECONDS, 5) delays the response body by 5 seconds, as shown in the response delays section.

Question 4

Can I use RESTMock for unit tests instead of instrumentation tests?

Accepted Answer

RESTMock is optimized for instrumentation tests on Android due to its HTTP server nature. For unit tests, consider lighter mocks like Mockito for your HTTP client, as RESTMock might be overkill and require additional setup.

Question 5

How do I verify that an API call was made during a test?

Accepted Answer

Use the RequestsVerifier class with methods like verifyGET().invoked() or .exactly(n) to check invocation counts. This allows you to confirm that specific requests were triggered as expected in your tests.

Question 6

Does RESTMock support mocking GraphQL APIs or only REST?

Accepted Answer

RESTMock is designed for REST APIs and uses HTTP request matchers. While you could mock GraphQL by matching request bodies, it lacks built-in support for GraphQL-specific features like query validation or schema handling.

RESTMock

What is RESTMock?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions