springdoc-openapi v3.0.1 released!

Added

• #3122 – Add log notifications when SpringDocs / Scalar are enabled by default
• #3123 – Add support for serving static resources
• #3151 – Add @Order to ApplicationReadyEvent listener
• #3158 – Add support for API groups in Scalar
• #3187 – Add Scalar WebMVC and WebFlux support
• #3185 – Disable creation of blank GitHub issues (GitHub settings & workflow)
• #3186 – Decouple Web Server APIs following Spring Boot modularization
• #3131 – Improve warning messages when documentation is explicitly enabled
• #3183 – Remove unused operations consumer from route builder methods
• #3141 – Change handling so useReturnTypeSchema is evaluated at HTTP status code level instead of method level

Changed

• Upgrade Spring Boot to version 4.0.1
• Upgrade swagger-core to version 2.2.41
• Upgrade swagger-ui to version 5.31.0
• Upgrade Scalar to version 0.4.3

Fixed

• #3133 – Fix regression where content type from Swagger @RequestBody did not take precedence
• #3146 – Fix WebJar resource handler mappings for Swagger UI resources
• #3168 – Support @Schema annotations on Kotlin value classes
• #3178 – Fix regression when generating documentation for Kotlin LinkedHashSet
• #3170 – Fix warnings when setting title and description in application.yml
• #3173 – Fix /v3/api-docs returning Base64-encoded response with Spring Framework 7.0.2
• #3155 – Fix native image support regression with SpringDoc 3.0 and Spring Boot 4.0

What's Changed

• Fix WebJar resource handler mappings for Swagger UI resources by @jamesmissen in #3146
• Decoupling Web Server APIs after Spring Boot modularization by @nicolasb29 in #3186

New Contributors

• @jamesmissen made their first contribution in #3146
• @nicolasb29 made their first contribution in #3186

Full Changelog: v3.0.0...v3.0.1

springdoc-openapi v2.8.15 released!

Added

• #3122 – Add log notifications when SpringDocs / Scalar are enabled by default
• #3123 – Add support for serving static resources
• #3151 – Add @Order to ApplicationReadyEvent listener
• #3158 – Add support for API groups in Scalar
• #3187 – Add Scalar WebMVC and WebFlux support
• #3185 – Disable creation of blank GitHub issues (GitHub settings & workflow)
• #3186 – Decouple Web Server APIs following Spring Boot modularization
• #3131 - Improve warning messages when documentation is explicitly enabled
• #3183 - Remove unused operations consumer from route builder methods
• #3141 - Change handling so useReturnTypeSchema is evaluated at HTTP status code level instead of method level

Changed

• Upgrade Spring Boot to version 3.5.9
• Upgrade swagger-core to version 2.2.41
• Upgrade swagger-ui to version 5.31.0
• Upgrade Scalar to version 0.4.3

Fixed

• #3133 – Fix regression where content type from Swagger @RequestBody did not take precedence
• #3146 – Fix WebJar resource handler mappings for Swagger UI resources
• #3168 – Support @Schema annotations on Kotlin value classes
• #3178 – Fix regression when generating documentation for Kotlin LinkedHashSet
• #3170 – Fix warnings when setting title and description in application.yml
• #3187 – Add scalar scalar-webmvc and scalar-webflux support

What's Changed

• feat: static resources by @TiPo4u4eK in #3123
• [Fix] Regression where content type from swagger @RequestBody does not take precedence by @Mattias-Sehlstedt in #3133
• docs(security): allow /v3/api-docs(.yaml) & Swagger UI when Spring Security is enabled (management port) by @RituMalav in #3150
• docs(management-port): add example for /v3/api-docs and Swagger UI (#… by @RituMalav in #3148
• Change so useReturnTypeSchema is considered on an http code level by @Mattias-Sehlstedt in #3141
• feat: add @order to ApplicationReadyEvent listener (#3151) by @WeisSebastian in #3153
• Remove unused operations consumer from route builder methods by @JohnNiang in #3183
• Disable creation of a blank GitHub issue by @Mattias-Sehlstedt in #3185

New Contributors

• @TiPo4u4eK made their first contribution in #3123
• @RituMalav made their first contribution in #3150
• @WeisSebastian made their first contribution in #3153

Full Changelog: v2.8.14...v2.8.15

springdoc-openapi v3.0.0 released!

Added

• #2975 - Spring Framework 7 - Initial API versioning support
• #3123 - Support static resources for webflux

Changed

• Upgrade to Spring Boot 4.0.0!
• Upgrade to Scalar 0.4.3

Fixed

• #3131 - Warning messages when docs are explicitly enabled
• #3121 - NPE in KotlinDeprecatedPropertyCustomizer - resolvedSchema is null

Full Changelog: v3.0.0-RC1...v3.0.0

springdoc-openapi v3.0.0-RC1 released!

Added

• #3095 - Add support for Spring Boot 4.0.0-RC1

Full Changelog: v3.0.0-M1...v3.0.0-RC1

springdoc-openapi v2.8.14 released!

What's Changed

• disable "/v3/api-docs", and "/swagger-ui.html" by default and upgrade to Scalar 0.2.1 by @zakaria-shahen in #3090
• Upgrade swagger-core to version 2.2.38 by @Mattias-Sehlstedt in #3105
• fix:compatible with lower version of getOpenApi(). by @SkyeBeFreeman in #3107
• Add logs to notify when SpringDocs/Scalar is enabled because SpringDocs/Scalar is enabled by default (#3090) by @zakaria-shahen in #3122

Added

• #3090 - Add logs to notify when SpringDocs/Scalar is enabled because SpringDocs/Scalar is enabled by default

Changed

• Upgrade swagger-ui to v5.30.1
• Upgrade swagger-core to v2.2.38
• Upgrade spring-boot to v3.5.7
• Upgrade commons-lang3 to v3.18.0
• Upgrade scalar to v0.3.12

Fixed

• #3107 - Fix:compatible with lower version of getOpenApi().
• #3121 - NPE in KotlinDeprecatedPropertyCustomizer - resolvedSchema is null

New Contributors

• @zakaria-shahen made their first contribution in #3090
• @SkyeBeFreeman made their first contribution in #3107

Full Changelog: v2.8.13...v2.8.14

springdoc-openapi v2.8.13 released!

Added

• #3084 - Add Scalar Support

Changed

• Upgrade swagger-ui to v5.28.1

Fixed

• #3076 - With oneOf the response schema contains an extra type: string

Full Changelog: v2.8.12...v2.8.13

springdoc-openapi v2.8.12 released!

Changed

• Upgrade swagger-ui to v5.28.0

Fixed

• #3073 - Duplicate key class Parameter when documenting two GET methods with same path and PathVariable.
• #3071 - @io.swagger.v3.oas.annotations.parameters.RequestBody does not work well with @RequestPart
• #3066 - Parameter is now required after upgrading to springdoc-openapi 2.8.10

Full Changelog: v2.8.11...v2.8.12

springdoc-openapi v3.0.0-M1 released!

Added

• #3062 - Add Spring Boot 4.0.0-M2 support

springdoc-openapi v2.8.11 released!

Added

• #3065 - javadoc and overall performance optimization

Changed

• Upgrade spring-boot to v3.5.5

Fixed

• #3064 -ClassNotFoundException: kotlin.reflect.full.KClasses

New Contributors

• @rayuuuu made their first contribution in #3065

Full Changelog: v2.8.10...v2.8.11

springdoc-openapi v2.8.10 released!

What's Changed

• Fix unexpected merging of media types by @Mattias-Sehlstedt in #3026
• Fixed "desciption" typo by @lc-nyovchev in #3036
• Fix: Property resolution for extensions within @OpenAPIDefinition Info object by @limehee in #3039
• Support externalDocs configure on SpecPropertiesCustomizer by @huisam in #3042
• Use adaptFromForwardedHeaders instead of deprecated fromHttpRequest by @thijsnissen in #3060
• Fixes so that a RequestPart with a Map is added to the RequestBody by @Mattias-Sehlstedt in #3051
• Refactor webhook discovery and scanning mechanism by @zdary in #3057

Added

• #3046 - Feature Request: Support @jakarta.annotation.Nonnull.
• #3042 - Support externalDocs configure on SpecPropertiesCustomizer
• #3057 - Refactor webhook discovery and scanning mechanism

Changed

• Upgrade spring-boot to v3.5.4
• Upgrade swagger-ui to v5.27.1
• Upgrade swagger-core to 2.2.36

Fixed

• #3050 - @RequestPart JSON parameters missing Content-Type in generated curl commands, causing 415 errors.
• #2978 - Parameter is no longer optional after upgrade to 2.8.8
• #3022 - NullPointerException thrown in SchemaUtils.
• #3026 - Fix unexpected merging of media types
• #3036 - Fixed "desciption"
• #3039 - Fix: Property resolution for extensions within @OpenAPIDefinition Info object
• #3051 - Fixes so that a RequestPart with a Map is added to the RequestBody
• #3060 - Use adaptFromForwardedHeaders instead of deprecated fromHttpRequest

New Contributors

• @Mattias-Sehlstedt made their first contribution in #3026
• @lc-nyovchev made their first contribution in #3036
• @huisam made their first contribution in #3042
• @thijsnissen made their first contribution in #3060
• @zdary made their first contribution in #3057

Full Changelog: v2.8.9...v2.8.10