java-spring

Generating server code with (Java) spring

This example showcases the usage of OpenAPI generator spring in a Spring Boot / Java / Maven application.

Generation is based on an OpenAPI spec file.

Current state

• simple model
• simple path
• complex model
• enums
• inheritence
• complex paths
• header
• references
• security

How-to run

mvn spring-boot:run

How-to test

• use the REST-API with some example requests
• run all tests:

mvn test

API documentation

• Generate the API documentation with Redocly CLI:

mvn clean verify -DskipTests -PdocGen

• Run the application and access the API documentation

Run as Docker container

mvn spring-boot:build-image
docker run --rm --name sp-java-spring -p 7003:7003 todofixme/shelf-patrol-java-spring