add better support for validation groups

.github/workflows/codeql-analysis.yml

@@ -46,7 +46,7 @@ jobs:
         languages: java
 
     - name: Cache local Maven repository
-      uses: actions/cache@v2
+      uses: actions/cache@v4
       with:
         path: ~/.m2/repository
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}

.github/workflows/maven-pulls.yml

@@ -19,7 +19,7 @@ jobs:
       with:
         java-version: ${{ matrix.java }}
     - name: Cache local Maven repository
-      uses: actions/cache@v2
+      uses: actions/cache@v4
       with:
         path: ~/.m2/repository
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}

.github/workflows/maven-v1-pulls.yml

@@ -19,7 +19,7 @@ jobs:
       with:
         java-version: ${{ matrix.java }}
     - name: Cache local Maven repository
-      uses: actions/cache@v2
+      uses: actions/cache@v4
       with:
         path: ~/.m2/repository
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}

.github/workflows/maven-v1.yml

@@ -22,7 +22,7 @@ jobs:
           server-username: MAVEN_USERNAME
           server-password: MAVEN_PASSWORD
       - name: Cache local Maven repository
-        uses: actions/cache@v2
+        uses: actions/cache@v4
         with:
           path: ~/.m2/repository
           key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}

.github/workflows/maven.yml

@@ -22,7 +22,7 @@ jobs:
         server-username: MAVEN_USERNAME
         server-password: MAVEN_PASSWORD
     - name: Cache local Maven repository
-      uses: actions/cache@v2
+      uses: actions/cache@v4
       with:
         path: ~/.m2/repository
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}

.github/workflows/prepare-release.yml

@@ -28,7 +28,7 @@ jobs:
         server-username: MAVEN_USERNAME
         server-password: MAVEN_PASSWORD
     - name: Cache local Maven repository
-      uses: actions/cache@v2
+      uses: actions/cache@v4
       with:
         path: ~/.m2/repository
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}

.github/workflows/release.yml

@@ -28,7 +28,7 @@ jobs:
         server-username: MAVEN_USERNAME
         server-password: MAVEN_PASSWORD
     - name: Cache local Maven repository
-      uses: actions/cache@v2
+      uses: actions/cache@v4
       with:
         path: ~/.m2/repository
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}

modules/swagger-annotations/src/main/java/io/swagger/v3/oas/annotations/Parameter.java

@@ -159,4 +159,6 @@
      * @return the reference
      **/
     String ref() default "";
+
+    Class<?>[] validationGroups() default {};
 }

modules/swagger-annotations/src/main/java/io/swagger/v3/oas/annotations/parameters/ValidatedParameter.java

@@ -0,0 +1,16 @@
+package io.swagger.v3.oas.annotations.parameters;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Variant of JSR-303's jakarta.validation.Valid, supporting the
+ * specification of validation groups.
+ **/
+@Target({ElementType.PARAMETER})
+@Retention(RetentionPolicy.RUNTIME)
+public @interface ValidatedParameter {
+    Class<?>[] value() default {};
+}

modules/swagger-core/src/main/java/io/swagger/v3/core/converter/ModelConverters.java

@@ -2,6 +2,7 @@
 
 import com.fasterxml.jackson.databind.type.TypeFactory;
 import io.swagger.v3.core.jackson.ModelResolver;
+import io.swagger.v3.core.util.Configuration;
 import io.swagger.v3.core.util.Json;
 import io.swagger.v3.core.util.Json31;
 import io.swagger.v3.oas.models.media.Schema;
@@ -51,6 +52,16 @@ public ModelConverters(boolean openapi31, Schema.SchemaResolution schemaResoluti
         }
     }
 
+    public ModelConverters(Configuration configuration) {
+        converters = new CopyOnWriteArrayList<>();
+        boolean openapi31 =configuration != null && configuration.isOpenAPI31() != null && configuration.isOpenAPI31();
+        if (openapi31) {
+            converters.add(new ModelResolver(Json31.mapper()).configuration(configuration));
+        } else {
+            converters.add(new ModelResolver(Json.mapper()).configuration(configuration));
+        }
+    }
+
     public Set<String> getSkippedPackages() {
         return skippedPackages;
     }
@@ -95,6 +106,28 @@ public static ModelConverters getInstance(boolean openapi31, Schema.SchemaResolu
         }
     }
 
+    public static ModelConverters getInstance(Configuration configuration) {
+        synchronized (ModelConverters.class) {
+            boolean openapi31 = configuration != null && configuration.isOpenAPI31() != null && configuration.isOpenAPI31();
+            if (openapi31) {
+                if (SINGLETON31 == null) {
+                    boolean applySchemaResolution = Boolean.parseBoolean(System.getProperty(Schema.APPLY_SCHEMA_RESOLUTION_PROPERTY, "false")) || Boolean.parseBoolean(System.getenv(Schema.APPLY_SCHEMA_RESOLUTION_PROPERTY));
+                    if (!applySchemaResolution) {
+                        configuration.schemaResolution(Schema.SchemaResolution.DEFAULT);
+                    }
+                    SINGLETON31 = new ModelConverters(configuration);
+                    init(SINGLETON31);
+                }
+                return SINGLETON31;
+            }
+            if (SINGLETON == null) {
+                SINGLETON = new ModelConverters(configuration);
+                init(SINGLETON);
+            }
+            return SINGLETON;
+        }
+    }
+
     private static void init(ModelConverters converter) {
         converter.addPackageToSkip("java.lang");
         converter.addPackageToSkip("groovy.lang");