Create short Helidon guide describing how to use OpenAPITools generator for Helidon

[tjquinno]

Environment Details

• Helidon Version: 2.x, 3.x
• Helidon SE or Helidon MP MP
• JDK version:
• OS:
• Docker version (if applicable):

---

Problem Description

Today, users can use the OpenAPITools generator to create Helidon MP server code and MicroProfile REST client code.
We have no documentation on the Helidon site explaining how to do this.

This issue represents creating a short guide which summarizes the support in the tool for Helidon and gives detailed instructions and examples (command line, the tool's maven plug-in, etc.) for using the tool to generated or update Helidon-friendly code.

[barchetta]

This should include an example.

[tjquinno]

What sort of example are you thinking about?

I was thinking that the guide would show:

• using the generator command line to create a new Maven project and/or regenerate code into an existing project
• using the generator's Maven plug-in in the project pom.xml to generate/regenerate code

The guide would show how to extend generated classes or implement generated interfaces to provide the business logic and how regenerating code preserves those.

Were you thinking of adding a separate example generated project as a whole in the Helidon examples area?

I can see that this would be helpful for users. For simplicity I think we'll want the example pom.xml to invoke the Maven plug-in for the tool to generate code (rather than using the tool's command line to create the project). I don't think we want to get into having our build generate the code and then check the generated code into our repo.

That means that one contrast between this example and our other ones would be that this one's code in our repo will not be complete in the sense that the generated code won't be there. Of course, once a user builds the project and triggers the plug-in, the project becomes complete.

[barchetta]

That sounds good. I was thinking it could follow the pattern that Keith uses in one of his projects. He has a project with spec, client and server modules. Maven plugin is used to generate client and server code (use base interface for generated code with business logic in implementing class). You can run the client code to communicate with the server.

[barchetta]

Covered by new Epic for Helidon Specific generator. Closing.