FAQ has been split into multiple smaller documents to better categorize and allow users to find what they're looking for (in docs folder or in new website). Release summary information (versioning strategy and cadence) has been migrated from the Wiki and clarified a bit. Also adds copy button for all code snippets in website.
1.5 KiB
How do I use my own Java models?
How do I disable certificate verification?
Please add -Dio.swagger.v3.parser.util.RemoteUrl.trustAll=true
when generating the code.
How do I skip files during code generation?
OpenAPI Generator has a built-in ignore file processor.
For example, to skip git_push.sh
, one can create a file named .openapi-generator-ignore
in the root of the output directory with the contents:
# Prevent generator from creating these files:
git_push.sh
The ignore file works just like .gitignore, and it is auto-generated by default.
If you need this functionality on initial generation, you can provide the option --ignore-file-override
(CLI) or ignoreFileOverride
(Maven and Gradle plugins) with a value targeting any existing file. The contents of that file will be evaluated relative to the output directory.
How can I customize the auto-generated code?
Variants:
- "How can I add a header/footer to generated code?"
- "How can I add my own logging to generated code?"
- "How can I add my license to the top of files?"
OpenAPI Generator supports user-defined templates without need to recompile the artifact. We also support custom generators (templates and logic) if those generators are accessible on the classpath.
See templating: Modifying Templates and customization docs for more details.