--- id: generator-opts-server-spring title: Config Options for spring sidebar_label: spring --- | Option | Description | Values | Default | | ------ | ----------- | ------ | ------- | |sortParamsByRequiredFlag|Sort method arguments to place required parameters before optional parameters.| |true| |ensureUniqueParams|Whether to ensure parameter names are unique in an operation (rename parameters that are not).| |true| |allowUnicodeIdentifiers|boolean, toggles whether unicode identifiers are allowed in names or not, default is false| |false| |prependFormOrBodyParameters|Add form or body parameters to the beginning of the parameter list.| |false| |modelPackage|package for generated models| |null| |apiPackage|package for generated api classes| |null| |invokerPackage|root package for generated code| |null| |groupId|groupId in generated pom.xml| |null| |artifactId|artifactId in generated pom.xml| |null| |artifactVersion|artifact version in generated pom.xml| |null| |artifactUrl|artifact URL in generated pom.xml| |null| |artifactDescription|artifact description in generated pom.xml| |null| |scmConnection|SCM connection in generated pom.xml| |null| |scmDeveloperConnection|SCM developer connection in generated pom.xml| |null| |scmUrl|SCM URL in generated pom.xml| |null| |developerName|developer name in generated pom.xml| |null| |developerEmail|developer email in generated pom.xml| |null| |developerOrganization|developer organization in generated pom.xml| |null| |developerOrganizationUrl|developer organization URL in generated pom.xml| |null| |licenseName|The name of the license| |null| |licenseUrl|The URL of the license| |null| |sourceFolder|source folder for generated code| |null| |serializableModel|boolean - toggle "implements Serializable" for generated models| |false| |bigDecimalAsString|Treat BigDecimal values as Strings to avoid precision loss.| |false| |fullJavaUtil|whether to use fully qualified name for classes under java.util. This option only works for Java API client| |false| |hideGenerationTimestamp|hides the timestamp when files were generated| |null| |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| |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)
|null| |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
|null| |disableHtmlEscaping|Disable HTML escaping of JSON strings when using gson (needed to avoid problems with byte[] fields)| |false| |booleanGetterPrefix|Set booleanGetterPrefix (default value 'get')| |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| |parentArtifactId|parent artifactId 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| |snapshotVersion|Uses a SNAPSHOT version.| |null| |title|server title name or client service name| |null| |configPackage|configuration package for generated code| |null| |basePackage|base package (invokerPackage) for generated code| |null| |interfaceOnly|Whether to generate only API interface stubs without the server files.| |false| |delegatePattern|Whether to generate the server files using the delegate pattern| |false| |singleContentTypes|Whether to select only one produces/consumes content-type by operation.| |false| |java8|use java8 default interface| |true| |async|use async Callable controllers| |false| |reactive|wrap responses in Mono/Flux Reactor types (spring-boot only)| |false| |responseWrapper|wrap the responses in given type (Future,Callable,CompletableFuture,ListenableFuture,DeferredResult,HystrixCommand,RxObservable,RxSingle or fully qualified type)| |null| |virtualService|Generates the virtual service. For more details refer - https://github.com/elan-venture/virtualan/wiki| |false| |useTags|use tags for creating interface and controller classnames| |false| |useBeanValidation|Use BeanValidation API annotations| |true| |performBeanValidation|Use Bean Validation Impl. to perform BeanValidation| |false| |implicitHeaders|Use of @ApiImplicitParams for headers.| |false| |swaggerDocketConfig|Generate Spring OpenAPI Docket configuration class.| |false| |apiFirst|Generate the API from the OAI spec at server compile time (API first approach)| |false| |useOptional|Use Optional container for optional parameters| |false| |hateoas|Use Spring HATEOAS library to allow adding HATEOAS links| |false| |returnSuccessCode|Generated server returns 2xx code| |false| |library|library template (sub-template) to use|
**spring-boot**
Spring-boot Server application using the SpringFox integration.
**spring-mvc**
Spring-MVC Server application using the SpringFox integration.
**spring-cloud**
Spring-Cloud-Feign client with Spring-Boot auto-configured settings.
|spring-boot|