OpenAPI Generator

OpenAPI Generator

  • Get Started
  • Generators
  • Roadmap
  • Team
  • FAQ
  • Blog

generators/java


id: generator-opts-client-java title: Config Options for java sidebar_label: java


OptionDescriptionValuesDefault
sortParamsByRequiredFlagSort method arguments to place required parameters before optional parameters.true
ensureUniqueParamsWhether to ensure parameter names are unique in an operation (rename parameters that are not).true
allowUnicodeIdentifiersboolean, toggles whether unicode identifiers are allowed in names or not, default is falsefalse
prependFormOrBodyParametersAdd form or body parameters to the beginning of the parameter list.false
modelPackagepackage for generated modelsnull
apiPackagepackage for generated api classesnull
invokerPackageroot package for generated codenull
groupIdgroupId in generated pom.xmlnull
artifactIdartifactId in generated pom.xmlnull
artifactVersionartifact version in generated pom.xmlnull
artifactUrlartifact URL in generated pom.xmlnull
artifactDescriptionartifact description in generated pom.xmlnull
scmConnectionSCM connection in generated pom.xmlnull
scmDeveloperConnectionSCM developer connection in generated pom.xmlnull
scmUrlSCM URL in generated pom.xmlnull
developerNamedeveloper name in generated pom.xmlnull
developerEmaildeveloper email in generated pom.xmlnull
developerOrganizationdeveloper organization in generated pom.xmlnull
developerOrganizationUrldeveloper organization URL in generated pom.xmlnull
licenseNameThe name of the licensenull
licenseUrlThe URL of the licensenull
sourceFoldersource folder for generated codenull
localVariablePrefixprefix for generated code members and local variablesnull
serializableModelboolean - toggle "implements Serializable" for generated modelsfalse
bigDecimalAsStringTreat BigDecimal values as Strings to avoid precision loss.false
fullJavaUtilwhether to use fully qualified name for classes under java.util. This option only works for Java API clientfalse
hideGenerationTimestamphides the timestamp when files were generatednull
withXmlwhether 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
dateLibraryOption. 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)
null
java8Option. Use Java8 classes instead of third party equivalents
true
Use Java 8 classes such as Base64
false
Various third party libraries as needed
null
disableHtmlEscapingDisable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)false
booleanGetterPrefixSet booleanGetterPrefix (default value 'get')null
parentGroupIdparent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effectnull
parentArtifactIdparent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effectnull
parentVersionparent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effectnull
useRxJavaWhether to use the RxJava adapter with the retrofit2 library.false
useRxJava2Whether to use the RxJava2 adapter with the retrofit2 library.false
parcelableModelWhether to generate models for Android that implement Parcelable with the okhttp-gson library.false
usePlayWSUse Play! Async HTTP client (Play WS API)false
playVersionVersion of Play! Framework (possible values "play24", "play25" (default), "play26")null
supportJava6Whether to support Java6 with the Jersey1 library.false
useBeanValidationUse BeanValidation API annotationsfalse
performBeanValidationPerform BeanValidationfalse
useGzipFeatureSend gzip-encoded requestsfalse
useRuntimeExceptionUse RuntimeException instead of Exceptionfalse
feignVersionVersion of OpenFeign: '10.x', '9.x' (default)false
useReflectionEqualsHashCodeUse 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
librarylibrary template (sub-template) to use
jersey1
HTTP client: Jersey client 1.19.4. JSON processing: Jackson 2.8.9. Enable Java6 support using '-DsupportJava6=true'. Enable gzip request encoding using '-DuseGzipFeature=true'.
feign
HTTP client: OpenFeign 9.4.0. JSON processing: Jackson 2.8.9. To enable OpenFeign 10.x, set the 'feignVersion' option to '10.x'
jersey2
HTTP client: Jersey client 2.25.1. JSON processing: Jackson 2.8.9
okhttp-gson
HTTP client: OkHttp 2.7.5. JSON processing: Gson 2.8.1. Enable Parcelable models on Android using '-DparcelableModel=true'. Enable gzip request encoding using '-DuseGzipFeature=true'.
retrofit
HTTP client: OkHttp 2.7.5. JSON processing: Gson 2.3.1 (Retrofit 1.9.0). IMPORTANT NOTE: retrofit1.x is no longer actively maintained so please upgrade to 'retrofit2' instead.
retrofit2
HTTP client: OkHttp 3.8.0. JSON processing: Gson 2.6.1 (Retrofit 2.3.0). Enable the RxJava adapter using '-DuseRxJava[2]=true'. (RxJava 1.x or 2.x)
resttemplate
HTTP client: Spring RestTemplate 4.3.9-RELEASE. JSON processing: Jackson 2.8.9
webclient
HTTP client: Spring WebClient 5.0.7-RELEASE. JSON processing: Jackson 2.9.5
resteasy
HTTP client: Resteasy client 3.1.3.Final. JSON processing: Jackson 2.8.9
vertx
HTTP client: VertX client 3.2.4. JSON processing: Jackson 2.8.9
google-api-client
HTTP client: Google API client 1.23.0. JSON processing: Jackson 2.8.9
rest-assured
HTTP client: rest-assured : 3.1.0. JSON processing: Gson 2.6.1. Only for Java8
okhttp-gson
Last updated on 2019-1-18
OpenAPI Generator
Docs
Customizing GeneratorsWorkflow Integrations
Community
User ShowcaseStack OverflowProject ChatTwitter
More
BlogGitHub RepoStar
Facebook Open SourceFontawesome (Free)
Copyright © 2019 OpenAPI-Generator Contributors (https://openapi-generator.tech)