我已经阅读了关于Ktor客户端HTTP请求的文档,但缺少文件上传示例。它提到了PartData.FileItem
,但不清楚如何使用。
那么,在Ktor中如何准备一个用于文件上传的multipart/form-data
请求呢?
你应该使用 submitFormWithBinaryData
的 formData
参数来提供一个部件列表。有一个帮助函数 与相同名称 用于创建这样的列表。
HttpClient(Apache).use { client ->
val parts: List<PartData> = formData {
// Regular form parameter
append("text", "Hello, world")
// File upload. Param name is "file-1" and file's name is "file.csv"
append("file-1", "file.csv", ContentType.Text.CSV) {
this.append("1,2,3")
}
// Verbose DSL
val headersBuilder = HeadersBuilder()
headersBuilder[HttpHeaders.ContentType] = "application/java-archive"
headersBuilder[HttpHeaders.ContentDisposition] = "filename=wrapper.jar"
this.append(
"file-2",
InputProvider { File("gradle/wrapper/gradle-wrapper.jar").inputStream().asInput() },
headersBuilder.build()
)
}
client.submitFormWithBinaryData<Unit>(formData = parts /* prepared parts */) {
url("https://hookb.in/XXX")
// Query string parameters
parameter("param-1", "value-1")
parameter("param-2", "value-2-1")
parameter("param-2", "value-2-2")
// Headers
headers {
this["X-My-Header-1"] = "X-My-Header-1-Value"
appendAll("X-My-Header-2", listOf("X-My-Header-2-Value-1", "X-My-Header-2-Value-2"))
}
}
}