openapi-first

# OpenAPI-First Development ## Maven Plugin Setup ```xml <plugin> <groupId>org.openapitools</groupId> <artifactId>openapi-generator-maven-plugin</artifactId> <version>7.5.0</version> <executions> <execution> <goals><goal>generate</goal></goals> <configuration> <inputSpec>${project.basedir}/src/main/resources/openapi.yaml</inputSpec> <generatorName>spring</generatorName> <apiPackage>com.example.api</apiPackage> <modelPackage>com.example.api.model</modelPackage> <configOptions> <delegatePattern>true</delegatePattern> <!-- implement delegate, not controller --> <interfaceOnly>false</interfaceOnly> <useSpringBoot3>true</useSpringBoot3> <!-- still the OpenAPI Generator Jakarta/Spring 6+ switch --> <useTags>true</useTags> <dateLibrary>java8</dateLibrary> <serializationLibrary>jackson</serializationLibrary> <openApiNullable>false</openApiNullable> <skipDefaultInterface>true</skipDefaultInterface> </configOptions> <generateSupportingFiles>true</generateSupportingFiles> <output>${project.build.directory}/generated-sources/openapi</output> </configuration> </execution> </executions> </plugin> ``` ## OpenAPI Spec Example ```...