Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Karate Mock Servlet

Test any Java Servlet without a Container

That’s right, you can test Spring MVC or Spring Boot controllers and even Jersey JAX-RS resource end-points without having to start Tomcat, JBoss, WebSphere, Glassfish or the like.

And you can re-use your traditional HTTP integration tests without changes - just switch your environment, and Karate can run tests and bypass HTTP on the wire.

This can be a huge time-saver as you don’t have to spend time waiting for your app-server to start and stop. You also don’t need to worry about having free ports on your local machine, there’s no more fiddling with HTTPS and certificates, and if you do things right - you can achieve TDD and code-coverage for all your application layers, starting from the web-controllers.

So yes, you can test HTTP web-services with the same ease that you expect from traditional unit-tests. Especially for micro-services - when you combine this approach with Karate’s data-driven and data-matching capabilities, you can lean towards having more integration tests without losing any of the benefits of unit-tests.




Switching the HTTP Client

You can completely customize the HTTP client used by Karate by implementing the HttpClient interface which happens to be very simple.

If you need to create a completely new HttpClient implementation from scratch, the MockHttpClient is a good reference. There are many possibilities here, you can add support for other HTTP clients besides Apache and Jersey, or mock a stack that is not based on Java servlets.

Karate defaults to the ApacheHttpClient, and to change this for a test-run, you can set the HttpClientFactory using the Runner “builder” API.

Mocking Your Servlet

Creating a Servlet and ServletContext instance is up to you and here is where you would manage configuration for your web-application. And then you can implement HttpClientFactory by using the MockHttpClient code provided by Karate.

Once you refer to the following examples, you should be able to get up and running for your project.

Note that the first example above tests the whole of the karate-demo Spring Boot application, and using a parallel runner

If you structure your tests propertly, your *.feature files can be re-used for mock as well as real integration tests.


Most teams would not run into these, but if you do, please consider contributing !

  • File Upload is not supported.
  • Other similar edge-cases (such as redirects) are not supported.

Teams typically use the mock-servlet for simple JSON / XML request-response use cases. If you find some file-upload or negative-test scenarios failing because of the above limitations, you can choose to tag those tests to run only in your end-to-end integration test environment.