v1.7.0

Added

• #​2152 - Detect directions in default sort values
• #​2167 #​2166 - Add request parameter for token endpoint
• #​2188 - Support of {*param} path patterns

Changed

• Upgrade spring-boot to 2.7.10
• Upgrade swagger-core to 2.2.9
• Upgrade swagger-ui to 4.18.2
• Spring Native is now superseded by Spring Boot 3 official
• #​2173 - Remove webjars-locator-core

Fixed

• #​2122 - Super tiny fix typo
• #​2131 - Fixed a bug that javadoc of record class parameters was not recognized.
• #​2140 - Javadoc record class parameters not recognized
• #​2123 #​2141 - fix spring authorization server response.
• #​2148 - Fix properties show-oauth2-endpoints and SpringDocConfigProperties#showOauth2Endpoint properties name mismatch
• #​2149 - Request parameters with default values are marked as required.
• #​2155 - openApi.getServers() is null in OpenApiCustomiser when using different locales.
• #​2152 - Redundant(wrong) direction appended to @​PageableDefault.
• #​2181 #​2183 - Fixed DefaultFlatParamObject to work with annotated parameters.
• #​2170 #​2187 - All request parameters marked as required for Java controllers in mixed projects in 2.0.3
• #​2165 - Custom Converters are not excluded if not registered for Http Message Converter.
• #​2185 - Fix behaviour of required flag for schema class fields.

v1.6.15

Compare Source

Added

• #​2006 - Support for nullable request parameters in Kotlin.
• #​2054 - Add copyright and license information to Jar.
• #​2021 - Required field in Schema annotation ignored in Kotlin.
• #​2094 - Initial support for Spring Authorization Server.

Changed

• Upgrade spring-boot to 2.7.9
• Upgrade swagger-core to 2.2.8
• Upgrade swagger-ui to 4.17.1

Fixed

• #​2010 - findByNameContainingIgnoreCaseAndDateBefore throw NullPointerException.
• #​2031 - Path variables parameters are not assigned correctly to endpoints.
• #​2038 - When extends JpaRepository, using @​Parameter over the method results in duplicate of the same parameter.
• #​2046 - Map Fields Disappear with Groovy on Classpath.
• #​2051 - Malformed api-docs JSON when StringHttpMessageConverter is not active
• #​2062 - OperationCustomizer is not working with Spring Data REST.
• #​2098 - When getting ExceptionHandler in the controller, use target class in case of AOP Proxy.
• #​2107 - Ordering of GlobalOpenApiCustomizers different than for OpenApiCustomisers.
• #​2089 - Fixed a bug that a NullPointerException is thrown when the description field of RequestBody is null and there is a javadoc description.
• #​2104 - OpenAPI Extensions no longer work.

v1.6.14

Added

• #​1965 - Prevents premature initialisation of factory-beans
• #​2003 - Resolve property descriptions for arrays

Changed

• Upgrade spring-boot to 2.7.6

Fixed

• #​1957 - AdditionalModelsConverter Schema params rewriting
• #​1962 - override-with-generic-response shouldn't shallow copy
• #​1985 - IllegalStateException: Duplicate key when two endpoints at the same URL with same header exist
• #​1992 - Java enumeration and Spring Converter no longer generates enum drop-down.
• #​2001 - Enum Collection parameter missing type info in Spring Data Rest search method

v1.6.13

Compare Source

Added

• #​1929 - Enables no cache on not cache swagger-initializer.js
• #​1922 - Check existence of superclass before accessing its name
• #​1923 - Javadoc description of the @​RequestPart param of multipart/form-data to the parameter description

Changed

• Upgrade spring-boot to 2.7.5
• Upgrade swagger-core to 2.2.7
• Upgrade swagger-ui to 4.15.5
• #​1912 - Upgrade spring-security-oauth2 to 2.5.2.RELEASE

Fixed

• #​1892 - springdoc.model-and-view-allowed enhanced
• #​1901 - When @​Get, using @​Parameter over the method results in duplicate of the same parameter
• #​1909 - ExceptionHandler in controller is not used by another controller
• #​1904 - springdoc-openapi-webflux-ui 2.0.0-M7 + spring actuator + spring cloud crashes at startup
• #​1911 - Wrong type for springdoc.swagger-ui.oauth.useBasicAuthenticationWithAccessCodeGrant configuration property
• #​1931 - Spring Security form login only offers application/json req body type.

v1.6.12

Compare Source

Added

• #​1888 - custom Summary for actuator
• #​1881 - Support @​Hidden annotation on REST repositories
• #​1878 - Sort request methods
• #​1830 - Support Java record
• #​1814 - Allow requestBody creation for GET on openapi resource endpoint

Changed

• Upgrade swagger-core to 2.2.4
• Upgrade spring-boot to 2.7.4
• Upgrade swagger-ui to 4.14.3

Fixed

• #​1829 - Wrong schema generation on endpoint consuming multipart form data combined with
  JsonView
• #​1842 - A HTTP header in multipart/form-data is handled as form item instead of header
• #​1845 - Wrong "response" description with two controllers having its own
  ExceptionHandler.
• #​1855 - Fixed a bug that duplicate field were get for record classes.
• #​1820 - Refresh the browser each time, the global header is added in duplicate.
• #​523 - No documented way to handle Mono/Flux without Webflux.
• #​1816 - Parameters with same name but different locations can't render in UI properly

v1.6.11

Compare Source

Added

• #​1805 - Default flat param object

Changed

• upgrade swagger-ui: 4.14.0

Fixed

• #​1801 - Duplicated header values when an endpoint can be called with different headers
• #​1801 - NPE for request bodies with content that has media type
  MULTIPART_FORM_DATA_VALUE
• #​1793 - Query parameter part of request body in controller with MultiPartFile
• #​1791 - Override-with-generic-response not working from 1.6.8 onwards
• #​1799 - Polymorphism - Support JsonTypeInfo.Id.CLASS

v1.6.10

Compare Source

Added

• #​1700 - Support PageableDefault#value()
• #​1706 - ßAdd RouterOperationCustomizer
• #​1754 - Default value and description of the page parameter when enabled
  spring.data.web.pageable.one-indexed-parameters property
• #​1755 - Adjust name of the parameters page and size when set
  spring.data.web.pageable.prefix property
• #​1742 - Optimize the group order problem

Changed

• upgrade to spring-boot 2.7.2
• upgrade swagger-ui: 4.13.2
• upgrade classgraph: 4.8.149
• upgrade spring-native: 0.12.1
• upgrqde swagger-core: 2.2.2
• upgrage therapi-runtime-javadoc: 0.15.0

Fixed

• #​1684 - incorrect generic param for multi interfaces
• #​1687, #​1688 - kotlin ByteArray property incorrect
• #​1692 - More specific bean name for objectMapperProvider
• #​1684 - Incorrect generic param for multi interfaces
• #​1707 - Concurrent problems when initializing multiple GroupedOpenApi parallelly
• #​1690 - Expected file to be in alphabetical order.
• #​1713 - ObjectMapperProvider to sort all properties.
• #​1717, #​1718 - javadoc of JsonUnwrapped fields not set
• #​1748, #​1712, Generated server url computation not cleared
• #​1696 - incorrect generic param for multi interfaces
• #​1749 - Update server out of cache
• #​1734 - springdoc-openapi-kotlin and springdoc-openapi-common do not agree on conditions
  for auto configuration
• #​1761- Exception documenting RestControllerEndpoint with PostMapping

v1.6.9

Compare Source

Added

• #​1664 - Add Schema properties support in method-level @​RequestBody
• #​1181 - Initial OpenAPI 3.1 support
• #​1651 - Ease group declaration through code or properties with actuators

Changed

• upgrade to spring-boot 2.7.0
• upgrade swagger-ui: 4.11.1
• upgrade classgraph: 4.8.147
• upgrade spring-native: 0.11.5
• upgrade spring-cloud-function: 3.2.4

Fixed

• #​1663 - @​Schema annotation with type String and allowableValues set doesn't generate
  enum drop-down in swagger-ui after upgrading from 1.6.6 (when Spring custom converter is
  used)
• #​1655 - OpenAPIService is using ObjectMapper without configured modules since SpringDoc
  1.6.7.
• #​1648 - Tags with only name provided are being added to the openAPI.tags field.
• #​1641 - ConcurrentModificationException when querying /v3/api-docs/{group} concurrently
  for different groups
• #​1634 - Generating doc for entities with map attribute does not work
• #​1633 - GroupedOpenApi.builder addOpenApiCustomiser execution order is reversed
• #​1630 - Remove repeated HttpSession
• #​1659 - fix oauth redirection when used in spring-native

v1.6.8

Added

• #​1616 - Add global customizer and filters
• #​1620 - Allow ComposedSchemas to replace non-composed so we can respect polymorphic
  links discovered in later methods
• #​1579 - Updated class and method javadoc handling

Changed

• upgrade to spring-boot 2.6.7
• #​1603 - Update swagger-ui path from /swaggerui to /swagger-ui when using management
  port (actuator) .
• Prefer ComposedSchemas over non-composed so that method name order doesn't prevent
  polymorphic links generating into the spec

Fixed

• #​1621 - Redirection to UI broken with query-config-enabled when any other boolean
  parameter is defined.
• #​1617 - spring cloud stream crashes at startup.
• #​1605 - spring-native NullPointerException due to missing TypeHint

v1.6.7

Added

• #​1596 - Add title property to GroupedOpenApi class for displaying a Human readable group
  name.
• #​1554 - Configurable caching of OpenAPI instances.
• #​1544 - @​Deprecated on controller to mark all its operations as deprecated.
• #​1534 - Support custom Spring type converters.
• #​1543 - Add method to retrieve server base URL and ability to 'customize' the generated
  server base URL.
• #​1505 - Support swagger-ui.withCredentials property.
• #​1481 - Include /oauth/token endpoint using OpenApi Swagger 1.6.5.
• #​1501 - Added CSRF Session Storage config properties and html transformer.
• #​1498 - Pick up exception handler in case there is no controller advice at all.

Changed

• upgrade to swagger-api 2.2.0 and swagger-ui 4.10.3
• spring-native upgrade to 0.11.4
• upgrade spring-boot version to 2.6.6
• classgraph upgrade to 4.8.143
• Update webjars-locator-core to 0.50
• add owasp dependency-check-maven plugin

Fixed

• #​1586 - Typo in Pageable sort description.
• #​1570 - Remove unused dependencies.
• #​1565- Missing Request Body for Write Operation Actuator Endpoints.
• #​1522 - parameter of type com.querydsl.core.types.Predicate ignored when unique.
• #​1556 - oauth2RedirectUrl cached unexpectedly.
• #​1546 - Custom Requestmapping consumes responses.
• #​1552 - resolve-schema-properties is not replacing tokens from properties file.
• #​1530 - Setting displayOperationId to false does not work.
• #​1525 - Null vendor extensions are excluded from Json/Yaml.

v1.6.6

Changed

• #​1424 - Upgrade to swagger-ui 4.5.0
• #​1474 - Upgrade webjars-locator-core version to 0.48

Fixed

• #​1469 - #​1036 - CSRF header should not be sent to cross domain sites
• #​1480 - Fix the problem that the inconsistent newline characters of different platforms
• #​1475 - Class level @​Tag overwrites method level @​Operation.tags.
• #​1491 - Set containingClass at MethodParameter

v1.6.5

Added

• #​1430 - Add Support custom login processing endpoints
• #​1429 - Allow excluding individual methods from OpenApi output
• #​1372 - Customize operation and parameters by the return value
• #​1453 - Reverse proxy context path aware support for manually provided files

Changed

• #​1424 - Upgrade to swagger-ui 4.2.1

Fixed

• #​1428 - Incorrect RequestBody type on schema/ui if class implements Map.
• #​1455 - Post without @​RequestBody not getting all fields
• #​1442 - Springdoc-openapi-webmvc-core not enought for Springdoc-openapi-native
• #​1446 - Upgrade from Springdoc 1.6.3 to 1.6.4 causes issues if springdoc-openapi-common
  is on the classpath but springdoc-openapi-ui is not
• #​1458 - java.lang.NoSuchMethodError:
  org.springframework.core.MethodParameter.getParameter() at /v3/api-docs request

v1.6.4

Added

• Add support out of the box for MultipartRequest
• #​1418 - Support for therapi-runtime-javadoc 0.13.0.

Changed

• #​1415 - Moving PageableDefault support to springdoc-openapi-common
• #​1424 - Update classgraph dependency to 4.8.138

Fixed

• #​1407 - Fix issue number in 1.6.3 CHANGELOG
• #​1421 - Actuator endpoints have 2 appended to operationId
• #​1425 - Parameter 2 of method indexPageTransformer in
  org.springdoc.webmvc.ui.SwaggerConfig required a single bean, but 2 were found

v1.6.3

Added

• #​1299 - Add support for Spring Cloud Function Web.

Changed

• Upgrade to swagger-core 2.1.12
• Upgrade to spring-boot 2.6.2
• Upgrade spring-native to 0.11.1
• bump classgraph version to 4.8.117

Fixed

• #​1405 - Enhance springdoc-openapi as BOM for Gradle

v1.6.2

Added

• #​1386, #​1385 - Disable validation by default
• #​1384 - Enhance swagger-ui access

Fixed

• #​1392 - Consistent OperationId generation problem with Locale
• #​1394 - Getting 404 when trying to access swagger-ui of a native spring-boot app