PrimeCodeGen - A custom openapi code generator
The Generator
The official generator is not very flexible (e.g. it is not possible to generate a file for each api operation).
This custom generator introduces the following features:
- a different template engine (pebble), which is easier to read/maintain than mustache
- typed templates with ide-plugin for code-completion
- a very flexible template registration system
Example:
cfg.templateSpecs.add(PrimeTemplateSpec(
description = "api interface for reactor",
sourceTemplate = "api_main.peb",
targetDirectory = apiFolder,
targetFileName = "{mainClassName}ReactorApi.java",
scope = TemplateScope.API,
iterator = PrimeIterator.EACH_API,
transform = { data ->
data.mainClassName = "${data.mainClassName}Reactor"
}
))
description = "api interface for reactor",
sourceTemplate = "api_main.peb",
targetDirectory = apiFolder,
targetFileName = "{mainClassName}ReactorApi.java",
scope = TemplateScope.API,
iterator = PrimeIterator.EACH_API,
transform = { data ->
data.mainClassName = "${data.mainClassName}Reactor"
}
))
- iterator:
ONCE_API,EACH_API,EACH_API_OPERATION,ONCE_MODEL,EACH_MODEL,ONCE_PROJECT - filter: dynamic filter to decide if the template should be executed (e.g. only for api operations with parameters)
- transform: dynamically transform data before the template is executed
Usage
TODO: add docker image / jar download link for cli usage
java -jar openapi-generator.jar generate -e auto -i openapi.yaml -o /my-project -c /my-project/openapi-generator.json
Limitations
- this generator MUST be used from the CLI, it is not compatible with the gradle or maven plugins
License
Released under the MIT License.