[JAVA-SPRING,KOTLIN-SPRING] - feature: validate Pageable params [size, page, sort] and preserve defaults; add PagedModel<T> support; Add 'autoXSpringPaginated' to java-spring (#23575)

* feat: add sort validation support for pageable operations

* add sample

* add generated samples

* add to compiled samples

* add to compiled samples

* regenerate docs

* feat: add pageable defaults validation for pageable operations

* feat: enhance pageable validation with sort enum support

* feat: add pageable constraint validation tests for size and page limits

* update samples

* update samples & fix test

* feat: add validation for pageable and sort parameters with new annotations

* simplify implementation

* improve doc description

* improve sample

* rename from non-existent 'beanValidations' to 'useBeanValidation'

* feat: add enum validation for pageable sort parameters in API

* add tests for both exploded and non-exploded params

* fix samples after fix

* add spring-boot-starter-validation when useBeanValidation

* add java spring test and delete incorrect sample

* modify sample

* add tests

* add java samples

* add java samples

* add tests to java samples

* add missing tests for autoXSpringPaginated in java spring

* add to built samples

* fix: guard ValidPageable validator against Pageable.unpaged()

   Calling getPageSize()/getPageNumber() on Pageable.unpaged() throws
   UnsupportedOperationException. Add an isPaged() check so unpaged
   requests pass validation without error.

* fix javadoc

* remove unused import

* add implementation to detect schemas matching PageModel shape and replace with generic

* add implementation to detect schemas matching PageModel shape and replace with generic

* keep original implementation conditionally when needed by @apiresponse annotation for springdoc

* update samples

* update Spring Boot version to 3.3.13 in build files

* try to compile samples

* delete samples

* fix sample

* delete generated sample

* fix kotlin sample

* regenerate docs

* update samples

* fix generation suppresion logic and regenerate samples

* update samples

Author: Picazsoo

.github/workflows/samples-kotlin-server-jdk17.yaml

@@ -11,6 +11,8 @@ on:
       - 'samples/server/petstore/kotlin-server-required-and-nullable-properties/**'
       - 'samples/server/petstore/kotlin-spring-declarative*/**'
       - 'samples/server/petstore/kotlin-spring-sealed-interfaces/**'
+      - 'samples/server/petstore/kotlin-springboot-sort-validation/**'
+      - 'samples/server/petstore/kotlin-springboot-paged-model/**'
       # comment out due to gradle build failure
       # - samples/server/petstore/kotlin-spring-default/**
   pull_request:
@@ -23,6 +25,8 @@ on:
       - 'samples/server/petstore/kotlin-server-required-and-nullable-properties/**'
       - 'samples/server/petstore/kotlin-spring-declarative*/**'
       - 'samples/server/petstore/kotlin-spring-sealed-interfaces/**'
+      - 'samples/server/petstore/kotlin-springboot-sort-validation/**'
+      - 'samples/server/petstore/kotlin-springboot-paged-model/**'
       # comment out due to gradle build failure
       # - samples/server/petstore/kotlin-spring-default/**
 
@@ -62,6 +66,8 @@ jobs:
           - samples/server/petstore/kotlin-spring-declarative-interface-reactive-reactor-wrapped
           - samples/server/petstore/kotlin-spring-declarative-interface-wrapped
           - samples/server/petstore/kotlin-spring-sealed-interfaces
+          - samples/server/petstore/kotlin-springboot-sort-validation
+          - samples/server/petstore/kotlin-springboot-paged-model
           # comment out due to gradle build failure
           # - samples/server/petstore/kotlin-spring-default/
     steps:

.github/workflows/samples-spring-jdk17.yaml

@@ -14,6 +14,8 @@ on:
       - samples/server/petstore/springboot-lombok-tostring/**
       - samples/server/petstore/springboot-file-delegate-optional/**
       - samples/server/petstore/springboot-petstore-with-api-response-examples/**
+      - samples/server/petstore/springboot-sort-validation/**
+      - samples/server/petstore/springboot-paged-model/**
       - samples/openapi3/server/petstore/spring-boot-oneof-sealed/**
       - samples/openapi3/server/petstore/spring-boot-oneof-interface/**
   pull_request:
@@ -29,6 +31,8 @@ on:
       - samples/server/petstore/springboot-lombok-tostring/**
       - samples/server/petstore/springboot-file-delegate-optional/**
       - samples/server/petstore/springboot-petstore-with-api-response-examples/**
+      - samples/server/petstore/springboot-sort-validation/**
+      - samples/server/petstore/springboot-paged-model/**
       - samples/openapi3/server/petstore/spring-boot-oneof-sealed/**
       - samples/openapi3/server/petstore/spring-boot-oneof-interface/**
 jobs:
@@ -52,6 +56,8 @@ jobs:
           - samples/server/petstore/springboot-lombok-tostring
           - samples/server/petstore/springboot-file-delegate-optional
           - samples/server/petstore/springboot-petstore-with-api-response-examples
+          - samples/server/petstore/springboot-sort-validation
+          - samples/server/petstore/springboot-paged-model
           - samples/openapi3/server/petstore/spring-boot-oneof-sealed
           - samples/openapi3/server/petstore/spring-boot-oneof-interface
     steps:

bin/configs/kotlin-spring-boot-3-no-response-entity.yaml

@@ -9,6 +9,6 @@ additionalProperties:
   useSwaggerUI: "false"
   serviceImplementation: "true"
   serializableModel: "true"
-  beanValidations: "true"
+  useBeanValidation: "true"
   useSpringBoot3: "true"
   requestMappingMode: api_interface

bin/configs/kotlin-spring-boot-3.yaml

@@ -9,6 +9,6 @@ additionalProperties:
   useSwaggerUI: "false"
   serviceImplementation: "true"
   serializableModel: "true"
-  beanValidations: "true"
+  useBeanValidation: "true"
   useSpringBoot3: "true"
   requestMappingMode: api_interface

bin/configs/kotlin-spring-boot-4.yaml

@@ -9,7 +9,7 @@ additionalProperties:
   useSwaggerUI: "false"
   serviceImplementation: "true"
   serializableModel: "true"
-  beanValidations: "true"
+  useBeanValidation: "true"
   useSpringBoot4: "true"
   useJackson3: "true"
   requestMappingMode: api_interface

bin/configs/kotlin-spring-boot-additionalproperties.yaml

@@ -9,6 +9,6 @@ additionalProperties:
   useSwaggerUI: "false"
   serviceImplementation: "true"
   serializableModel: "true"
-  beanValidations: "true"
+  useBeanValidation: "true"
   useSpringBoot3: "true"
   requestMappingMode: api_interface

bin/configs/kotlin-spring-boot-delegate-nodefaults.yaml

@@ -9,6 +9,6 @@ additionalProperties:
   useSwaggerUI: "true"
   delegatePattern: "true"
   skipDefaultInterface: "true"
-  beanValidations: "true"
+  useBeanValidation: "true"
   requestMappingMode: "api_interface"
   useSpringBoot3: "true"

bin/configs/kotlin-spring-boot-delegate.yaml

@@ -9,5 +9,5 @@ additionalProperties:
   useSwaggerUI: "true"
   delegatePattern: "true"
   appendRequestToHandler: "true"
-  beanValidations: "true"
+  useBeanValidation: "true"
   requestMappingMode: none

bin/configs/kotlin-spring-boot-include-http-request-context-delegate.yaml

@@ -11,7 +11,7 @@ additionalProperties:
   skipDefaultInterface: true
   interfaceOnly: false
   serializableModel: true
-  beanValidations: true
+  useBeanValidation: true
   includeHttpRequestContext: true
   reactive: true
   delegatePattern: true

bin/configs/kotlin-spring-boot-modelMutable.yaml

@@ -9,5 +9,5 @@ additionalProperties:
   useSwaggerUI: "true"
   serializableModel: "true"
   serviceImplementation: "true"
-  beanValidations: "true"
+  useBeanValidation: "true"
   modelMutable: "true"