tegral-openapi-dsl/guru.zoroark.tegral.openapi.dsl/RequestBodyDsl

RequestBodyDsl

interface RequestBodyDsl : BodyDsl

DSL for the request body object.

Inheritors

RequestBodyBuilder

Properties

abstract val content: MutableList<Pair<String, Buildable<MediaType>>>

A "map" containing descriptions of potential payloads. The key is a media type or media type range and teh value describes it.

abstract var description: String?

A brief description of the request body. This could contain examples of use. CommonMark syntax may be used for rich text representation.

open val form: ContentType

ContentType object for application/x-www-form-urlencoded

open val json: ContentType

ContentType object for application/json

open val plainText: ContentType

ContentType object for text/plain

abstract var required: Boolean?

Determines if the request body is required in the request. Defaults to false.

open val xml: ContentType

ContentType object for application/xml

Functions

abstract infix fun String.content(builder: MediaTypeBuilder.() -> Unit)

Creates a content entry for this content type (the string receiver) and body (the builder configured by the lambda). See MediaTypeDsl for more information on what you can do in the lambda.

open operator fun ContentType.invoke(builder: MediaTypeBuilder.() -> Unit)

Creates a content entry for this content type and body. See MediaTypeDsl for more information on what you can do in the lambda.

open operator fun MultiContentType.invoke(builder: MediaTypeBuilder.() -> Unit)

Creates content entries for each of the provided content types with the same body. See MediaTypeDsl for more information on what you can do in the lambda.