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

ParameterBuilder

class ParameterBuilder( context: OpenApiDslContext, name: String, kind: ParameterKind) : Builder<Parameter> , ParameterDsl

Builder for ParameterDsl

Constructors

ParameterBuilder

fun ParameterBuilder( context: OpenApiDslContext, name: String, kind: ParameterKind)

Functions

build

open override fun build(): Parameter

Build the object.

required

open fun required()

Sets required = true when called.

schema

open override fun schema(ktype: KType)

Sets the schema of this object to be of the given KType. The type will be converted to a schema.

Properties

allowEmptyValue

~~open~~ ~~override~~ ~~var~~ ~~allowEmptyValue~~: Boolean? = ~~null~~

If true, the parameter value can be empty. Valid only for query parameters. Default is false.

allowReserved

open override var allowReserved: Boolean? = null

If true, the parameter value can contain reserved characters.

deprecated

open override var deprecated: Boolean? = null

Specifies that a parameter is deprecated and should be transitioned out of usage. False by default.

description

open override var description: String? = null

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

example

open override var example: Any? = null

The example for this object. Should match the given schema.

explode

open override var explode: Boolean? = null

When set to true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map. Has no effect for other types of parameters. Default value is true if style is set to form, false otherwise.

required

open override var required: Boolean? = null

Determines whether this parameter is mandatory. If the parameter is a path parameter, this value will always be set to true, otherwise it is false by default.

schema

open override var schema: Schema<*>? = null

The schema for this object.

style

open override var style: Parameter.StyleEnum? = null

Describes how the parameter value will be serialized dependong on the type of the parameter value.