openapi-generator/docs/faq-extending.md
Jim Schubert 3ed68a0515 [docs] Migrate FAQ, release summary from wiki
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.
2019-01-06 22:45:32 -05:00

41 lines
1.5 KiB
Markdown

---
id: faq-extending
title: FAQ: Extending
---
## How do I use my own Java models?
See [Bringing your own Models](./customization.md#bringing-your-own-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](./templating.md#modifying-templates) and [customization](./customization.md) docs for more details.