testTypes = new HashMap<>();
@@ -123,6 +141,69 @@ void test_classes_and_records() {
.verifyIssues();
}
+ @Test
+ void test_spring_7_path_api_version() {
+ CheckVerifier.newVerifier()
+ .onFiles(List.of(API_VERSION_PATH_TEST_FILE, API_VERSION_PATH_CONFIGURATION_FILE))
+ .withCheck(new MissingPathVariableAnnotationCheck())
+ .withClassPath(SPRING_WEB_70_MODULE.getClassPath())
+ .verifyIssues();
+ }
+
+ @Test
+ void test_spring_7_unconditional_path_api_version() {
+ CheckVerifier.newVerifier()
+ .onFiles(List.of(API_VERSION_PATH_TEST_FILE, API_VERSION_PATH_UNCONDITIONAL_CONFIGURATION_FILE))
+ .withCheck(new MissingPathVariableAnnotationCheck())
+ .withClassPath(SPRING_WEB_70_MODULE.getClassPath())
+ .verifyIssues();
+ }
+
+ @Test
+ void test_spring_7_path_api_version_with_alternative_resolver() {
+ CheckVerifier.newVerifier()
+ .onFile(NON_PATH_API_VERSION_TEST_FILE)
+ .withCheck(new MissingPathVariableAnnotationCheck())
+ .withClassPath(SPRING_WEB_70_MODULE.getClassPath())
+ .verifyIssues();
+ }
+
+ @Test
+ void test_spring_7_ignores_inactive_api_version_configuration() {
+ CheckVerifier.newVerifier()
+ .onFile(INACTIVE_API_VERSION_CONFIGURATION_TEST_FILE)
+ .withCheck(new MissingPathVariableAnnotationCheck())
+ .withClassPath(SPRING_WEB_70_MODULE.getClassPath())
+ .verifyIssues();
+ }
+
+ @Test
+ void test_spring_7_multiple_path_api_version_indices_are_ambiguous() {
+ CheckVerifier.newVerifier()
+ .onFile(MULTIPLE_API_VERSION_INDICES_TEST_FILE)
+ .withCheck(new MissingPathVariableAnnotationCheck())
+ .withClassPath(SPRING_WEB_70_MODULE.getClassPath())
+ .verifyIssues();
+ }
+
+ @Test
+ void test_spring_7_configurer_escape_is_ambiguous() {
+ CheckVerifier.newVerifier()
+ .onFile(ESCAPING_API_VERSION_CONFIGURATION_TEST_FILE)
+ .withCheck(new MissingPathVariableAnnotationCheck())
+ .withClassPath(SPRING_WEB_70_MODULE.getClassPath())
+ .verifyIssues();
+ }
+
+ @Test
+ void test_spring_7_dynamic_path_api_version_index_is_ambiguous() {
+ CheckVerifier.newVerifier()
+ .onFile(DYNAMIC_API_VERSION_INDEX_TEST_FILE)
+ .withCheck(new MissingPathVariableAnnotationCheck())
+ .withClassPath(SPRING_WEB_70_MODULE.getClassPath())
+ .verifyIssues();
+ }
+
@Test
void test_without_semantic() {
CheckVerifier.newVerifier()
diff --git a/sonar-java-plugin/src/main/resources/org/sonar/l10n/java/rules/java/S6856.html b/sonar-java-plugin/src/main/resources/org/sonar/l10n/java/rules/java/S6856.html
index 8351dde38ea..cd893b08202 100644
--- a/sonar-java-plugin/src/main/resources/org/sonar/l10n/java/rules/java/S6856.html
+++ b/sonar-java-plugin/src/main/resources/org/sonar/l10n/java/rules/java/S6856.html
@@ -11,8 +11,12 @@ Why is this an issue?
variables to properties that have setter methods (including Lombok-generated setters). For records (Spring Web 5.3+), Spring binds path variables to
record components through their accessor methods. The @BindParam annotation can be used on record components to specify custom binding
names.
-This rule will raise an issue if a method has a path template with a placeholder, but no corresponding @PathVariable, matching class
-property, or matching record component, or vice-versa.
+Spring Framework 7 also supports resolving an API version from a path segment. When
+ApiVersionConfigurer.usePathSegment(...) is configured, the API version resolver reads the raw request path segment independently of
+controller argument binding. A placeholder in an explicitly versioned mapping can therefore be structural and does not need to be exposed as a
+handler method parameter.
+Except for a placeholder recognized as an API-version path segment, this rule will raise an issue if a method has a path template with a
+placeholder, but no corresponding @PathVariable, matching class property, or matching record component, or vice-versa.
How to fix it
Code examples
Noncompliant code example
@@ -133,9 +137,9 @@ Documentation
Framework API - PutMapping