io.javalin.plugin.openapi.dsl.openApiUpdaterDsl.kt Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of javalin Show documentation

Javalin: Simple REST APIs for Java and Kotlin

There is a newer version: 6.2.0

/**
 * This file contains helper methods to update openapi items without overriding the original
 */
package io.javalin.plugin.openapi.dsl

import io.swagger.v3.oas.models.*
import io.swagger.v3.oas.models.media.Content
import io.swagger.v3.oas.models.parameters.Parameter
import io.swagger.v3.oas.models.parameters.RequestBody
import io.swagger.v3.oas.models.responses.ApiResponse
import io.swagger.v3.oas.models.responses.ApiResponses

internal fun OpenAPI.updateComponents(apply: Components.() -> Unit) {
    components = components ?: Components()
    components.apply(apply)
}

internal fun OpenAPI.updatePaths(apply: Paths.() -> Unit) {
    paths = paths ?: Paths()
    paths.apply(apply)
}

internal fun Paths.updatePath(name: String, apply: PathItem.() -> Unit) {
    if (get(name) == null) {
        addPathItem(name, PathItem())
    }
    get(name)!!.apply(apply)
}

internal fun RequestBody.updateContent(apply: Content.() -> Unit) {
    content = content ?: Content()
    content.apply(apply)
}

internal fun ApiResponse.updateContent(apply: Content.() -> Unit) {
    content = content ?: Content()
    content.apply(apply)
}

internal fun Operation.updateParameter(apply: Parameter.() -> Unit) {
    val parameterWithUpdatesApplied = Parameter().also { apply(it) }
    if (parameters == null) {
        parameters = mutableListOf()
    }
    val oldParameter = parameters.find { it.`in` == parameterWithUpdatesApplied.`in` && it.name == parameterWithUpdatesApplied.name }
    if (oldParameter == null) {
        parameters.add(Parameter().apply(apply))
    } else {
        oldParameter.apply(apply)
    }
}

fun Operation.updateRequestBody(apply: RequestBody.() -> Unit) {
    if (requestBody == null) {
        requestBody = RequestBody()
    }
    requestBody.apply(apply)
}

internal fun Operation.updateResponses(apply: ApiResponses.() -> Unit) {
    if (responses == null) {
        responses = ApiResponses()
    }
    responses.apply(apply)
}

internal fun ApiResponses.updateResponse(name: String, apply: ApiResponse.() -> Unit) {
    val response = get(name)
    if (response == null) {
        addApiResponse(name, ApiResponse().apply(apply))
    } else {
        response.apply(apply)
    }
}