Web

路由器 DSL

Spring Framework 提供了 3 種風格的 Kotlin 路由器 DSL

這些 DSL 讓你能夠編寫整潔、地道的 Kotlin 程式碼來構建 RouterFunction 例項，如下例所示

@Configuration
class RouterRouterConfiguration {

	@Bean
	fun mainRouter(userHandler: UserHandler) = router {
		accept(TEXT_HTML).nest {
			GET("/") { ok().render("index") }
			GET("/sse") { ok().render("sse") }
			GET("/users", userHandler::findAllView)
		}
		"/api".nest {
			accept(APPLICATION_JSON).nest {
				GET("/users", userHandler::findAll)
			}
			accept(TEXT_EVENT_STREAM).nest {
				GET("/users", userHandler::stream)
			}
		}
		resources("/**", ClassPathResource("static/"))
	}
}

此 DSL 是程式設計式的，這意味著它允許透過 if 表示式、for 迴圈或任何其他 Kotlin 構造進行 Bean 的自定義註冊邏輯。當你需要根據動態資料（例如，來自資料庫）註冊路由時，這會很有用。

請參閱 MiXiT project 獲取具體示例。

MockMvc DSL

透過 MockMvc Kotlin 擴充套件提供了 Kotlin DSL，以提供更地道的 Kotlin API 並允許更好的可發現性（不使用靜態方法）。

val mockMvc: MockMvc = ...
mockMvc.get("/person/{name}", "Lee") {
	secure = true
	accept = APPLICATION_JSON
	headers {
		contentLanguage = Locale.FRANCE
	}
	principal = Principal { "foo" }
}.andExpect {
	status { isOk }
	content { contentType(APPLICATION_JSON) }
	jsonPath("$.name") { value("Lee") }
	content { json("""{"someBoolean": false}""", false) }
}.andDo {
	print()
}

Kotlin 指令碼模板

Spring Framework 提供了 ScriptTemplateView，它支援 JSR-223，可以使用指令碼引擎渲染模板。

透過利用 scripting-jsr223 依賴，可以使用此特性，透過 kotlinx.html DSL 或 Kotlin 多行插值 String 渲染基於 Kotlin 的模板。

build.gradle.kts

dependencies {
	runtime("org.jetbrains.kotlin:kotlin-scripting-jsr223:${kotlinVersion}")
}

配置通常透過 ScriptTemplateConfigurer 和 ScriptTemplateViewResolver Bean 完成。

KotlinScriptConfiguration.kt

@Configuration
class KotlinScriptConfiguration {

	@Bean
	fun kotlinScriptConfigurer() = ScriptTemplateConfigurer().apply {
		engineName = "kotlin"
		setScripts("scripts/render.kts")
		renderFunction = "render"
		isSharedEngine = false
	}

	@Bean
	fun kotlinScriptViewResolver() = ScriptTemplateViewResolver().apply {
		setPrefix("templates/")
		setSuffix(".kts")
	}
}

有關更多詳情，請參閱 kotlin-script-templating 示例專案。

Kotlin 多平臺序列化

Kotlin 多平臺序列化在 Spring MVC、Spring WebFlux 和 Spring Messaging (RSocket) 中得到支援。內建支援目前針對 CBOR、JSON 和 ProtoBuf 格式。

要啟用它，請按照這些說明新增相關的依賴和外掛。對於 Spring MVC 和 WebFlux，如果它們在類路徑中，Kotlin 序列化和 Jackson 都會預設配置，因為 Kotlin 序列化旨在僅序列化用 @Serializable 註解的 Kotlin 類。對於 Spring Messaging (RSocket)，如果你想要自動配置，請確保類路徑中沒有 Jackson、GSON 或 JSONB；如果需要 Jackson，請手動配置 KotlinSerializationJsonMessageConverter。