generators/spring
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 |
| null |
| java8 | Option. Use Java8 classes instead of third party equivalents |
| 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 |