contribution #6123: add spring support for SSE conform specs (#16543)

* add spring support for SSE conform specs

see https://github.com/OpenAPITools/openapi-generator/issues/6123 for the ongoing discussion

* extend generator option documentation

* applied review suggestions

* regenerated samples

* regenerated docu

* fix code style: removed tabs

modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/SpringCodegen.java

@@ -68,6 +68,7 @@ import io.swagger.v3.oas.models.Components;
 import io.swagger.v3.oas.models.OpenAPI;
 import io.swagger.v3.oas.models.Operation;
 import io.swagger.v3.oas.models.PathItem;
+import io.swagger.v3.oas.models.media.MediaType;
 import io.swagger.v3.oas.models.media.Schema;
 import io.swagger.v3.oas.models.parameters.Parameter;
 import io.swagger.v3.oas.models.servers.Server;
@@ -96,6 +97,7 @@ public class SpringCodegen extends AbstractJavaCodegen
 
     public static final String ASYNC = "async";
     public static final String REACTIVE = "reactive";
+    public static final String SSE = "serverSentEvents";
     public static final String RESPONSE_WRAPPER = "responseWrapper";
     public static final String USE_TAGS = "useTags";
     public static final String SPRING_BOOT = "spring-boot";
@@ -144,6 +146,7 @@ public class SpringCodegen extends AbstractJavaCodegen
     protected boolean singleContentTypes = false;
     protected boolean async = false;
     protected boolean reactive = false;
+    protected boolean sse = false;
     protected String responseWrapper = "";
     protected boolean skipDefaultInterface = false;
     protected boolean useTags = false;
@@ -448,6 +451,9 @@ public class SpringCodegen extends AbstractJavaCodegen
                 throw new IllegalArgumentException("Currently, reactive option doesn't supported by Spring Cloud");
             }
             this.setReactive(Boolean.parseBoolean(additionalProperties.get(REACTIVE).toString()));
+            if (additionalProperties.containsKey(SSE)) {
+                this.setSse(Boolean.parseBoolean(additionalProperties.get(SSE).toString()));
+            }
         }
 
         if (additionalProperties.containsKey(RESPONSE_WRAPPER)) {
@@ -1069,6 +1075,10 @@ public class SpringCodegen extends AbstractJavaCodegen
         this.reactive = reactive;
     }
 
+    public void setSse(boolean sse) {
+        this.sse = sse;
+    }
+
     public void setResponseWrapper(String responseWrapper) {
         this.responseWrapper = responseWrapper;
     }
@@ -1249,6 +1259,50 @@ public class SpringCodegen extends AbstractJavaCodegen
             if (DocumentationProvider.SPRINGFOX.equals(getDocumentationProvider())) {
                 codegenOperation.imports.add("ApiIgnore");
             }
+            if (sse) {
+                var MEDIA_EVENT_STREAM = "text/event-stream";
+                // inspecting used streaming media types
+                /*
+                 expected definition:
+                 content:
+                    text/event-stream:
+                        schema:
+                        type: array
+                        format: event-stream
+                        items:
+                            type: <type> or
+                            $ref: <typeRef>
+                 */
+                Map<String, List<Schema>> schemaTypes = operation.getResponses().entrySet().stream()
+                        .map(e -> Pair.of(e.getValue(), fromResponse(e.getKey(), e.getValue())))
+                        .filter(p -> p.getRight().is2xx) // consider only success
+                        .map(p -> p.getLeft().getContent().get(MEDIA_EVENT_STREAM))
+                        .map(MediaType::getSchema)
+                        .collect(Collectors.toList()).stream()
+                        .collect(Collectors.groupingBy(Schema::getType));
+                if(schemaTypes.containsKey("array")) {
+                    // we have a match with SSE pattern
+                    // double check potential conflicting, multiple specs
+                    if(schemaTypes.keySet().size() > 1) {
+                        throw new RuntimeException("only 1 response media type supported, when SSE is detected");
+                    }
+                    // double check schema format
+                    List<Schema> eventTypes = schemaTypes.get("array");
+                    if( eventTypes.stream().anyMatch(schema -> !"event-stream".equalsIgnoreCase(schema.getFormat()))) {
+                        throw new RuntimeException("schema format 'event-stream' is required, when SSE is detected");
+                    }
+                    // double check item types
+                    Set<String> itemTypes = eventTypes.stream()
+                            .map(schema -> schema.getItems().getType() != null
+                                    ? schema.getItems().getType()
+                                    : schema.getItems().get$ref())
+                            .collect(Collectors.toSet());
+                    if(itemTypes.size() > 1) {
+                        throw new RuntimeException("only single item type is supported, when SSE is detected");
+                    }
+                    codegenOperation.vendorExtensions.put("x-sse", true);
+                } // Not an SSE compliant definition
+            }
         }
         return codegenOperation;
     }

modules/openapi-generator/src/main/resources/JavaSpring/api.mustache

@@ -246,7 +246,8 @@ public interface {{classname}} {
     {{#vendorExtensions.x-operation-extra-annotation}}
     {{{.}}}
     {{/vendorExtensions.x-operation-extra-annotation}}
-    {{#jdk8-default-interface}}default {{/jdk8-default-interface}}{{#responseWrapper}}{{.}}<{{/responseWrapper}}{{#useResponseEntity}}ResponseEntity<{{/useResponseEntity}}{{>returnTypes}}{{#useResponseEntity}}>{{/useResponseEntity}}{{#responseWrapper}}>{{/responseWrapper}} {{#delegate-method}}_{{/delegate-method}}{{operationId}}(
+    {{#vendorExtensions.x-sse}}@ResponseBody{{/vendorExtensions.x-sse}}
+    {{#jdk8-default-interface}}default {{/jdk8-default-interface}}{{>responseType}} {{#delegate-method}}_{{/delegate-method}}{{operationId}}(
         {{#allParams}}{{>queryParams}}{{>pathParams}}{{>headerParams}}{{>bodyParams}}{{>formParams}}{{>cookieParams}}{{^-last}},
         {{/-last}}{{/allParams}}{{#reactive}}{{#hasParams}},
         {{/hasParams}}{{#swagger2AnnotationLibrary}}@Parameter(hidden = true){{/swagger2AnnotationLibrary}}{{#springFoxDocumentationProvider}}@ApiIgnore{{/springFoxDocumentationProvider}} final ServerWebExchange exchange{{/reactive}}{{#vendorExtensions.x-spring-paginated}}{{#hasParams}},
@@ -257,7 +258,7 @@ public interface {{classname}} {
     }
 
     // Override this method
-    {{#jdk8-default-interface}}default {{/jdk8-default-interface}} {{#responseWrapper}}{{.}}<{{/responseWrapper}}{{#useResponseEntity}}ResponseEntity<{{/useResponseEntity}}{{>returnTypes}}{{#useResponseEntity}}>{{/useResponseEntity}}{{#responseWrapper}}>{{/responseWrapper}} {{operationId}}({{#allParams}}{{^isFile}}{{^isBodyParam}}{{>optionalDataType}}{{/isBodyParam}}{{#isBodyParam}}{{^reactive}}{{{dataType}}}{{/reactive}}{{#reactive}}{{^isArray}}Mono<{{{dataType}}}>{{/isArray}}{{#isArray}}Flux<{{{baseType}}}>{{/isArray}}{{/reactive}}{{/isBodyParam}}{{/isFile}}{{#isFile}}{{#reactive}}Flux<Part>{{/reactive}}{{^reactive}}MultipartFile{{/reactive}}{{/isFile}} {{paramName}}{{^-last}}, {{/-last}}{{/allParams}}{{#reactive}}{{#hasParams}}, {{/hasParams}}{{#springFoxDocumentationProvider}}@ApiIgnore{{/springFoxDocumentationProvider}} final ServerWebExchange exchange{{/reactive}}{{#vendorExtensions.x-spring-paginated}}{{#hasParams}}, {{/hasParams}}{{^hasParams}}{{#reactive}}, {{/reactive}}{{/hasParams}}{{#springFoxDocumentationProvider}}@ApiIgnore{{/springFoxDocumentationProvider}}final Pageable pageable{{/vendorExtensions.x-spring-paginated}}){{#unhandledException}} throws Exception{{/unhandledException}} {
+    {{#jdk8-default-interface}}default {{/jdk8-default-interface}} {{>responseType}} {{operationId}}({{#allParams}}{{^isFile}}{{^isBodyParam}}{{>optionalDataType}}{{/isBodyParam}}{{#isBodyParam}}{{^reactive}}{{{dataType}}}{{/reactive}}{{#reactive}}{{^isArray}}Mono<{{{dataType}}}>{{/isArray}}{{#isArray}}Flux<{{{baseType}}}>{{/isArray}}{{/reactive}}{{/isBodyParam}}{{/isFile}}{{#isFile}}{{#reactive}}Flux<Part>{{/reactive}}{{^reactive}}MultipartFile{{/reactive}}{{/isFile}} {{paramName}}{{^-last}}, {{/-last}}{{/allParams}}{{#reactive}}{{#hasParams}}, {{/hasParams}}{{#springFoxDocumentationProvider}}@ApiIgnore{{/springFoxDocumentationProvider}} final ServerWebExchange exchange{{/reactive}}{{#vendorExtensions.x-spring-paginated}}{{#hasParams}}, {{/hasParams}}{{^hasParams}}{{#reactive}}, {{/reactive}}{{/hasParams}}{{#springFoxDocumentationProvider}}@ApiIgnore{{/springFoxDocumentationProvider}}final Pageable pageable{{/vendorExtensions.x-spring-paginated}}){{#unhandledException}} throws Exception{{/unhandledException}} {
         {{/delegate-method}}
         {{^isDelegate}}
         {{>methodBody}}

modules/openapi-generator/src/main/resources/JavaSpring/apiDelegate.mustache

@@ -66,7 +66,7 @@ public interface {{classname}}Delegate {
     {{#isDeprecated}}
     @Deprecated
     {{/isDeprecated}}
-    {{#jdk8-default-interface}}default {{/jdk8-default-interface}}{{#responseWrapper}}{{.}}<{{/responseWrapper}}{{#useResponseEntity}}ResponseEntity<{{/useResponseEntity}}{{>returnTypes}}{{#useResponseEntity}}>{{/useResponseEntity}}{{#responseWrapper}}>{{/responseWrapper}} {{operationId}}({{#allParams}}{{^isFile}}{{^isBodyParam}}{{>optionalDataType}}{{/isBodyParam}}{{#isBodyParam}}{{^reactive}}{{{dataType}}}{{/reactive}}{{#reactive}}{{^isArray}}Mono<{{{dataType}}}>{{/isArray}}{{#isArray}}Flux<{{{baseType}}}>{{/isArray}}{{/reactive}}{{/isBodyParam}}{{/isFile}}{{#isFile}}{{#isArray}}List<{{/isArray}}{{#reactive}}Flux<Part>{{/reactive}}{{^reactive}}MultipartFile{{/reactive}}{{#isArray}}>{{/isArray}}{{/isFile}} {{paramName}}{{^-last}},
+    {{#jdk8-default-interface}}default {{/jdk8-default-interface}}{{>responseType}} {{operationId}}({{#allParams}}{{^isFile}}{{^isBodyParam}}{{>optionalDataType}}{{/isBodyParam}}{{#isBodyParam}}{{^reactive}}{{{dataType}}}{{/reactive}}{{#reactive}}{{^isArray}}Mono<{{{dataType}}}>{{/isArray}}{{#isArray}}Flux<{{{baseType}}}>{{/isArray}}{{/reactive}}{{/isBodyParam}}{{/isFile}}{{#isFile}}{{#isArray}}List<{{/isArray}}{{#reactive}}Flux<Part>{{/reactive}}{{^reactive}}MultipartFile{{/reactive}}{{#isArray}}>{{/isArray}}{{/isFile}} {{paramName}}{{^-last}},
         {{/-last}}{{/allParams}}{{#reactive}}{{#hasParams}},
         {{/hasParams}}ServerWebExchange exchange{{/reactive}}{{#vendorExtensions.x-spring-paginated}}{{#hasParams}}, {{/hasParams}}{{^hasParams}}{{#reactive}}, {{/reactive}}{{/hasParams}}final Pageable pageable{{/vendorExtensions.x-spring-paginated}}){{#unhandledException}} throws Exception{{/unhandledException}}{{^jdk8-default-interface}};{{/jdk8-default-interface}}{{#jdk8-default-interface}} {
         {{>methodBody}}

modules/openapi-generator/src/main/resources/JavaSpring/methodBody.mustache

@@ -31,6 +31,7 @@ return CompletableFuture.supplyAsync(()-> {
 {{/examples}}
 {{/reactive}}
 {{#reactive}}
+{{^vendorExtensions.x-sse}}
 Mono<Void> result = Mono.empty();
     {{#examples}}
         {{#-first}}
@@ -50,4 +51,9 @@ Mono<Void> result = Mono.empty();
         exchange.getResponse().setStatusCode({{#returnSuccessCode}}HttpStatus.OK{{/returnSuccessCode}}{{^returnSuccessCode}}HttpStatus.NOT_IMPLEMENTED{{/returnSuccessCode}});
 {{/examples}}
         return result{{#allParams}}{{#isBodyParam}}{{^isArray}}{{#paramName}}.then({{.}}){{/paramName}}{{/isArray}}{{#isArray}}{{#paramName}}.thenMany({{.}}){{/paramName}}{{/isArray}}{{/isBodyParam}}{{/allParams}}.then(Mono.empty());
-{{/reactive}}
+{{/vendorExtensions.x-sse}}
+{{#vendorExtensions.x-sse}}
+exchange.getResponse().setStatusCode({{#returnSuccessCode}}HttpStatus.valueOf({{{statusCode}}}){{/returnSuccessCode}}{{^returnSuccessCode}}HttpStatus.NOT_IMPLEMENTED{{/returnSuccessCode}});
+        return Flux.empty();
+{{/vendorExtensions.x-sse}}
+{{/reactive}}

modules/openapi-generator/src/main/resources/JavaSpring/responseType.mustache

@@ -0,0 +1 @@
+{{^vendorExtensions.x-sse}}{{#responseWrapper}}{{.}}<{{/responseWrapper}}{{#useResponseEntity}}ResponseEntity<{{/useResponseEntity}}{{>returnTypes}}{{#useResponseEntity}}>{{/useResponseEntity}}{{#responseWrapper}}>{{/responseWrapper}}{{/vendorExtensions.x-sse}}{{#vendorExtensions.x-sse}}{{>returnTypes}}{{/vendorExtensions.x-sse}}

modules/openapi-generator/src/test/java/org/openapitools/codegen/java/spring/SpringCodegenTest.java

@@ -17,15 +17,56 @@
 
 package org.openapitools.codegen.java.spring;
 
-import com.google.common.collect.ImmutableMap;
+import static java.util.stream.Collectors.groupingBy;
-import io.swagger.parser.OpenAPIParser;
+import static org.assertj.core.api.Assertions.assertThat;
-import io.swagger.v3.oas.models.OpenAPI;
+import static org.openapitools.codegen.TestUtils.assertFileContains;
-import io.swagger.v3.oas.models.Operation;
+import static org.openapitools.codegen.TestUtils.assertFileNotContains;
-import io.swagger.v3.oas.models.info.Info;
+import static org.openapitools.codegen.languages.SpringCodegen.ASYNC;
-import io.swagger.v3.oas.models.media.Schema;
+import static org.openapitools.codegen.languages.SpringCodegen.DELEGATE_PATTERN;
-import io.swagger.v3.oas.models.servers.Server;
+import static org.openapitools.codegen.languages.SpringCodegen.DocumentationProvider;
-import io.swagger.v3.parser.core.models.ParseOptions;
+import static org.openapitools.codegen.languages.SpringCodegen.IMPLICIT_HEADERS;
-import org.openapitools.codegen.*;
+import static org.openapitools.codegen.languages.SpringCodegen.INTERFACE_ONLY;
+import static org.openapitools.codegen.languages.SpringCodegen.OPENAPI_NULLABLE;
+import static org.openapitools.codegen.languages.SpringCodegen.REACTIVE;
+import static org.openapitools.codegen.languages.SpringCodegen.REQUEST_MAPPING_OPTION;
+import static org.openapitools.codegen.languages.SpringCodegen.RESPONSE_WRAPPER;
+import static org.openapitools.codegen.languages.SpringCodegen.RETURN_SUCCESS_CODE;
+import static org.openapitools.codegen.languages.SpringCodegen.SKIP_DEFAULT_INTERFACE;
+import static org.openapitools.codegen.languages.SpringCodegen.SPRING_BOOT;
+import static org.openapitools.codegen.languages.SpringCodegen.SPRING_CLOUD_LIBRARY;
+import static org.openapitools.codegen.languages.SpringCodegen.SPRING_CONTROLLER;
+import static org.openapitools.codegen.languages.SpringCodegen.SSE;
+import static org.openapitools.codegen.languages.SpringCodegen.USE_ENUM_CASE_INSENSITIVE;
+import static org.openapitools.codegen.languages.SpringCodegen.USE_RESPONSE_ENTITY;
+import static org.openapitools.codegen.languages.SpringCodegen.USE_SPRING_BOOT3;
+import static org.openapitools.codegen.languages.SpringCodegen.USE_TAGS;
+import static org.openapitools.codegen.languages.features.DocumentationProviderFeatures.ANNOTATION_LIBRARY;
+import static org.openapitools.codegen.languages.features.DocumentationProviderFeatures.DOCUMENTATION_PROVIDER;
+import static org.testng.Assert.assertEquals;
+import static org.testng.Assert.fail;
+
+import java.io.File;
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Paths;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Consumer;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+
+import org.assertj.core.api.MapAssert;
+import org.openapitools.codegen.CliOption;
+import org.openapitools.codegen.ClientOptInput;
+import org.openapitools.codegen.CodegenConstants;
+import org.openapitools.codegen.CodegenModel;
+import org.openapitools.codegen.CodegenOperation;
+import org.openapitools.codegen.CodegenParameter;
+import org.openapitools.codegen.CodegenProperty;
+import org.openapitools.codegen.DefaultGenerator;
+import org.openapitools.codegen.SupportingFile;
+import org.openapitools.codegen.TestUtils;
 import org.openapitools.codegen.config.CodegenConfigurator;
 import org.openapitools.codegen.config.GlobalSettings;
 import org.openapitools.codegen.java.assertions.JavaFileAssert;
@@ -40,26 +81,15 @@ import org.testng.annotations.DataProvider;
 import org.testng.annotations.Ignore;
 import org.testng.annotations.Test;
 
-import java.io.File;
+import com.google.common.collect.ImmutableMap;
-import java.io.IOException;
-import java.nio.file.Files;
-import java.nio.file.Paths;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-import java.util.function.Consumer;
-import java.util.function.Function;
-import java.util.stream.Collectors;
 
-import static java.util.stream.Collectors.groupingBy;
+import io.swagger.parser.OpenAPIParser;
-import static org.assertj.core.api.Assertions.assertThat;
+import io.swagger.v3.oas.models.OpenAPI;
-import static org.openapitools.codegen.TestUtils.assertFileContains;
+import io.swagger.v3.oas.models.Operation;
-import static org.openapitools.codegen.TestUtils.assertFileNotContains;
+import io.swagger.v3.oas.models.info.Info;
-import static org.openapitools.codegen.languages.SpringCodegen.*;
+import io.swagger.v3.oas.models.media.Schema;
-import static org.openapitools.codegen.languages.features.DocumentationProviderFeatures.ANNOTATION_LIBRARY;
+import io.swagger.v3.oas.models.servers.Server;
-import static org.openapitools.codegen.languages.features.DocumentationProviderFeatures.DOCUMENTATION_PROVIDER;
+import io.swagger.v3.parser.core.models.ParseOptions;
-import static org.testng.Assert.assertEquals;
-import static org.testng.Assert.fail;
 
 public class SpringCodegenTest {
 
@@ -3084,4 +3114,65 @@ public class SpringCodegenTest {
         JavaFileAssert.assertThat(files.get("PingTagApi.java"))
                 .fileContains("This is a multine tag : * tag item 1 * tag item 2 ");
     }
+
+    @Test
+    public void testSSEOperationSupport() throws Exception {
+
+        File output = Files.createTempDirectory("test").toFile().getCanonicalFile();
+        output.deleteOnExit();
+
+        final OpenAPI openAPI = TestUtils.parseFlattenSpec("src/test/resources/3_0/sse.yaml");
+        final SpringCodegen codegen = new SpringCodegen();
+        codegen.setOpenAPI(openAPI);
+        codegen.setOutputDir(output.getAbsolutePath());
+
+        codegen.additionalProperties().put(SSE, "true");
+        codegen.additionalProperties().put(REACTIVE, "true");
+        codegen.additionalProperties().put(INTERFACE_ONLY, "false");
+        codegen.additionalProperties().put(DELEGATE_PATTERN, "true");
+
+        ClientOptInput input = new ClientOptInput();
+        input.openAPI(openAPI);
+        input.config(codegen);
+
+        DefaultGenerator generator = new DefaultGenerator();
+
+        Map<String, File> files = generator.opts(input).generate().stream()
+                .collect(Collectors.toMap(File::getName, Function.identity()));
+
+        MapAssert.assertThatMap(files).isNotEmpty();
+        File api = files.get("PathApi.java");
+        File delegate = files.get("PathApiDelegate.java");
+
+        JavaFileAssert.assertThat(api)
+                .assertMethod("sseVariant1", "ServerWebExchange")
+                .isNotNull()
+                .hasReturnType("Flux<String>")
+                .toFileAssert()
+                .assertMethod("sseVariant2", "ServerWebExchange")
+                .isNotNull()
+                .hasReturnType("Flux<EventType>")
+                .toFileAssert()
+                .assertMethod("nonSSE", "ServerWebExchange")
+                .isNotNull()
+                .hasReturnType("Mono<ResponseEntity<String>>");
+
+        JavaFileAssert.assertThat(delegate)
+                .assertMethod("sseVariant1", "ServerWebExchange")
+                .isNotNull()
+                .hasReturnType("Flux<String>")
+                .bodyContainsLines("return Flux.empty();")
+                .toFileAssert()
+                .assertMethod("sseVariant2", "ServerWebExchange")
+                .isNotNull()
+                .hasReturnType("Flux<EventType>")
+                .bodyContainsLines("return Flux.empty();")
+                .toFileAssert()
+                .assertMethod("nonSSE", "ServerWebExchange")
+                .isNotNull()
+                .hasReturnType("Mono<ResponseEntity<String>>")
+                .bodyContainsLines("return result.then(Mono.empty());")
+        ;
+
+    }
 }

modules/openapi-generator/src/test/resources/3_0/sse.yaml

@@ -0,0 +1,62 @@
+openapi: 3.0.1
+info:
+  title: SSE test
+  description: SSE test cases
+  version: 1.0.0
+servers:
+  - url: 'https'
+tags:
+  - name: sse
+paths:
+  /path/variant1:
+    post:
+      operationId: sseVariant1
+      tags:
+        - sse
+      responses:
+        '200':
+          description: acknowledged
+          content:
+            text/event-stream:
+              schema:
+                type: array
+                format: event-stream
+                items:
+                  type: string
+  /path/variant2:
+    post:
+      operationId: sseVariant2
+      tags:
+        - sse
+      responses:
+        '200':
+          description: acknowledged
+          content:
+            text/event-stream:
+              schema:
+                type: array
+                format: event-stream
+                items:
+                  $ref: '#/components/schemas/EventType'
+  /path/variant3:
+    post:
+      operationId: nonSSE
+      tags:
+        - sse
+      responses:
+        '200':
+          description: acknowledged
+          content:
+            text/event-stream:
+              schema:
+                type: string
+                format: event-stream
+components:
+  schemas:
+    EventType:
+      type: object
+      properties:
+        attribute1:
+          type: string
+
+  

samples/client/petstore/spring-cloud-date-time/src/main/java/org/openapitools/api/DefaultApi.java

@@ -50,6 +50,7 @@ public interface DefaultApi {
         method = RequestMethod.GET,
         value = "/thingy/{date}"
     )
+    
     ResponseEntity<Void> get(
         @ApiParam(value = "A date path parameter", required = true, defaultValue = "1972-01-01") @PathVariable("date") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date,
         @NotNull @ApiParam(value = "A date-time query parameter", required = true, defaultValue = "1973-12-19T03:39:57-08:00") @Valid @RequestParam(value = "dateTime", required = true, defaultValue = "1973-12-19T03:39:57-08:00") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME) OffsetDateTime dateTime,
@@ -79,6 +80,7 @@ public interface DefaultApi {
         value = "/thingy/{date}",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     ResponseEntity<Void> updatePetWithForm(
         @ApiParam(value = "A date path parameter", required = true, defaultValue = "1970-01-01") @PathVariable("date") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date,
         @ApiParam(value = "Updated last visit timestamp", defaultValue = "1971-12-19T03:39:57-08:00") @Valid @RequestParam(value = "visitDate", required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME) OffsetDateTime visitDate

samples/client/petstore/spring-cloud-feign-without-url/src/main/java/org/openapitools/api/PetApi.java

@@ -59,6 +59,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Pet> addPet(
         @ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     );
@@ -91,6 +92,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     ResponseEntity<Void> deletePet(
         @ApiParam(value = "Pet id to delete", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "") @RequestHeader(value = "api_key", required = false) String apiKey
@@ -127,6 +129,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @ApiParam(value = "Status values that need to be considered for filter", required = true, allowableValues = "available, pending, sold") @Valid @RequestParam(value = "status", required = true) @Deprecated List<String> status
     );
@@ -164,6 +167,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByTags(
         @NotNull @ApiParam(value = "Tags to filter by", required = true) @Valid @RequestParam(value = "tags", required = true) List<String> tags
     );
@@ -198,6 +202,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Pet> getPetById(
         @ApiParam(value = "ID of pet to return", required = true) @PathVariable("petId") Long petId
     );
@@ -240,6 +245,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Pet> updatePet(
         @ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     );
@@ -274,6 +280,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     ResponseEntity<Void> updatePetWithForm(
         @ApiParam(value = "ID of pet that needs to be updated", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -312,6 +319,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "multipart/form-data"
     )
+    
     ResponseEntity<ModelApiResponse> uploadFile(
         @ApiParam(value = "ID of pet to update", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/client/petstore/spring-cloud-feign-without-url/src/main/java/org/openapitools/api/StoreApi.java

@@ -50,6 +50,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{orderId}"
     )
+    
     ResponseEntity<Void> deleteOrder(
         @ApiParam(value = "ID of the order that needs to be deleted", required = true) @PathVariable("orderId") String orderId
     );
@@ -80,6 +81,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = "application/json"
     )
+    
     ResponseEntity<Map<String, Integer>> getInventory(
         
     );
@@ -111,6 +113,7 @@ public interface StoreApi {
         value = "/store/order/{orderId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @ApiParam(value = "ID of pet that needs to be fetched", required = true) @PathVariable("orderId") Long orderId
     );
@@ -141,6 +144,7 @@ public interface StoreApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Order> placeOrder(
         @ApiParam(value = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     );

samples/client/petstore/spring-cloud-feign-without-url/src/main/java/org/openapitools/api/UserApi.java

@@ -52,6 +52,7 @@ public interface UserApi {
         value = "/user",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUser(
         @ApiParam(value = "Created user object", required = true) @Valid @RequestBody User user
     );
@@ -81,6 +82,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUsersWithArrayInput(
         @ApiParam(value = "List of user object", required = true) @Valid @RequestBody List<User> user
     );
@@ -110,6 +112,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUsersWithListInput(
         @ApiParam(value = "List of user object", required = true) @Valid @RequestBody List<User> user
     );
@@ -140,6 +143,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     ResponseEntity<Void> deleteUser(
         @ApiParam(value = "The name that needs to be deleted", required = true) @PathVariable("username") String username
     );
@@ -171,6 +175,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = "application/json"
     )
+    
     ResponseEntity<User> getUserByName(
         @ApiParam(value = "The name that needs to be fetched. Use user1 for testing.", required = true) @PathVariable("username") String username
     );
@@ -201,6 +206,7 @@ public interface UserApi {
         value = "/user/login",
         produces = "application/json"
     )
+    
     ResponseEntity<String> loginUser(
         @NotNull @Pattern(regexp = "^[a-zA-Z0-9]+[a-zA-Z0-9\\.\\-_]*[a-zA-Z0-9]+$") @ApiParam(value = "The user name for login", required = true) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @ApiParam(value = "The password for login in clear text", required = true) @Valid @RequestParam(value = "password", required = true) String password
@@ -229,6 +235,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     ResponseEntity<Void> logoutUser(
         
     );
@@ -261,6 +268,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> updateUser(
         @ApiParam(value = "name that need to be deleted", required = true) @PathVariable("username") String username,
         @ApiParam(value = "Updated user object", required = true) @Valid @RequestBody User user

samples/client/petstore/spring-cloud-tags/src/main/java/org/openapitools/api/PetController.java

@@ -56,6 +56,7 @@ public interface PetController {
         value = "/pet",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> addPet(
         @ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet body
     );
@@ -87,6 +88,7 @@ public interface PetController {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     ResponseEntity<Void> deletePet(
         @ApiParam(value = "Pet id to delete", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "") @RequestHeader(value = "api_key", required = false) String apiKey
@@ -124,6 +126,7 @@ public interface PetController {
         value = "/pet/findByStatus",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @ApiParam(value = "Status values that need to be considered for filter", required = true, allowableValues = "available, pending, sold") @Valid @RequestParam(value = "status", required = true) List<String> status,
         @ApiIgnore final Pageable pageable
@@ -163,6 +166,7 @@ public interface PetController {
         value = "/pet/findByTags",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByTags(
         @NotNull @ApiParam(value = "Tags to filter by", required = true) @Valid @RequestParam(value = "tags", required = true) List<String> tags,
         @ApiIgnore final Pageable pageable
@@ -198,6 +202,7 @@ public interface PetController {
         value = "/pet/{petId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Pet> getPetById(
         @ApiParam(value = "ID of pet to return", required = true) @PathVariable("petId") Long petId
     );
@@ -233,6 +238,7 @@ public interface PetController {
         value = "/pet",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> updatePet(
         @ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet body
     );
@@ -266,6 +272,7 @@ public interface PetController {
         value = "/pet/{petId}",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     ResponseEntity<Void> updatePetWithForm(
         @ApiParam(value = "ID of pet that needs to be updated", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -303,6 +310,7 @@ public interface PetController {
         produces = "application/json",
         consumes = "multipart/form-data"
     )
+    
     ResponseEntity<ModelApiResponse> uploadFile(
         @ApiParam(value = "ID of pet to update", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/client/petstore/spring-cloud-tags/src/main/java/org/openapitools/api/StoreController.java

@@ -50,6 +50,7 @@ public interface StoreController {
         method = RequestMethod.DELETE,
         value = "/store/order/{orderId}"
     )
+    
     ResponseEntity<Void> deleteOrder(
         @ApiParam(value = "ID of the order that needs to be deleted", required = true) @PathVariable("orderId") String orderId
     );
@@ -80,6 +81,7 @@ public interface StoreController {
         value = "/store/inventory",
         produces = "application/json"
     )
+    
     ResponseEntity<Map<String, Integer>> getInventory(
         
     );
@@ -111,6 +113,7 @@ public interface StoreController {
         value = "/store/order/{orderId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @ApiParam(value = "ID of pet that needs to be fetched", required = true) @PathVariable("orderId") Long orderId
     );
@@ -139,6 +142,7 @@ public interface StoreController {
         value = "/store/order",
         produces = "application/json"
     )
+    
     ResponseEntity<Order> placeOrder(
         @ApiParam(value = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order body
     );

samples/client/petstore/spring-cloud-tags/src/main/java/org/openapitools/api/UserController.java

@@ -48,6 +48,7 @@ public interface UserController {
         method = RequestMethod.POST,
         value = "/user"
     )
+    
     ResponseEntity<Void> createUser(
         @ApiParam(value = "Created user object", required = true) @Valid @RequestBody User body
     );
@@ -72,6 +73,7 @@ public interface UserController {
         method = RequestMethod.POST,
         value = "/user/createWithArray"
     )
+    
     ResponseEntity<Void> createUsersWithArrayInput(
         @ApiParam(value = "List of user object", required = true) @Valid @RequestBody List<User> body
     );
@@ -96,6 +98,7 @@ public interface UserController {
         method = RequestMethod.POST,
         value = "/user/createWithList"
     )
+    
     ResponseEntity<Void> createUsersWithListInput(
         @ApiParam(value = "List of user object", required = true) @Valid @RequestBody List<User> body
     );
@@ -123,6 +126,7 @@ public interface UserController {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     ResponseEntity<Void> deleteUser(
         @ApiParam(value = "The name that needs to be deleted", required = true) @PathVariable("username") String username
     );
@@ -153,6 +157,7 @@ public interface UserController {
         value = "/user/{username}",
         produces = "application/json"
     )
+    
     ResponseEntity<User> getUserByName(
         @ApiParam(value = "The name that needs to be fetched. Use user1 for testing.", required = true) @PathVariable("username") String username
     );
@@ -182,6 +187,7 @@ public interface UserController {
         value = "/user/login",
         produces = "application/json"
     )
+    
     ResponseEntity<String> loginUser(
         @NotNull @ApiParam(value = "The user name for login", required = true) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @ApiParam(value = "The password for login in clear text", required = true) @Valid @RequestParam(value = "password", required = true) String password
@@ -206,6 +212,7 @@ public interface UserController {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     ResponseEntity<Void> logoutUser(
         
     );
@@ -229,6 +236,7 @@ public interface UserController {
         method = RequestMethod.OPTIONS,
         value = "/user/logout"
     )
+    
     ResponseEntity<Void> logoutUserOptions(
         
     );
@@ -257,6 +265,7 @@ public interface UserController {
         method = RequestMethod.PUT,
         value = "/user/{username}"
     )
+    
     ResponseEntity<Void> updateUser(
         @ApiParam(value = "name that need to be deleted", required = true) @PathVariable("username") String username,
         @ApiParam(value = "Updated user object", required = true) @Valid @RequestBody User body

samples/client/petstore/spring-cloud/src/main/java/org/openapitools/api/PetApi.java

@@ -59,6 +59,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Pet> addPet(
         @ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     );
@@ -91,6 +92,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     ResponseEntity<Void> deletePet(
         @ApiParam(value = "Pet id to delete", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "") @RequestHeader(value = "api_key", required = false) String apiKey
@@ -127,6 +129,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @ApiParam(value = "Status values that need to be considered for filter", required = true, allowableValues = "available, pending, sold") @Valid @RequestParam(value = "status", required = true) @Deprecated List<String> status
     );
@@ -164,6 +167,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByTags(
         @NotNull @ApiParam(value = "Tags to filter by", required = true) @Valid @RequestParam(value = "tags", required = true) List<String> tags
     );
@@ -198,6 +202,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Pet> getPetById(
         @ApiParam(value = "ID of pet to return", required = true) @PathVariable("petId") Long petId
     );
@@ -240,6 +245,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Pet> updatePet(
         @ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     );
@@ -274,6 +280,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     ResponseEntity<Void> updatePetWithForm(
         @ApiParam(value = "ID of pet that needs to be updated", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -312,6 +319,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "multipart/form-data"
     )
+    
     ResponseEntity<ModelApiResponse> uploadFile(
         @ApiParam(value = "ID of pet to update", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/client/petstore/spring-cloud/src/main/java/org/openapitools/api/StoreApi.java

@@ -50,6 +50,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{orderId}"
     )
+    
     ResponseEntity<Void> deleteOrder(
         @ApiParam(value = "ID of the order that needs to be deleted", required = true) @PathVariable("orderId") String orderId
     );
@@ -80,6 +81,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = "application/json"
     )
+    
     ResponseEntity<Map<String, Integer>> getInventory(
         
     );
@@ -111,6 +113,7 @@ public interface StoreApi {
         value = "/store/order/{orderId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @ApiParam(value = "ID of pet that needs to be fetched", required = true) @PathVariable("orderId") Long orderId
     );
@@ -141,6 +144,7 @@ public interface StoreApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Order> placeOrder(
         @ApiParam(value = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     );

samples/client/petstore/spring-cloud/src/main/java/org/openapitools/api/UserApi.java

@@ -52,6 +52,7 @@ public interface UserApi {
         value = "/user",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUser(
         @ApiParam(value = "Created user object", required = true) @Valid @RequestBody User user
     );
@@ -81,6 +82,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUsersWithArrayInput(
         @ApiParam(value = "List of user object", required = true) @Valid @RequestBody List<User> user
     );
@@ -110,6 +112,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUsersWithListInput(
         @ApiParam(value = "List of user object", required = true) @Valid @RequestBody List<User> user
     );
@@ -140,6 +143,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     ResponseEntity<Void> deleteUser(
         @ApiParam(value = "The name that needs to be deleted", required = true) @PathVariable("username") String username
     );
@@ -171,6 +175,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = "application/json"
     )
+    
     ResponseEntity<User> getUserByName(
         @ApiParam(value = "The name that needs to be fetched. Use user1 for testing.", required = true) @PathVariable("username") String username
     );
@@ -201,6 +206,7 @@ public interface UserApi {
         value = "/user/login",
         produces = "application/json"
     )
+    
     ResponseEntity<String> loginUser(
         @NotNull @Pattern(regexp = "^[a-zA-Z0-9]+[a-zA-Z0-9\\.\\-_]*[a-zA-Z0-9]+$") @ApiParam(value = "The user name for login", required = true) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @ApiParam(value = "The password for login in clear text", required = true) @Valid @RequestParam(value = "password", required = true) String password
@@ -229,6 +235,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     ResponseEntity<Void> logoutUser(
         
     );
@@ -261,6 +268,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> updateUser(
         @ApiParam(value = "name that need to be deleted", required = true) @PathVariable("username") String username,
         @ApiParam(value = "Updated user object", required = true) @Valid @RequestBody User user

samples/openapi3/client/petstore/spring-cloud-3-with-optional/src/main/java/org/openapitools/api/PetApi.java

@@ -40,6 +40,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Pet> addPet(
          @Valid @RequestBody Pet pet
     );
@@ -57,6 +58,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     ResponseEntity<Void> deletePet(
          @PathVariable("petId") Long petId,
          @RequestHeader(value = "api_key", required = false) Optional<String> apiKey
@@ -76,6 +78,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull  @Valid @RequestParam(value = "status", required = true) @Deprecated List<String> status
     );
@@ -96,6 +99,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByTags(
         @NotNull  @Valid @RequestParam(value = "tags", required = true) List<String> tags
     );
@@ -115,6 +119,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Pet> getPetById(
          @PathVariable("petId") Long petId
     );
@@ -138,6 +143,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Pet> updatePet(
          @Valid @RequestBody Pet pet
     );
@@ -157,6 +163,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     ResponseEntity<Void> updatePetWithForm(
          @PathVariable("petId") Long petId,
          @Valid @RequestParam(value = "name", required = false) String name,
@@ -179,6 +186,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "multipart/form-data"
     )
+    
     ResponseEntity<ModelApiResponse> uploadFile(
          @PathVariable("petId") Long petId,
          @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/openapi3/client/petstore/spring-cloud-3-with-optional/src/main/java/org/openapitools/api/StoreApi.java

@@ -38,6 +38,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{orderId}"
     )
+    
     ResponseEntity<Void> deleteOrder(
          @PathVariable("orderId") String orderId
     );
@@ -54,6 +55,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = "application/json"
     )
+    
     ResponseEntity<Map<String, Integer>> getInventory(
         
     );
@@ -73,6 +75,7 @@ public interface StoreApi {
         value = "/store/order/{orderId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L)  @PathVariable("orderId") Long orderId
     );
@@ -92,6 +95,7 @@ public interface StoreApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Order> placeOrder(
          @Valid @RequestBody Order order
     );

samples/openapi3/client/petstore/spring-cloud-3-with-optional/src/main/java/org/openapitools/api/UserApi.java

@@ -38,6 +38,7 @@ public interface UserApi {
         value = "/user",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUser(
          @Valid @RequestBody User user
     );
@@ -55,6 +56,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUsersWithArrayInput(
          @Valid @RequestBody List<User> user
     );
@@ -72,6 +74,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUsersWithListInput(
          @Valid @RequestBody List<User> user
     );
@@ -89,6 +92,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     ResponseEntity<Void> deleteUser(
          @PathVariable("username") String username
     );
@@ -108,6 +112,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = "application/json"
     )
+    
     ResponseEntity<User> getUserByName(
          @PathVariable("username") String username
     );
@@ -127,6 +132,7 @@ public interface UserApi {
         value = "/user/login",
         produces = "application/json"
     )
+    
     ResponseEntity<String> loginUser(
         @NotNull @Pattern(regexp = "^[a-zA-Z0-9]+[a-zA-Z0-9\\.\\-_]*[a-zA-Z0-9]+$")  @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull  @Valid @RequestParam(value = "password", required = true) String password
@@ -143,6 +149,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     ResponseEntity<Void> logoutUser(
         
     );
@@ -162,6 +169,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> updateUser(
          @PathVariable("username") String username,
          @Valid @RequestBody User user

samples/openapi3/client/petstore/spring-cloud-3/src/main/java/org/openapitools/api/PetApi.java

@@ -68,6 +68,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Pet> addPet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     );
@@ -97,6 +98,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     ResponseEntity<Void> deletePet(
         @Parameter(name = "petId", description = "Pet id to delete", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "api_key", description = "", in = ParameterIn.HEADER) @RequestHeader(value = "api_key", required = false) String apiKey
@@ -132,6 +134,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @Parameter(name = "status", deprecated = true, description = "Status values that need to be considered for filter", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "status", required = true) @Deprecated List<String> status
     );
@@ -169,6 +172,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByTags(
         @NotNull @Parameter(name = "tags", description = "Tags to filter by", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "tags", required = true) List<String> tags
     );
@@ -205,6 +209,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Pet> getPetById(
         @Parameter(name = "petId", description = "ID of pet to return", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     );
@@ -247,6 +252,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Pet> updatePet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     );
@@ -278,6 +284,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     ResponseEntity<Void> updatePetWithForm(
         @Parameter(name = "petId", description = "ID of pet that needs to be updated", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "name", description = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -314,6 +321,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "multipart/form-data"
     )
+    
     ResponseEntity<ModelApiResponse> uploadFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "additionalMetadata", description = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/openapi3/client/petstore/spring-cloud-3/src/main/java/org/openapitools/api/StoreApi.java

@@ -60,6 +60,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{orderId}"
     )
+    
     ResponseEntity<Void> deleteOrder(
         @Parameter(name = "orderId", description = "ID of the order that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("orderId") String orderId
     );
@@ -90,6 +91,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = "application/json"
     )
+    
     ResponseEntity<Map<String, Integer>> getInventory(
         
     );
@@ -123,6 +125,7 @@ public interface StoreApi {
         value = "/store/order/{orderId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @Parameter(name = "orderId", description = "ID of pet that needs to be fetched", required = true, in = ParameterIn.PATH) @PathVariable("orderId") Long orderId
     );
@@ -155,6 +158,7 @@ public interface StoreApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Order> placeOrder(
         @Parameter(name = "Order", description = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     );

samples/openapi3/client/petstore/spring-cloud-3/src/main/java/org/openapitools/api/UserApi.java

@@ -62,6 +62,7 @@ public interface UserApi {
         value = "/user",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUser(
         @Parameter(name = "User", description = "Created user object", required = true) @Valid @RequestBody User user
     );
@@ -91,6 +92,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUsersWithArrayInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     );
@@ -120,6 +122,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUsersWithListInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     );
@@ -150,6 +153,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     ResponseEntity<Void> deleteUser(
         @Parameter(name = "username", description = "The name that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     );
@@ -183,6 +187,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = "application/json"
     )
+    
     ResponseEntity<User> getUserByName(
         @Parameter(name = "username", description = "The name that needs to be fetched. Use user1 for testing.", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     );
@@ -215,6 +220,7 @@ public interface UserApi {
         value = "/user/login",
         produces = "application/json"
     )
+    
     ResponseEntity<String> loginUser(
         @NotNull @Pattern(regexp = "^[a-zA-Z0-9]+[a-zA-Z0-9\\.\\-_]*[a-zA-Z0-9]+$") @Parameter(name = "username", description = "The user name for login", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @Parameter(name = "password", description = "The password for login in clear text", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "password", required = true) String password
@@ -243,6 +249,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     ResponseEntity<Void> logoutUser(
         
     );
@@ -275,6 +282,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> updateUser(
         @Parameter(name = "username", description = "name that need to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username,
         @Parameter(name = "User", description = "Updated user object", required = true) @Valid @RequestBody User user

samples/openapi3/client/petstore/spring-cloud-async/src/main/java/org/openapitools/api/PetApi.java

@@ -69,6 +69,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     CompletableFuture<ResponseEntity<Pet>> addPet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     );
@@ -98,6 +99,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     CompletableFuture<ResponseEntity<Void>> deletePet(
         @Parameter(name = "petId", description = "Pet id to delete", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "api_key", description = "", in = ParameterIn.HEADER) @RequestHeader(value = "api_key", required = false) String apiKey
@@ -133,6 +135,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = "application/json"
     )
+    
     CompletableFuture<ResponseEntity<List<Pet>>> findPetsByStatus(
         @NotNull @Parameter(name = "status", deprecated = true, description = "Status values that need to be considered for filter", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "status", required = true) @Deprecated List<String> status
     );
@@ -170,6 +173,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = "application/json"
     )
+    
     CompletableFuture<ResponseEntity<List<Pet>>> findPetsByTags(
         @NotNull @Parameter(name = "tags", description = "Tags to filter by", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "tags", required = true) List<String> tags
     );
@@ -206,6 +210,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = "application/json"
     )
+    
     CompletableFuture<ResponseEntity<Pet>> getPetById(
         @Parameter(name = "petId", description = "ID of pet to return", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     );
@@ -248,6 +253,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     CompletableFuture<ResponseEntity<Pet>> updatePet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     );
@@ -279,6 +285,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     CompletableFuture<ResponseEntity<Void>> updatePetWithForm(
         @Parameter(name = "petId", description = "ID of pet that needs to be updated", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "name", description = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -315,6 +322,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "multipart/form-data"
     )
+    
     CompletableFuture<ResponseEntity<ModelApiResponse>> uploadFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "additionalMetadata", description = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/openapi3/client/petstore/spring-cloud-async/src/main/java/org/openapitools/api/StoreApi.java

@@ -61,6 +61,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{orderId}"
     )
+    
     CompletableFuture<ResponseEntity<Void>> deleteOrder(
         @Parameter(name = "orderId", description = "ID of the order that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("orderId") String orderId
     );
@@ -91,6 +92,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = "application/json"
     )
+    
     CompletableFuture<ResponseEntity<Map<String, Integer>>> getInventory(
         
     );
@@ -124,6 +126,7 @@ public interface StoreApi {
         value = "/store/order/{orderId}",
         produces = "application/json"
     )
+    
     CompletableFuture<ResponseEntity<Order>> getOrderById(
         @Min(1L) @Max(5L) @Parameter(name = "orderId", description = "ID of pet that needs to be fetched", required = true, in = ParameterIn.PATH) @PathVariable("orderId") Long orderId
     );
@@ -156,6 +159,7 @@ public interface StoreApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     CompletableFuture<ResponseEntity<Order>> placeOrder(
         @Parameter(name = "Order", description = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     );

samples/openapi3/client/petstore/spring-cloud-async/src/main/java/org/openapitools/api/UserApi.java

@@ -63,6 +63,7 @@ public interface UserApi {
         value = "/user",
         consumes = "application/json"
     )
+    
     CompletableFuture<ResponseEntity<Void>> createUser(
         @Parameter(name = "User", description = "Created user object", required = true) @Valid @RequestBody User user
     );
@@ -92,6 +93,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = "application/json"
     )
+    
     CompletableFuture<ResponseEntity<Void>> createUsersWithArrayInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     );
@@ -121,6 +123,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = "application/json"
     )
+    
     CompletableFuture<ResponseEntity<Void>> createUsersWithListInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     );
@@ -151,6 +154,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     CompletableFuture<ResponseEntity<Void>> deleteUser(
         @Parameter(name = "username", description = "The name that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     );
@@ -184,6 +188,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = "application/json"
     )
+    
     CompletableFuture<ResponseEntity<User>> getUserByName(
         @Parameter(name = "username", description = "The name that needs to be fetched. Use user1 for testing.", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     );
@@ -216,6 +221,7 @@ public interface UserApi {
         value = "/user/login",
         produces = "application/json"
     )
+    
     CompletableFuture<ResponseEntity<String>> loginUser(
         @NotNull @Pattern(regexp = "^[a-zA-Z0-9]+[a-zA-Z0-9\\.\\-_]*[a-zA-Z0-9]+$") @Parameter(name = "username", description = "The user name for login", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @Parameter(name = "password", description = "The password for login in clear text", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "password", required = true) String password
@@ -244,6 +250,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     CompletableFuture<ResponseEntity<Void>> logoutUser(
         
     );
@@ -276,6 +283,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = "application/json"
     )
+    
     CompletableFuture<ResponseEntity<Void>> updateUser(
         @Parameter(name = "username", description = "name that need to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username,
         @Parameter(name = "User", description = "Updated user object", required = true) @Valid @RequestBody User user

samples/openapi3/client/petstore/spring-cloud-date-time/src/main/java/org/openapitools/api/DefaultApi.java

@@ -58,6 +58,7 @@ public interface DefaultApi {
         method = RequestMethod.GET,
         value = "/thingy/{date}"
     )
+    
     ResponseEntity<Void> get(
         @Parameter(name = "date", description = "A date path parameter", required = true, in = ParameterIn.PATH) @PathVariable("date") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date,
         @NotNull @Parameter(name = "dateTime", description = "A date-time query parameter", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "dateTime", required = true, defaultValue = "1973-12-19T03:39:57-08:00") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME) OffsetDateTime dateTime,
@@ -86,6 +87,7 @@ public interface DefaultApi {
         value = "/thingy/{date}",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     ResponseEntity<Void> updatePetWithForm(
         @Parameter(name = "date", description = "A date path parameter", required = true, in = ParameterIn.PATH) @PathVariable("date") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date,
         @Parameter(name = "visitDate", description = "Updated last visit timestamp") @Valid @RequestParam(value = "visitDate", required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME) OffsetDateTime visitDate

samples/openapi3/client/petstore/spring-cloud-oas3-fakeapi/src/main/java/org/openapitools/api/AnotherFakeApi.java

@@ -61,6 +61,7 @@ public interface AnotherFakeApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Client> call123testSpecialTags(
         @Parameter(name = "Client", description = "client model", required = true) @Valid @RequestBody Client client
     );

samples/openapi3/client/petstore/spring-cloud-oas3-fakeapi/src/main/java/org/openapitools/api/FakeApi.java

@@ -68,6 +68,7 @@ public interface FakeApi {
         value = "/fake/create_xml_item",
         consumes = "application/xml"
     )
+    
     ResponseEntity<Void> createXmlItem(
         @Parameter(name = "XmlItem", description = "XmlItem Body", required = true) @Valid @RequestBody XmlItem xmlItem
     );
@@ -96,6 +97,7 @@ public interface FakeApi {
         produces = "*/*",
         consumes = "application/json"
     )
+    
     ResponseEntity<Boolean> fakeOuterBooleanSerialize(
         @Parameter(name = "body", description = "Input boolean as post body") @Valid @RequestBody(required = false) Boolean body
     );
@@ -124,6 +126,7 @@ public interface FakeApi {
         produces = "*/*",
         consumes = "application/json"
     )
+    
     ResponseEntity<OuterComposite> fakeOuterCompositeSerialize(
         @Parameter(name = "OuterComposite", description = "Input composite as post body") @Valid @RequestBody(required = false) OuterComposite outerComposite
     );
@@ -152,6 +155,7 @@ public interface FakeApi {
         produces = "*/*",
         consumes = "application/json"
     )
+    
     ResponseEntity<BigDecimal> fakeOuterNumberSerialize(
         @Parameter(name = "body", description = "Input number as post body") @Valid @RequestBody(required = false) BigDecimal body
     );
@@ -180,6 +184,7 @@ public interface FakeApi {
         produces = "*/*",
         consumes = "application/json"
     )
+    
     ResponseEntity<String> fakeOuterStringSerialize(
         @Parameter(name = "body", description = "Input string as post body") @Valid @RequestBody(required = false) String body
     );
@@ -205,6 +210,7 @@ public interface FakeApi {
         value = "/fake/body-with-file-schema",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> testBodyWithFileSchema(
         @Parameter(name = "FileSchemaTestClass", description = "", required = true) @Valid @RequestBody FileSchemaTestClass fileSchemaTestClass
     );
@@ -229,6 +235,7 @@ public interface FakeApi {
         value = "/fake/body-with-query-params",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> testBodyWithQueryParams(
         @NotNull @Parameter(name = "query", description = "", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "query", required = true) String query,
         @Parameter(name = "User", description = "", required = true) @Valid @RequestBody User user
@@ -259,6 +266,7 @@ public interface FakeApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Client> testClientModel(
         @Parameter(name = "Client", description = "client model", required = true) @Valid @RequestBody Client client
     );
@@ -303,6 +311,7 @@ public interface FakeApi {
         value = "/fake",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     ResponseEntity<Void> testEndpointParameters(
         @Parameter(name = "number", description = "None", required = true) @Valid @RequestParam(value = "number", required = true) BigDecimal number,
         @Parameter(name = "double", description = "None", required = true) @Valid @RequestParam(value = "double", required = true) Double _double,
@@ -351,6 +360,7 @@ public interface FakeApi {
         value = "/fake",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     ResponseEntity<Void> testEnumParameters(
         @Parameter(name = "enum_header_string_array", description = "Header parameter enum test (string array)", in = ParameterIn.HEADER) @RequestHeader(value = "enum_header_string_array", required = false) List<String> enumHeaderStringArray,
         @Parameter(name = "enum_header_string", description = "Header parameter enum test (string)", in = ParameterIn.HEADER) @RequestHeader(value = "enum_header_string", required = false, defaultValue = "-efg") String enumHeaderString,
@@ -388,6 +398,7 @@ public interface FakeApi {
         method = RequestMethod.DELETE,
         value = "/fake"
     )
+    
     ResponseEntity<Void> testGroupParameters(
         @NotNull @Parameter(name = "required_string_group", description = "Required String in group parameters", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "required_string_group", required = true) Integer requiredStringGroup,
         @NotNull @Parameter(name = "required_boolean_group", description = "Required Boolean in group parameters", required = true, in = ParameterIn.HEADER) @RequestHeader(value = "required_boolean_group", required = true) Boolean requiredBooleanGroup,
@@ -419,6 +430,7 @@ public interface FakeApi {
         value = "/fake/inline-additionalProperties",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> testInlineAdditionalProperties(
         @Parameter(name = "request_body", description = "request body", required = true) @Valid @RequestBody Map<String, String> requestBody
     );
@@ -446,6 +458,7 @@ public interface FakeApi {
         value = "/fake/jsonFormData",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     ResponseEntity<Void> testJsonFormData(
         @Parameter(name = "param", description = "field1", required = true) @Valid @RequestParam(value = "param", required = true) String param,
         @Parameter(name = "param2", description = "field2", required = true) @Valid @RequestParam(value = "param2", required = true) String param2
@@ -500,6 +513,7 @@ public interface FakeApi {
         method = RequestMethod.PUT,
         value = "/fake/test-query-parameters"
     )
+    
     ResponseEntity<Void> testQueryParameterCollectionFormat(
         @NotNull @Parameter(name = "pipe", description = "", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "pipe", required = true) List<String> pipe,
         @NotNull @Parameter(name = "http", description = "", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "http", required = true) List<String> http,
@@ -529,6 +543,7 @@ public interface FakeApi {
         value = "/fake/response-with-example",
         produces = "application/json"
     )
+    
     ResponseEntity<Integer> testWithResultExample(
         
     );

samples/openapi3/client/petstore/spring-cloud-oas3-fakeapi/src/main/java/org/openapitools/api/FakeClassnameTags123Api.java

@@ -64,6 +64,7 @@ public interface FakeClassnameTags123Api {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Client> testClassname(
         @Parameter(name = "Client", description = "client model", required = true) @Valid @RequestBody Client client
     );

samples/openapi3/client/petstore/spring-cloud-oas3-fakeapi/src/main/java/org/openapitools/api/PetApi.java

@@ -66,6 +66,7 @@ public interface PetApi {
         value = "/pet",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> addPet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     );
@@ -97,6 +98,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     ResponseEntity<Void> deletePet(
         @Parameter(name = "petId", description = "Pet id to delete", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "api_key", description = "", in = ParameterIn.HEADER) @RequestHeader(value = "api_key", required = false) String apiKey
@@ -132,6 +134,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @Parameter(name = "status", description = "Status values that need to be considered for filter", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "status", required = true) List<String> status
     );
@@ -169,6 +172,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = "application/json"
     )
+    
     ResponseEntity<Set<Pet>> findPetsByTags(
         @NotNull @Parameter(name = "tags", description = "Tags to filter by", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "tags", required = true) Set<String> tags
     );
@@ -205,6 +209,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Pet> getPetById(
         @Parameter(name = "petId", description = "ID of pet to return", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     );
@@ -230,6 +235,7 @@ public interface PetApi {
         value = "/fake/{petId}/response-object-different-names",
         produces = "application/json"
     )
+    
     ResponseEntity<ResponseObjectWithDifferentFieldNames> responseObjectDifferentNames(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     );
@@ -265,6 +271,7 @@ public interface PetApi {
         value = "/pet",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> updatePet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     );
@@ -296,6 +303,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     ResponseEntity<Void> updatePetWithForm(
         @Parameter(name = "petId", description = "ID of pet that needs to be updated", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "name", description = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -332,6 +340,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "multipart/form-data"
     )
+    
     ResponseEntity<ModelApiResponse> uploadFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "additionalMetadata", description = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,
@@ -368,6 +377,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "multipart/form-data"
     )
+    
     ResponseEntity<ModelApiResponse> uploadFileWithRequiredFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "requiredFile", description = "file to upload", required = true) @RequestPart(value = "requiredFile", required = true) MultipartFile requiredFile,

samples/openapi3/client/petstore/spring-cloud-oas3-fakeapi/src/main/java/org/openapitools/api/StoreApi.java

@@ -60,6 +60,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{order_id}"
     )
+    
     ResponseEntity<Void> deleteOrder(
         @Parameter(name = "order_id", description = "ID of the order that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("order_id") String orderId
     );
@@ -90,6 +91,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = "application/json"
     )
+    
     ResponseEntity<Map<String, Integer>> getInventory(
         
     );
@@ -123,6 +125,7 @@ public interface StoreApi {
         value = "/store/order/{order_id}",
         produces = "application/json"
     )
+    
     ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @Parameter(name = "order_id", description = "ID of pet that needs to be fetched", required = true, in = ParameterIn.PATH) @PathVariable("order_id") Long orderId
     );
@@ -155,6 +158,7 @@ public interface StoreApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Order> placeOrder(
         @Parameter(name = "Order", description = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     );

samples/openapi3/client/petstore/spring-cloud-oas3-fakeapi/src/main/java/org/openapitools/api/UserApi.java

@@ -59,6 +59,7 @@ public interface UserApi {
         value = "/user",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUser(
         @Parameter(name = "User", description = "Created user object", required = true) @Valid @RequestBody User user
     );
@@ -85,6 +86,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUsersWithArrayInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     );
@@ -111,6 +113,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUsersWithListInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     );
@@ -138,6 +141,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     ResponseEntity<Void> deleteUser(
         @Parameter(name = "username", description = "The name that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     );
@@ -171,6 +175,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = "application/json"
     )
+    
     ResponseEntity<User> getUserByName(
         @Parameter(name = "username", description = "The name that needs to be fetched. Use user1 for testing.", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     );
@@ -203,6 +208,7 @@ public interface UserApi {
         value = "/user/login",
         produces = "application/json"
     )
+    
     ResponseEntity<String> loginUser(
         @NotNull @Parameter(name = "username", description = "The user name for login", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @Parameter(name = "password", description = "The password for login in clear text", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "password", required = true) String password
@@ -228,6 +234,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     ResponseEntity<Void> logoutUser(
         
     );
@@ -257,6 +264,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> updateUser(
         @Parameter(name = "username", description = "name that need to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username,
         @Parameter(name = "User", description = "Updated user object", required = true) @Valid @RequestBody User user

samples/openapi3/client/petstore/spring-cloud-spring-pageable/src/main/java/org/openapitools/api/PetApi.java

@@ -62,6 +62,7 @@ public interface PetApi {
         value = "/pet",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> addPet(
         @Parameter(name = "body", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet body
     );
@@ -89,6 +90,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     ResponseEntity<Void> deletePet(
         @Parameter(name = "petId", description = "Pet id to delete", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "api_key", description = "", in = ParameterIn.HEADER) @RequestHeader(value = "api_key", required = false) String apiKey
@@ -124,6 +126,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @Parameter(name = "status", description = "Status values that need to be considered for filter", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "status", required = true) List<String> status,
         @ParameterObject final Pageable pageable
@@ -162,6 +165,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByTags(
         @NotNull @Parameter(name = "tags", description = "Tags to filter by", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "tags", required = true) List<String> tags,
         @ParameterObject final Pageable pageable
@@ -199,6 +203,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Pet> getPetById(
         @Parameter(name = "petId", description = "ID of pet to return", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     );
@@ -230,6 +235,7 @@ public interface PetApi {
         value = "/pet",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> updatePet(
         @Parameter(name = "body", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet body
     );
@@ -259,6 +265,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     ResponseEntity<Void> updatePetWithForm(
         @Parameter(name = "petId", description = "ID of pet that needs to be updated", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "name", description = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -293,6 +300,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "multipart/form-data"
     )
+    
     ResponseEntity<ModelApiResponse> uploadFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "additionalMetadata", description = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/openapi3/client/petstore/spring-cloud-spring-pageable/src/main/java/org/openapitools/api/StoreApi.java

@@ -60,6 +60,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{orderId}"
     )
+    
     ResponseEntity<Void> deleteOrder(
         @Parameter(name = "orderId", description = "ID of the order that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("orderId") String orderId
     );
@@ -90,6 +91,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = "application/json"
     )
+    
     ResponseEntity<Map<String, Integer>> getInventory(
         
     );
@@ -123,6 +125,7 @@ public interface StoreApi {
         value = "/store/order/{orderId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @Parameter(name = "orderId", description = "ID of pet that needs to be fetched", required = true, in = ParameterIn.PATH) @PathVariable("orderId") Long orderId
     );
@@ -152,6 +155,7 @@ public interface StoreApi {
         value = "/store/order",
         produces = "application/json"
     )
+    
     ResponseEntity<Order> placeOrder(
         @Parameter(name = "body", description = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order body
     );

samples/openapi3/client/petstore/spring-cloud-spring-pageable/src/main/java/org/openapitools/api/UserApi.java

@@ -58,6 +58,7 @@ public interface UserApi {
         method = RequestMethod.POST,
         value = "/user"
     )
+    
     ResponseEntity<Void> createUser(
         @Parameter(name = "body", description = "Created user object", required = true) @Valid @RequestBody User body
     );
@@ -81,6 +82,7 @@ public interface UserApi {
         method = RequestMethod.POST,
         value = "/user/createWithArray"
     )
+    
     ResponseEntity<Void> createUsersWithArrayInput(
         @Parameter(name = "body", description = "List of user object", required = true) @Valid @RequestBody List<User> body
     );
@@ -104,6 +106,7 @@ public interface UserApi {
         method = RequestMethod.POST,
         value = "/user/createWithList"
     )
+    
     ResponseEntity<Void> createUsersWithListInput(
         @Parameter(name = "body", description = "List of user object", required = true) @Valid @RequestBody List<User> body
     );
@@ -131,6 +134,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     ResponseEntity<Void> deleteUser(
         @Parameter(name = "username", description = "The name that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     );
@@ -162,6 +166,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = "application/json"
     )
+    
     ResponseEntity<User> getUserByName(
         @Parameter(name = "username", description = "The name that needs to be fetched. Use user1 for testing.", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     );
@@ -192,6 +197,7 @@ public interface UserApi {
         value = "/user/login",
         produces = "application/json"
     )
+    
     ResponseEntity<String> loginUser(
         @NotNull @Parameter(name = "username", description = "The user name for login", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @Parameter(name = "password", description = "The password for login in clear text", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "password", required = true) String password
@@ -215,6 +221,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     ResponseEntity<Void> logoutUser(
         
     );
@@ -237,6 +244,7 @@ public interface UserApi {
         method = RequestMethod.OPTIONS,
         value = "/user/logout"
     )
+    
     ResponseEntity<Void> logoutUserOptions(
         
     );
@@ -265,6 +273,7 @@ public interface UserApi {
         method = RequestMethod.PUT,
         value = "/user/{username}"
     )
+    
     ResponseEntity<Void> updateUser(
         @Parameter(name = "username", description = "name that need to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username,
         @Parameter(name = "body", description = "Updated user object", required = true) @Valid @RequestBody User body

samples/openapi3/client/petstore/spring-cloud/src/main/java/org/openapitools/api/PetApi.java

@@ -68,6 +68,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Pet> addPet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     );
@@ -97,6 +98,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     ResponseEntity<Void> deletePet(
         @Parameter(name = "petId", description = "Pet id to delete", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "api_key", description = "", in = ParameterIn.HEADER) @RequestHeader(value = "api_key", required = false) String apiKey
@@ -132,6 +134,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @Parameter(name = "status", deprecated = true, description = "Status values that need to be considered for filter", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "status", required = true) @Deprecated List<String> status
     );
@@ -169,6 +172,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByTags(
         @NotNull @Parameter(name = "tags", description = "Tags to filter by", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "tags", required = true) List<String> tags
     );
@@ -205,6 +209,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Pet> getPetById(
         @Parameter(name = "petId", description = "ID of pet to return", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     );
@@ -247,6 +252,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Pet> updatePet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     );
@@ -278,6 +284,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     ResponseEntity<Void> updatePetWithForm(
         @Parameter(name = "petId", description = "ID of pet that needs to be updated", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "name", description = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -314,6 +321,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "multipart/form-data"
     )
+    
     ResponseEntity<ModelApiResponse> uploadFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "additionalMetadata", description = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/openapi3/client/petstore/spring-cloud/src/main/java/org/openapitools/api/StoreApi.java

@@ -60,6 +60,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{orderId}"
     )
+    
     ResponseEntity<Void> deleteOrder(
         @Parameter(name = "orderId", description = "ID of the order that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("orderId") String orderId
     );
@@ -90,6 +91,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = "application/json"
     )
+    
     ResponseEntity<Map<String, Integer>> getInventory(
         
     );
@@ -123,6 +125,7 @@ public interface StoreApi {
         value = "/store/order/{orderId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @Parameter(name = "orderId", description = "ID of pet that needs to be fetched", required = true, in = ParameterIn.PATH) @PathVariable("orderId") Long orderId
     );
@@ -155,6 +158,7 @@ public interface StoreApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Order> placeOrder(
         @Parameter(name = "Order", description = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     );

samples/openapi3/client/petstore/spring-cloud/src/main/java/org/openapitools/api/UserApi.java

@@ -62,6 +62,7 @@ public interface UserApi {
         value = "/user",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUser(
         @Parameter(name = "User", description = "Created user object", required = true) @Valid @RequestBody User user
     );
@@ -91,6 +92,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUsersWithArrayInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     );
@@ -120,6 +122,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUsersWithListInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     );
@@ -150,6 +153,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     ResponseEntity<Void> deleteUser(
         @Parameter(name = "username", description = "The name that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     );
@@ -183,6 +187,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = "application/json"
     )
+    
     ResponseEntity<User> getUserByName(
         @Parameter(name = "username", description = "The name that needs to be fetched. Use user1 for testing.", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     );
@@ -215,6 +220,7 @@ public interface UserApi {
         value = "/user/login",
         produces = "application/json"
     )
+    
     ResponseEntity<String> loginUser(
         @NotNull @Pattern(regexp = "^[a-zA-Z0-9]+[a-zA-Z0-9\\.\\-_]*[a-zA-Z0-9]+$") @Parameter(name = "username", description = "The user name for login", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @Parameter(name = "password", description = "The password for login in clear text", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "password", required = true) String password
@@ -243,6 +249,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     ResponseEntity<Void> logoutUser(
         
     );
@@ -275,6 +282,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> updateUser(
         @Parameter(name = "username", description = "name that need to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username,
         @Parameter(name = "User", description = "Updated user object", required = true) @Valid @RequestBody User user

samples/openapi3/client/petstore/spring-stubs-skip-default-interface/src/main/java/org/openapitools/api/PetApi.java

@@ -68,6 +68,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Pet> addPet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) throws Exception;
@@ -97,6 +98,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     ResponseEntity<Void> deletePet(
         @Parameter(name = "petId", description = "Pet id to delete", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "api_key", description = "", in = ParameterIn.HEADER) @RequestHeader(value = "api_key", required = false) String apiKey
@@ -132,6 +134,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @Parameter(name = "status", deprecated = true, description = "Status values that need to be considered for filter", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "status", required = true) @Deprecated List<String> status
     ) throws Exception;
@@ -169,6 +172,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = "application/json"
     )
+    
     ResponseEntity<List<Pet>> findPetsByTags(
         @NotNull @Parameter(name = "tags", description = "Tags to filter by", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "tags", required = true) List<String> tags
     ) throws Exception;
@@ -205,6 +209,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Pet> getPetById(
         @Parameter(name = "petId", description = "ID of pet to return", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     ) throws Exception;
@@ -247,6 +252,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Pet> updatePet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) throws Exception;
@@ -278,6 +284,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     ResponseEntity<Void> updatePetWithForm(
         @Parameter(name = "petId", description = "ID of pet that needs to be updated", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "name", description = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -314,6 +321,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "multipart/form-data"
     )
+    
     ResponseEntity<ModelApiResponse> uploadFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "additionalMetadata", description = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/openapi3/client/petstore/spring-stubs-skip-default-interface/src/main/java/org/openapitools/api/StoreApi.java

@@ -60,6 +60,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{orderId}"
     )
+    
     ResponseEntity<Void> deleteOrder(
         @Parameter(name = "orderId", description = "ID of the order that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("orderId") String orderId
     ) throws Exception;
@@ -90,6 +91,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = "application/json"
     )
+    
     ResponseEntity<Map<String, Integer>> getInventory(
         
     ) throws Exception;
@@ -123,6 +125,7 @@ public interface StoreApi {
         value = "/store/order/{orderId}",
         produces = "application/json"
     )
+    
     ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @Parameter(name = "orderId", description = "ID of pet that needs to be fetched", required = true, in = ParameterIn.PATH) @PathVariable("orderId") Long orderId
     ) throws Exception;
@@ -155,6 +158,7 @@ public interface StoreApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     ResponseEntity<Order> placeOrder(
         @Parameter(name = "Order", description = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     ) throws Exception;

samples/openapi3/client/petstore/spring-stubs-skip-default-interface/src/main/java/org/openapitools/api/UserApi.java

@@ -62,6 +62,7 @@ public interface UserApi {
         value = "/user",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUser(
         @Parameter(name = "User", description = "Created user object", required = true) @Valid @RequestBody User user
     ) throws Exception;
@@ -91,6 +92,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUsersWithArrayInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) throws Exception;
@@ -120,6 +122,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> createUsersWithListInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) throws Exception;
@@ -150,6 +153,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     ResponseEntity<Void> deleteUser(
         @Parameter(name = "username", description = "The name that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) throws Exception;
@@ -183,6 +187,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = "application/json"
     )
+    
     ResponseEntity<User> getUserByName(
         @Parameter(name = "username", description = "The name that needs to be fetched. Use user1 for testing.", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) throws Exception;
@@ -215,6 +220,7 @@ public interface UserApi {
         value = "/user/login",
         produces = "application/json"
     )
+    
     ResponseEntity<String> loginUser(
         @NotNull @Pattern(regexp = "^[a-zA-Z0-9]+[a-zA-Z0-9\\.\\-_]*[a-zA-Z0-9]+$") @Parameter(name = "username", description = "The user name for login", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @Parameter(name = "password", description = "The password for login in clear text", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "password", required = true) String password
@@ -243,6 +249,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     ResponseEntity<Void> logoutUser(
         
     ) throws Exception;
@@ -275,6 +282,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = "application/json"
     )
+    
     ResponseEntity<Void> updateUser(
         @Parameter(name = "username", description = "name that need to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username,
         @Parameter(name = "User", description = "Updated user object", required = true) @Valid @RequestBody User user

samples/openapi3/client/petstore/spring-stubs/src/main/java/org/openapitools/api/PetApi.java

@@ -72,6 +72,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     default ResponseEntity<Pet> addPet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -118,6 +119,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     default ResponseEntity<Void> deletePet(
         @Parameter(name = "petId", description = "Pet id to delete", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "api_key", description = "", in = ParameterIn.HEADER) @RequestHeader(value = "api_key", required = false) String apiKey
@@ -156,6 +158,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = "application/json"
     )
+    
     default ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @Parameter(name = "status", deprecated = true, description = "Status values that need to be considered for filter", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "status", required = true) @Deprecated List<String> status
     ) {
@@ -210,6 +213,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = "application/json"
     )
+    
     default ResponseEntity<List<Pet>> findPetsByTags(
         @NotNull @Parameter(name = "tags", description = "Tags to filter by", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "tags", required = true) List<String> tags
     ) {
@@ -263,6 +267,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = "application/json"
     )
+    
     default ResponseEntity<Pet> getPetById(
         @Parameter(name = "petId", description = "ID of pet to return", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     ) {
@@ -322,6 +327,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     default ResponseEntity<Pet> updatePet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -370,6 +376,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = "application/x-www-form-urlencoded"
     )
+    
     default ResponseEntity<Void> updatePetWithForm(
         @Parameter(name = "petId", description = "ID of pet that needs to be updated", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "name", description = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -409,6 +416,7 @@ public interface PetApi {
         produces = "application/json",
         consumes = "multipart/form-data"
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "additionalMetadata", description = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/openapi3/client/petstore/spring-stubs/src/main/java/org/openapitools/api/StoreApi.java

@@ -64,6 +64,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{orderId}"
     )
+    
     default ResponseEntity<Void> deleteOrder(
         @Parameter(name = "orderId", description = "ID of the order that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("orderId") String orderId
     ) {
@@ -97,6 +98,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = "application/json"
     )
+    
     default ResponseEntity<Map<String, Integer>> getInventory(
         
     ) {
@@ -133,6 +135,7 @@ public interface StoreApi {
         value = "/store/order/{orderId}",
         produces = "application/json"
     )
+    
     default ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @Parameter(name = "orderId", description = "ID of pet that needs to be fetched", required = true, in = ParameterIn.PATH) @PathVariable("orderId") Long orderId
     ) {
@@ -182,6 +185,7 @@ public interface StoreApi {
         produces = "application/json",
         consumes = "application/json"
     )
+    
     default ResponseEntity<Order> placeOrder(
         @Parameter(name = "Order", description = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     ) {

samples/openapi3/client/petstore/spring-stubs/src/main/java/org/openapitools/api/UserApi.java

@@ -66,6 +66,7 @@ public interface UserApi {
         value = "/user",
         consumes = "application/json"
     )
+    
     default ResponseEntity<Void> createUser(
         @Parameter(name = "User", description = "Created user object", required = true) @Valid @RequestBody User user
     ) {
@@ -98,6 +99,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = "application/json"
     )
+    
     default ResponseEntity<Void> createUsersWithArrayInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -130,6 +132,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = "application/json"
     )
+    
     default ResponseEntity<Void> createUsersWithListInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -163,6 +166,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     default ResponseEntity<Void> deleteUser(
         @Parameter(name = "username", description = "The name that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) {
@@ -199,6 +203,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = "application/json"
     )
+    
     default ResponseEntity<User> getUserByName(
         @Parameter(name = "username", description = "The name that needs to be fetched. Use user1 for testing.", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) {
@@ -248,6 +253,7 @@ public interface UserApi {
         value = "/user/login",
         produces = "application/json"
     )
+    
     default ResponseEntity<String> loginUser(
         @NotNull @Pattern(regexp = "^[a-zA-Z0-9]+[a-zA-Z0-9\\.\\-_]*[a-zA-Z0-9]+$") @Parameter(name = "username", description = "The user name for login", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @Parameter(name = "password", description = "The password for login in clear text", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "password", required = true) String password
@@ -279,6 +285,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     default ResponseEntity<Void> logoutUser(
         
     ) {
@@ -314,6 +321,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = "application/json"
     )
+    
     default ResponseEntity<Void> updateUser(
         @Parameter(name = "username", description = "name that need to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username,
         @Parameter(name = "User", description = "Updated user object", required = true) @Valid @RequestBody User user

samples/openapi3/server/petstore/spring-boot-oneof/src/main/java/org/openapitools/api/BarApi.java

@@ -64,6 +64,7 @@ public interface BarApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Bar> createBar(
         @Parameter(name = "BarCreate", description = "", required = true) @Valid @RequestBody BarCreate barCreate
     ) {

samples/openapi3/server/petstore/spring-boot-oneof/src/main/java/org/openapitools/api/FooApi.java

@@ -64,6 +64,7 @@ public interface FooApi {
         produces = { "application/json" },
         consumes = { "application/json;charset=utf-8" }
     )
+    
     default ResponseEntity<FooRefOrValue> createFoo(
         @Parameter(name = "Foo", description = "The Foo to be created") @Valid @RequestBody(required = false) Foo foo
     ) {
@@ -101,6 +102,7 @@ public interface FooApi {
         value = "/foo",
         produces = { "application/json;charset=utf-8" }
     )
+    
     default ResponseEntity<List<FooRefOrValue>> getAllFoos(
         
     ) {

samples/openapi3/server/petstore/spring-boot-springdoc/src/main/java/org/openapitools/api/PetApi.java

@@ -72,6 +72,7 @@ public interface PetApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Pet> addPet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -118,6 +119,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     default ResponseEntity<Void> deletePet(
         @Parameter(name = "petId", description = "Pet id to delete", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "api_key", description = "", in = ParameterIn.HEADER) @RequestHeader(value = "api_key", required = false) String apiKey
@@ -156,6 +158,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @Parameter(name = "status", deprecated = true, description = "Status values that need to be considered for filter", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "status", required = true) @Deprecated List<String> status
     ) {
@@ -210,6 +213,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<List<Pet>> findPetsByTags(
         @NotNull @Parameter(name = "tags", description = "Tags to filter by", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "tags", required = true) List<String> tags
     ) {
@@ -263,6 +267,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Pet> getPetById(
         @Parameter(name = "petId", description = "ID of pet to return", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     ) {
@@ -322,6 +327,7 @@ public interface PetApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Pet> updatePet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -370,6 +376,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> updatePetWithForm(
         @Parameter(name = "petId", description = "ID of pet that needs to be updated", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "name", description = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -409,6 +416,7 @@ public interface PetApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "additionalMetadata", description = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/openapi3/server/petstore/spring-boot-springdoc/src/main/java/org/openapitools/api/StoreApi.java

@@ -64,6 +64,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{orderId}"
     )
+    
     default ResponseEntity<Void> deleteOrder(
         @Parameter(name = "orderId", description = "ID of the order that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("orderId") String orderId
     ) {
@@ -97,6 +98,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<Map<String, Integer>> getInventory(
         
     ) {
@@ -133,6 +135,7 @@ public interface StoreApi {
         value = "/store/order/{orderId}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @Parameter(name = "orderId", description = "ID of pet that needs to be fetched", required = true, in = ParameterIn.PATH) @PathVariable("orderId") Long orderId
     ) {
@@ -182,6 +185,7 @@ public interface StoreApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Order> placeOrder(
         @Parameter(name = "Order", description = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     ) {

samples/openapi3/server/petstore/spring-boot-springdoc/src/main/java/org/openapitools/api/UserApi.java

@@ -66,6 +66,7 @@ public interface UserApi {
         value = "/user",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUser(
         @Parameter(name = "User", description = "Created user object", required = true) @Valid @RequestBody User user
     ) {
@@ -98,6 +99,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithArrayInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -130,6 +132,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithListInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -163,6 +166,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     default ResponseEntity<Void> deleteUser(
         @Parameter(name = "username", description = "The name that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) {
@@ -199,6 +203,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<User> getUserByName(
         @Parameter(name = "username", description = "The name that needs to be fetched. Use user1 for testing.", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) {
@@ -248,6 +253,7 @@ public interface UserApi {
         value = "/user/login",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<String> loginUser(
         @NotNull @Pattern(regexp = "^[a-zA-Z0-9]+[a-zA-Z0-9\\.\\-_]*[a-zA-Z0-9]+$") @Parameter(name = "username", description = "The user name for login", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @Parameter(name = "password", description = "The password for login in clear text", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "password", required = true) String password
@@ -279,6 +285,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     default ResponseEntity<Void> logoutUser(
         
     ) {
@@ -314,6 +321,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> updateUser(
         @Parameter(name = "username", description = "name that need to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username,
         @Parameter(name = "User", description = "Updated user object", required = true) @Valid @RequestBody User user

samples/openapi3/server/petstore/springboot-3/src/main/java/org/openapitools/api/PetApi.java

@@ -72,6 +72,7 @@ public interface PetApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Pet> addPet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -118,6 +119,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     default ResponseEntity<Void> deletePet(
         @Parameter(name = "petId", description = "Pet id to delete", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "api_key", description = "", in = ParameterIn.HEADER) @RequestHeader(value = "api_key", required = false) String apiKey
@@ -156,6 +158,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @Parameter(name = "status", deprecated = true, description = "Status values that need to be considered for filter", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "status", required = true) @Deprecated List<String> status
     ) {
@@ -210,6 +213,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<List<Pet>> findPetsByTags(
         @NotNull @Parameter(name = "tags", description = "Tags to filter by", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "tags", required = true) List<String> tags
     ) {
@@ -263,6 +267,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Pet> getPetById(
         @Parameter(name = "petId", description = "ID of pet to return", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     ) {
@@ -322,6 +327,7 @@ public interface PetApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Pet> updatePet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -370,6 +376,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> updatePetWithForm(
         @Parameter(name = "petId", description = "ID of pet that needs to be updated", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "name", description = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -409,6 +416,7 @@ public interface PetApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "additionalMetadata", description = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/openapi3/server/petstore/springboot-3/src/main/java/org/openapitools/api/StoreApi.java

@@ -64,6 +64,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{orderId}"
     )
+    
     default ResponseEntity<Void> deleteOrder(
         @Parameter(name = "orderId", description = "ID of the order that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("orderId") String orderId
     ) {
@@ -97,6 +98,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<Map<String, Integer>> getInventory(
         
     ) {
@@ -133,6 +135,7 @@ public interface StoreApi {
         value = "/store/order/{orderId}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @Parameter(name = "orderId", description = "ID of pet that needs to be fetched", required = true, in = ParameterIn.PATH) @PathVariable("orderId") Long orderId
     ) {
@@ -182,6 +185,7 @@ public interface StoreApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Order> placeOrder(
         @Parameter(name = "Order", description = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     ) {

samples/openapi3/server/petstore/springboot-3/src/main/java/org/openapitools/api/UserApi.java

@@ -66,6 +66,7 @@ public interface UserApi {
         value = "/user",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUser(
         @Parameter(name = "User", description = "Created user object", required = true) @Valid @RequestBody User user
     ) {
@@ -98,6 +99,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithArrayInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -130,6 +132,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithListInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -163,6 +166,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     default ResponseEntity<Void> deleteUser(
         @Parameter(name = "username", description = "The name that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) {
@@ -199,6 +203,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<User> getUserByName(
         @Parameter(name = "username", description = "The name that needs to be fetched. Use user1 for testing.", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) {
@@ -248,6 +253,7 @@ public interface UserApi {
         value = "/user/login",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<String> loginUser(
         @NotNull @Pattern(regexp = "^[a-zA-Z0-9]+[a-zA-Z0-9\\.\\-_]*[a-zA-Z0-9]+$") @Parameter(name = "username", description = "The user name for login", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @Parameter(name = "password", description = "The password for login in clear text", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "password", required = true) String password
@@ -279,6 +285,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     default ResponseEntity<Void> logoutUser(
         
     ) {
@@ -314,6 +321,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> updateUser(
         @Parameter(name = "username", description = "name that need to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username,
         @Parameter(name = "User", description = "Updated user object", required = true) @Valid @RequestBody User user

samples/openapi3/server/petstore/springboot-delegate/src/main/java/org/openapitools/api/AnotherFakeApi.java

@@ -61,6 +61,7 @@ public interface AnotherFakeApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> call123testSpecialTags(
         @Parameter(name = "Client", description = "client model", required = true) @Valid @RequestBody Client client
     ) {

samples/openapi3/server/petstore/springboot-delegate/src/main/java/org/openapitools/api/FakeApi.java

@@ -70,6 +70,7 @@ public interface FakeApi {
         value = "/fake/create_xml_item",
         consumes = { "application/xml", "application/xml; charset=utf-8", "application/xml; charset=utf-16", "text/xml", "text/xml; charset=utf-8", "text/xml; charset=utf-16" }
     )
+    
     default ResponseEntity<Void> createXmlItem(
         @Parameter(name = "XmlItem", description = "XmlItem Body", required = true) @Valid @RequestBody XmlItem xmlItem
     ) {
@@ -100,6 +101,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Boolean> fakeOuterBooleanSerialize(
         @Parameter(name = "body", description = "Input boolean as post body") @Valid @RequestBody(required = false) Boolean body
     ) {
@@ -130,6 +132,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<OuterComposite> fakeOuterCompositeSerialize(
         @Parameter(name = "OuterComposite", description = "Input composite as post body") @Valid @RequestBody(required = false) OuterComposite outerComposite
     ) {
@@ -160,6 +163,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<BigDecimal> fakeOuterNumberSerialize(
         @Parameter(name = "body", description = "Input number as post body") @Valid @RequestBody(required = false) BigDecimal body
     ) {
@@ -190,6 +194,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<String> fakeOuterStringSerialize(
         @Parameter(name = "body", description = "Input string as post body") @Valid @RequestBody(required = false) String body
     ) {
@@ -217,6 +222,7 @@ public interface FakeApi {
         value = "/fake/{petId}/response-object-different-names",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<ResponseObjectWithDifferentFieldNames> responseObjectDifferentNames(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     ) {
@@ -244,6 +250,7 @@ public interface FakeApi {
         value = "/fake/body-with-file-schema",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testBodyWithFileSchema(
         @Parameter(name = "FileSchemaTestClass", description = "", required = true) @Valid @RequestBody FileSchemaTestClass fileSchemaTestClass
     ) {
@@ -270,6 +277,7 @@ public interface FakeApi {
         value = "/fake/body-with-query-params",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testBodyWithQueryParams(
         @NotNull @Parameter(name = "query", description = "", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "query", required = true) String query,
         @Parameter(name = "User", description = "", required = true) @Valid @RequestBody User user
@@ -302,6 +310,7 @@ public interface FakeApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> testClientModel(
         @Parameter(name = "Client", description = "client model", required = true) @Valid @RequestBody Client client
     ) {
@@ -348,6 +357,7 @@ public interface FakeApi {
         value = "/fake",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testEndpointParameters(
         @Parameter(name = "number", description = "None", required = true) @Valid @RequestParam(value = "number", required = true) BigDecimal number,
         @Parameter(name = "double", description = "None", required = true) @Valid @RequestParam(value = "double", required = true) Double _double,
@@ -398,6 +408,7 @@ public interface FakeApi {
         value = "/fake",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testEnumParameters(
         @Parameter(name = "enum_header_string_array", description = "Header parameter enum test (string array)", in = ParameterIn.HEADER) @RequestHeader(value = "enum_header_string_array", required = false) List<String> enumHeaderStringArray,
         @Parameter(name = "enum_header_string", description = "Header parameter enum test (string)", in = ParameterIn.HEADER) @RequestHeader(value = "enum_header_string", required = false, defaultValue = "-efg") String enumHeaderString,
@@ -437,6 +448,7 @@ public interface FakeApi {
         method = RequestMethod.DELETE,
         value = "/fake"
     )
+    
     default ResponseEntity<Void> testGroupParameters(
         @NotNull @Parameter(name = "required_string_group", description = "Required String in group parameters", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "required_string_group", required = true) Integer requiredStringGroup,
         @NotNull @Parameter(name = "required_boolean_group", description = "Required Boolean in group parameters", required = true, in = ParameterIn.HEADER) @RequestHeader(value = "required_boolean_group", required = true) Boolean requiredBooleanGroup,
@@ -470,6 +482,7 @@ public interface FakeApi {
         value = "/fake/inline-additionalProperties",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testInlineAdditionalProperties(
         @Parameter(name = "request_body", description = "request body", required = true) @Valid @RequestBody Map<String, String> requestBody
     ) {
@@ -499,6 +512,7 @@ public interface FakeApi {
         value = "/fake/jsonFormData",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testJsonFormData(
         @Parameter(name = "param", description = "field1", required = true) @Valid @RequestParam(value = "param", required = true) String param,
         @Parameter(name = "param2", description = "field2", required = true) @Valid @RequestParam(value = "param2", required = true) String param2
@@ -557,6 +571,7 @@ public interface FakeApi {
         method = RequestMethod.PUT,
         value = "/fake/test-query-parameters"
     )
+    
     default ResponseEntity<Void> testQueryParameterCollectionFormat(
         @NotNull @Parameter(name = "pipe", description = "", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "pipe", required = true) List<String> pipe,
         @NotNull @Parameter(name = "http", description = "", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "http", required = true) List<String> http,
@@ -588,6 +603,7 @@ public interface FakeApi {
         value = "/fake/response-with-example",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<Integer> testWithResultExample(
         
     ) {
@@ -624,6 +640,7 @@ public interface FakeApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFileWithRequiredFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "requiredFile", description = "file to upload", required = true) @RequestPart(value = "requiredFile", required = true) MultipartFile requiredFile,

samples/openapi3/server/petstore/springboot-delegate/src/main/java/org/openapitools/api/FakeClassnameTestApi.java

@@ -64,6 +64,7 @@ public interface FakeClassnameTestApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> testClassname(
         @Parameter(name = "Client", description = "client model", required = true) @Valid @RequestBody Client client
     ) {

samples/openapi3/server/petstore/springboot-delegate/src/main/java/org/openapitools/api/PetApi.java

@@ -65,6 +65,7 @@ public interface PetApi {
         value = "/pet",
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Void> addPet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -98,6 +99,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     default ResponseEntity<Void> deletePet(
         @Parameter(name = "petId", description = "Pet id to delete", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "api_key", description = "", in = ParameterIn.HEADER) @RequestHeader(value = "api_key", required = false) String apiKey
@@ -135,6 +137,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @Parameter(name = "status", description = "Status values that need to be considered for filter", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "status", required = true) List<String> status
     ) {
@@ -174,6 +177,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Set<Pet>> findPetsByTags(
         @NotNull @Parameter(name = "tags", description = "Tags to filter by", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "tags", required = true) Set<String> tags
     ) {
@@ -212,6 +216,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Pet> getPetById(
         @Parameter(name = "petId", description = "ID of pet to return", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     ) {
@@ -249,6 +254,7 @@ public interface PetApi {
         value = "/pet",
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Void> updatePet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -282,6 +288,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> updatePetWithForm(
         @Parameter(name = "petId", description = "ID of pet that needs to be updated", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "name", description = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -320,6 +327,7 @@ public interface PetApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "additionalMetadata", description = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/openapi3/server/petstore/springboot-delegate/src/main/java/org/openapitools/api/StoreApi.java

@@ -60,6 +60,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{order_id}"
     )
+    
     default ResponseEntity<Void> deleteOrder(
         @Parameter(name = "order_id", description = "ID of the order that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("order_id") String orderId
     ) {
@@ -92,6 +93,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<Map<String, Integer>> getInventory(
         
     ) {
@@ -127,6 +129,7 @@ public interface StoreApi {
         value = "/store/order/{order_id}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @Parameter(name = "order_id", description = "ID of pet that needs to be fetched", required = true, in = ParameterIn.PATH) @PathVariable("order_id") Long orderId
     ) {
@@ -161,6 +164,7 @@ public interface StoreApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Order> placeOrder(
         @Parameter(name = "Order", description = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     ) {

samples/openapi3/server/petstore/springboot-delegate/src/main/java/org/openapitools/api/UserApi.java

@@ -59,6 +59,7 @@ public interface UserApi {
         value = "/user",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUser(
         @Parameter(name = "User", description = "Created user object", required = true) @Valid @RequestBody User user
     ) {
@@ -87,6 +88,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithArrayInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -115,6 +117,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithListInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -144,6 +147,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     default ResponseEntity<Void> deleteUser(
         @Parameter(name = "username", description = "The name that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) {
@@ -179,6 +183,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<User> getUserByName(
         @Parameter(name = "username", description = "The name that needs to be fetched. Use user1 for testing.", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) {
@@ -213,6 +218,7 @@ public interface UserApi {
         value = "/user/login",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<String> loginUser(
         @NotNull @Parameter(name = "username", description = "The user name for login", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @Parameter(name = "password", description = "The password for login in clear text", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "password", required = true) String password
@@ -240,6 +246,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     default ResponseEntity<Void> logoutUser(
         
     ) {
@@ -271,6 +278,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> updateUser(
         @Parameter(name = "username", description = "name that need to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username,
         @Parameter(name = "User", description = "Updated user object", required = true) @Valid @RequestBody User user

samples/openapi3/server/petstore/springboot-implicitHeaders/src/main/java/org/openapitools/api/AnotherFakeApi.java

@@ -65,6 +65,7 @@ public interface AnotherFakeApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> call123testSpecialTags(
         @Parameter(name = "Client", description = "client model", required = true) @Valid @RequestBody Client client
     ) {

samples/openapi3/server/petstore/springboot-implicitHeaders/src/main/java/org/openapitools/api/FakeApi.java

@@ -74,6 +74,7 @@ public interface FakeApi {
         value = "/fake/create_xml_item",
         consumes = { "application/xml", "application/xml; charset=utf-8", "application/xml; charset=utf-16", "text/xml", "text/xml; charset=utf-8", "text/xml; charset=utf-16" }
     )
+    
     default ResponseEntity<Void> createXmlItem(
         @Parameter(name = "XmlItem", description = "XmlItem Body", required = true) @Valid @RequestBody XmlItem xmlItem
     ) {
@@ -105,6 +106,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Boolean> fakeOuterBooleanSerialize(
         @Parameter(name = "body", description = "Input boolean as post body") @Valid @RequestBody(required = false) Boolean body
     ) {
@@ -136,6 +138,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<OuterComposite> fakeOuterCompositeSerialize(
         @Parameter(name = "OuterComposite", description = "Input composite as post body") @Valid @RequestBody(required = false) OuterComposite outerComposite
     ) {
@@ -176,6 +179,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<BigDecimal> fakeOuterNumberSerialize(
         @Parameter(name = "body", description = "Input number as post body") @Valid @RequestBody(required = false) BigDecimal body
     ) {
@@ -207,6 +211,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<String> fakeOuterStringSerialize(
         @Parameter(name = "body", description = "Input string as post body") @Valid @RequestBody(required = false) String body
     ) {
@@ -235,6 +240,7 @@ public interface FakeApi {
         value = "/fake/{petId}/response-object-different-names",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<ResponseObjectWithDifferentFieldNames> responseObjectDifferentNames(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     ) {
@@ -272,6 +278,7 @@ public interface FakeApi {
         value = "/fake/body-with-file-schema",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testBodyWithFileSchema(
         @Parameter(name = "FileSchemaTestClass", description = "", required = true) @Valid @RequestBody FileSchemaTestClass fileSchemaTestClass
     ) {
@@ -299,6 +306,7 @@ public interface FakeApi {
         value = "/fake/body-with-query-params",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testBodyWithQueryParams(
         @NotNull @Parameter(name = "query", description = "", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "query", required = true) String query,
         @Parameter(name = "User", description = "", required = true) @Valid @RequestBody User user
@@ -332,6 +340,7 @@ public interface FakeApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> testClientModel(
         @Parameter(name = "Client", description = "client model", required = true) @Valid @RequestBody Client client
     ) {
@@ -388,6 +397,7 @@ public interface FakeApi {
         value = "/fake",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testEndpointParameters(
         @Parameter(name = "number", description = "None", required = true) @Valid @RequestParam(value = "number", required = true) BigDecimal number,
         @Parameter(name = "double", description = "None", required = true) @Valid @RequestParam(value = "double", required = true) Double _double,
@@ -441,6 +451,7 @@ public interface FakeApi {
         value = "/fake",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testEnumParameters(
         @Parameter(name = "enum_query_string_array", description = "Query parameter enum test (string array)", in = ParameterIn.QUERY) @Valid @RequestParam(value = "enum_query_string_array", required = false) List<String> enumQueryStringArray,
         @Parameter(name = "enum_query_string", description = "Query parameter enum test (string)", in = ParameterIn.QUERY) @Valid @RequestParam(value = "enum_query_string", required = false, defaultValue = "-efg") String enumQueryString,
@@ -481,6 +492,7 @@ public interface FakeApi {
         method = RequestMethod.DELETE,
         value = "/fake"
     )
+    
     default ResponseEntity<Void> testGroupParameters(
         @NotNull @Parameter(name = "required_string_group", description = "Required String in group parameters", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "required_string_group", required = true) Integer requiredStringGroup,
         @NotNull @Parameter(name = "required_int64_group", description = "Required Integer in group parameters", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "required_int64_group", required = true) Long requiredInt64Group,
@@ -513,6 +525,7 @@ public interface FakeApi {
         value = "/fake/inline-additionalProperties",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testInlineAdditionalProperties(
         @Parameter(name = "request_body", description = "request body", required = true) @Valid @RequestBody Map<String, String> requestBody
     ) {
@@ -543,6 +556,7 @@ public interface FakeApi {
         value = "/fake/jsonFormData",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testJsonFormData(
         @Parameter(name = "param", description = "field1", required = true) @Valid @RequestParam(value = "param", required = true) String param,
         @Parameter(name = "param2", description = "field2", required = true) @Valid @RequestParam(value = "param2", required = true) String param2
@@ -603,6 +617,7 @@ public interface FakeApi {
         method = RequestMethod.PUT,
         value = "/fake/test-query-parameters"
     )
+    
     default ResponseEntity<Void> testQueryParameterCollectionFormat(
         @NotNull @Parameter(name = "pipe", description = "", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "pipe", required = true) List<String> pipe,
         @NotNull @Parameter(name = "http", description = "", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "http", required = true) List<String> http,
@@ -635,6 +650,7 @@ public interface FakeApi {
         value = "/fake/response-with-example",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<Integer> testWithResultExample(
         
     ) {
@@ -681,6 +697,7 @@ public interface FakeApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFileWithRequiredFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "requiredFile", description = "file to upload", required = true) @RequestPart(value = "requiredFile", required = true) MultipartFile requiredFile,

samples/openapi3/server/petstore/springboot-implicitHeaders/src/main/java/org/openapitools/api/FakeClassnameTestApi.java

@@ -68,6 +68,7 @@ public interface FakeClassnameTestApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> testClassname(
         @Parameter(name = "Client", description = "client model", required = true) @Valid @RequestBody Client client
     ) {

samples/openapi3/server/petstore/springboot-implicitHeaders/src/main/java/org/openapitools/api/PetApi.java

@@ -69,6 +69,7 @@ public interface PetApi {
         value = "/pet",
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Void> addPet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -105,6 +106,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     default ResponseEntity<Void> deletePet(
         @Parameter(name = "petId", description = "Pet id to delete", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     ) {
@@ -142,6 +144,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @Parameter(name = "status", description = "Status values that need to be considered for filter", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "status", required = true) List<String> status
     ) {
@@ -196,6 +199,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Set<Pet>> findPetsByTags(
         @NotNull @Parameter(name = "tags", description = "Tags to filter by", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "tags", required = true) Set<String> tags
     ) {
@@ -249,6 +253,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Pet> getPetById(
         @Parameter(name = "petId", description = "ID of pet to return", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     ) {
@@ -301,6 +306,7 @@ public interface PetApi {
         value = "/pet",
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Void> updatePet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -335,6 +341,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> updatePetWithForm(
         @Parameter(name = "petId", description = "ID of pet that needs to be updated", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "name", description = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -374,6 +381,7 @@ public interface PetApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "additionalMetadata", description = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/openapi3/server/petstore/springboot-implicitHeaders/src/main/java/org/openapitools/api/StoreApi.java

@@ -64,6 +64,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{order_id}"
     )
+    
     default ResponseEntity<Void> deleteOrder(
         @Parameter(name = "order_id", description = "ID of the order that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("order_id") String orderId
     ) {
@@ -97,6 +98,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<Map<String, Integer>> getInventory(
         
     ) {
@@ -133,6 +135,7 @@ public interface StoreApi {
         value = "/store/order/{order_id}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @Parameter(name = "order_id", description = "ID of pet that needs to be fetched", required = true, in = ParameterIn.PATH) @PathVariable("order_id") Long orderId
     ) {
@@ -182,6 +185,7 @@ public interface StoreApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Order> placeOrder(
         @Parameter(name = "Order", description = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     ) {

samples/openapi3/server/petstore/springboot-implicitHeaders/src/main/java/org/openapitools/api/UserApi.java

@@ -63,6 +63,7 @@ public interface UserApi {
         value = "/user",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUser(
         @Parameter(name = "User", description = "Created user object", required = true) @Valid @RequestBody User user
     ) {
@@ -92,6 +93,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithArrayInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -121,6 +123,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithListInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -151,6 +154,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     default ResponseEntity<Void> deleteUser(
         @Parameter(name = "username", description = "The name that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) {
@@ -187,6 +191,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<User> getUserByName(
         @Parameter(name = "username", description = "The name that needs to be fetched. Use user1 for testing.", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) {
@@ -236,6 +241,7 @@ public interface UserApi {
         value = "/user/login",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<String> loginUser(
         @NotNull @Parameter(name = "username", description = "The user name for login", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @Parameter(name = "password", description = "The password for login in clear text", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "password", required = true) String password
@@ -264,6 +270,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     default ResponseEntity<Void> logoutUser(
         
     ) {
@@ -296,6 +303,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> updateUser(
         @Parameter(name = "username", description = "name that need to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username,
         @Parameter(name = "User", description = "Updated user object", required = true) @Valid @RequestBody User user

samples/openapi3/server/petstore/springboot-source/src/main/java/org/openapitools/api/PetApi.java

@@ -44,6 +44,7 @@ public interface PetApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Pet> addPet(
          @Valid @RequestBody Pet pet
     ) {
@@ -78,6 +79,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     default ResponseEntity<Void> deletePet(
          @PathVariable("petId") Long petId,
          @RequestHeader(value = "api_key", required = false) String apiKey
@@ -100,6 +102,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull  @Valid @RequestParam(value = "status", required = true) @Deprecated List<String> status
     ) {
@@ -137,6 +140,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<List<Pet>> findPetsByTags(
         @NotNull  @Valid @RequestParam(value = "tags", required = true) List<String> tags
     ) {
@@ -173,6 +177,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Pet> getPetById(
          @PathVariable("petId") Long petId
     ) {
@@ -213,6 +218,7 @@ public interface PetApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Pet> updatePet(
          @Valid @RequestBody Pet pet
     ) {
@@ -249,6 +255,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> updatePetWithForm(
          @PathVariable("petId") Long petId,
          @Valid @RequestParam(value = "name", required = false) String name,
@@ -274,6 +281,7 @@ public interface PetApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFile(
          @PathVariable("petId") Long petId,
          @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/openapi3/server/petstore/springboot-source/src/main/java/org/openapitools/api/StoreApi.java

@@ -42,6 +42,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{orderId}"
     )
+    
     default ResponseEntity<Void> deleteOrder(
          @PathVariable("orderId") String orderId
     ) {
@@ -61,6 +62,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<Map<String, Integer>> getInventory(
         
     ) {
@@ -83,6 +85,7 @@ public interface StoreApi {
         value = "/store/order/{orderId}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L)  @PathVariable("orderId") Long orderId
     ) {
@@ -119,6 +122,7 @@ public interface StoreApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Order> placeOrder(
          @Valid @RequestBody Order order
     ) {

samples/openapi3/server/petstore/springboot-source/src/main/java/org/openapitools/api/UserApi.java

@@ -42,6 +42,7 @@ public interface UserApi {
         value = "/user",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUser(
          @Valid @RequestBody User user
     ) {
@@ -62,6 +63,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithArrayInput(
          @Valid @RequestBody List<User> user
     ) {
@@ -82,6 +84,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithListInput(
          @Valid @RequestBody List<User> user
     ) {
@@ -102,6 +105,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     default ResponseEntity<Void> deleteUser(
          @PathVariable("username") String username
     ) {
@@ -124,6 +128,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<User> getUserByName(
          @PathVariable("username") String username
     ) {
@@ -160,6 +165,7 @@ public interface UserApi {
         value = "/user/login",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<String> loginUser(
         @NotNull @Pattern(regexp = "^[a-zA-Z0-9]+[a-zA-Z0-9\\.\\-_]*[a-zA-Z0-9]+$")  @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull  @Valid @RequestParam(value = "password", required = true) String password
@@ -179,6 +185,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     default ResponseEntity<Void> logoutUser(
         
     ) {
@@ -201,6 +208,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> updateUser(
          @PathVariable("username") String username,
          @Valid @RequestBody User user

samples/openapi3/server/petstore/springboot/src/main/java/org/openapitools/api/PetApi.java

@@ -73,6 +73,7 @@ public interface PetApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Pet> addPet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -119,6 +120,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     default ResponseEntity<Void> deletePet(
         @Parameter(name = "petId", description = "Pet id to delete", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "api_key", description = "", in = ParameterIn.HEADER) @RequestHeader(value = "api_key", required = false) String apiKey
@@ -157,6 +159,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @Parameter(name = "status", deprecated = true, description = "Status values that need to be considered for filter", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "status", required = true) @Deprecated List<String> status
     ) {
@@ -211,6 +214,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<List<Pet>> findPetsByTags(
         @NotNull @Parameter(name = "tags", description = "Tags to filter by", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "tags", required = true) List<String> tags
     ) {
@@ -264,6 +268,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Pet> getPetById(
         @Parameter(name = "petId", description = "ID of pet to return", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     ) {
@@ -323,6 +328,7 @@ public interface PetApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Pet> updatePet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -371,6 +377,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> updatePetWithForm(
         @Parameter(name = "petId", description = "ID of pet that needs to be updated", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "name", description = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -410,6 +417,7 @@ public interface PetApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "additionalMetadata", description = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/openapi3/server/petstore/springboot/src/main/java/org/openapitools/api/StoreApi.java

@@ -65,6 +65,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{orderId}"
     )
+    
     default ResponseEntity<Void> deleteOrder(
         @Parameter(name = "orderId", description = "ID of the order that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("orderId") String orderId
     ) {
@@ -98,6 +99,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<Map<String, Integer>> getInventory(
         
     ) {
@@ -134,6 +136,7 @@ public interface StoreApi {
         value = "/store/order/{orderId}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @Parameter(name = "orderId", description = "ID of pet that needs to be fetched", required = true, in = ParameterIn.PATH) @PathVariable("orderId") Long orderId
     ) {
@@ -183,6 +186,7 @@ public interface StoreApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Order> placeOrder(
         @Parameter(name = "Order", description = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     ) {

samples/openapi3/server/petstore/springboot/src/main/java/org/openapitools/api/UserApi.java

@@ -67,6 +67,7 @@ public interface UserApi {
         value = "/user",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUser(
         @Parameter(name = "User", description = "Created user object", required = true) @Valid @RequestBody User user
     ) {
@@ -99,6 +100,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithArrayInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -131,6 +133,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithListInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -164,6 +167,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     default ResponseEntity<Void> deleteUser(
         @Parameter(name = "username", description = "The name that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) {
@@ -200,6 +204,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<User> getUserByName(
         @Parameter(name = "username", description = "The name that needs to be fetched. Use user1 for testing.", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) {
@@ -249,6 +254,7 @@ public interface UserApi {
         value = "/user/login",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<String> loginUser(
         @NotNull @Pattern(regexp = "^[a-zA-Z0-9]+[a-zA-Z0-9\\.\\-_]*[a-zA-Z0-9]+$") @Parameter(name = "username", description = "The user name for login", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @Parameter(name = "password", description = "The password for login in clear text", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "password", required = true) String password
@@ -280,6 +286,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     default ResponseEntity<Void> logoutUser(
         
     ) {
@@ -315,6 +322,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> updateUser(
         @Parameter(name = "username", description = "name that need to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username,
         @Parameter(name = "User", description = "Updated user object", required = true) @Valid @RequestBody User user

samples/server/petstore/spring-boot-defaultInterface-unhandledException/src/main/java/org/openapitools/api/AnotherFakeApi.java

@@ -61,6 +61,7 @@ public interface AnotherFakeApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     ResponseEntity<Client> call123testSpecialTags(
         @Parameter(name = "Client", description = "client model", required = true) @Valid @RequestBody Client client
     ) throws Exception;

samples/server/petstore/spring-boot-defaultInterface-unhandledException/src/main/java/org/openapitools/api/FakeApi.java

@@ -70,6 +70,7 @@ public interface FakeApi {
         value = "/fake/create_xml_item",
         consumes = { "application/xml", "application/xml; charset=utf-8", "application/xml; charset=utf-16", "text/xml", "text/xml; charset=utf-8", "text/xml; charset=utf-16" }
     )
+    
     ResponseEntity<Void> createXmlItem(
         @Parameter(name = "XmlItem", description = "XmlItem Body", required = true) @Valid @RequestBody XmlItem xmlItem
     ) throws Exception;
@@ -98,6 +99,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     ResponseEntity<Boolean> fakeOuterBooleanSerialize(
         @Parameter(name = "body", description = "Input boolean as post body") @Valid @RequestBody(required = false) Boolean body
     ) throws Exception;
@@ -126,6 +128,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     ResponseEntity<OuterComposite> fakeOuterCompositeSerialize(
         @Parameter(name = "OuterComposite", description = "Input composite as post body") @Valid @RequestBody(required = false) OuterComposite outerComposite
     ) throws Exception;
@@ -154,6 +157,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     ResponseEntity<BigDecimal> fakeOuterNumberSerialize(
         @Parameter(name = "body", description = "Input number as post body") @Valid @RequestBody(required = false) BigDecimal body
     ) throws Exception;
@@ -182,6 +186,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     ResponseEntity<String> fakeOuterStringSerialize(
         @Parameter(name = "body", description = "Input string as post body") @Valid @RequestBody(required = false) String body
     ) throws Exception;
@@ -207,6 +212,7 @@ public interface FakeApi {
         value = "/fake/{petId}/response-object-different-names",
         produces = { "application/json" }
     )
+    
     ResponseEntity<ResponseObjectWithDifferentFieldNames> responseObjectDifferentNames(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     ) throws Exception;
@@ -232,6 +238,7 @@ public interface FakeApi {
         value = "/fake/body-with-file-schema",
         consumes = { "application/json" }
     )
+    
     ResponseEntity<Void> testBodyWithFileSchema(
         @Parameter(name = "FileSchemaTestClass", description = "", required = true) @Valid @RequestBody FileSchemaTestClass fileSchemaTestClass
     ) throws Exception;
@@ -256,6 +263,7 @@ public interface FakeApi {
         value = "/fake/body-with-query-params",
         consumes = { "application/json" }
     )
+    
     ResponseEntity<Void> testBodyWithQueryParams(
         @NotNull @Parameter(name = "query", description = "", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "query", required = true) String query,
         @Parameter(name = "User", description = "", required = true) @Valid @RequestBody User user
@@ -286,6 +294,7 @@ public interface FakeApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     ResponseEntity<Client> testClientModel(
         @Parameter(name = "Client", description = "client model", required = true) @Valid @RequestBody Client client
     ) throws Exception;
@@ -330,6 +339,7 @@ public interface FakeApi {
         value = "/fake",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     ResponseEntity<Void> testEndpointParameters(
         @Parameter(name = "number", description = "None", required = true) @Valid @RequestParam(value = "number", required = true) BigDecimal number,
         @Parameter(name = "double", description = "None", required = true) @Valid @RequestParam(value = "double", required = true) Double _double,
@@ -378,6 +388,7 @@ public interface FakeApi {
         value = "/fake",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     ResponseEntity<Void> testEnumParameters(
         @Parameter(name = "enum_header_string_array", description = "Header parameter enum test (string array)", in = ParameterIn.HEADER) @RequestHeader(value = "enum_header_string_array", required = false) List<String> enumHeaderStringArray,
         @Parameter(name = "enum_header_string", description = "Header parameter enum test (string)", in = ParameterIn.HEADER) @RequestHeader(value = "enum_header_string", required = false, defaultValue = "-efg") String enumHeaderString,
@@ -415,6 +426,7 @@ public interface FakeApi {
         method = RequestMethod.DELETE,
         value = "/fake"
     )
+    
     ResponseEntity<Void> testGroupParameters(
         @NotNull @Parameter(name = "required_string_group", description = "Required String in group parameters", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "required_string_group", required = true) Integer requiredStringGroup,
         @NotNull @Parameter(name = "required_boolean_group", description = "Required Boolean in group parameters", required = true, in = ParameterIn.HEADER) @RequestHeader(value = "required_boolean_group", required = true) Boolean requiredBooleanGroup,
@@ -446,6 +458,7 @@ public interface FakeApi {
         value = "/fake/inline-additionalProperties",
         consumes = { "application/json" }
     )
+    
     ResponseEntity<Void> testInlineAdditionalProperties(
         @Parameter(name = "request_body", description = "request body", required = true) @Valid @RequestBody Map<String, String> requestBody
     ) throws Exception;
@@ -473,6 +486,7 @@ public interface FakeApi {
         value = "/fake/jsonFormData",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     ResponseEntity<Void> testJsonFormData(
         @Parameter(name = "param", description = "field1", required = true) @Valid @RequestParam(value = "param", required = true) String param,
         @Parameter(name = "param2", description = "field2", required = true) @Valid @RequestParam(value = "param2", required = true) String param2
@@ -527,6 +541,7 @@ public interface FakeApi {
         method = RequestMethod.PUT,
         value = "/fake/test-query-parameters"
     )
+    
     ResponseEntity<Void> testQueryParameterCollectionFormat(
         @NotNull @Parameter(name = "pipe", description = "", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "pipe", required = true) List<String> pipe,
         @NotNull @Parameter(name = "http", description = "", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "http", required = true) List<String> http,
@@ -556,6 +571,7 @@ public interface FakeApi {
         value = "/fake/response-with-example",
         produces = { "application/json" }
     )
+    
     ResponseEntity<Integer> testWithResultExample(
         
     ) throws Exception;
@@ -590,6 +606,7 @@ public interface FakeApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     ResponseEntity<ModelApiResponse> uploadFileWithRequiredFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "requiredFile", description = "file to upload", required = true) @RequestPart(value = "requiredFile", required = true) MultipartFile requiredFile,

samples/server/petstore/spring-boot-defaultInterface-unhandledException/src/main/java/org/openapitools/api/FakeClassnameTestApi.java

@@ -64,6 +64,7 @@ public interface FakeClassnameTestApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     ResponseEntity<Client> testClassname(
         @Parameter(name = "Client", description = "client model", required = true) @Valid @RequestBody Client client
     ) throws Exception;

samples/server/petstore/spring-boot-defaultInterface-unhandledException/src/main/java/org/openapitools/api/PetApi.java

@@ -65,6 +65,7 @@ public interface PetApi {
         value = "/pet",
         consumes = { "application/json", "application/xml" }
     )
+    
     ResponseEntity<Void> addPet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) throws Exception;
@@ -96,6 +97,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     ResponseEntity<Void> deletePet(
         @Parameter(name = "petId", description = "Pet id to delete", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "api_key", description = "", in = ParameterIn.HEADER) @RequestHeader(value = "api_key", required = false) String apiKey
@@ -131,6 +133,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = { "application/xml", "application/json" }
     )
+    
     ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @Parameter(name = "status", description = "Status values that need to be considered for filter", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "status", required = true) List<String> status
     ) throws Exception;
@@ -168,6 +171,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = { "application/xml", "application/json" }
     )
+    
     ResponseEntity<Set<Pet>> findPetsByTags(
         @NotNull @Parameter(name = "tags", description = "Tags to filter by", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "tags", required = true) Set<String> tags
     ) throws Exception;
@@ -204,6 +208,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = { "application/xml", "application/json" }
     )
+    
     ResponseEntity<Pet> getPetById(
         @Parameter(name = "petId", description = "ID of pet to return", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId
     ) throws Exception;
@@ -239,6 +244,7 @@ public interface PetApi {
         value = "/pet",
         consumes = { "application/json", "application/xml" }
     )
+    
     ResponseEntity<Void> updatePet(
         @Parameter(name = "Pet", description = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) throws Exception;
@@ -270,6 +276,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     ResponseEntity<Void> updatePetWithForm(
         @Parameter(name = "petId", description = "ID of pet that needs to be updated", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "name", description = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -306,6 +313,7 @@ public interface PetApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     ResponseEntity<ModelApiResponse> uploadFile(
         @Parameter(name = "petId", description = "ID of pet to update", required = true, in = ParameterIn.PATH) @PathVariable("petId") Long petId,
         @Parameter(name = "additionalMetadata", description = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/server/petstore/spring-boot-defaultInterface-unhandledException/src/main/java/org/openapitools/api/StoreApi.java

@@ -60,6 +60,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{order_id}"
     )
+    
     ResponseEntity<Void> deleteOrder(
         @Parameter(name = "order_id", description = "ID of the order that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("order_id") String orderId
     ) throws Exception;
@@ -90,6 +91,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = { "application/json" }
     )
+    
     ResponseEntity<Map<String, Integer>> getInventory(
         
     ) throws Exception;
@@ -123,6 +125,7 @@ public interface StoreApi {
         value = "/store/order/{order_id}",
         produces = { "application/xml", "application/json" }
     )
+    
     ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @Parameter(name = "order_id", description = "ID of pet that needs to be fetched", required = true, in = ParameterIn.PATH) @PathVariable("order_id") Long orderId
     ) throws Exception;
@@ -155,6 +158,7 @@ public interface StoreApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json" }
     )
+    
     ResponseEntity<Order> placeOrder(
         @Parameter(name = "Order", description = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     ) throws Exception;

samples/server/petstore/spring-boot-defaultInterface-unhandledException/src/main/java/org/openapitools/api/UserApi.java

@@ -59,6 +59,7 @@ public interface UserApi {
         value = "/user",
         consumes = { "application/json" }
     )
+    
     ResponseEntity<Void> createUser(
         @Parameter(name = "User", description = "Created user object", required = true) @Valid @RequestBody User user
     ) throws Exception;
@@ -85,6 +86,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = { "application/json" }
     )
+    
     ResponseEntity<Void> createUsersWithArrayInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) throws Exception;
@@ -111,6 +113,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = { "application/json" }
     )
+    
     ResponseEntity<Void> createUsersWithListInput(
         @Parameter(name = "User", description = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) throws Exception;
@@ -138,6 +141,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     ResponseEntity<Void> deleteUser(
         @Parameter(name = "username", description = "The name that needs to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) throws Exception;
@@ -171,6 +175,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = { "application/xml", "application/json" }
     )
+    
     ResponseEntity<User> getUserByName(
         @Parameter(name = "username", description = "The name that needs to be fetched. Use user1 for testing.", required = true, in = ParameterIn.PATH) @PathVariable("username") String username
     ) throws Exception;
@@ -203,6 +208,7 @@ public interface UserApi {
         value = "/user/login",
         produces = { "application/xml", "application/json" }
     )
+    
     ResponseEntity<String> loginUser(
         @NotNull @Parameter(name = "username", description = "The user name for login", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @Parameter(name = "password", description = "The password for login in clear text", required = true, in = ParameterIn.QUERY) @Valid @RequestParam(value = "password", required = true) String password
@@ -228,6 +234,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     ResponseEntity<Void> logoutUser(
         
     ) throws Exception;
@@ -257,6 +264,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = { "application/json" }
     )
+    
     ResponseEntity<Void> updateUser(
         @Parameter(name = "username", description = "name that need to be deleted", required = true, in = ParameterIn.PATH) @PathVariable("username") String username,
         @Parameter(name = "User", description = "Updated user object", required = true) @Valid @RequestBody User user

samples/server/petstore/spring-boot-nullable-set/src/main/java/org/openapitools/api/NullableApi.java

@@ -62,6 +62,7 @@ public interface NullableApi {
         value = "/nullable",
         consumes = "application/json"
     )
+    
     default ResponseEntity<Void> nullableTest(
         @Parameter(name = "ObjectWithUniqueItems", description = "") @Valid @RequestBody(required = false) ObjectWithUniqueItems objectWithUniqueItems
     ) {

samples/server/petstore/springboot-beanvalidation-no-nullable/src/main/java/org/openapitools/api/AnotherFakeApi.java

@@ -54,6 +54,7 @@ public interface AnotherFakeApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> call123testSpecialTags(
         @ApiParam(value = "client model", required = true) @Valid @RequestBody Client client
     ) {

samples/server/petstore/springboot-beanvalidation-no-nullable/src/main/java/org/openapitools/api/FakeApi.java

@@ -64,6 +64,7 @@ public interface FakeApi {
         value = "/fake/create_xml_item",
         consumes = { "application/xml", "application/xml; charset=utf-8", "application/xml; charset=utf-16", "text/xml", "text/xml; charset=utf-8", "text/xml; charset=utf-16" }
     )
+    
     default ResponseEntity<Void> createXmlItem(
         @ApiParam(value = "XmlItem Body", required = true) @Valid @RequestBody XmlItem xmlItem
     ) {
@@ -95,6 +96,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Boolean> fakeOuterBooleanSerialize(
         @ApiParam(value = "Input boolean as post body") @Valid @RequestBody(required = false) Boolean body
     ) {
@@ -126,6 +128,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<OuterComposite> fakeOuterCompositeSerialize(
         @ApiParam(value = "Input composite as post body") @Valid @RequestBody(required = false) OuterComposite outerComposite
     ) {
@@ -166,6 +169,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<BigDecimal> fakeOuterNumberSerialize(
         @ApiParam(value = "Input number as post body") @Valid @RequestBody(required = false) BigDecimal body
     ) {
@@ -197,6 +201,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<String> fakeOuterStringSerialize(
         @ApiParam(value = "Input string as post body") @Valid @RequestBody(required = false) String body
     ) {
@@ -226,6 +231,7 @@ public interface FakeApi {
         value = "/fake/{petId}/response-object-different-names",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<ResponseObjectWithDifferentFieldNames> responseObjectDifferentNames(
         @ApiParam(value = "ID of pet to update", required = true) @PathVariable("petId") Long petId
     ) {
@@ -264,6 +270,7 @@ public interface FakeApi {
         value = "/fake/body-with-file-schema",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testBodyWithFileSchema(
         @ApiParam(value = "", required = true) @Valid @RequestBody FileSchemaTestClass fileSchemaTestClass
     ) {
@@ -293,6 +300,7 @@ public interface FakeApi {
         value = "/fake/body-with-query-params",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testBodyWithQueryParams(
         @NotNull @ApiParam(value = "", required = true) @Valid @RequestParam(value = "query", required = true) String query,
         @ApiParam(value = "", required = true) @Valid @RequestBody User user
@@ -325,6 +333,7 @@ public interface FakeApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> testClientModel(
         @ApiParam(value = "client model", required = true) @Valid @RequestBody Client client
     ) {
@@ -381,6 +390,7 @@ public interface FakeApi {
         value = "/fake",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testEndpointParameters(
         @ApiParam(value = "None", required = true) @Valid @RequestParam(value = "number", required = true) BigDecimal number,
         @ApiParam(value = "None", required = true) @Valid @RequestParam(value = "double", required = true) Double _double,
@@ -432,6 +442,7 @@ public interface FakeApi {
         value = "/fake",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testEnumParameters(
         @ApiParam(value = "Header parameter enum test (string array)", allowableValues = ">, $") @RequestHeader(value = "enum_header_string_array", required = false) List<String> enumHeaderStringArray,
         @ApiParam(value = "Header parameter enum test (string)", allowableValues = "_abc, -efg, (xyz)", defaultValue = "-efg") @RequestHeader(value = "enum_header_string", required = false, defaultValue = "-efg") String enumHeaderString,
@@ -472,6 +483,7 @@ public interface FakeApi {
         method = RequestMethod.DELETE,
         value = "/fake"
     )
+    
     default ResponseEntity<Void> testGroupParameters(
         @NotNull @ApiParam(value = "Required String in group parameters", required = true) @Valid @RequestParam(value = "required_string_group", required = true) Integer requiredStringGroup,
         @NotNull @ApiParam(value = "Required Boolean in group parameters", required = true) @RequestHeader(value = "required_boolean_group", required = true) Boolean requiredBooleanGroup,
@@ -506,6 +518,7 @@ public interface FakeApi {
         value = "/fake/inline-additionalProperties",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testInlineAdditionalProperties(
         @ApiParam(value = "request body", required = true) @Valid @RequestBody Map<String, String> requestBody
     ) {
@@ -536,6 +549,7 @@ public interface FakeApi {
         value = "/fake/jsonFormData",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testJsonFormData(
         @ApiParam(value = "field1", required = true) @Valid @RequestParam(value = "param", required = true) String param,
         @ApiParam(value = "field2", required = true) @Valid @RequestParam(value = "param2", required = true) String param2
@@ -597,6 +611,7 @@ public interface FakeApi {
         method = RequestMethod.PUT,
         value = "/fake/test-query-parameters"
     )
+    
     default ResponseEntity<Void> testQueryParameterCollectionFormat(
         @NotNull @ApiParam(value = "", required = true) @Valid @RequestParam(value = "pipe", required = true) List<String> pipe,
         @NotNull @ApiParam(value = "", required = true) @Valid @RequestParam(value = "http", required = true) List<String> http,
@@ -629,6 +644,7 @@ public interface FakeApi {
         value = "/fake/response-with-example",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<Integer> testWithResultExample(
         
     ) {
@@ -677,6 +693,7 @@ public interface FakeApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFileWithRequiredFile(
         @ApiParam(value = "ID of pet to update", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "file to upload", required = true) @RequestPart(value = "requiredFile", required = true) MultipartFile requiredFile,

samples/server/petstore/springboot-beanvalidation-no-nullable/src/main/java/org/openapitools/api/FakeClassnameTestApi.java

@@ -57,6 +57,7 @@ public interface FakeClassnameTestApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> testClassname(
         @ApiParam(value = "client model", required = true) @Valid @RequestBody Client client
     ) {

samples/server/petstore/springboot-beanvalidation-no-nullable/src/main/java/org/openapitools/api/PetApi.java

@@ -62,6 +62,7 @@ public interface PetApi {
         value = "/pet",
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Void> addPet(
         @ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -99,6 +100,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     default ResponseEntity<Void> deletePet(
         @ApiParam(value = "Pet id to delete", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "") @RequestHeader(value = "api_key", required = false) String apiKey
@@ -139,6 +141,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @ApiParam(value = "Status values that need to be considered for filter", required = true, allowableValues = "available, pending, sold") @Valid @RequestParam(value = "status", required = true) List<String> status
     ) {
@@ -194,6 +197,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Set<Pet>> findPetsByTags(
         @NotNull @ApiParam(value = "Tags to filter by", required = true) @Valid @RequestParam(value = "tags", required = true) Set<String> tags
     ) {
@@ -245,6 +249,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Pet> getPetById(
         @ApiParam(value = "ID of pet to return", required = true) @PathVariable("petId") Long petId
     ) {
@@ -300,6 +305,7 @@ public interface PetApi {
         value = "/pet",
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Void> updatePet(
         @ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -337,6 +343,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> updatePetWithForm(
         @ApiParam(value = "ID of pet that needs to be updated", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -378,6 +385,7 @@ public interface PetApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFile(
         @ApiParam(value = "ID of pet to update", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/server/petstore/springboot-beanvalidation-no-nullable/src/main/java/org/openapitools/api/StoreApi.java

@@ -54,6 +54,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{order_id}"
     )
+    
     default ResponseEntity<Void> deleteOrder(
         @ApiParam(value = "ID of the order that needs to be deleted", required = true) @PathVariable("order_id") String orderId
     ) {
@@ -87,6 +88,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<Map<String, Integer>> getInventory(
         
     ) {
@@ -121,6 +123,7 @@ public interface StoreApi {
         value = "/store/order/{order_id}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @ApiParam(value = "ID of pet that needs to be fetched", required = true) @PathVariable("order_id") Long orderId
     ) {
@@ -168,6 +171,7 @@ public interface StoreApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Order> placeOrder(
         @ApiParam(value = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     ) {

samples/server/petstore/springboot-beanvalidation-no-nullable/src/main/java/org/openapitools/api/UserApi.java

@@ -53,6 +53,7 @@ public interface UserApi {
         value = "/user",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUser(
         @ApiParam(value = "Created user object", required = true) @Valid @RequestBody User user
     ) {
@@ -82,6 +83,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithArrayInput(
         @ApiParam(value = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -111,6 +113,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithListInput(
         @ApiParam(value = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -141,6 +144,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     default ResponseEntity<Void> deleteUser(
         @ApiParam(value = "The name that needs to be deleted", required = true) @PathVariable("username") String username
     ) {
@@ -175,6 +179,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<User> getUserByName(
         @ApiParam(value = "The name that needs to be fetched. Use user1 for testing.", required = true) @PathVariable("username") String username
     ) {
@@ -222,6 +227,7 @@ public interface UserApi {
         value = "/user/login",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<String> loginUser(
         @NotNull @ApiParam(value = "The user name for login", required = true) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @ApiParam(value = "The password for login in clear text", required = true) @Valid @RequestParam(value = "password", required = true) String password
@@ -250,6 +256,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     default ResponseEntity<Void> logoutUser(
         
     ) {
@@ -282,6 +289,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> updateUser(
         @ApiParam(value = "name that need to be deleted", required = true) @PathVariable("username") String username,
         @ApiParam(value = "Updated user object", required = true) @Valid @RequestBody User user

samples/server/petstore/springboot-beanvalidation/src/main/java/org/openapitools/api/AnotherFakeApi.java

@@ -54,6 +54,7 @@ public interface AnotherFakeApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> call123testSpecialTags(
         @ApiParam(value = "client model", required = true) @Valid @RequestBody Client client
     ) {

samples/server/petstore/springboot-beanvalidation/src/main/java/org/openapitools/api/FakeApi.java

@@ -64,6 +64,7 @@ public interface FakeApi {
         value = "/fake/create_xml_item",
         consumes = { "application/xml", "application/xml; charset=utf-8", "application/xml; charset=utf-16", "text/xml", "text/xml; charset=utf-8", "text/xml; charset=utf-16" }
     )
+    
     default ResponseEntity<Void> createXmlItem(
         @ApiParam(value = "XmlItem Body", required = true) @Valid @RequestBody XmlItem xmlItem
     ) {
@@ -95,6 +96,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Boolean> fakeOuterBooleanSerialize(
         @ApiParam(value = "Input boolean as post body") @Valid @RequestBody(required = false) Boolean body
     ) {
@@ -126,6 +128,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<OuterComposite> fakeOuterCompositeSerialize(
         @ApiParam(value = "Input composite as post body") @Valid @RequestBody(required = false) OuterComposite outerComposite
     ) {
@@ -166,6 +169,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<BigDecimal> fakeOuterNumberSerialize(
         @ApiParam(value = "Input number as post body") @Valid @RequestBody(required = false) BigDecimal body
     ) {
@@ -197,6 +201,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<String> fakeOuterStringSerialize(
         @ApiParam(value = "Input string as post body") @Valid @RequestBody(required = false) String body
     ) {
@@ -226,6 +231,7 @@ public interface FakeApi {
         value = "/fake/{petId}/response-object-different-names",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<ResponseObjectWithDifferentFieldNames> responseObjectDifferentNames(
         @ApiParam(value = "ID of pet to update", required = true) @PathVariable("petId") Long petId
     ) {
@@ -264,6 +270,7 @@ public interface FakeApi {
         value = "/fake/body-with-file-schema",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testBodyWithFileSchema(
         @ApiParam(value = "", required = true) @Valid @RequestBody FileSchemaTestClass fileSchemaTestClass
     ) {
@@ -293,6 +300,7 @@ public interface FakeApi {
         value = "/fake/body-with-query-params",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testBodyWithQueryParams(
         @NotNull @ApiParam(value = "", required = true) @Valid @RequestParam(value = "query", required = true) String query,
         @ApiParam(value = "", required = true) @Valid @RequestBody User user
@@ -325,6 +333,7 @@ public interface FakeApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> testClientModel(
         @ApiParam(value = "client model", required = true) @Valid @RequestBody Client client
     ) {
@@ -381,6 +390,7 @@ public interface FakeApi {
         value = "/fake",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testEndpointParameters(
         @ApiParam(value = "None", required = true) @Valid @RequestParam(value = "number", required = true) BigDecimal number,
         @ApiParam(value = "None", required = true) @Valid @RequestParam(value = "double", required = true) Double _double,
@@ -432,6 +442,7 @@ public interface FakeApi {
         value = "/fake",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testEnumParameters(
         @ApiParam(value = "Header parameter enum test (string array)", allowableValues = ">, $") @RequestHeader(value = "enum_header_string_array", required = false) List<String> enumHeaderStringArray,
         @ApiParam(value = "Header parameter enum test (string)", allowableValues = "_abc, -efg, (xyz)", defaultValue = "-efg") @RequestHeader(value = "enum_header_string", required = false, defaultValue = "-efg") String enumHeaderString,
@@ -472,6 +483,7 @@ public interface FakeApi {
         method = RequestMethod.DELETE,
         value = "/fake"
     )
+    
     default ResponseEntity<Void> testGroupParameters(
         @NotNull @ApiParam(value = "Required String in group parameters", required = true) @Valid @RequestParam(value = "required_string_group", required = true) Integer requiredStringGroup,
         @NotNull @ApiParam(value = "Required Boolean in group parameters", required = true) @RequestHeader(value = "required_boolean_group", required = true) Boolean requiredBooleanGroup,
@@ -506,6 +518,7 @@ public interface FakeApi {
         value = "/fake/inline-additionalProperties",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testInlineAdditionalProperties(
         @ApiParam(value = "request body", required = true) @Valid @RequestBody Map<String, String> requestBody
     ) {
@@ -536,6 +549,7 @@ public interface FakeApi {
         value = "/fake/jsonFormData",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testJsonFormData(
         @ApiParam(value = "field1", required = true) @Valid @RequestParam(value = "param", required = true) String param,
         @ApiParam(value = "field2", required = true) @Valid @RequestParam(value = "param2", required = true) String param2
@@ -597,6 +611,7 @@ public interface FakeApi {
         method = RequestMethod.PUT,
         value = "/fake/test-query-parameters"
     )
+    
     default ResponseEntity<Void> testQueryParameterCollectionFormat(
         @NotNull @ApiParam(value = "", required = true) @Valid @RequestParam(value = "pipe", required = true) List<String> pipe,
         @NotNull @ApiParam(value = "", required = true) @Valid @RequestParam(value = "http", required = true) List<String> http,
@@ -629,6 +644,7 @@ public interface FakeApi {
         value = "/fake/response-with-example",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<Integer> testWithResultExample(
         
     ) {
@@ -677,6 +693,7 @@ public interface FakeApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFileWithRequiredFile(
         @ApiParam(value = "ID of pet to update", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "file to upload", required = true) @RequestPart(value = "requiredFile", required = true) MultipartFile requiredFile,

samples/server/petstore/springboot-beanvalidation/src/main/java/org/openapitools/api/FakeClassnameTestApi.java

@@ -57,6 +57,7 @@ public interface FakeClassnameTestApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> testClassname(
         @ApiParam(value = "client model", required = true) @Valid @RequestBody Client client
     ) {

samples/server/petstore/springboot-beanvalidation/src/main/java/org/openapitools/api/PetApi.java

@@ -62,6 +62,7 @@ public interface PetApi {
         value = "/pet",
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Void> addPet(
         @ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -99,6 +100,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     default ResponseEntity<Void> deletePet(
         @ApiParam(value = "Pet id to delete", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "") @RequestHeader(value = "api_key", required = false) String apiKey
@@ -139,6 +141,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @ApiParam(value = "Status values that need to be considered for filter", required = true, allowableValues = "available, pending, sold") @Valid @RequestParam(value = "status", required = true) List<String> status
     ) {
@@ -194,6 +197,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Set<Pet>> findPetsByTags(
         @NotNull @ApiParam(value = "Tags to filter by", required = true) @Valid @RequestParam(value = "tags", required = true) Set<String> tags
     ) {
@@ -245,6 +249,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Pet> getPetById(
         @ApiParam(value = "ID of pet to return", required = true) @PathVariable("petId") Long petId
     ) {
@@ -300,6 +305,7 @@ public interface PetApi {
         value = "/pet",
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Void> updatePet(
         @ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -337,6 +343,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> updatePetWithForm(
         @ApiParam(value = "ID of pet that needs to be updated", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -378,6 +385,7 @@ public interface PetApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFile(
         @ApiParam(value = "ID of pet to update", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/server/petstore/springboot-beanvalidation/src/main/java/org/openapitools/api/StoreApi.java

@@ -54,6 +54,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{order_id}"
     )
+    
     default ResponseEntity<Void> deleteOrder(
         @ApiParam(value = "ID of the order that needs to be deleted", required = true) @PathVariable("order_id") String orderId
     ) {
@@ -87,6 +88,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<Map<String, Integer>> getInventory(
         
     ) {
@@ -121,6 +123,7 @@ public interface StoreApi {
         value = "/store/order/{order_id}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @ApiParam(value = "ID of pet that needs to be fetched", required = true) @PathVariable("order_id") Long orderId
     ) {
@@ -168,6 +171,7 @@ public interface StoreApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Order> placeOrder(
         @ApiParam(value = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     ) {

samples/server/petstore/springboot-beanvalidation/src/main/java/org/openapitools/api/UserApi.java

@@ -53,6 +53,7 @@ public interface UserApi {
         value = "/user",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUser(
         @ApiParam(value = "Created user object", required = true) @Valid @RequestBody User user
     ) {
@@ -82,6 +83,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithArrayInput(
         @ApiParam(value = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -111,6 +113,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithListInput(
         @ApiParam(value = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -141,6 +144,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     default ResponseEntity<Void> deleteUser(
         @ApiParam(value = "The name that needs to be deleted", required = true) @PathVariable("username") String username
     ) {
@@ -175,6 +179,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<User> getUserByName(
         @ApiParam(value = "The name that needs to be fetched. Use user1 for testing.", required = true) @PathVariable("username") String username
     ) {
@@ -222,6 +227,7 @@ public interface UserApi {
         value = "/user/login",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<String> loginUser(
         @NotNull @ApiParam(value = "The user name for login", required = true) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @ApiParam(value = "The password for login in clear text", required = true) @Valid @RequestParam(value = "password", required = true) String password
@@ -250,6 +256,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     default ResponseEntity<Void> logoutUser(
         
     ) {
@@ -282,6 +289,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> updateUser(
         @ApiParam(value = "name that need to be deleted", required = true) @PathVariable("username") String username,
         @ApiParam(value = "Updated user object", required = true) @Valid @RequestBody User user

samples/server/petstore/springboot-delegate-j8/src/main/java/org/openapitools/api/AnotherFakeApi.java

@@ -50,6 +50,7 @@ public interface AnotherFakeApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> call123testSpecialTags(
         @ApiParam(value = "client model", required = true) @Valid @RequestBody Client client
     ) {

samples/server/petstore/springboot-delegate-j8/src/main/java/org/openapitools/api/FakeApi.java

@@ -60,6 +60,7 @@ public interface FakeApi {
         value = "/fake/create_xml_item",
         consumes = { "application/xml", "application/xml; charset=utf-8", "application/xml; charset=utf-16", "text/xml", "text/xml; charset=utf-8", "text/xml; charset=utf-16" }
     )
+    
     default ResponseEntity<Void> createXmlItem(
         @ApiParam(value = "XmlItem Body", required = true) @Valid @RequestBody XmlItem xmlItem
     ) {
@@ -90,6 +91,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Boolean> fakeOuterBooleanSerialize(
         @ApiParam(value = "Input boolean as post body") @Valid @RequestBody(required = false) Boolean body
     ) {
@@ -120,6 +122,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<OuterComposite> fakeOuterCompositeSerialize(
         @ApiParam(value = "Input composite as post body") @Valid @RequestBody(required = false) OuterComposite outerComposite
     ) {
@@ -150,6 +153,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<BigDecimal> fakeOuterNumberSerialize(
         @ApiParam(value = "Input number as post body") @Valid @RequestBody(required = false) BigDecimal body
     ) {
@@ -180,6 +184,7 @@ public interface FakeApi {
         produces = { "*/*" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<String> fakeOuterStringSerialize(
         @ApiParam(value = "Input string as post body") @Valid @RequestBody(required = false) String body
     ) {
@@ -208,6 +213,7 @@ public interface FakeApi {
         value = "/fake/{petId}/response-object-different-names",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<ResponseObjectWithDifferentFieldNames> responseObjectDifferentNames(
         @ApiParam(value = "ID of pet to update", required = true) @PathVariable("petId") Long petId
     ) {
@@ -236,6 +242,7 @@ public interface FakeApi {
         value = "/fake/body-with-file-schema",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testBodyWithFileSchema(
         @ApiParam(value = "", required = true) @Valid @RequestBody FileSchemaTestClass fileSchemaTestClass
     ) {
@@ -264,6 +271,7 @@ public interface FakeApi {
         value = "/fake/body-with-query-params",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testBodyWithQueryParams(
         @NotNull @ApiParam(value = "", required = true) @Valid @RequestParam(value = "query", required = true) String query,
         @ApiParam(value = "", required = true) @Valid @RequestBody User user
@@ -295,6 +303,7 @@ public interface FakeApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> testClientModel(
         @ApiParam(value = "client model", required = true) @Valid @RequestBody Client client
     ) {
@@ -341,6 +350,7 @@ public interface FakeApi {
         value = "/fake",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testEndpointParameters(
         @ApiParam(value = "None", required = true) @Valid @RequestParam(value = "number", required = true) BigDecimal number,
         @ApiParam(value = "None", required = true) @Valid @RequestParam(value = "double", required = true) Double _double,
@@ -391,6 +401,7 @@ public interface FakeApi {
         value = "/fake",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testEnumParameters(
         @ApiParam(value = "Header parameter enum test (string array)", allowableValues = ">, $") @RequestHeader(value = "enum_header_string_array", required = false) List<String> enumHeaderStringArray,
         @ApiParam(value = "Header parameter enum test (string)", allowableValues = "_abc, -efg, (xyz)", defaultValue = "-efg") @RequestHeader(value = "enum_header_string", required = false, defaultValue = "-efg") String enumHeaderString,
@@ -430,6 +441,7 @@ public interface FakeApi {
         method = RequestMethod.DELETE,
         value = "/fake"
     )
+    
     default ResponseEntity<Void> testGroupParameters(
         @NotNull @ApiParam(value = "Required String in group parameters", required = true) @Valid @RequestParam(value = "required_string_group", required = true) Integer requiredStringGroup,
         @NotNull @ApiParam(value = "Required Boolean in group parameters", required = true) @RequestHeader(value = "required_boolean_group", required = true) Boolean requiredBooleanGroup,
@@ -463,6 +475,7 @@ public interface FakeApi {
         value = "/fake/inline-additionalProperties",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> testInlineAdditionalProperties(
         @ApiParam(value = "request body", required = true) @Valid @RequestBody Map<String, String> requestBody
     ) {
@@ -492,6 +505,7 @@ public interface FakeApi {
         value = "/fake/jsonFormData",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> testJsonFormData(
         @ApiParam(value = "field1", required = true) @Valid @RequestParam(value = "param", required = true) String param,
         @ApiParam(value = "field2", required = true) @Valid @RequestParam(value = "param2", required = true) String param2
@@ -551,6 +565,7 @@ public interface FakeApi {
         method = RequestMethod.PUT,
         value = "/fake/test-query-parameters"
     )
+    
     default ResponseEntity<Void> testQueryParameterCollectionFormat(
         @NotNull @ApiParam(value = "", required = true) @Valid @RequestParam(value = "pipe", required = true) List<String> pipe,
         @NotNull @ApiParam(value = "", required = true) @Valid @RequestParam(value = "http", required = true) List<String> http,
@@ -582,6 +597,7 @@ public interface FakeApi {
         value = "/fake/response-with-example",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<Integer> testWithResultExample(
         
     ) {
@@ -620,6 +636,7 @@ public interface FakeApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFileWithRequiredFile(
         @ApiParam(value = "ID of pet to update", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "file to upload", required = true) @RequestPart(value = "requiredFile", required = true) MultipartFile requiredFile,

samples/server/petstore/springboot-delegate-j8/src/main/java/org/openapitools/api/FakeClassnameTestApi.java

@@ -53,6 +53,7 @@ public interface FakeClassnameTestApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> testClassname(
         @ApiParam(value = "client model", required = true) @Valid @RequestBody Client client
     ) {

samples/server/petstore/springboot-delegate-j8/src/main/java/org/openapitools/api/PetApi.java

@@ -58,6 +58,7 @@ public interface PetApi {
         value = "/pet",
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Void> addPet(
         @ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -94,6 +95,7 @@ public interface PetApi {
         method = RequestMethod.DELETE,
         value = "/pet/{petId}"
     )
+    
     default ResponseEntity<Void> deletePet(
         @ApiParam(value = "Pet id to delete", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "") @RequestHeader(value = "api_key", required = false) String apiKey
@@ -133,6 +135,7 @@ public interface PetApi {
         value = "/pet/findByStatus",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<List<Pet>> findPetsByStatus(
         @NotNull @ApiParam(value = "Status values that need to be considered for filter", required = true, allowableValues = "available, pending, sold") @Valid @RequestParam(value = "status", required = true) List<String> status
     ) {
@@ -173,6 +176,7 @@ public interface PetApi {
         value = "/pet/findByTags",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Set<Pet>> findPetsByTags(
         @NotNull @ApiParam(value = "Tags to filter by", required = true) @Valid @RequestParam(value = "tags", required = true) Set<String> tags
     ) {
@@ -209,6 +213,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Pet> getPetById(
         @ApiParam(value = "ID of pet to return", required = true) @PathVariable("petId") Long petId
     ) {
@@ -249,6 +254,7 @@ public interface PetApi {
         value = "/pet",
         consumes = { "application/json", "application/xml" }
     )
+    
     default ResponseEntity<Void> updatePet(
         @ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -285,6 +291,7 @@ public interface PetApi {
         value = "/pet/{petId}",
         consumes = { "application/x-www-form-urlencoded" }
     )
+    
     default ResponseEntity<Void> updatePetWithForm(
         @ApiParam(value = "ID of pet that needs to be updated", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -325,6 +332,7 @@ public interface PetApi {
         produces = { "application/json" },
         consumes = { "multipart/form-data" }
     )
+    
     default ResponseEntity<ModelApiResponse> uploadFile(
         @ApiParam(value = "ID of pet to update", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/server/petstore/springboot-delegate-j8/src/main/java/org/openapitools/api/StoreApi.java

@@ -50,6 +50,7 @@ public interface StoreApi {
         method = RequestMethod.DELETE,
         value = "/store/order/{order_id}"
     )
+    
     default ResponseEntity<Void> deleteOrder(
         @ApiParam(value = "ID of the order that needs to be deleted", required = true) @PathVariable("order_id") String orderId
     ) {
@@ -82,6 +83,7 @@ public interface StoreApi {
         value = "/store/inventory",
         produces = { "application/json" }
     )
+    
     default ResponseEntity<Map<String, Integer>> getInventory(
         
     ) {
@@ -115,6 +117,7 @@ public interface StoreApi {
         value = "/store/order/{order_id}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<Order> getOrderById(
         @Min(1L) @Max(5L) @ApiParam(value = "ID of pet that needs to be fetched", required = true) @PathVariable("order_id") Long orderId
     ) {
@@ -147,6 +150,7 @@ public interface StoreApi {
         produces = { "application/xml", "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Order> placeOrder(
         @ApiParam(value = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     ) {

samples/server/petstore/springboot-delegate-j8/src/main/java/org/openapitools/api/UserApi.java

@@ -49,6 +49,7 @@ public interface UserApi {
         value = "/user",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUser(
         @ApiParam(value = "Created user object", required = true) @Valid @RequestBody User user
     ) {
@@ -77,6 +78,7 @@ public interface UserApi {
         value = "/user/createWithArray",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithArrayInput(
         @ApiParam(value = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -105,6 +107,7 @@ public interface UserApi {
         value = "/user/createWithList",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> createUsersWithListInput(
         @ApiParam(value = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -134,6 +137,7 @@ public interface UserApi {
         method = RequestMethod.DELETE,
         value = "/user/{username}"
     )
+    
     default ResponseEntity<Void> deleteUser(
         @ApiParam(value = "The name that needs to be deleted", required = true) @PathVariable("username") String username
     ) {
@@ -167,6 +171,7 @@ public interface UserApi {
         value = "/user/{username}",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<User> getUserByName(
         @ApiParam(value = "The name that needs to be fetched. Use user1 for testing.", required = true) @PathVariable("username") String username
     ) {
@@ -199,6 +204,7 @@ public interface UserApi {
         value = "/user/login",
         produces = { "application/xml", "application/json" }
     )
+    
     default ResponseEntity<String> loginUser(
         @NotNull @ApiParam(value = "The user name for login", required = true) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @ApiParam(value = "The password for login in clear text", required = true) @Valid @RequestParam(value = "password", required = true) String password
@@ -226,6 +232,7 @@ public interface UserApi {
         method = RequestMethod.GET,
         value = "/user/logout"
     )
+    
     default ResponseEntity<Void> logoutUser(
         
     ) {
@@ -257,6 +264,7 @@ public interface UserApi {
         value = "/user/{username}",
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Void> updateUser(
         @ApiParam(value = "name that need to be deleted", required = true) @PathVariable("username") String username,
         @ApiParam(value = "Updated user object", required = true) @Valid @RequestBody User user

samples/server/petstore/springboot-delegate-no-response-entity/src/main/java/org/openapitools/api/PetApi.java

@@ -60,6 +60,7 @@ public interface PetApi {
         consumes = { "application/json", "application/xml" }
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default Pet addPet(
         @ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -95,6 +96,7 @@ public interface PetApi {
         value = "/pet/{petId}"
     )
     @ResponseStatus(HttpStatus.BAD_REQUEST)
+    
     default void deletePet(
         @ApiParam(value = "Pet id to delete", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "") @RequestHeader(value = "api_key", required = false) String apiKey
@@ -134,6 +136,7 @@ public interface PetApi {
         produces = { "application/xml", "application/json" }
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default List<Pet> findPetsByStatus(
         @NotNull @ApiParam(value = "Status values that need to be considered for filter", required = true, allowableValues = "available, pending, sold") @Valid @RequestParam(value = "status", required = true) @Deprecated List<String> status
     ) {
@@ -174,6 +177,7 @@ public interface PetApi {
         produces = { "application/xml", "application/json" }
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default List<Pet> findPetsByTags(
         @NotNull @ApiParam(value = "Tags to filter by", required = true) @Valid @RequestParam(value = "tags", required = true) List<String> tags
     ) {
@@ -211,6 +215,7 @@ public interface PetApi {
         produces = { "application/xml", "application/json" }
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default Pet getPetById(
         @ApiParam(value = "ID of pet to return", required = true) @PathVariable("petId") Long petId
     ) {
@@ -256,6 +261,7 @@ public interface PetApi {
         consumes = { "application/json", "application/xml" }
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default Pet updatePet(
         @ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Pet pet
     ) {
@@ -293,6 +299,7 @@ public interface PetApi {
         consumes = { "application/x-www-form-urlencoded" }
     )
     @ResponseStatus(HttpStatus.METHOD_NOT_ALLOWED)
+    
     default void updatePetWithForm(
         @ApiParam(value = "ID of pet that needs to be updated", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "Updated name of the pet") @Valid @RequestParam(value = "name", required = false) String name,
@@ -334,6 +341,7 @@ public interface PetApi {
         consumes = { "multipart/form-data" }
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default ModelApiResponse uploadFile(
         @ApiParam(value = "ID of pet to update", required = true) @PathVariable("petId") Long petId,
         @ApiParam(value = "Additional data to pass to server") @Valid @RequestParam(value = "additionalMetadata", required = false) String additionalMetadata,

samples/server/petstore/springboot-delegate-no-response-entity/src/main/java/org/openapitools/api/StoreApi.java

@@ -51,6 +51,7 @@ public interface StoreApi {
         value = "/store/order/{orderId}"
     )
     @ResponseStatus(HttpStatus.BAD_REQUEST)
+    
     default void deleteOrder(
         @ApiParam(value = "ID of the order that needs to be deleted", required = true) @PathVariable("orderId") String orderId
     ) {
@@ -84,6 +85,7 @@ public interface StoreApi {
         produces = { "application/json" }
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default Map<String, Integer> getInventory(
         
     ) {
@@ -118,6 +120,7 @@ public interface StoreApi {
         produces = { "application/xml", "application/json" }
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default Order getOrderById(
         @Min(1L) @Max(5L) @ApiParam(value = "ID of pet that needs to be fetched", required = true) @PathVariable("orderId") Long orderId
     ) {
@@ -151,6 +154,7 @@ public interface StoreApi {
         consumes = { "application/json" }
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default Order placeOrder(
         @ApiParam(value = "order placed for purchasing the pet", required = true) @Valid @RequestBody Order order
     ) {

samples/server/petstore/springboot-delegate-no-response-entity/src/main/java/org/openapitools/api/UserApi.java

@@ -53,6 +53,7 @@ public interface UserApi {
         consumes = { "application/json" }
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default void createUser(
         @ApiParam(value = "Created user object", required = true) @Valid @RequestBody User user
     ) {
@@ -85,6 +86,7 @@ public interface UserApi {
         consumes = { "application/json" }
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default void createUsersWithArrayInput(
         @ApiParam(value = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -117,6 +119,7 @@ public interface UserApi {
         consumes = { "application/json" }
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default void createUsersWithListInput(
         @ApiParam(value = "List of user object", required = true) @Valid @RequestBody List<User> user
     ) {
@@ -150,6 +153,7 @@ public interface UserApi {
         value = "/user/{username}"
     )
     @ResponseStatus(HttpStatus.BAD_REQUEST)
+    
     default void deleteUser(
         @ApiParam(value = "The name that needs to be deleted", required = true) @PathVariable("username") String username
     ) {
@@ -184,6 +188,7 @@ public interface UserApi {
         produces = { "application/xml", "application/json" }
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default User getUserByName(
         @ApiParam(value = "The name that needs to be fetched. Use user1 for testing.", required = true) @PathVariable("username") String username
     ) {
@@ -217,6 +222,7 @@ public interface UserApi {
         produces = { "application/xml", "application/json" }
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default String loginUser(
         @NotNull @Pattern(regexp = "^[a-zA-Z0-9]+[a-zA-Z0-9\\.\\-_]*[a-zA-Z0-9]+$") @ApiParam(value = "The user name for login", required = true) @Valid @RequestParam(value = "username", required = true) String username,
         @NotNull @ApiParam(value = "The password for login in clear text", required = true) @Valid @RequestParam(value = "password", required = true) String password
@@ -248,6 +254,7 @@ public interface UserApi {
         value = "/user/logout"
     )
     @ResponseStatus(HttpStatus.OK)
+    
     default void logoutUser(
         
     ) {
@@ -283,6 +290,7 @@ public interface UserApi {
         consumes = { "application/json" }
     )
     @ResponseStatus(HttpStatus.BAD_REQUEST)
+    
     default void updateUser(
         @ApiParam(value = "name that need to be deleted", required = true) @PathVariable("username") String username,
         @ApiParam(value = "Updated user object", required = true) @Valid @RequestBody User user

samples/server/petstore/springboot-delegate/src/main/java/org/openapitools/api/AnotherFakeApi.java

@@ -50,6 +50,7 @@ public interface AnotherFakeApi {
         produces = { "application/json" },
         consumes = { "application/json" }
     )
+    
     default ResponseEntity<Client> call123testSpecialTags(
         @ApiParam(value = "client model", required = true) @Valid @RequestBody Client client
     ) {