How to generate the source code from OpenAPI spec?

[sgoeschl]

Hi,

just came across your project and really like it :-)

I would like to extend the functionality with some performance-testing related stuff such as simulating a blocking GC pause but I wonder how you generate the code? Is that done manually or somewhere in the code (guess gen.sh?!)

If so this very much Linux specific and could be done also in the Maven build - which I could contribute ...

Thanks in advance,

Siegfried

[sgoeschl]

Ahh, I see that it is not so easy since the generated source is modified to allow dependency injection

[dyrnq]

use openapi-generator generate the source code from OpenAPI spec

yes gen.sh dyrnq/springboot-httpbin/blob/main/gen.sh

welcome contribute :)

[sgoeschl]

Basically I need a vehicle to show the effect of coordinated omission for performance testing :-)

Here are my changes: sgoeschl#1 - not sure if there is anything interesting for you :)

• Added a "GET /performance/gc-pause" method to simulate coordinated omission (only in springboot-httpbin)
• Updated the OpenAPI spec to make Swagger Editor happy again
• Extracted a "openapi-generate.sh" to help with OpenAPI code generation

[sgoeschl]

Usually I do the code generation as part of the Maven build - with some tweaking it is possible to separate generated and manually written code - see https://github.com/sgoeschl/presentations/blob/master/javameetup/openapi/slides/openapi.md#openapi-generator-maven-plugin-1 for more detail

And I remembered that I also created a sample project - https://github.com/sgoeschl/presentations/blob/master/javameetup/openapi/sample/pom.xml

[dyrnq]

Basically I need a vehicle to show the effect of coordinated omission for performance testing :-)

Here are my changes: sgoeschl#1 - not sure if there is anything interesting for you :)

• Added a "GET /performance/gc-pause" method to simulate coordinated omission (only in springboot-httpbin)
• Updated the OpenAPI spec to make Swagger Editor happy again
• Extracted a "openapi-generate.sh" to help with OpenAPI code generation

that easy impl by annotation,no need openapi-generator-cli.

why i use openapi-generator-cli, because this project bootstrap from https://httpbin.dmuth.org/openapi.json, that is scheme first process.

then update the code and coding with openapi annotation that is code first process. then get out of control of openapi-generator-cli.

e.g.

https://github.com/dyrnq/springboot-httpbin/blob/main/springboot-httpbin/src/main/java/com/dyrnq/httpbin/controller/ResponseFormatsApiController.java#L83 /zstd is using annotations are directly, that is not come from https://httpbin.dmuth.org/openapi.json.

that is

• 1. bootstrap openapi.json(or yaml) to code, schema first.
• 2. coding using annotations, code(annotations) first.

Of course, it is a good habit to keep using schema first. :)

[dyrnq]

Usually I do the code generation as part of the Maven build - with some tweaking it is possible to separate generated and manually written code - see https://github.com/sgoeschl/presentations/blob/master/javameetup/openapi/slides/openapi.md#openapi-generator-maven-plugin-1 for more detail

And I remembered that I also created a sample project - https://github.com/sgoeschl/presentations/blob/master/javameetup/openapi/sample/pom.xml

openapitools/openapi-generator-cli and openapi-generator-maven-plugin are all come from openapitools.