An open API service indexing awesome lists of open source software.

https://github.com/testcontainers/tc-guide-testing-rest-api-integrations-using-mockserver

Testing REST API integrations using MockServer Guide
https://github.com/testcontainers/tc-guide-testing-rest-api-integrations-using-mockserver

Last synced: 3 months ago
JSON representation

Testing REST API integrations using MockServer Guide

Awesome Lists containing this project

README

        

# Testing REST API integrations using MockServer

This is sample code for [Testing REST API integrations using MockServer](https://testcontainers.com/guides/testing-rest-api-integrations-using-mockserver) guide.

## 1. Setup Environment
Make sure you have Java 8+ and a [compatible Docker environment](https://www.testcontainers.org/supported_docker_environment/) installed.
If you are going to use Maven build tool then make sure Java 17+ is installed.

For example:

```shell
$ java -version
openjdk version "17.0.4" 2022-07-19
OpenJDK Runtime Environment Temurin-17.0.4+8 (build 17.0.4+8)
OpenJDK 64-Bit Server VM Temurin-17.0.4+8 (build 17.0.4+8, mixed mode, sharing)
$ docker version
...
Server: Docker Desktop 4.12.0 (85629)
Engine:
Version: 20.10.17
API version: 1.41 (minimum version 1.12)
Go version: go1.17.11
...
```

## 2. Setup Project

* Clone the repository

```shell
git clone https://github.com/testcontainers/tc-guide-testing-rest-api-integrations-using-mockserver.git
cd tc-guide-testing-rest-api-integrations-using-mockserver
```

* Open the **tc-guide-testing-rest-api-integrations-using-mockserver** project in your favorite IDE.

## 3. Run Tests

Run the command to run the tests.

```shell
$ ./gradlew test //for Gradle
$ ./mvnw verify //for Maven
```

The tests should pass.

> [!NOTE]
> The project is configured to automate the code formatting with spotless plugin
> using prettier-plugin-java, which internally requires Node.js runtime.
> If you don't have Node.js installed and want to disable the code formatting,
> you can pass additional parameter to the build command as shown below:

```shell
./gradlew build -x spotlessCheck //for Gradle
./mvnw verify -Dspotless.check.skip=true //for Maven
```