Support Java record for @ParameterObejct annotation. Fixes #1728

Author: bnasslahsen

springdoc-openapi-starter-common/src/main/java/org/springdoc/core/extractor/MethodParameterPojoExtractor.java

@@ -173,15 +173,23 @@ private static Stream<MethodParameter> fromSimpleClass(Class<?> paramClass, Fiel
 		Annotation[] fieldAnnotations = field.getDeclaredAnnotations();
 		try {
 			Parameter parameter = field.getAnnotation(Parameter.class);
-			boolean isNotRequired  = parameter == null || !parameter.required();
+			boolean isNotRequired = parameter == null || !parameter.required();
 			Annotation[] finalFieldAnnotations = fieldAnnotations;
-			return Stream.of(Introspector.getBeanInfo(paramClass).getPropertyDescriptors())
-					.filter(d -> d.getName().equals(field.getName()))
-					.map(PropertyDescriptor::getReadMethod)
-					.filter(Objects::nonNull)
-					.map(method -> new MethodParameter(method, -1))
-					.map(methodParameter -> DelegatingMethodParameter.changeContainingClass(methodParameter, paramClass))
-					.map(param -> new DelegatingMethodParameter(param, fieldNamePrefix + field.getName(), finalFieldAnnotations, true, isNotRequired));
+			if (paramClass.isRecord()) {
+				return Stream.of( paramClass.getRecordComponents()).map(recordComponent -> recordComponent.getAccessor())
+						.map(method -> new MethodParameter(method, -1))
+						.map(methodParameter -> DelegatingMethodParameter.changeContainingClass(methodParameter, paramClass))
+						.map(param -> new DelegatingMethodParameter(param, fieldNamePrefix + field.getName(), finalFieldAnnotations, true, isNotRequired));
+
+			}
+			else
+				return Stream.of(Introspector.getBeanInfo(paramClass).getPropertyDescriptors())
+						.filter(d -> d.getName().equals(field.getName()))
+						.map(PropertyDescriptor::getReadMethod)
+						.filter(Objects::nonNull)
+						.map(method -> new MethodParameter(method, -1))
+						.map(methodParameter -> DelegatingMethodParameter.changeContainingClass(methodParameter, paramClass))
+						.map(param -> new DelegatingMethodParameter(param, fieldNamePrefix + field.getName(), finalFieldAnnotations, true, isNotRequired));
 		}
 		catch (IntrospectionException e) {
 			return Stream.of();

springdoc-openapi-starter-webmvc-api/src/test/java/test/org/springdoc/api/v30/app69/HelloController.java

@@ -26,7 +26,10 @@
 
 import java.util.concurrent.Callable;
 
+import org.springdoc.core.annotations.ParameterObject;
+
 import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RequestMethod;
 import org.springframework.web.bind.annotation.RestController;
@@ -39,4 +42,9 @@ private Callable<ResponseEntity<PersonDTO>> getTasks(String str) {
 		return null;
 	}
 
+	@GetMapping(value = "/testRecord")
+	private Callable<ResponseEntity<PersonDTO>> getInfo(@ParameterObject PersonDTO personDTO) {
+		return null;
+	}
+
 }

springdoc-openapi-starter-webmvc-api/src/test/java/test/org/springdoc/api/v30/app69/PersonDTO.java

@@ -24,43 +24,5 @@
 
 package test.org.springdoc.api.v30.app69;
 
-public class PersonDTO {
-	private String email;
-
-	private String firstName;
-
-	private String lastName;
-
-	public PersonDTO() {
-	}
-
-	public PersonDTO(final String email, final String firstName, final String lastName) {
-		this.email = email;
-		this.firstName = firstName;
-		this.lastName = lastName;
-	}
-
-	public String getEmail() {
-		return email;
-	}
-
-	public void setEmail(final String email) {
-		this.email = email;
-	}
-
-	public String getFirstName() {
-		return firstName;
-	}
-
-	public void setFirstName(final String firstName) {
-		this.firstName = firstName;
-	}
-
-	public String getLastName() {
-		return lastName;
-	}
-
-	public void setLastName(final String lastName) {
-		this.lastName = lastName;
-	}
+public record PersonDTO (String email,String firstName,String lastName){
 }

springdoc-openapi-starter-webmvc-api/src/test/resources/results/3.0.1/app69.json

@@ -11,6 +11,52 @@
     }
   ],
   "paths": {
+    "/testRecord": {
+      "get": {
+        "tags": [
+          "hello-controller"
+        ],
+        "operationId": "getInfo",
+        "parameters": [
+          {
+            "name": "email",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "firstName",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "lastName",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "*/*": {
+                "schema": {
+                  "$ref": "#/components/schemas/PersonDTO"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/tasks": {
       "get": {
         "tags": [