请求验证
所需依赖项: io.ktor:ktor-server-request-validation
代码示例: request-validation
原生服务器Ktor 支持 Kotlin/Native,并允许您在无需额外运行时或虚拟机的情况下运行服务器。支持: ✅
RequestValidation 插件提供了验证传入请求正文的功能。您可以验证原始请求正文,或者在安装了带有序列化程序的 ContentNegotiation 插件时验证指定的请求对象属性。如果请求正文验证失败,该插件会引发 RequestValidationException,可以使用 StatusPages 插件对其进行处理。
添加依赖项
要使用 RequestValidation,请将 ktor-server-request-validation 构件添加到您的构建脚本中:
implementation(ktorLibs.server.requestValidation)implementation ktorLibs.server.requestValidation<dependency>
<groupId>io.ktor</groupId>
<artifactId>ktor-server-request-validation-jvm</artifactId>
<version>${ktor_version}</version>
</dependency>安装 RequestValidation
要在应用程序中安装 RequestValidation 插件,请将其传递给指定模块模块允许您通过对路由进行分组来构建应用程序结构。中的 install 函数。以下示例展示了如何安装 RequestValidation:
- 在
embeddedServer()函数调用中。 - 在
Application类上显式定义的module()扩展函数中。
import io.ktor.server.engine.*
import io.ktor.server.netty.*
import io.ktor.server.application.*
import io.ktor.server.plugins.requestvalidation.*
fun main() {
embeddedServer(Netty, port = 8080) {
install(RequestValidation)
// ...
}.start(wait = true)
}import io.ktor.server.application.*
import io.ktor.server.plugins.requestvalidation.*
// ...
fun Application.module() {
install(RequestValidation)
// ...
}RequestValidation 插件也可以安装到特定路由。如果您需要为不同的应用程序资源使用不同的 RequestValidation 配置,这会非常有用。
配置 RequestValidation
配置 RequestValidation 主要包含三个步骤:
1. 接收正文
如果您调用带有类型实参的 receive 函数,RequestValidation 插件将验证请求的正文。例如,以下代码段展示了如何将正文作为 String 值接收:
routing {
post("/text") {
val body = call.receive<String>()
call.respond(body)
}
}2. 配置验证函数
要验证请求正文,请使用 validate 函数。 该函数返回一个表示验证成功或失败结果的 ValidationResult 对象。 对于失败的结果,会引发 RequestValidationException。
validate 函数具有两个重载,允许您通过两种方式验证请求正文:
第一个
validate重载允许您将请求正文作为指定类型的对象进行访问。 以下示例展示了如何验证表示String值的请求正文:kotlininstall(RequestValidation) { validate<String> { bodyText -> if (!bodyText.startsWith("Hello")) ValidationResult.Invalid("Body text should start with 'Hello'") else ValidationResult.Valid } }如果您安装了配置有特定序列化程序的
ContentNegotiation插件,则可以验证对象属性。详细了解请参阅示例:验证对象属性。第二个
validate重载接受ValidatorBuilder,允许您提供自定义验证规则。 您可以从示例:验证字节数组中了解更多信息。
3. 处理验证异常
如果请求验证失败,RequestValidation 会引发 RequestValidationException。 此异常允许您访问请求正文并获取此请求所有验证失败的原因。
您可以按如下方式使用 StatusPages 插件处理 RequestValidationException:
install(StatusPages) {
exception<RequestValidationException> { call, cause ->
call.respond(HttpStatusCode.BadRequest, cause.reasons.joinToString())
}
}您可以在此处找到完整示例:request-validation。
示例:验证对象属性
在本示例中,我们将探讨如何使用 RequestValidation 插件验证对象属性。 假设服务器收到包含以下 JSON 数据的 POST 请求:
POST http://0.0.0.0:8080/json
Content-Type: application/json
{
"id": -1,
"firstName": "Jet",
"lastName": "Brains"
}要添加对 id 属性的验证,请按以下步骤操作:
创建描述上述 JSON 对象的
Customer数据类:kotlin@Serializable data class Customer(val id: Int, val firstName: String, val lastName: String)安装带有 JSON 序列化程序的
ContentNegotiation插件:kotlininstall(ContentNegotiation) { json() }在服务器端接收
Customer对象,如下所示:kotlinpost("/json") { val customer = call.receive<Customer>() call.respond(customer) }在
RequestValidation插件配置中,添加对id属性的验证,以确保其位于指定范围内:kotlininstall(RequestValidation) { validate<Customer> { customer -> if (customer.id <= 0) ValidationResult.Invalid("A customer ID should be greater than 0") else ValidationResult.Valid } }在这种情况下,如果
id值小于或等于0,RequestValidation将引发 RequestValidationException。
示例:验证字节数组
在本示例中,我们将探讨如何验证作为字节数组接收的请求正文。 假设服务器收到包含以下文本数据的 POST 请求:
POST http://localhost:8080/array
Content-Type: text/plain
-1要将数据作为字节数组接收并对其进行验证,请执行以下步骤:
- 在服务器端接收数据,如下所示:kotlin
post("/array") { val body = call.receive<ByteArray>() call.respond(String(body)) } - 为了验证接收到的数据,我们将使用第二个
validate函数重载,该重载接受ValidatorBuilder并允许您提供自定义验证规则:kotlininstall(RequestValidation) { validate { filter { body -> body is ByteArray } validation { body -> check(body is ByteArray) val intValue = String(body).toInt() if (intValue <= 0) ValidationResult.Invalid("A value should be greater than 0") else ValidationResult.Valid } } }
