Openapi generator for JeKa

Openapi plugin for JeKa acts as a thin wrapper around openapi-generator-cli.

It handles on-the-fly installation for you, so you only have to specify which version you want to use.

This plugin offers several out-of-the-box commands to invoke openapi-generator-cli conveniently. To see list of provided commands and options, execute :

jeka @dev.jeka:openapi-plugin:0.10.38.0 openapi#help

Furthermore, this plugin offers convenient methods to link source code generation with any project KBean.

The generation match strictly the openapi-generator-cli syntax, so you can refer to the official documentation to generate sources for any target technology without limitations.

Using local.properties

You can append openapi source generator to your working project, just declaring properties in your local.properties file, following the below example.

# Import this plugin into JeKa classpath
jeka.classpath.inject=@dev.jeka:openapi-plugin:0.10.38.0
jeka.default.kbean=project

# Specify the version of openapi-generator-cli to set
openapi#cliVersion=7.0.1

# Append a source generator, called 'myServer', to the project based on the following command line.
# The sources will be generated automatically prior compilation
# Any property formatted as openapi.gen.xxx will be taken in account
openapi.gen.myServer=generate -g spring \
  --model-name-prefix Rest \
  -i https://petstore.swagger.io/v2/swagger.json \
  --additional-properties=useBeanValidation=true,useSwaggerUI=false,interfaceOnly=true

# Append a second source generator
openapi.gen.myClient=generate -g client \
  --model-name-prefix Rest \
  -i https://my.spec.server/an-api.json

See project example here.

Using programmatic method

Alternatively, you can leverage of the fluent api to link your built project with an openapi source code generator, as demonstrated below.

import dev.jeka.core.tool.JkInjectClasspath;

@JkInjectClasspath("dev.jeka:openapi-plugin:0.10.38.1")
public class SampleBuild_Programmatic extends JkBean {

    private static final String SPEC_URL = "https://petstore.swagger.io/v2/swagger.json";

    private static final String OPENAPI_CLI_VERSION = "7.0.1";

    private JkProject project() {
        JkProject project = JkProject.of();
        //...
        JkOpenApi.ofVersion(OPENAPI_CLI_VERSION).addSourceGenerator(project, "spring", SPEC_URL)
                .customize(cmdBuilder -> cmdBuilder
                        .addApiAndModelPackage("com.mycompany")
                        .add(JkOpenapiCmdBuilder.MODEL_NAME_PREFIX, "Rest")
                        .addAdditionalProperties("useSpringBoot3", "true")
                        .add("--language-specific-primitives=Pet")
                        .addImportMapping("Pet", "com.yourpackage.models.Pet")
                        .addImportMapping("DateTime", "java.time.LocalDateTime")
                        .addTypeMapping("DateTime", "java.time.LocalDateTime")
                );
        return project;
    }

    public void genCode() {
        project().compilation.generateSources();
    }
    ...
}

See project example here.

Developers

How to release ?

Just use the github release mechanism. Creating a release implies creating a tag, that will trigger a build and a publication on Maven Central.