Mokksy/dev.mokksy.mokksy.request/RequestSpecification

RequestSpecification

open class RequestSpecification<P : Any>(val method: Matcher<HttpMethod>? = null, val path: Matcher<String>? = null, val headers: List<Matcher<Headers>> = listOf(), val body: List<Matcher<P?>> = listOf(), val bodyString: List<Matcher<String?>> = listOf(), val priority: Int = DEFAULT_STUB_PRIORITY, requestType: KClass<P>)(source)

Represents a specification for matching incoming HTTP requests based on defined criteria, such as HTTP method, request path, and request body.

This class is used to define the criteria against which incoming requests are tested. It provides functionality for checking whether a given request satisfies the specified conditions and supports prioritization for defining matching order.

Parameters

type of the request payload

Constructors

RequestSpecification

constructor(method: Matcher<HttpMethod>? = null, path: Matcher<String>? = null, headers: List<Matcher<Headers>> = listOf(), body: List<Matcher<P?>> = listOf(), bodyString: List<Matcher<String?>> = listOf(), priority: Int = DEFAULT_STUB_PRIORITY, requestType: KClass<P>)

Properties

body

val body: List<Matcher<P?>>

List of matchers for the request body as a P. All matchers must pass for a match to succeed.

bodyString

val bodyString: List<Matcher<String?>>

List of matchers for the request body as a String. All matchers must pass for a match to succeed.

headers

val headers: List<Matcher<Headers>>

List of matchers for Ktor Headers object. All matchers must pass for a match to succeed.

method

val method: Matcher<HttpMethod>?

Matcher for the HTTP method of the request. If null, the method is not validated.

path

val path: Matcher<String>?

Matcher for the request path. If null, the path is not validated.

priority

val priority: Int

The priority value used for comparing different specifications. Lower values indicate higher priority. Default value is DEFAULT_STUB_PRIORITY

Functions

matches

suspend fun matches(request: ApplicationRequest): Result<Boolean>