Serialization to openapi of org.springframework.data.domain.Sort is not done correctly. Fixes #2447

Author: bnasslahsen

springdoc-openapi-starter-common/src/main/java/org/springdoc/core/converters/models/SortObject.java

@@ -24,11 +24,14 @@
 package org.springdoc.core.converters.models;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
+import io.swagger.v3.oas.annotations.media.ArraySchema;
+import io.swagger.v3.oas.annotations.media.Schema;
 
 /**
  * The type Sort response.
  * @author bnasslahsen
  */
+@ArraySchema(arraySchema = @Schema(implementation = SortObject.class))
 public class SortObject {
 
 	/**

springdoc-openapi-tests/springdoc-openapi-data-rest-tests/src/test/resources/results/app24.json

@@ -105,21 +105,24 @@
             "format": "int32"
           },
           "sort": {
-            "$ref": "#/components/schemas/SortObject"
-          },
-          "numberOfElements": {
-            "type": "integer",
-            "format": "int32"
-          },
-          "pageable": {
-            "$ref": "#/components/schemas/PageableObject"
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SortObject"
+            }
           },
           "first": {
             "type": "boolean"
           },
           "last": {
             "type": "boolean"
           },
+          "pageable": {
+            "$ref": "#/components/schemas/PageableObject"
+          },
+          "numberOfElements": {
+            "type": "integer",
+            "format": "int32"
+          },
           "empty": {
             "type": "boolean"
           }
@@ -133,7 +136,16 @@
             "format": "int64"
           },
           "sort": {
-            "$ref": "#/components/schemas/SortObject"
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SortObject"
+            }
+          },
+          "paged": {
+            "type": "boolean"
+          },
+          "unpaged": {
+            "type": "boolean"
           },
           "pageNumber": {
             "type": "integer",
@@ -142,12 +154,6 @@
           "pageSize": {
             "type": "integer",
             "format": "int32"
-          },
-          "paged": {
-            "type": "boolean"
-          },
-          "unpaged": {
-            "type": "boolean"
           }
         }
       },

springdoc-openapi-tests/springdoc-openapi-data-rest-tests/src/test/resources/results/app27.json

@@ -63,7 +63,16 @@
             "format": "int64"
           },
           "sort": {
-            "$ref": "#/components/schemas/SortObject"
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SortObject"
+            }
+          },
+          "paged": {
+            "type": "boolean"
+          },
+          "unpaged": {
+            "type": "boolean"
           },
           "pageNumber": {
             "type": "integer",
@@ -72,12 +81,6 @@
           "pageSize": {
             "type": "integer",
             "format": "int32"
-          },
-          "paged": {
-            "type": "boolean"
-          },
-          "unpaged": {
-            "type": "boolean"
           }
         }
       },