loafle/openapi-generator
3
0
Fork 0
forked from loafle/openapi-generator-original
Code Pull Requests Activity

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

Browse Source 
* 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
This commit is contained in:
krasv
2023-09-21 11:08:24 +02:00
committed by GitHub
parent 254b359a56
commit 8f8fd85fd6
172 changed files with 1287 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
samples/server/petstore/springboot-reactive/src/main/java/org/openapitools/api/AnotherFakeApi.java
View File

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

17
samples/server/petstore/springboot-reactive/src/main/java/org/openapitools/api/FakeApi.java
View File

@@ -65,6 +65,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 Mono<ResponseEntity<Void>> createXmlItem(
@ApiParam(value = "XmlItem Body", required = true) @Valid @RequestBody Mono<XmlItem> xmlItem,
@ApiIgnore final ServerWebExchange exchange
@@ -96,6 +97,7 @@ public interface FakeApi {
produces = { "*/*" },
consumes = { "application/json" }
)
default Mono<ResponseEntity<Boolean>> fakeOuterBooleanSerialize(
@ApiParam(value = "Input boolean as post body") @Valid @RequestBody(required = false) Mono<Boolean> body,
@ApiIgnore final ServerWebExchange exchange
@@ -127,6 +129,7 @@ public interface FakeApi {
produces = { "*/*" },
consumes = { "application/json" }
)
default Mono<ResponseEntity<OuterComposite>> fakeOuterCompositeSerialize(
@ApiParam(value = "Input composite as post body") @Valid @RequestBody(required = false) Mono<OuterComposite> outerComposite,
@ApiIgnore final ServerWebExchange exchange
@@ -158,6 +161,7 @@ public interface FakeApi {
produces = { "*/*" },
consumes = { "application/json" }
)
default Mono<ResponseEntity<BigDecimal>> fakeOuterNumberSerialize(
@ApiParam(value = "Input number as post body") @Valid @RequestBody(required = false) Mono<BigDecimal> body,
@ApiIgnore final ServerWebExchange exchange
@@ -189,6 +193,7 @@ public interface FakeApi {
produces = { "*/*" },
consumes = { "application/json" }
)
default Mono<ResponseEntity<String>> fakeOuterStringSerialize(
@ApiParam(value = "Input string as post body") @Valid @RequestBody(required = false) Mono<String> body,
@ApiIgnore final ServerWebExchange exchange
@@ -218,6 +223,7 @@ public interface FakeApi {
value = "/fake/{petId}/response-object-different-names",
produces = { "application/json" }
)
default Mono<ResponseEntity<ResponseObjectWithDifferentFieldNames>> responseObjectDifferentNames(
@ApiParam(value = "ID of pet to update", required = true) @PathVariable("petId") Long petId,
@ApiIgnore final ServerWebExchange exchange
@@ -247,6 +253,7 @@ public interface FakeApi {
value = "/fake/body-with-file-schema",
consumes = { "application/json" }
)
default Mono<ResponseEntity<Void>> testBodyWithFileSchema(
@ApiParam(value = "", required = true) @Valid @RequestBody Mono<FileSchemaTestClass> fileSchemaTestClass,
@ApiIgnore final ServerWebExchange exchange
@@ -276,6 +283,7 @@ public interface FakeApi {
value = "/fake/body-with-query-params",
consumes = { "application/json" }
)
default Mono<ResponseEntity<Void>> testBodyWithQueryParams(
@NotNull @ApiParam(value = "", required = true) @Valid @RequestParam(value = "query", required = true) String query,
@ApiParam(value = "", required = true) @Valid @RequestBody Mono<User> user,
@@ -308,6 +316,7 @@ public interface FakeApi {
produces = { "application/json" },
consumes = { "application/json" }
)
default Mono<ResponseEntity<Client>> testClientModel(
@ApiParam(value = "client model", required = true) @Valid @RequestBody Mono<Client> client,
@ApiIgnore final ServerWebExchange exchange
@@ -355,6 +364,7 @@ public interface FakeApi {
value = "/fake",
consumes = { "application/x-www-form-urlencoded" }
)
default Mono<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,
@@ -406,6 +416,7 @@ public interface FakeApi {
value = "/fake",
consumes = { "application/x-www-form-urlencoded" }
)
default Mono<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,
@@ -446,6 +457,7 @@ public interface FakeApi {
method = RequestMethod.DELETE,
value = "/fake"
)
default Mono<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,
@@ -480,6 +492,7 @@ public interface FakeApi {
value = "/fake/inline-additionalProperties",
consumes = { "application/json" }
)
default Mono<ResponseEntity<Void>> testInlineAdditionalProperties(
@ApiParam(value = "request body", required = true) @Valid @RequestBody Mono<Map<String, String>> requestBody,
@ApiIgnore final ServerWebExchange exchange
@@ -510,6 +523,7 @@ public interface FakeApi {
value = "/fake/jsonFormData",
consumes = { "application/x-www-form-urlencoded" }
)
default Mono<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,
@@ -571,6 +585,7 @@ public interface FakeApi {
method = RequestMethod.PUT,
value = "/fake/test-query-parameters"
)
default Mono<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,
@@ -603,6 +618,7 @@ public interface FakeApi {
value = "/fake/response-with-example",
produces = { "application/json" }
)
default Mono<ResponseEntity<Integer>> testWithResultExample(
@ApiIgnore final ServerWebExchange exchange
) {
@@ -641,6 +657,7 @@ public interface FakeApi {
produces = { "application/json" },
consumes = { "multipart/form-data" }
)
default Mono<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) Flux<Part> requiredFile,

1
samples/server/petstore/springboot-reactive/src/main/java/org/openapitools/api/FakeClassnameTestApi.java
View File

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

8
samples/server/petstore/springboot-reactive/src/main/java/org/openapitools/api/PetApi.java
View File

@@ -63,6 +63,7 @@ public interface PetApi {
value = "/pet",
consumes = { "application/json", "application/xml" }
)
default Mono<ResponseEntity<Void>> addPet(
@ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Mono<Pet> pet,
@ApiIgnore final ServerWebExchange exchange
@@ -100,6 +101,7 @@ public interface PetApi {
method = RequestMethod.DELETE,
value = "/pet/{petId}"
)
default Mono<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,
@@ -140,6 +142,7 @@ public interface PetApi {
value = "/pet/findByStatus",
produces = { "application/xml", "application/json" }
)
default Mono<ResponseEntity<Flux<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 ServerWebExchange exchange
@@ -181,6 +184,7 @@ public interface PetApi {
value = "/pet/findByTags",
produces = { "application/xml", "application/json" }
)
default Mono<ResponseEntity<Flux<Pet>>> findPetsByTags(
@NotNull @ApiParam(value = "Tags to filter by", required = true) @Valid @RequestParam(value = "tags", required = true) Set<String> tags,
@ApiIgnore final ServerWebExchange exchange
@@ -218,6 +222,7 @@ public interface PetApi {
value = "/pet/{petId}",
produces = { "application/xml", "application/json" }
)
default Mono<ResponseEntity<Pet>> getPetById(
@ApiParam(value = "ID of pet to return", required = true) @PathVariable("petId") Long petId,
@ApiIgnore final ServerWebExchange exchange
@@ -259,6 +264,7 @@ public interface PetApi {
value = "/pet",
consumes = { "application/json", "application/xml" }
)
default Mono<ResponseEntity<Void>> updatePet(
@ApiParam(value = "Pet object that needs to be added to the store", required = true) @Valid @RequestBody Mono<Pet> pet,
@ApiIgnore final ServerWebExchange exchange
@@ -296,6 +302,7 @@ public interface PetApi {
value = "/pet/{petId}",
consumes = { "application/x-www-form-urlencoded" }
)
default Mono<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,
@@ -337,6 +344,7 @@ public interface PetApi {
produces = { "application/json" },
consumes = { "multipart/form-data" }
)
default Mono<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,

4
samples/server/petstore/springboot-reactive/src/main/java/org/openapitools/api/StoreApi.java
View File

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

8
samples/server/petstore/springboot-reactive/src/main/java/org/openapitools/api/UserApi.java
View File

@@ -54,6 +54,7 @@ public interface UserApi {
value = "/user",
consumes = { "application/json" }
)
default Mono<ResponseEntity<Void>> createUser(
@ApiParam(value = "Created user object", required = true) @Valid @RequestBody Mono<User> user,
@ApiIgnore final ServerWebExchange exchange
@@ -83,6 +84,7 @@ public interface UserApi {
value = "/user/createWithArray",
consumes = { "application/json" }
)
default Mono<ResponseEntity<Void>> createUsersWithArrayInput(
@ApiParam(value = "List of user object", required = true) @Valid @RequestBody Flux<User> user,
@ApiIgnore final ServerWebExchange exchange
@@ -112,6 +114,7 @@ public interface UserApi {
value = "/user/createWithList",
consumes = { "application/json" }
)
default Mono<ResponseEntity<Void>> createUsersWithListInput(
@ApiParam(value = "List of user object", required = true) @Valid @RequestBody Flux<User> user,
@ApiIgnore final ServerWebExchange exchange
@@ -142,6 +145,7 @@ public interface UserApi {
method = RequestMethod.DELETE,
value = "/user/{username}"
)
default Mono<ResponseEntity<Void>> deleteUser(
@ApiParam(value = "The name that needs to be deleted", required = true) @PathVariable("username") String username,
@ApiIgnore final ServerWebExchange exchange
@@ -176,6 +180,7 @@ public interface UserApi {
value = "/user/{username}",
produces = { "application/xml", "application/json" }
)
default Mono<ResponseEntity<User>> getUserByName(
@ApiParam(value = "The name that needs to be fetched. Use user1 for testing.", required = true) @PathVariable("username") String username,
@ApiIgnore final ServerWebExchange exchange
@@ -209,6 +214,7 @@ public interface UserApi {
value = "/user/login",
produces = { "application/xml", "application/json" }
)
default Mono<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,
@@ -237,6 +243,7 @@ public interface UserApi {
method = RequestMethod.GET,
value = "/user/logout"
)
default Mono<ResponseEntity<Void>> logoutUser(
@ApiIgnore final ServerWebExchange exchange
) {
@@ -268,6 +275,7 @@ public interface UserApi {
value = "/user/{username}",
consumes = { "application/json" }
)
default Mono<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 Mono<User> user,