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

Added

• #3062 - Add Spring Boot 4.0.0-M2 support

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

Contributors

• @rayuuuu

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

Contributors

• @thijsnissen
• @lc-nyovchev
• @zdary
• @huisam
• @Mattias-Sehlstedt
• @limehee

What's Changed

• Support for @positive by @mpleine in #3001
• Fixes for Spring Boot 3.5.0 API by @mschout in #3007
• feat: type-use for method parameters by @mymx2 in #3011

Added

• #2944 - Support for @positive
• #3011 - type-use for method parameters

Changed

• Upgrade spring-boot to version 3.5.0

Fixed

• #2982 - application/problem+json content type is not set for ProblemDetails
• #2990 - Issues with POST Request, application/x-www-form-urlencoded and only one parameter
• #2998 - io.swagger.v3.oas.annotations.Webhook does not work when defined on the method level
• #3012 - Order of examples is (sometimes) not preserved

New Contributors

• @mpleine made their first contribution in #3001

Full Changelog: v2.8.8...v2.8.9

Contributors

• @mschout
• @positive
• @mymx2
• @mpleine

Full Changelog: v2.8.7...v2.8.8

Fixed

• #2977 - Handle projects not using kotlin-reflect #2977

What's Changed

Added

• #2944 - Introducing springdoc-openapi-bom project
• #2948 - Customize Servers via application.yml
• #2963 - Set default content type for problem details object to application/problem+jso
• #2971 - List of value classes in Kotlin

Changed

• Upgrade swagger-ui to v5.21.0
• Upgrade swagger-core to 2.2.30
• Upgrade spring-boot to version 3.4.5
• Upgrade spring-security-oauth2-authorization-server to version 1.4.3

Fixed

• #2947 - Unexpected warning "Appended trailing slash to static resource location"
• #2960 - NPE when customizing group's open-api without specifying any schema
• #2969 - fix path to register resource handler to work SwaggerIndexPageTransformer considering /webjar path prefix
• #2964 - Cannot add custom description and example for java.time.Duration since v2.8.6
• #2972 - @Header(schema = @Schema(type = "string")) generates empty or broken schema in OpenAPI output since 2.8.0
• #2976, #2967 - Build Failure due to Private Inner Class.
• #2556 - Unable to determine if it is a Kotlin type

New Contributors

• @lagoshny made their first contribution in #2970
• @mymx2 made their first contribution in #2950

Full Changelog: v2.8.6...v2.8.7

Contributors

• @Header
• @Schema
• @mymx2
• @lagoshny

What's Changed

• Update README.md by @berezkin88 in #2911
• Check both SerDe BeanPropertyDefinition for @JsonUnwrapped/@Schema by @wingsofovnia in #2909
• Bail sealed class subtype introspection on Schema by @sahil-ramagiri in #2927
• Add missing builder methods in SchemaBuilder by @JohnNiang in #2928

Added

• #2909 - Check both SerDe BeanPropertyDefinition for @JsonUnwrapped/@Schema
• #2927 - Bail sealed class subtype introspection on Schema
• #2917 - Add Future to ignored response wrappers
• #2938 - Add out of the box support for LocalTime, YearMonth, MonthDay

Changed

• Upgrade swagger-ui to v5.20.1
• Upgrade swagger-core to 2.2.29
• Upgrade spring-cloud-function to 4.2.2
• Upgrade spring-boot to version 3.4.4

Fixed

• #2928 - Add missing builder methods in SchemaBuilder
• #2905 - ModelResolver.enumAsRef = true result in invalid openapi with actuator using enum param
• #2939 - Duplicate ModelConverter registration with Spring Boot DevTools
• #2941 - SpringBoot native fails /v3/api-docs when using a Map as an http entity field

New Contributors

• @berezkin88 made their first contribution in #2911

Full Changelog: v2.8.5...v2.8.6

Contributors

• @wingsofovnia
• @JohnNiang
• @berezkin88
• @Schema
• @sahil-ramagiri

What's Changed

• fix defaultValue when using @PageableDefault together with one-indexed-parameters by @pheyken in #2881
• Refactor trimIndent Method by @Ryan-Dia in #2891
• fix: respect @JsonUnwrapped & @Schema on props not fields only by @wingsofovnia in #2894
• Only filter out actuator endpoints with double asterisks. Fixes #2895 by @mc1arke in #2896
• add needed runtime reflection hints for native image by @lorenzbaier in #2898
• Do not require JsonSubType annotation for sealed classes by @sahil-ramagiri in #2696

Added

• #2696 - Do not require JsonSubType annotation for sealed classes
• #2898 - add needed runtime reflection hints for native image
• #2891 - Refactor trimIndent Method

Changed

• Upgrade swagger-ui to v5.18.3

Fixed

• #2902 - Schema replaced by String when using @apiresponse with RepresentationModel (Hateoas links)
• #2876 - Restentpoints with same name get mix up
• #2895 - Only filter out actuator endpoints with double asterisks.
• #2894 - respect @JsonUnwrapped & @Schema on props not fields only
• #2881 - fix defaultValue when using @PageableDefault together with one-indexed-parameters
• #2888 - Provide a better consistency for parameters and responses order.

New Contributors

• @pheyken made their first contribution in #2881
• @Ryan-Dia made their first contribution in #2891
• @wingsofovnia made their first contribution in #2894
• @lorenzbaier made their first contribution in #2898
• @sahil-ramagiri made their first contribution in #2696

Full Changelog: v2.8.4...v2.8.5

Contributors

• @mc1arke
• @wingsofovnia
• @Schema
• @sahil-ramagiri
• @pheyken
• @lorenzbaier
• @Ryan-Dia

What's Changed

• Align Swagger-UI Prefix Path with Swagger-WebMvc Behavior by @abdelmoez-guetat in #2862
• Improve performance of getGenericMapResponse by @ML-Marco in #2873
• Provide option to set allowed locales #2836 by @martin-tarjanyi in #2875

Added

• #2873 - Improve performance of getGenericMapResponse
• #2836 - Provide option to set allowed locales
• #2862 - Align Swagger-UI Prefix Path with Swagger-WebMvc Behavior. This ER, removes SpringDocUIConfiguration

Changed

• Upgrade spring-boot to 3.4.2
• Upgrade spring-cloud-function to 4.2.1
• Upgrade swagger-core to 2.2.28

Fixed

• #2870 - Springdoc 2.8.x + Spring Boot 3.4.1 breaks native image support
• #2869 - Exception logged when generating schema for delete method of Spring Data repository.
• #2856 - @JsonUnwrapped is ignored in new version of lib.
• #2852 - @Schema(types = "xxx") does not work for multipart param with enabled springdoc.default-support-form-data config option.

New Contributors

• @abdelmoez-guetat made their first contribution in #2862
• @ML-Marco made their first contribution in #2873
• @martin-tarjanyi made their first contribution in #2875

Full Changelog: v2.8.3...v2.8.4

Contributors

• @abdelmoez-guetat
• @martin-tarjanyi
• @Schema
• @ML-Marco