updated samples and docs as required by PR checklist

Author: rignicat

samples/server/petstore/jaxrs-spec-interface-response/.openapi-generator/FILES

@@ -4,8 +4,6 @@ src/gen/java/org/openapitools/api/AnotherFakeApi.java
 src/gen/java/org/openapitools/api/FakeApi.java
 src/gen/java/org/openapitools/api/FakeClassnameTestApi.java
 src/gen/java/org/openapitools/api/PetApi.java
-src/gen/java/org/openapitools/api/RestApplication.java
-src/gen/java/org/openapitools/api/RestResourceRoot.java
 src/gen/java/org/openapitools/api/StoreApi.java
 src/gen/java/org/openapitools/api/UserApi.java
 src/gen/java/org/openapitools/model/AdditionalPropertiesAnyType.java

samples/server/petstore/jaxrs-spec-interface-response/src/gen/java/org/openapitools/api/AnotherFakeApi.java

@@ -17,7 +17,6 @@
 /**
 * Represents a collection of functions to interact with the API endpoints.
 */
-@Path("/another-fake/dummy")
 @Api(description = "the another-fake API")
 @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaJAXRSSpecServerCodegen", comments = "Generator version: 7.17.0-SNAPSHOT")
 public interface AnotherFakeApi {
@@ -30,6 +29,7 @@ public interface AnotherFakeApi {
      * @return successful operation
      */
     @PATCH
+    @Path("/another-fake/dummy")
     @Consumes({ "application/json" })
     @Produces({ "application/json" })
     @ApiOperation(value = "To test special tags", notes = "To test special tags and operation ID starting with number", tags={ "$another-fake?" })

samples/server/petstore/jaxrs-spec-interface-response/src/gen/java/org/openapitools/api/FakeApi.java

@@ -26,7 +26,6 @@
 /**
 * Represents a collection of functions to interact with the API endpoints.
 */
-@Path("/fake")
 @Api(description = "the fake API")
 @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaJAXRSSpecServerCodegen", comments = "Generator version: 7.17.0-SNAPSHOT")
 public interface FakeApi {
@@ -38,7 +37,7 @@ public interface FakeApi {
      * @return successful operation
      */
     @POST
-    @Path("/create_xml_item")
+    @Path("/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" })
     @ApiOperation(value = "creates an XmlItem", notes = "this route creates an XmlItem", tags={ "fake" })
     @ApiResponses(value = { 
@@ -53,7 +52,7 @@ public interface FakeApi {
      * @return Output boolean
      */
     @POST
-    @Path("/outer/boolean")
+    @Path("/fake/outer/boolean")
     @Produces({ "*/*" })
     @ApiOperation(value = "", notes = "Test serialization of outer boolean types", tags={ "fake" })
     @ApiResponses(value = { 
@@ -68,7 +67,7 @@ public interface FakeApi {
      * @return Output composite
      */
     @POST
-    @Path("/outer/composite")
+    @Path("/fake/outer/composite")
     @Produces({ "*/*" })
     @ApiOperation(value = "", notes = "Test serialization of object with outer number type", tags={ "fake" })
     @ApiResponses(value = { 
@@ -83,7 +82,7 @@ public interface FakeApi {
      * @return Output number
      */
     @POST
-    @Path("/outer/number")
+    @Path("/fake/outer/number")
     @Produces({ "*/*" })
     @ApiOperation(value = "", notes = "Test serialization of outer number types", tags={ "fake" })
     @ApiResponses(value = { 
@@ -98,7 +97,7 @@ public interface FakeApi {
      * @return Output string
      */
     @POST
-    @Path("/outer/string")
+    @Path("/fake/outer/string")
     @Produces({ "*/*" })
     @ApiOperation(value = "", notes = "Test serialization of outer string types", tags={ "fake" })
     @ApiResponses(value = { 
@@ -113,7 +112,7 @@ public interface FakeApi {
      * @return Success
      */
     @PUT
-    @Path("/body-with-file-schema")
+    @Path("/fake/body-with-file-schema")
     @Consumes({ "application/json" })
     @ApiOperation(value = "", notes = "For this test, the body for this request much reference a schema named `File`.", tags={ "fake" })
     @ApiResponses(value = { 
@@ -129,7 +128,7 @@ public interface FakeApi {
      * @return Success
      */
     @PUT
-    @Path("/body-with-query-params")
+    @Path("/fake/body-with-query-params")
     @Consumes({ "application/json" })
     @ApiOperation(value = "", notes = "", tags={ "fake" })
     @ApiResponses(value = { 
@@ -144,6 +143,7 @@ public interface FakeApi {
      * @return successful operation
      */
     @PATCH
+    @Path("/fake")
     @Consumes({ "application/json" })
     @Produces({ "application/json" })
     @ApiOperation(value = "To test \"client\" model", notes = "To test \"client\" model", tags={ "fake" })
@@ -173,6 +173,7 @@ public interface FakeApi {
      * @return User not found
      */
     @POST
+    @Path("/fake")
     @Consumes({ "application/x-www-form-urlencoded" })
     @ApiOperation(value = "Fake endpoint for testing various parameters  假端點  偽のエンドポイント  가짜 엔드 포인트", notes = "Fake endpoint for testing various parameters  假端點  偽のエンドポイント  가짜 엔드 포인트", authorizations = {
 
@@ -199,6 +200,7 @@ public interface FakeApi {
      * @return Not found
      */
     @GET
+    @Path("/fake")
     @Consumes({ "application/x-www-form-urlencoded" })
     @ApiOperation(value = "To test enum parameters", notes = "To test enum parameters", tags={ "fake" })
     @ApiResponses(value = { 
@@ -219,6 +221,7 @@ public interface FakeApi {
      * @return Something wrong
      */
     @DELETE
+    @Path("/fake")
     @ApiOperation(value = "Fake endpoint to test group parameters (optional)", notes = "Fake endpoint to test group parameters (optional)", tags={ "fake" })
     @ApiResponses(value = { 
         @ApiResponse(code = 400, message = "Something wrong", response = Void.class) })
@@ -232,7 +235,7 @@ public interface FakeApi {
      * @return successful operation
      */
     @POST
-    @Path("/inline-additionalProperties")
+    @Path("/fake/inline-additionalProperties")
     @Consumes({ "application/json" })
     @ApiOperation(value = "test inline additionalProperties", notes = "", tags={ "fake" })
     @ApiResponses(value = { 
@@ -248,7 +251,7 @@ public interface FakeApi {
      * @return successful operation
      */
     @GET
-    @Path("/jsonFormData")
+    @Path("/fake/jsonFormData")
     @Consumes({ "application/x-www-form-urlencoded" })
     @ApiOperation(value = "test json serialization of form data", notes = "", tags={ "fake" })
     @ApiResponses(value = { 
@@ -267,7 +270,7 @@ public interface FakeApi {
      * @return Success
      */
     @PUT
-    @Path("/test-query-parameters")
+    @Path("/fake/test-query-parameters")
     @ApiOperation(value = "", notes = "To test the collection format in query parameters", tags={ "fake" })
     @ApiResponses(value = { 
         @ApiResponse(code = 200, message = "Success", response = Void.class) })
@@ -283,7 +286,7 @@ public interface FakeApi {
      * @return successful operation
      */
     @POST
-    @Path("/{petId}/uploadImageWithRequiredFile")
+    @Path("/fake/{petId}/uploadImageWithRequiredFile")
     @Consumes({ "multipart/form-data" })
     @Produces({ "application/json" })
     @ApiOperation(value = "uploads an image (required)", notes = "", authorizations = {

samples/server/petstore/jaxrs-spec-interface-response/src/gen/java/org/openapitools/api/FakeClassnameTestApi.java

@@ -16,7 +16,6 @@
 /**
 * Represents a collection of functions to interact with the API endpoints.
 */
-@Path("/fake_classname_test")
 @Api(description = "the fake_classname_test API")
 @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaJAXRSSpecServerCodegen", comments = "Generator version: 7.17.0-SNAPSHOT")
 public interface FakeClassnameTestApi {
@@ -28,6 +27,7 @@ public interface FakeClassnameTestApi {
      * @return successful operation
      */
     @PATCH
+    @Path("/fake_classname_test")
     @Consumes({ "application/json" })
     @Produces({ "application/json" })
     @ApiOperation(value = "To test class name in snake case", notes = "To test class name in snake case", authorizations = {

samples/server/petstore/jaxrs-spec-interface-response/src/gen/java/org/openapitools/api/PetApi.java

@@ -19,7 +19,6 @@
 /**
 * Represents a collection of functions to interact with the API endpoints.
 */
-@Path("/pet")
 @Api(description = "the pet API")
 @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaJAXRSSpecServerCodegen", comments = "Generator version: 7.17.0-SNAPSHOT")
 public interface PetApi {
@@ -32,6 +31,7 @@ public interface PetApi {
      * @return Invalid input
      */
     @POST
+    @Path("/pet")
     @Consumes({ "application/json", "application/xml" })
     @ApiOperation(value = "Add a new pet to the store", notes = "", authorizations = {
         @Authorization(value = "petstore_auth", scopes = {
@@ -53,7 +53,7 @@ public interface PetApi {
      * @return Invalid pet value
      */
     @DELETE
-    @Path("/{petId}")
+    @Path("/pet/{petId}")
     @ApiOperation(value = "Deletes a pet", notes = "", authorizations = {
         @Authorization(value = "petstore_auth", scopes = {
             @AuthorizationScope(scope = "write:pets", description = "modify pets in your account"),
@@ -73,7 +73,7 @@ public interface PetApi {
      * @return Invalid status value
      */
     @GET
-    @Path("/findByStatus")
+    @Path("/pet/findByStatus")
     @Produces({ "application/xml", "application/json" })
     @ApiOperation(value = "Finds Pets by status", notes = "Multiple status values can be provided with comma separated strings", authorizations = {
         @Authorization(value = "petstore_auth", scopes = {
@@ -94,7 +94,7 @@ public interface PetApi {
      * @return Invalid tag value
      */
     @GET
-    @Path("/findByTags")
+    @Path("/pet/findByTags")
     @Produces({ "application/xml", "application/json" })
     @ApiOperation(value = "Finds Pets by tags", notes = "Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.", authorizations = {
         @Authorization(value = "petstore_auth", scopes = {
@@ -116,7 +116,7 @@ public interface PetApi {
      * @return Pet not found
      */
     @GET
-    @Path("/{petId}")
+    @Path("/pet/{petId}")
     @Produces({ "application/xml", "application/json" })
     @ApiOperation(value = "Find pet by ID", notes = "Returns a single pet", authorizations = {
 
@@ -139,6 +139,7 @@ public interface PetApi {
      * @return Validation exception
      */
     @PUT
+    @Path("/pet")
     @Consumes({ "application/json", "application/xml" })
     @ApiOperation(value = "Update an existing pet", notes = "", authorizations = {
         @Authorization(value = "petstore_auth", scopes = {
@@ -162,7 +163,7 @@ public interface PetApi {
      * @return Invalid input
      */
     @POST
-    @Path("/{petId}")
+    @Path("/pet/{petId}")
     @Consumes({ "application/x-www-form-urlencoded" })
     @ApiOperation(value = "Updates a pet in the store with form data", notes = "", authorizations = {
         @Authorization(value = "petstore_auth", scopes = {
@@ -183,7 +184,7 @@ public interface PetApi {
      * @return successful operation
      */
     @POST
-    @Path("/{petId}/uploadImage")
+    @Path("/pet/{petId}/uploadImage")
     @Consumes({ "multipart/form-data" })
     @Produces({ "application/json" })
     @ApiOperation(value = "uploads an image", notes = "", authorizations = {

samples/server/petstore/jaxrs-spec-interface-response/src/gen/java/org/openapitools/api/StoreApi.java

@@ -17,7 +17,6 @@
 /**
 * Represents a collection of functions to interact with the API endpoints.
 */
-@Path("/store")
 @Api(description = "the store API")
 @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaJAXRSSpecServerCodegen", comments = "Generator version: 7.17.0-SNAPSHOT")
 public interface StoreApi {
@@ -30,7 +29,7 @@ public interface StoreApi {
      * @return Order not found
      */
     @DELETE
-    @Path("/order/{order_id}")
+    @Path("/store/order/{order_id}")
     @ApiOperation(value = "Delete purchase order by ID", notes = "For valid response try integer IDs with value < 1000. Anything above 1000 or nonintegers will generate API errors", tags={ "store" })
     @ApiResponses(value = { 
         @ApiResponse(code = 400, message = "Invalid ID supplied", response = Void.class),
@@ -44,7 +43,7 @@ public interface StoreApi {
      * @return successful operation
      */
     @GET
-    @Path("/inventory")
+    @Path("/store/inventory")
     @Produces({ "application/json" })
     @ApiOperation(value = "Returns pet inventories by status", notes = "Returns a map of status codes to quantities", authorizations = {
 
@@ -64,7 +63,7 @@ public interface StoreApi {
      * @return Order not found
      */
     @GET
-    @Path("/order/{order_id}")
+    @Path("/store/order/{order_id}")
     @Produces({ "application/xml", "application/json" })
     @ApiOperation(value = "Find purchase order by ID", notes = "For valid response try integer IDs with value <= 5 or > 10. Other values will generate exceptions", tags={ "store" })
     @ApiResponses(value = { 
@@ -82,7 +81,7 @@ public interface StoreApi {
      * @return Invalid Order
      */
     @POST
-    @Path("/order")
+    @Path("/store/order")
     @Produces({ "application/xml", "application/json" })
     @ApiOperation(value = "Place an order for a pet", notes = "", tags={ "store" })
     @ApiResponses(value = { 

samples/server/petstore/jaxrs-spec-interface-response/src/gen/java/org/openapitools/api/UserApi.java

@@ -17,7 +17,6 @@
 /**
 * Represents a collection of functions to interact with the API endpoints.
 */
-@Path("/user")
 @Api(description = "the user API")
 @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaJAXRSSpecServerCodegen", comments = "Generator version: 7.17.0-SNAPSHOT")
 public interface UserApi {
@@ -29,6 +28,7 @@ public interface UserApi {
      * @return successful operation
      */
     @POST
+    @Path("/user")
     @ApiOperation(value = "Create user", notes = "This can only be done by the logged in user.", tags={ "user" })
     @ApiResponses(value = { 
         @ApiResponse(code = 200, message = "successful operation", response = Void.class) })
@@ -42,7 +42,7 @@ public interface UserApi {
      * @return successful operation
      */
     @POST
-    @Path("/createWithArray")
+    @Path("/user/createWithArray")
     @ApiOperation(value = "Creates list of users with given input array", notes = "", tags={ "user" })
     @ApiResponses(value = { 
         @ApiResponse(code = 200, message = "successful operation", response = Void.class) })
@@ -56,7 +56,7 @@ public interface UserApi {
      * @return successful operation
      */
     @POST
-    @Path("/createWithList")
+    @Path("/user/createWithList")
     @ApiOperation(value = "Creates list of users with given input array", notes = "", tags={ "user" })
     @ApiResponses(value = { 
         @ApiResponse(code = 200, message = "successful operation", response = Void.class) })
@@ -71,7 +71,7 @@ public interface UserApi {
      * @return User not found
      */
     @DELETE
-    @Path("/{username}")
+    @Path("/user/{username}")
     @ApiOperation(value = "Delete user", notes = "This can only be done by the logged in user.", tags={ "user" })
     @ApiResponses(value = { 
         @ApiResponse(code = 400, message = "Invalid username supplied", response = Void.class),
@@ -88,7 +88,7 @@ public interface UserApi {
      * @return User not found
      */
     @GET
-    @Path("/{username}")
+    @Path("/user/{username}")
     @Produces({ "application/xml", "application/json" })
     @ApiOperation(value = "Get user by user name", notes = "", tags={ "user" })
     @ApiResponses(value = { 
@@ -107,7 +107,7 @@ public interface UserApi {
      * @return Invalid username/password supplied
      */
     @GET
-    @Path("/login")
+    @Path("/user/login")
     @Produces({ "application/xml", "application/json" })
     @ApiOperation(value = "Logs user into the system", notes = "", tags={ "user" })
     @ApiResponses(value = { 
@@ -122,7 +122,7 @@ public interface UserApi {
      * @return successful operation
      */
     @GET
-    @Path("/logout")
+    @Path("/user/logout")
     @ApiOperation(value = "Logs out current logged in user session", notes = "", tags={ "user" })
     @ApiResponses(value = { 
         @ApiResponse(code = 200, message = "successful operation", response = Void.class) })
@@ -138,7 +138,7 @@ public interface UserApi {
      * @return User not found
      */
     @PUT
-    @Path("/{username}")
+    @Path("/user/{username}")
     @ApiOperation(value = "Updated user", notes = "This can only be done by the logged in user.", tags={ "user" })
     @ApiResponses(value = { 
         @ApiResponse(code = 400, message = "Invalid user supplied", response = Void.class),

samples/server/petstore/jaxrs-spec-interface-response/src/gen/java/org/openapitools/model/AdditionalPropertiesAnyType.java

@@ -17,7 +17,6 @@
 
 
 
-
 @JsonTypeName("AdditionalPropertiesAnyType")
 @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaJAXRSSpecServerCodegen", comments = "Generator version: 7.17.0-SNAPSHOT")
 public class AdditionalPropertiesAnyType extends HashMap<String, Object> implements Serializable {

samples/server/petstore/jaxrs-spec-interface-response/src/gen/java/org/openapitools/model/AdditionalPropertiesArray.java

@@ -18,7 +18,6 @@
 
 
 
-
 @JsonTypeName("AdditionalPropertiesArray")
 @javax.annotation.Generated(value = "org.openapitools.codegen.languages.JavaJAXRSSpecServerCodegen", comments = "Generator version: 7.17.0-SNAPSHOT")
 public class AdditionalPropertiesArray extends HashMap<String, List> implements Serializable {