Releases · javalin/javalin-openapi

GH-127 Support compile-time Groovy script to preconfigure annotation processor (Experimental API)
- GH-125 Add debug logging to custom annotation mapper
- GH-108 Extend experimental scripting API with a possibility to filter specific properties from schemes
- GH-125 Print in debug mode all annotations on element with usage and its implementation
- Script should be defined in src/main/compile/openapi.groovy file as follows:

import groovy.transform.CompileStatic
import io.javalin.openapi.experimental.ExperimentalCompileOpenApiConfiguration
import io.javalin.openapi.experimental.OpenApiAnnotationProcessorConfiguration
import io.javalin.openapi.experimental.OpenApiAnnotationProcessorConfigurer

@CompileStatic
@ExperimentalCompileOpenApiConfiguration
class OpenApiConfiguration implements OpenApiAnnotationProcessorConfigurer {

    @Override
    void configure(OpenApiAnnotationProcessorConfiguration openApiAnnotationProcessorConfiguration) {
        // enable extra debug logging
        openApiAnnotationProcessorConfiguration.debug = true

        // example of custom property filter to exclude/include given element in class scheme
        configuration.propertyInSchemeFilter = { AnnotationProcessorContext ctx, ClassDefinition type, Element property ->
            TypeElement specificRecord = ctx.forTypeElement('io.javalin.openapi.processor.UserCasesTest.SpecificRecord')

            if (ctx.isAssignable(type.mirror, specificRecord.asType())) {
                return !ctx.hasElement(specificRecord, property)
            }

            return true
        }
    }

}

GH-124 Remove generic type signature from TypeMirror names

Download

Wiki / Installation

Assets 2

16 Dec 21:10

dzikoysk

5.3.0-alpha.3

95a9a2e

5.3.0-alpha.3 Pre-release

Pre-release

This is alpha build
API may be changed between alpha builds to properly form its final shape in the official release.

Changes

GH-122 Support @OpenApiName on classes
GH-123 Fix invalid info object serialization in OpenApiPlugin
GH-121 Preserve declared order of parameters
GH-118 Implement backwards compatible layer for old OpenApi plugin configuration

Download

Wiki / Installation

Assets 2

10 Dec 00:21

dzikoysk

5.3.0-alpha.1

dcd7ca7

5.3.0-alpha.1 Pre-release

Pre-release

This is alpha build
API may be changed between alpha builds to properly form its final shape in the official release.

Changes

GH-116 Distinguish definitions in plugin setup
- This change is breaking, so you have to update your current configuration of OpenApi plugin.
  Those changes were required to properly address different versions of generated schemes.
- See updated setup on wiki to check the new approach
GH-96 Support @OneOf/@AllOf/@AnyOf on classes
GH-97 Use reusable enums to cover enum values
GH-111 Hide implementation details of enum classes
GH-113 Automatically add missing / to routes
GH-112 Exclude dependencies of ReDoc webjar by default
GH-95 Add error location to the missing mime type warning