Test using Service Virtualisation
Using the JUnit Extensions
package guide.howto.test_using_service_virtualisation.junit
import com.natpryce.hamkrest.assertion.assertThat
import com.natpryce.hamkrest.equalTo
import org.http4k.client.ApacheClient
import org.http4k.core.Credentials
import org.http4k.core.HttpHandler
import org.http4k.core.Method.POST
import org.http4k.core.Request
import org.http4k.core.Response
import org.http4k.core.Status.Companion.OK
import org.http4k.core.Uri
import org.http4k.core.then
import org.http4k.filter.ClientFilters.SetHostFrom
import org.http4k.junit.ServirtiumRecording
import org.http4k.junit.ServirtiumReplay
import org.http4k.server.SunHttp
import org.http4k.server.asServer
import org.http4k.servirtium.GitHub
import org.http4k.servirtium.InteractionStorage.Companion.Disk
import org.junit.jupiter.api.AfterEach
import org.junit.jupiter.api.BeforeAll
import org.junit.jupiter.api.Disabled
import org.junit.jupiter.api.Test
import org.junit.jupiter.api.TestInstance
import org.junit.jupiter.api.TestInstance.Lifecycle.PER_CLASS
import org.junit.jupiter.api.extension.RegisterExtension
import java.io.File
import java.nio.file.Paths
/**
* This client wraps the calls to a remote WordCounter service
*/
class WordCounterClient(private val http: HttpHandler) {
fun wordCount(name: String): Int =
http(Request(POST, "/count").body(name)).bodyString().toInt()
}
/**
* This is our producing app
*/
class WordCounterApp : HttpHandler {
override fun invoke(req: Request) = Response(OK).body(
req.bodyString().run { if (isBlank()) 0 else split(" ").size }.toString()
)
}
/**
* Defines the test contract which will be recorded and replayed later.
* The injected HttpHandler is provided by the implementations of this interface.
*/
interface WordCounterContract {
@Test
fun `count the number of words`(handler: HttpHandler) {
assertThat(
WordCounterClient(handler).wordCount("A random string with 6 words"),
equalTo(6)
)
}
@Test
fun `empty string has zero words`(handler: HttpHandler) {
assertThat(WordCounterClient(handler).wordCount(""), equalTo(0))
}
}
/**
* For the traditional use-case of a CDC, we use a real Http client to
* record the traffic against a running version of the producing service.
*/
@Disabled
class RemoteHttpRecordingWordCounterTest : WordCounterContract {
private val app = SetHostFrom(Uri.of("http://serverundertest:8080"))
.then(ApacheClient())
@JvmField
@RegisterExtension
val record = ServirtiumRecording("WordCounter", app, Disk(File(".")))
}
/**
* In cases where the producing service codebase:
* 1. Has access to the wrapping Client and the ClientContract code (eg. monorepo with several services)
* 2. Is also written in http4k
* ... we can have the Producer implement the contract entirely in-memory without a MiTM.
*/
@Disabled
class InMemoryRecordingWordCounterTest : WordCounterContract {
private val app = WordCounterApp()
@JvmField
@RegisterExtension
val record = ServirtiumRecording("WordCounter", app, Disk(File(".")))
@AfterEach
fun after(handler: HttpHandler) {
val name = "this traffic is not recorded"
println(name + ": " + WordCounterClient(handler).wordCount(name))
}
}
/**
* In cases where the producing service codebase:
* 1. Has access to the wrapping Client and the ClientContract code (eg. monorepo with several services)
* 2. Is *not* written in http4k
* ... we can have the Producer implement the contract by starting up the server and with a MiTM.
*/
@TestInstance(PER_CLASS)
@Disabled
class PortBoundRecordingWordCounterTest : WordCounterContract {
@BeforeAll
fun start() {
// pretend that this is not an http4k service.. :)
WordCounterApp().asServer(SunHttp(8080)).start()
}
private val app = SetHostFrom(Uri.of("http://localhost:8080"))
.then(ApacheClient())
@JvmField
@RegisterExtension
val record = ServirtiumRecording("WordCounter", app, Disk(File(".")))
}
@Disabled
class ReplayFromDiskTest : WordCounterContract {
@JvmField
@RegisterExtension
val replay = ServirtiumReplay("WordCounter", Disk(File(".")))
}
@Disabled
class ReplayFromGitHubTest : WordCounterContract {
@JvmField
@RegisterExtension
val replay = ServirtiumReplay(
"WordCounter",
GitHub(
"http4k", "http4k",
Credentials("<github user>", "<personal access token>"),
Paths.get("src/test/resources/guide/howto/service_virtualisation")
)
)
}
Using a MiTM Proxy
package guide.howto.test_using_service_virtualisation.mitm
import com.natpryce.hamkrest.assertion.assertThat
import com.natpryce.hamkrest.equalTo
import org.http4k.client.ApacheClient
import org.http4k.core.Credentials
import org.http4k.core.Method.POST
import org.http4k.core.Request
import org.http4k.core.Response
import org.http4k.core.Status.Companion.OK
import org.http4k.core.Uri
import org.http4k.core.then
import org.http4k.filter.ClientFilters
import org.http4k.filter.ClientFilters.SetHostFrom
import org.http4k.filter.HandleRemoteRequestFailed
import org.http4k.routing.bind
import org.http4k.routing.routes
import org.http4k.server.Http4kServer
import org.http4k.server.SunHttp
import org.http4k.server.asServer
import org.http4k.servirtium.GitHub
import org.http4k.servirtium.InteractionOptions
import org.http4k.servirtium.InteractionStorage.Companion.Disk
import org.http4k.servirtium.ServirtiumServer
import org.junit.jupiter.api.AfterEach
import org.junit.jupiter.api.BeforeEach
import org.junit.jupiter.api.Disabled
import org.junit.jupiter.api.Test
import org.junit.jupiter.api.TestInfo
import java.io.File
import java.nio.file.Paths
/**
* This is our producing app
*/
fun WordCounterApp(port: Int): Http4kServer {
val app = routes("/count" bind POST to { req: Request ->
Response(OK).body(
req.bodyString().run { if (isBlank()) 0 else split(" ").size }.toString()
)
})
return app.asServer(SunHttp(port))
}
/**
* This client wraps the calls to a remote WordCounter service
*/
class WordCounterClient(baseUri: Uri) {
private val http = SetHostFrom(baseUri)
.then(ClientFilters.HandleRemoteRequestFailed())
.then(ApacheClient())
fun wordCount(name: String): Int =
http(Request(POST, "/count").body(name)).bodyString().toInt()
}
/**
* Defines the test contract which will be recorded and replayed later.
*/
interface WordCounterContract {
val uri: Uri
@Test
fun `count the number of words`() {
assertThat(
WordCounterClient(uri).wordCount("A random string with 6 words"),
equalTo(6)
)
}
@Test
fun `empty string has zero words`() {
assertThat(WordCounterClient(uri).wordCount(""), equalTo(0))
}
}
/**
* This calls the server directly
*/
@Disabled
class DirectHttpWordCounterTest : WordCounterContract {
override val uri = Uri.of("http://serverundertest:8080")
}
/**
* Proxies traffic to the real service and records it to disk. Both MiTM and Producer start on a random port.
*/
@Disabled
class MiTMRecordingWordCounterTest : WordCounterContract {
override val uri get() = Uri.of("http://localhost:${servirtium.port()}")
private val app = WordCounterApp(0)
private lateinit var servirtium: Http4kServer
@BeforeEach
fun start(info: TestInfo) {
val appPort = app.start().port()
servirtium = ServirtiumServer.Recording(
info.displayName.removeSuffix("()"),
Uri.of("http://localhost:$appPort"),
Disk(File(".")),
object : InteractionOptions {
override fun modify(request: Request) =
request.removeHeader("Host").removeHeader("User-agent")
override fun modify(response: Response) = response.removeHeader("Date")
}
).start()
}
@AfterEach
fun stop() {
app.stop()
servirtium.stop()
}
}
/**
* Replays incoming traffic from disk. MiTM starts on a random port.
*/
@Disabled
class MiTMReplayingWordCounterTest : WordCounterContract {
override val uri get() = Uri.of("http://localhost:${servirtium.port()}")
private lateinit var servirtium: Http4kServer
@BeforeEach
fun start(info: TestInfo) {
servirtium = ServirtiumServer.Replay(info.displayName.removeSuffix("()"),
Disk(File(".")),
object : InteractionOptions {
override fun modify(request: Request) =
request.header("Date", "some overridden date")
}
).start()
}
@AfterEach
fun stop() {
servirtium.stop()
}
}
/**
* Replays incoming traffic from GitHub. MiTM starts on a random port. Requires a github username
* and personal access token.
*/
@Disabled
class GitHubReplayingWordCounterTest : WordCounterContract {
override val uri get() = Uri.of("http://localhost:${servirtium.port()}")
private lateinit var servirtium: Http4kServer
@BeforeEach
fun start(info: TestInfo) {
servirtium =
ServirtiumServer.Replay(
name = "WordCounter." + info.displayName.removeSuffix("()"),
GitHub(
"http4k", "http4k",
Credentials("<github user>", "<personal access token>"),
Paths.get("src/test/resources/guide/howto/service_virtualisation")
),
object : InteractionOptions {
override fun modify(request: Request) = request
.removeHeader("Accept-encoding")
.removeHeader("Connection")
.removeHeader("Host")
.removeHeader("User-agent")
.removeHeader("Content-length")
}
).start()
}
@AfterEach
fun stop() {
servirtium.stop()
}
}