forked from loafle/openapi-generator-original
63 lines
13 KiB
HTML
63 lines
13 KiB
HTML
<!DOCTYPE html><html lang="en"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>generators/java · OpenAPI Generator</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="<hr>
|
|
"/><meta name="docsearch:language" content="en"/><meta property="og:title" content="generators/java · OpenAPI Generator"/><meta property="og:type" content="website"/><meta property="og:url" content="https://OpenAPITools.github.io/openapi-generator/index.html"/><meta property="og:description" content="<hr>
|
|
"/><meta property="og:image" content="https://OpenAPITools.github.io/openapi-generator/img/docusaurus.png"/><meta name="twitter:card" content="summary"/><meta name="twitter:image" content="https://OpenAPITools.github.io/openapi-generator/img/icons/twitter.svg"/><link rel="shortcut icon" href="/openapi-generator/img/favicon.png"/><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/default.min.css"/><link rel="alternate" type="application/atom+xml" href="https://OpenAPITools.github.io/openapi-generator/blog/atom.xml" title="OpenAPI Generator Blog ATOM Feed"/><link rel="alternate" type="application/rss+xml" href="https://OpenAPITools.github.io/openapi-generator/blog/feed.xml" title="OpenAPI Generator Blog RSS Feed"/><script type="text/javascript" src="https://buttons.github.io/buttons.js"></script><script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.0/clipboard.min.js"></script><script type="text/javascript" src="/openapi-generator/js/code-block-buttons.js"></script><link rel="stylesheet" href="/openapi-generator/css/main.css"/></head><body class="sideNavVisible separateOnPageNav"><div class="fixedHeaderContainer"><div class="headerWrapper wrapper"><header><a href="/openapi-generator/"><img class="logo" src="/openapi-generator/img/mono-logo.svg" alt="OpenAPI Generator"/><h2 class="headerTitleWithLogo">OpenAPI Generator</h2></a><div class="navigationWrapper navigationSlider"><nav class="slidingNav"><ul class="nav-site nav-site-internal"><li class=""><a href="/openapi-generator/docs/installation" target="_self">Get Started</a></li><li class=""><a href="/openapi-generator/docs/generators" target="_self">Generators</a></li><li class=""><a href="/openapi-generator/docs/roadmap" target="_self">Roadmap</a></li><li class=""><a href="/openapi-generator/team" target="_self">Team</a></li><li class=""><a href="/openapi-generator/docs/faq" target="_self">FAQ</a></li><li class=""><a href="/openapi-generator/blog/" target="_self">Blog</a></li></ul></nav></div></header></div></div><div class="navPusher"><div class="docMainWrapper wrapper"><div class="container mainContainer"><div class="wrapper"><div class="post"><header class="postHeader"><h1 class="postHeaderTitle">generators/java</h1></header><article><div><span><hr>
|
|
<p>id: generator-opts-client-java
|
|
title: Config Options for java
|
|
sidebar_label: java</p>
|
|
<hr>
|
|
<table>
|
|
<thead>
|
|
<tr><th>Option</th><th>Description</th><th>Values</th><th>Default</th></tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr><td>sortParamsByRequiredFlag</td><td>Sort method arguments to place required parameters before optional parameters.</td><td></td><td>true</td></tr>
|
|
<tr><td>ensureUniqueParams</td><td>Whether to ensure parameter names are unique in an operation (rename parameters that are not).</td><td></td><td>true</td></tr>
|
|
<tr><td>allowUnicodeIdentifiers</td><td>boolean, toggles whether unicode identifiers are allowed in names or not, default is false</td><td></td><td>false</td></tr>
|
|
<tr><td>prependFormOrBodyParameters</td><td>Add form or body parameters to the beginning of the parameter list.</td><td></td><td>false</td></tr>
|
|
<tr><td>modelPackage</td><td>package for generated models</td><td></td><td>null</td></tr>
|
|
<tr><td>apiPackage</td><td>package for generated api classes</td><td></td><td>null</td></tr>
|
|
<tr><td>invokerPackage</td><td>root package for generated code</td><td></td><td>null</td></tr>
|
|
<tr><td>groupId</td><td>groupId in generated pom.xml</td><td></td><td>null</td></tr>
|
|
<tr><td>artifactId</td><td>artifactId in generated pom.xml</td><td></td><td>null</td></tr>
|
|
<tr><td>artifactVersion</td><td>artifact version in generated pom.xml</td><td></td><td>null</td></tr>
|
|
<tr><td>artifactUrl</td><td>artifact URL in generated pom.xml</td><td></td><td>null</td></tr>
|
|
<tr><td>artifactDescription</td><td>artifact description in generated pom.xml</td><td></td><td>null</td></tr>
|
|
<tr><td>scmConnection</td><td>SCM connection in generated pom.xml</td><td></td><td>null</td></tr>
|
|
<tr><td>scmDeveloperConnection</td><td>SCM developer connection in generated pom.xml</td><td></td><td>null</td></tr>
|
|
<tr><td>scmUrl</td><td>SCM URL in generated pom.xml</td><td></td><td>null</td></tr>
|
|
<tr><td>developerName</td><td>developer name in generated pom.xml</td><td></td><td>null</td></tr>
|
|
<tr><td>developerEmail</td><td>developer email in generated pom.xml</td><td></td><td>null</td></tr>
|
|
<tr><td>developerOrganization</td><td>developer organization in generated pom.xml</td><td></td><td>null</td></tr>
|
|
<tr><td>developerOrganizationUrl</td><td>developer organization URL in generated pom.xml</td><td></td><td>null</td></tr>
|
|
<tr><td>licenseName</td><td>The name of the license</td><td></td><td>null</td></tr>
|
|
<tr><td>licenseUrl</td><td>The URL of the license</td><td></td><td>null</td></tr>
|
|
<tr><td>sourceFolder</td><td>source folder for generated code</td><td></td><td>null</td></tr>
|
|
<tr><td>localVariablePrefix</td><td>prefix for generated code members and local variables</td><td></td><td>null</td></tr>
|
|
<tr><td>serializableModel</td><td>boolean - toggle "implements Serializable" for generated models</td><td></td><td>false</td></tr>
|
|
<tr><td>bigDecimalAsString</td><td>Treat BigDecimal values as Strings to avoid precision loss.</td><td></td><td>false</td></tr>
|
|
<tr><td>fullJavaUtil</td><td>whether to use fully qualified name for classes under java.util. This option only works for Java API client</td><td></td><td>false</td></tr>
|
|
<tr><td>hideGenerationTimestamp</td><td>hides the timestamp when files were generated</td><td></td><td>null</td></tr>
|
|
<tr><td>withXml</td><td>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)</td><td></td><td>false</td></tr>
|
|
<tr><td>dateLibrary</td><td>Option. Date library to use</td><td><dl><dt><strong>joda</strong></dt><dd>Joda (for legacy app only)</dd><dt><strong>legacy</strong></dt><dd>Legacy java.util.Date (if you really have a good reason not to use threetenbp</dd><dt><strong>java8-localdatetime</strong></dt><dd>Java 8 using LocalDateTime (for legacy app only)</dd><dt><strong>java8</strong></dt><dd>Java 8 native JSR310 (preferred for jdk 1.8+) - note: this also sets "java8" to true</dd><dt><strong>threetenbp</strong></dt><dd>Backport of JSR310 (preferred for jdk < 1.8)</dd><dl></td><td>null</td></tr>
|
|
<tr><td>java8</td><td>Option. Use Java8 classes instead of third party equivalents</td><td><dl><dt><strong>true</strong></dt><dd>Use Java 8 classes such as Base64</dd><dt><strong>false</strong></dt><dd>Various third party libraries as needed</dd><dl></td><td>null</td></tr>
|
|
<tr><td>disableHtmlEscaping</td><td>Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)</td><td></td><td>false</td></tr>
|
|
<tr><td>booleanGetterPrefix</td><td>Set booleanGetterPrefix (default value 'get')</td><td></td><td>null</td></tr>
|
|
<tr><td>parentGroupId</td><td>parent groupId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr>
|
|
<tr><td>parentArtifactId</td><td>parent artifactId in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr>
|
|
<tr><td>parentVersion</td><td>parent version in generated pom N.B. parentGroupId, parentArtifactId and parentVersion must all be specified for any of them to take effect</td><td></td><td>null</td></tr>
|
|
<tr><td>useRxJava</td><td>Whether to use the RxJava adapter with the retrofit2 library.</td><td></td><td>false</td></tr>
|
|
<tr><td>useRxJava2</td><td>Whether to use the RxJava2 adapter with the retrofit2 library.</td><td></td><td>false</td></tr>
|
|
<tr><td>parcelableModel</td><td>Whether to generate models for Android that implement Parcelable with the okhttp-gson library.</td><td></td><td>false</td></tr>
|
|
<tr><td>usePlayWS</td><td>Use Play! Async HTTP client (Play WS API)</td><td></td><td>false</td></tr>
|
|
<tr><td>playVersion</td><td>Version of Play! Framework (possible values "play24", "play25" (default), "play26")</td><td></td><td>null</td></tr>
|
|
<tr><td>supportJava6</td><td>Whether to support Java6 with the Jersey1 library.</td><td></td><td>false</td></tr>
|
|
<tr><td>useBeanValidation</td><td>Use BeanValidation API annotations</td><td></td><td>false</td></tr>
|
|
<tr><td>performBeanValidation</td><td>Perform BeanValidation</td><td></td><td>false</td></tr>
|
|
<tr><td>useGzipFeature</td><td>Send gzip-encoded requests</td><td></td><td>false</td></tr>
|
|
<tr><td>useRuntimeException</td><td>Use RuntimeException instead of Exception</td><td></td><td>false</td></tr>
|
|
<tr><td>feignVersion</td><td>Version of OpenFeign: '10.x', '9.x' (default)</td><td></td><td>false</td></tr>
|
|
<tr><td>useReflectionEqualsHashCode</td><td>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.</td><td></td><td>false</td></tr>
|
|
<tr><td>library</td><td>library template (sub-template) to use</td><td><dl><dt><strong>jersey1</strong></dt><dd>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'.</dd><dt><strong>feign</strong></dt><dd>HTTP client: OpenFeign 9.4.0. JSON processing: Jackson 2.8.9. To enable OpenFeign 10.x, set the 'feignVersion' option to '10.x'</dd><dt><strong>jersey2</strong></dt><dd>HTTP client: Jersey client 2.25.1. JSON processing: Jackson 2.8.9</dd><dt><strong>okhttp-gson</strong></dt><dd>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'.</dd><dt><strong>retrofit</strong></dt><dd>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.</dd><dt><strong>retrofit2</strong></dt><dd>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)</dd><dt><strong>resttemplate</strong></dt><dd>HTTP client: Spring RestTemplate 4.3.9-RELEASE. JSON processing: Jackson 2.8.9</dd><dt><strong>webclient</strong></dt><dd>HTTP client: Spring WebClient 5.0.7-RELEASE. JSON processing: Jackson 2.9.5</dd><dt><strong>resteasy</strong></dt><dd>HTTP client: Resteasy client 3.1.3.Final. JSON processing: Jackson 2.8.9</dd><dt><strong>vertx</strong></dt><dd>HTTP client: VertX client 3.2.4. JSON processing: Jackson 2.8.9</dd><dt><strong>google-api-client</strong></dt><dd>HTTP client: Google API client 1.23.0. JSON processing: Jackson 2.8.9</dd><dt><strong>rest-assured</strong></dt><dd>HTTP client: rest-assured : 3.1.0. JSON processing: Gson 2.6.1. Only for Java8</dd><dl></td><td>okhttp-gson</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</span></div></article></div><div class="docLastUpdate"><em>Last updated on 2019-1-18</em></div><div class="docs-prevnext"></div></div></div><nav class="onPageNav"></nav></div><footer class="nav-footer" id="footer"><section class="sitemap"><a href="/openapi-generator/" class="nav-home"><img src="/openapi-generator/img/mono-logo.svg" alt="OpenAPI Generator" width="66" height="58"/></a><div><h5>Docs</h5><a href="/openapi-generator/docs/en/customization.html">Customizing Generators</a><a href="/openapi-generator/docs/en/integrations.html">Workflow Integrations</a></div><div><h5>Community</h5><a href="/openapi-generator/en/users.html">User Showcase</a><a href="http://stackoverflow.com/questions/tagged/openapi-generator" target="_blank" rel="noreferrer noopener">Stack Overflow</a><a href="https://gitter.im/OpenAPITools/openapi-generator">Project Chat</a><a href="https://twitter.com/oas_generator" target="_blank" rel="noreferrer noopener">Twitter</a></div><div><h5>More</h5><a href="/openapi-generator/blog">Blog</a><a href="https://github.com/OpenAPITools/openapi-generator">GitHub Repo</a><a class="github-button" href="https://github.com/OpenAPITools/openapi-generator" data-icon="octicon-star" data-count-href="/OpenAPITools/openapi-generator/stargazers" data-show-count="true" data-count-aria-label="# stargazers on GitHub" aria-label="Star this project on GitHub">Star</a></div></section><section class="attribution"><a href="https://code.facebook.com/projects/" target="_blank" rel="noreferrer noopener" class="fbOpenSource"><img src="/openapi-generator/img/oss_logo.png" alt="Facebook Open Source" width="170" height="45"/></a><a href="https://fontawesome.com/license/free" target="_blank" rel="noreferrer noopener" class="fbOpenSource"><img src="/openapi-generator/img/fa-logo.svg" alt="Fontawesome (Free)" width="170" height="45"/></a></section><section class="copyright">Copyright © 2019 OpenAPI-Generator Contributors (https://openapi-generator.tech)</section></footer></div></body></html> |