Expose handler to ApiVersionDeprecationHandler implementations

Closes gh-35750

Author: rstoyanchev

spring-web/src/main/java/org/springframework/web/accept/ApiVersionDeprecationHandler.java

@@ -35,9 +35,12 @@ public interface ApiVersionDeprecationHandler {
 	 * accordingly, e.g. by setting response headers to signal the deprecation,
 	 * to specify relevant dates and provide links to further details.
 	 * @param version the resolved and parsed request version
+	 * @param handler the handler chosen for the request
 	 * @param request the current request
 	 * @param response the current response
 	 */
-	void handleVersion(Comparable<?> version, HttpServletRequest request, HttpServletResponse response);
+	void handleVersion(
+			Comparable<?> version, Object handler,
+			HttpServletRequest request, HttpServletResponse response);
 
 }

spring-web/src/main/java/org/springframework/web/accept/ApiVersionStrategy.java

@@ -91,10 +91,12 @@ void validateVersion(@Nullable Comparable<?> requestVersion, HttpServletRequest
 	 * accordingly, e.g. by setting response headers to signal the deprecation,
 	 * to specify relevant dates and provide links to further details.
 	 * @param version the resolved and parsed request version
+	 * @param handler the handler chosen for the request
 	 * @param request the current request
 	 * @param response the current response
 	 * @see ApiVersionDeprecationHandler
 	 */
-	void handleDeprecations(Comparable<?> version, HttpServletRequest request, HttpServletResponse response);
+	void handleDeprecations(
+			Comparable<?> version, Object handler, HttpServletRequest request, HttpServletResponse response);
 
 }

spring-web/src/main/java/org/springframework/web/accept/DefaultApiVersionStrategy.java

@@ -180,9 +180,11 @@ public void validateVersion(@Nullable Comparable<?> requestVersion, HttpServletR
 	}
 
 	@Override
-	public void handleDeprecations(Comparable<?> version, HttpServletRequest request, HttpServletResponse response) {
+	public void handleDeprecations(
+			Comparable<?> version, Object handler, HttpServletRequest request, HttpServletResponse response) {
+
 		if (this.deprecationHandler != null) {
-			this.deprecationHandler.handleVersion(version, request, response);
+			this.deprecationHandler.handleVersion(version, handler, request, response);
 		}
 	}
 

spring-web/src/main/java/org/springframework/web/accept/StandardApiVersionDeprecationHandler.java

@@ -87,7 +87,8 @@ public VersionSpec configureVersion(String version) {
 
 	@Override
 	public void handleVersion(
-			Comparable<?> requestVersion, HttpServletRequest request, HttpServletResponse response) {
+			Comparable<?> requestVersion, Object handler,
+			HttpServletRequest request, HttpServletResponse response) {
 
 		for (VersionInfo info : this.infos.values()) {
 			if (info.match(requestVersion, request)) {

spring-web/src/test/java/org/springframework/web/accept/StandardApiVersionDeprecationHandlerTests.java

@@ -53,7 +53,7 @@ void basic() {
 				.setSunsetDate(getDate(sunsetDate))
 				.setSunsetLink(URI.create(sunsetUrl));
 
-		handler.handleVersion("1.1", request, response);
+		handler.handleVersion("1.1", new Object(), request, response);
 
 		assertThat(response.getHeader("Deprecation")).isEqualTo("@1688169599");
 		assertThat(response.getHeader("Sunset")).isEqualTo(sunsetDate);

spring-webflux/src/main/java/org/springframework/web/reactive/accept/ApiVersionDeprecationHandler.java

@@ -33,8 +33,9 @@ public interface ApiVersionDeprecationHandler {
 	 * accordingly, e.g. by setting response headers to signal the deprecation,
 	 * to specify relevant dates and provide links to further details.
 	 * @param version the resolved and parsed request version
+	 * @param handler the handler chosen for the exchange
 	 * @param exchange the current exchange
 	 */
-	void handleVersion(Comparable<?> version, ServerWebExchange exchange);
+	void handleVersion(Comparable<?> version, Object handler, ServerWebExchange exchange);
 
 }

spring-webflux/src/main/java/org/springframework/web/reactive/accept/ApiVersionStrategy.java

@@ -93,9 +93,10 @@ void validateVersion(@Nullable Comparable<?> requestVersion, ServerWebExchange e
 	 * accordingly, e.g. by setting response headers to signal the deprecation,
 	 * to specify relevant dates and provide links to further details.
 	 * @param version the resolved and parsed request version
+	 * @param handler the handler chosen for the exchange
 	 * @param exchange the current exchange
 	 * @see ApiVersionDeprecationHandler
 	 */
-	void handleDeprecations(Comparable<?> version, ServerWebExchange exchange);
+	void handleDeprecations(Comparable<?> version, Object handler, ServerWebExchange exchange);
 
 }

spring-webflux/src/main/java/org/springframework/web/reactive/accept/DefaultApiVersionStrategy.java

@@ -181,9 +181,9 @@ public void validateVersion(@Nullable Comparable<?> requestVersion, ServerWebExc
 	}
 
 	@Override
-	public void handleDeprecations(Comparable<?> version, ServerWebExchange exchange) {
+	public void handleDeprecations(Comparable<?> version, Object handler, ServerWebExchange exchange) {
 		if (this.deprecationHandler != null) {
-			this.deprecationHandler.handleVersion(version, exchange);
+			this.deprecationHandler.handleVersion(version, handler, exchange);
 		}
 	}
 

spring-webflux/src/main/java/org/springframework/web/reactive/accept/StandardApiVersionDeprecationHandler.java

@@ -86,7 +86,7 @@ public VersionSpec configureVersion(String version) {
 	}
 
 	@Override
-	public void handleVersion(Comparable<?> requestVersion, ServerWebExchange exchange) {
+	public void handleVersion(Comparable<?> requestVersion, Object handler, ServerWebExchange exchange) {
 		for (VersionInfo info : this.infos.values()) {
 			if (info.match(requestVersion, exchange)) {
 				HttpHeaders headers = exchange.getResponse().getHeaders();

spring-webflux/src/main/java/org/springframework/web/reactive/handler/AbstractHandlerMapping.java

@@ -206,7 +206,7 @@ public Mono<Object> getHandler(ServerWebExchange exchange) {
 			if (getApiVersionStrategy() != null) {
 				Comparable<?> version = exchange.getAttribute(API_VERSION_ATTRIBUTE);
 				if (version != null) {
-					getApiVersionStrategy().handleDeprecations(version, exchange);
+					getApiVersionStrategy().handleDeprecations(version, handler, exchange);
 				}
 			}
 			return handler;