GH-180 Bump OpenApi spec to 3.1.0, include only non-null properties in scheme & use standalone ObjectMapper instance (Fix #180)

Author: dzikoysk

build.gradle.kts

@@ -121,9 +121,9 @@ subprojects {
 
         testImplementation("org.assertj:assertj-core:3.24.2")
         testImplementation("net.javacrumbs.json-unit:json-unit-assertj:2.36.1")
-        testImplementation("com.konghq:unirest-java:3.14.1")
+        testImplementation("com.konghq:unirest-java:3.14.2")
 
-        testImplementation("ch.qos.logback:logback-classic:1.4.5")
+        testImplementation("ch.qos.logback:logback-classic:1.4.6")
     }
 
     tasks.withType<Test> {

examples/javalin-gradle-kotlin/src/main/java/io/javalin/openapi/plugin/test/JavalinTest.java

@@ -91,7 +91,6 @@ public static void main(String[] args) {
                             openApiLicense.setIdentifier("Apache-2.0");
 
                             openApiInfo.setTitle("Awesome App");
-                            openApiInfo.setSummary("App summary");
                             openApiInfo.setDescription("App description goes right here");
                             openApiInfo.setTermsOfService("https://example.com/tos");
                             openApiInfo.setContact(openApiContact);

javalin-plugins/javalin-openapi-plugin/src/main/kotlin/io/javalin/openapi/plugin/OpenApiPlugin.kt

@@ -1,11 +1,10 @@
 package io.javalin.openapi.plugin
 
+import com.fasterxml.jackson.annotation.JsonInclude.Include
 import com.fasterxml.jackson.databind.JsonNode
 import com.fasterxml.jackson.databind.ObjectMapper
 import com.fasterxml.jackson.databind.node.ObjectNode
 import io.javalin.Javalin
-import io.javalin.json.JavalinJackson
-import io.javalin.json.jsonMapper
 import io.javalin.openapi.OpenApiLoader
 import io.javalin.plugin.Plugin
 import kotlin.DeprecationLevel.WARNING
@@ -28,17 +27,17 @@ open class OpenApiPlugin @JvmOverloads constructor(private val configuration: Op
 
     private fun createDocumentation(app: Javalin): Lazy<Map<String, String>> =
         lazy {
-            val jsonMapper = when (val jsonMapper = app.jsonMapper()) {
-                is JavalinJackson -> jsonMapper.mapper
-                else -> JavalinJackson.defaultMapper()
+            // skip nulls from cfg
+            val jsonMapper = lazy {
+                ObjectMapper().setSerializationInclusion(Include.NON_NULL)
             }
 
             OpenApiLoader()
                 .loadOpenApiSchemes()
                 .mapValues { (version, rawDocs) ->
                     configuration.definitionConfiguration
                         ?.let { DefinitionConfiguration().also { definition -> it.accept(version, definition) } }
-                        ?.applyConfigurationTo(jsonMapper, version, rawDocs)
+                        ?.applyConfigurationTo(jsonMapper.value, version, rawDocs)
                         ?: rawDocs
                 }
         }

openapi-annotation-processor/src/main/kotlin/io/javalin/openapi/processor/generators/OpenApiGenerator.kt

@@ -98,7 +98,7 @@ internal class OpenApiGenerator {
      */
     private fun generateSchema(openApiAnnotations: Collection<Pair<Element, OpenApi>>): String {
         val openApi = JsonObject()
-        openApi.addProperty("openapi", "3.0.3")
+        openApi.addProperty("openapi", "3.1.0")
 
         // fill info
         val info = JsonObject()

openapi-annotation-processor/src/test/kotlin/io/javalin/openapi/processor/OpenApiAnnotationTest.kt

@@ -23,7 +23,7 @@ internal class OpenApiAnnotationTest : OpenApiAnnotationProcessorSpecification()
     fun should_generate_info() = withOpenApi("should_generate_info") {
         assertThatJson(it)
             .isObject
-            .containsEntry("openapi", "3.0.3")
+            .containsEntry("openapi", "3.1.0")
             .containsEntry("info", json("""{ "title":"", "version": "" }"""))
     }
 

openapi-specification/build.gradle.kts

@@ -1,6 +1,8 @@
 description = "Javalin OpenAPI Specification | Compile-time OpenAPI integration for Javalin 5.x"
 
 dependencies {
-    api("com.fasterxml.jackson.core:jackson-databind:2.14.2")
+    val jacksonVersion = "2.14.2"
+    api("com.fasterxml.jackson.core:jackson-databind:$jacksonVersion")
+    api("com.fasterxml.jackson.module:jackson-module-kotlin:$jacksonVersion")
     api("com.google.code.gson:gson:2.10.1")
 }