Mark HtmxView as deprecated in favor of HTML Fragments support in Spring Framework 6.2

See https://docs.spring.io/spring-framework/reference/web/webmvc-view/mvc-fragments.html

Author: xhaggi

htmx-spring-boot/src/main/java/io/github/wimdeblauwe/htmx/spring/boot/mvc/HtmxMvcAutoConfiguration.java

@@ -2,45 +2,29 @@
 
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.fasterxml.jackson.databind.json.JsonMapper;
-import org.springframework.beans.factory.ObjectFactory;
-import org.springframework.beans.factory.annotation.Qualifier;
 import org.springframework.boot.autoconfigure.AutoConfiguration;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnBean;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnWebApplication;
 import org.springframework.boot.autoconfigure.web.servlet.WebMvcRegistrations;
 import org.springframework.context.annotation.Bean;
 import org.springframework.core.Ordered;
-import org.springframework.util.Assert;
 import org.springframework.web.method.support.HandlerMethodArgumentResolver;
 import org.springframework.web.method.support.HandlerMethodReturnValueHandler;
-import org.springframework.web.servlet.LocaleResolver;
 import org.springframework.web.servlet.View;
-import org.springframework.web.servlet.ViewResolver;
 import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
-import org.springframework.web.servlet.config.annotation.ViewControllerRegistry;
 import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
 import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping;
-import org.springframework.web.servlet.view.BeanNameViewResolver;
 
 import java.util.List;
 
 @AutoConfiguration
 @ConditionalOnWebApplication
 public class HtmxMvcAutoConfiguration implements WebMvcRegistrations, WebMvcConfigurer {
 
-    private final ObjectFactory<ViewResolver> viewResolverObjectFactory;
-    private final ObjectFactory<LocaleResolver> localeResolverObjectFactory;
     private final ObjectMapper objectMapper;
 
-    HtmxMvcAutoConfiguration(@Qualifier("viewResolver") ObjectFactory<ViewResolver> viewResolverObjectFactory,
-                             ObjectFactory<LocaleResolver> localeResolverObjectFactory) {
-
-        Assert.notNull(viewResolverObjectFactory, "viewResolverObjectFactory must not be null!");
-        Assert.notNull(localeResolverObjectFactory, "localeResolverObjectFactory must not be null!");
-
-        this.viewResolverObjectFactory = viewResolverObjectFactory;
-        this.localeResolverObjectFactory = localeResolverObjectFactory;
+    HtmxMvcAutoConfiguration() {
         this.objectMapper = JsonMapper.builder().build();
     }
 
@@ -62,7 +46,7 @@ public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers)
 
     @Override
     public void addReturnValueHandlers(List<HandlerMethodReturnValueHandler> handlers) {
-        handlers.add(new HtmxViewMethodReturnValueHandler(viewResolverObjectFactory.getObject(), localeResolverObjectFactory.getObject()));
+        handlers.add(new HtmxViewMethodReturnValueHandler());
     }
 
     @Bean

htmx-spring-boot/src/main/java/io/github/wimdeblauwe/htmx/spring/boot/mvc/HtmxResponse.java

@@ -2,9 +2,7 @@
 
 import org.springframework.util.Assert;
 
-import java.util.Collection;
-import java.util.LinkedHashSet;
-import java.util.Set;
+import java.util.*;
 
 /**
  * A holder for htmx-related response headers that can be used as method argument in controllers.

htmx-spring-boot/src/main/java/io/github/wimdeblauwe/htmx/spring/boot/mvc/HtmxView.java

@@ -17,7 +17,9 @@
  * this class.
  *
  * @since 3.6.0
+ * @deprecated since 4.0.0 for removal in 4.1.0 in favor of <a href="https://docs.spring.io/spring-framework/reference/web/webmvc-view/mvc-fragments.html">HTML Fragments</a> support.
  */
+@Deprecated
 public class HtmxView {
 
     private final Set<ModelAndView> views = new LinkedHashSet<>();

htmx-spring-boot/src/main/java/io/github/wimdeblauwe/htmx/spring/boot/mvc/HtmxViewMethodReturnValueHandler.java

@@ -1,45 +1,20 @@
 package io.github.wimdeblauwe.htmx.spring.boot.mvc;
 
-import com.fasterxml.jackson.core.JsonProcessingException;
-import jakarta.servlet.http.HttpServletRequest;
-import jakarta.servlet.http.HttpServletResponse;
-import org.springframework.context.i18n.LocaleContextHolder;
 import org.springframework.core.MethodParameter;
-import org.springframework.lang.Nullable;
-import org.springframework.ui.ModelMap;
-import org.springframework.util.Assert;
-import org.springframework.util.CollectionUtils;
 import org.springframework.web.context.request.NativeWebRequest;
 import org.springframework.web.method.support.HandlerMethodReturnValueHandler;
 import org.springframework.web.method.support.ModelAndViewContainer;
-import org.springframework.web.servlet.LocaleResolver;
-import org.springframework.web.servlet.ModelAndView;
-import org.springframework.web.servlet.View;
-import org.springframework.web.servlet.ViewResolver;
-import org.springframework.web.servlet.mvc.support.RedirectAttributes;
-import org.springframework.web.util.ContentCachingResponseWrapper;
-
-import java.util.Collection;
-import java.util.HashMap;
-import java.util.Locale;
-import java.util.Map;
-import java.util.stream.Collectors;
+import org.springframework.web.servlet.view.FragmentsRendering;
 
 /**
  * Handles return values that are of type {@link HtmxView}.
  *
  * @since 3.6.0
+ * @deprecated since 4.0.0 for removal in 4.1.0 in favor of <a href="https://docs.spring.io/spring-framework/reference/web/webmvc-view/mvc-fragments.html">HTML Fragments</a> support.
  */
+@Deprecated
 public class HtmxViewMethodReturnValueHandler implements HandlerMethodReturnValueHandler {
 
-    private final ViewResolver viewResolver;
-    private final LocaleResolver localeResolver;
-
-    public HtmxViewMethodReturnValueHandler(ViewResolver viewResolver, LocaleResolver localeResolver) {
-        this.viewResolver = viewResolver;
-        this.localeResolver = localeResolver;
-    }
-
     @Override
     public boolean supportsReturnType(MethodParameter returnType) {
         return HtmxView.class.isAssignableFrom(returnType.getParameterType());
@@ -52,40 +27,10 @@ public void handleReturnValue(Object returnValue,
                                   NativeWebRequest webRequest) throws Exception {
 
         if (returnValue instanceof HtmxView htmxView) {
-            mavContainer.setView(toView(htmxView));
+            mavContainer.setView(FragmentsRendering.with(htmxView.getViews()).build());
         } else if (returnValue != null) {
             throw new UnsupportedOperationException("Unexpected return type: " + returnType.getParameterType().getName() + " in method: " + returnType.getMethod());
         }
     }
 
-    private View toView(HtmxView htmxView) {
-
-        return (model, request, response) -> {
-            Locale locale = localeResolver.resolveLocale(request);
-            ContentCachingResponseWrapper wrapper = new ContentCachingResponseWrapper(response);
-
-            for (ModelAndView mav : htmxView.getViews()) {
-                View view;
-                if (mav.isReference()) {
-                    view = viewResolver.resolveViewName(mav.getViewName(), locale);
-                    if (view == null) {
-                        throw new IllegalArgumentException("Could not resolve view with name '" + mav.getViewName() + "'.");
-                    }
-                } else {
-                    view = mav.getView();
-                }
-
-                for (String key : model.keySet()) {
-                    if (!mav.getModel().containsKey(key)) {
-                        mav.getModel().put(key, model.get(key));
-                    }
-                }
-
-                view.render(mav.getModel(), request, wrapper);
-            }
-
-            wrapper.copyBodyToResponse();
-        };
-    }
-
 }