此版本仍在开发中,尚不被认为是稳定的。对于最新的稳定版本,请使用 Spring Framework 6.2.10! |
HTML 片段
HTMX 和 Hotwire Turbo 强调HTML-over-the-wire 方法,客户端以 HTML 而不是 JSON 形式接收服务器更新。这允许 SPA(单页应用程序)的好处,而无需编写太多甚至任何 JavaScript。要获得良好的概述并了解更多信息,请访问他们各自的网站。
在 Spring MVC 中,视图渲染通常涉及指定一个视图和一个模型。但是,在 HTML-over-the-wire 中,一个常见的功能是发送多个 HTML 片段,这些浏览器可以使用这些片段来更新页面的不同部分。为此,控制器方法可以返回Collection<ModelAndView>
. 例如:
-
Java
-
Kotlin
@GetMapping
List<ModelAndView> handle() {
return List.of(new ModelAndView("posts"), new ModelAndView("comments"));
}
@GetMapping
fun handle(): List<ModelAndView> {
return listOf(ModelAndView("posts"), ModelAndView("comments"))
}
同样也可以通过返回专用类型来完成FragmentsRendering
:
-
Java
-
Kotlin
@GetMapping
FragmentsRendering handle() {
return FragmentsRendering.with("posts").fragment("comments").build();
}
@GetMapping
fun handle(): FragmentsRendering {
return FragmentsRendering.with("posts").fragment("comments").build()
}
每个片段都可以有一个独立的模型,并且该模型继承了请求的属性shared 模型。
HTMX 和 Hotwire Turbo 支持通过 SSE 进行流式更新(服务器发送的事件)。控制器可以使用SseEmitter
发送ModelAndView
要为每个事件渲染一个片段:
-
Java
-
Kotlin
@GetMapping
SseEmitter handle() {
SseEmitter emitter = new SseEmitter();
startWorkerThread(() -> {
try {
emitter.send(SseEmitter.event().data(new ModelAndView("posts")));
emitter.send(SseEmitter.event().data(new ModelAndView("comments")));
// ...
}
catch (IOException ex) {
// Cancel sending
}
});
return emitter;
}
@GetMapping
fun handle(): SseEmitter {
val emitter = SseEmitter()
startWorkerThread{
try {
emitter.send(SseEmitter.event().data(ModelAndView("posts")))
emitter.send(SseEmitter.event().data(ModelAndView("comments")))
// ...
}
catch (ex: IOException) {
// Cancel sending
}
}
return emitter
}
同样也可以通过返回来完成Flux<ModelAndView>
,或任何其他类型可适应到响应式流Publisher
通过ReactiveAdapterRegistry
.