Spring Boot中Thymeleaf和htmx助手工具库
内容提要
该文章介绍了Spring Boot中使用Thymeleaf和htmx助手工具库的方法。htmx-spring-boot提供注释和帮助器类，htmx-spring-boot-thymeleaf提供Thymeleaf方言。通过注释控制器方法，可以将其映射到htmx请求，并可以限制调用的触发元素和目标元素。使用HtmxRequest对象可以访问htmx发送的HTTP请求头。使用注解或HtmxResponse类可以设置htmx响应头。使用HtmxResponse作为控制器方法的返回类型可以实现带外交换。Thymeleaf方言支持标记选择器和hx:get属性。
延伸解读
精准控制请求映射
通过@HxRequest注解，可以确保控制器方法仅响应htmx发起的请求，避免普通请求误入。进一步，使用value、triggerId或triggerName属性，能将调用限制在特定触发元素上；而target属性则限定目标元素。这种细粒度控制有助于减少不必要的请求处理，提升应用性能与代码可维护性。
灵活设置响应头与带外交换
设置htmx响应头有两种方式：注解（如@HxTrigger）或返回HtmxResponse对象。后者更灵活，支持链式调用，并能实现带外交换——在单个响应中返回多个视图片段，同时更新页面多个区域。HtmxResponse还可用于全局异常处理，通过reswap(HtmxReswap.none())阻止默认交换，仅显示错误信息片段。
Thymeleaf方言的便利与陷阱
Thymeleaf方言允许在hx-*属性中使用Thymeleaf表达式，如hx:get动态生成URL。但需注意：属性名用冒号代替连字符（hx:get而非hx-get），且值中若含#可能被误解析为翻译键，此时应使用hx-target="mydiv"或hx:target="${'mydiv'}"。hx:vals属性支持内联Map，简化JSON字符串的编写。
安全集成与错误处理
Spring Security集成提供了HxRefreshHeaderAuthenticationEntryPoint，当认证失败时，可让htmx强制刷新整个页面，避免登录页面出现在交换区域。配置时需将其设置为默认认证入口点，并匹配HX-Request请求头。结合HtmxResponse的错误处理，能构建更健壮的交互体验。
Q&A
如何在Spring Boot中使用htmx和Thymeleaf？
可以通过引入htmx-spring-boot和htmx-spring-boot-thymeleaf依赖，使用注释和辅助类来实现htmx与Thymeleaf的集成。
什么是HxRequest注解，它的作用是什么？
HxRequest注解用于将控制器方法映射到htmx请求，只有在基于htmx的请求时才会被调用。
如何使用HtmxResponse实现带外交换？
可以将HtmxResponse作为控制器方法的返回类型，并在其中添加多个视图，以实现带外交换更新多个目标。
Thymeleaf方言在htmx中有什么作用？
Thymeleaf方言为htmx相关属性提供了处理器，使得在模板中可以动态处理htmx属性。
如何在htmx请求中访问HTTP请求头？
可以使用HtmxRequest对象作为控制器方法的参数来访问htmx发送的HTTP请求头。
hx:vals属性的用途是什么？
hx:vals属性允许添加将随AJAX请求提交的参数，值应为JSON字符串，方便传递数据。
