openapi-maven-plugin

🚀 New features and improvements

• Tags and contained operations with the same path are now deterministically ordered. #99 & #100 (Thanks to @magx2)
• Allow free fields merging between common and specific api configuration. #107 (Thanks to @royteeuwen)
• Model substitution configuration #98
• Handle default values in "required" for Spring MVC parameters #115
• Add support for Jackson @JsonProperty #116 (Thanks to @hugop95)
• Optional configuration #106
• Configuration nullable/non nullable annotations and default value for dto fields #78 (Thanks to @josve )
• Integration tests on jdk21

🐞 Bug Fixes

• Sealed classes parsing #105 (reported by @FlorentSimonnot)
• @author parsing issue in records #110 (reported by @Hakkerchief)

📄 Documentation updates

• Add "mergeFreeFields" value
• Add "defaultNonNullableFields" value
• Add "nonNullableAnnotation" value
• Add "nullableAnnotation" value
• Add "openapiModels" value
• Add "modelsAssociations" value

• Fix issue #89
• Add a "pathPrefix" configuration (see documentation)
• Add a "defaultErrors" configuration (see documentation)
• Allow to set the "freeFields" configuration with a file (see documentation)

• bugfix class was not scanned under some circumstances. The scan now use the Plexus Classloader.

• Records' javadoc parsing
• JaxRS / JakartaRS Response object can be annoted with a custom annotation in order to define the return type
• Better genericity support, especially on controller classes
• JaxRS / JakartaRS parameters annotated with @BeanParam are excluded from the documentation
• SpringMVC ModelAndView responses excludes the endpoint from being documented
• Bugfix on java file syntax parsing (JavaParser library upgrade)
• Date java object is correctly supported

• Bugfix "Collection" class not handled properly
• Add the possibility to add to the schema section java classes not directly referenced by an endpoint (see "extraSchemaClasses" configuration)
• Change the class / method separator from the white/black list from "__" to "#" to respect java convention