openapi-generatr-spring

a simple OpenAPI interface only code generator for Spring Boot.

Getting Started

See the documentation.

Sample

See openapi-generatr-spring-mvc-sample for a complete working sample of a minimal openapi.yaml.

Features & Bugs

In case some feature is missing or the generated code is not 100% what you would expect create an issue with test case. Providing a test case will help significantly :-)

A test case is a single folder with an openapi.yaml file and the expected Java files the generatr should create. The structure looks like this:

my-new-test-case/
                 openapi.yaml
                 mapping.yaml
                 generated/
                           api/
                              AnEndpointInterface.java
                              .. more api interfaces ..
                           model/
                                 AModelClass.java
                                 AnotherModelClass.java
                                 .. more model files ..

The mapping.yaml contains the type mapping information and is an optional file.

See the existing integration tests for a couple of examples.