mirror of
https://github.com/valitydev/openapi-generator.git
synced 2024-11-06 18:45:23 +00:00
aa7cd4f5af
* [docs] Upgrade to Docusaurus 2 Due to formatting issues with Docusaurus 1 and code blocks, and upcoming 4.3 and 5.0 releases, this is an upgrade to have more control over formatting and other functionality. This adds behavior to have light/dark themes. As a consequence of upgrading, columnar format on ul element in generated generator docs had to be moved to css. This will not impact users viewing the markdown on GitHub because it didn't display the column format. This upgrade should improve syntax highlighting and performance. * Fix user page layout, choose theme with clear diff colors
41 lines
1.5 KiB
Markdown
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.
|