| additionalModelTypeAnnotations | Additional annotations for model type(class level annotations) | | null |
| allowUnicodeIdentifiers | boolean, toggles whether unicode identifiers are allowed in names or not, default is false | | false |
| apiPackage | package for generated api classes | | org.openapitools.client.api |
| artifactDescription | artifact description in generated pom.xml | | OpenAPI Java |
| artifactId | artifactId in generated pom.xml. This also becomes part of the generated library's filename | | openapi-java-client |
| artifactUrl | artifact URL in generated pom.xml | | https://github.com/openapitools/openapi-generator |
| artifactVersion | artifact version in generated pom.xml. This also becomes part of the generated library's filename | | 1.0.0 |
| bigDecimalAsString | Treat BigDecimal values as Strings to avoid precision loss. | | false |
| booleanGetterPrefix | Set booleanGetterPrefix | | get |
| caseInsensitiveResponseHeaders | Make API response's headers case-insensitive. Available on okhttp-gson, jersey2 libraries | | false |
| dateLibrary | Option. Date library to use | - joda
- Joda (for legacy app only)
- legacy
- Legacy java.util.Date (if you really have a good reason not to use threetenbp
- java8-localdatetime
- Java 8 using LocalDateTime (for legacy app only)
- java8
- Java 8 native JSR310 (preferred for jdk 1.8+) - note: this also sets "java8" to true
- threetenbp
- Backport of JSR310 (preferred for jdk < 1.8)
| threetenbp |
| developerEmail | developer email in generated pom.xml | | team@openapitools.org |
| developerName | developer name in generated pom.xml | | OpenAPI-Generator Contributors |
| developerOrganization | developer organization in generated pom.xml | | OpenAPITools.org |
| developerOrganizationUrl | developer organization URL in generated pom.xml | | http://openapitools.org |
| disableHtmlEscaping | Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields) | | false |
| ensureUniqueParams | Whether to ensure parameter names are unique in an operation (rename parameters that are not). | | true |
| feignVersion | Version of OpenFeign: '10.x', '9.x' (default) | | false |
| fullJavaUtil | whether to use fully qualified name for classes under java.util. This option only works for Java API client | | false |
| groupId | groupId in generated pom.xml | | org.openapitools |
| hideGenerationTimestamp | Hides the generation timestamp when files are generated. | | false |
| invokerPackage | root package for generated code | | org.openapitools.client |
| java8 | Option. Use Java8 classes instead of third party equivalents | - true
- Use Java 8 classes such as Base64
- false
- Various third party libraries as needed
| false |
| library | library template (sub-template) to use | - jersey1
- HTTP client: Jersey client 1.19.x. JSON processing: Jackson 2.9.x. Enable Java6 support using '-DsupportJava6=true'. Enable gzip request encoding using '-DuseGzipFeature=true'. IMPORTANT NOTE: jersey 1.x is no longer actively maintained so please upgrade to 'jersey2' or other HTTP libaries instead.
- jersey2
- HTTP client: Jersey client 2.25.1. JSON processing: Jackson 2.9.x
- feign
- HTTP client: OpenFeign 9.x or 10.x. JSON processing: Jackson 2.9.x. To enable OpenFeign 10.x, set the 'feignVersion' option to '10.x'
- okhttp-gson
- [DEFAULT] HTTP client: OkHttp 3.x. JSON processing: Gson 2.8.x. Enable Parcelable models on Android using '-DparcelableModel=true'. Enable gzip request encoding using '-DuseGzipFeature=true'.
- retrofit
- HTTP client: OkHttp 2.x. JSON processing: Gson 2.x (Retrofit 1.9.0). IMPORTANT NOTE: retrofit1.x is no longer actively maintained so please upgrade to 'retrofit2' instead.
- retrofit2
- HTTP client: OkHttp 3.x. JSON processing: Gson 2.x (Retrofit 2.3.0). Enable the RxJava adapter using '-DuseRxJava[2]=true'. (RxJava 1.x or 2.x)
- resttemplate
- HTTP client: Spring RestTemplate 4.x. JSON processing: Jackson 2.9.x
- webclient
- HTTP client: Spring WebClient 5.x. JSON processing: Jackson 2.9.x
- resteasy
- HTTP client: Resteasy client 3.x. JSON processing: Jackson 2.9.x
- vertx
- HTTP client: VertX client 3.x. JSON processing: Jackson 2.9.x
- google-api-client
- HTTP client: Google API client 1.x. JSON processing: Jackson 2.9.x
- rest-assured
- HTTP client: rest-assured : 4.x. JSON processing: Gson 2.x or Jackson 2.9.x. Only for Java8
- native
- HTTP client: Java native HttpClient. JSON processing: Jackson 2.9.x. Only for Java11+
- microprofile
- HTTP client: Microprofile client X.x. JSON processing: Jackson 2.9.x
| okhttp-gson |
| licenseName | The name of the license | | Unlicense |
| licenseUrl | The URL of the license | | http://unlicense.org |
| modelPackage | package for generated models | | org.openapitools.client.model |
| parcelableModel | Whether to generate models for Android that implement Parcelable with the okhttp-gson library. | | false |
| parentArtifactId | parent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect | | null |
| parentGroupId | parent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect | | null |
| parentVersion | parent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect | | null |
| performBeanValidation | Perform BeanValidation | | false |
| playVersion | Version of Play! Framework (possible values "play24", "play25" (default), "play26") | | null |
| prependFormOrBodyParameters | Add form or body parameters to the beginning of the parameter list. | | false |
| scmConnection | SCM connection in generated pom.xml | | scm:git:git@github.com:openapitools/openapi-generator.git |
| scmDeveloperConnection | SCM developer connection in generated pom.xml | | scm:git:git@github.com:openapitools/openapi-generator.git |
| scmUrl | SCM URL in generated pom.xml | | https://github.com/openapitools/openapi-generator |
| serializableModel | boolean - toggle "implements Serializable" for generated models | | false |
| serializationLibrary | Serialization library, default depends from the library | - jackson
- Use Jackson as serialization library
- gson
- Use Gson as serialization library
| null |
| snapshotVersion | Uses a SNAPSHOT version. | - true
- Use a SnapShot Version
- false
- Use a Release Version
| null |
| sortModelPropertiesByRequiredFlag | Sort model properties to place required parameters before optional parameters. | | true |
| sortParamsByRequiredFlag | Sort method arguments to place required parameters before optional parameters. | | true |
| sourceFolder | source folder for generated code | | src/main/java |
| supportJava6 | Whether to support Java6 with the Jersey1 library. | | false |
| useBeanValidation | Use BeanValidation API annotations | | false |
| useGzipFeature | Send gzip-encoded requests | | false |
| usePlayWS | Use Play! Async HTTP client (Play WS API) | | false |
| useReflectionEqualsHashCode | Use org.apache.commons.lang3.builder for equals and hashCode in the models. WARNING: This will fail under a security manager, unless the appropriate permissions are set up correctly and also there's potential performance impact. | | false |
| useRuntimeException | Use RuntimeException instead of Exception | | false |
| useRxJava | Whether to use the RxJava adapter with the retrofit2 library. | | false |
| useRxJava2 | Whether to use the RxJava2 adapter with the retrofit2 library. | | false |
| withXml | whether to include support for application/xml content type and include XML annotations in the model (works with libraries that provide support for JSON and XML) | | false |
