HTTP 請求生命週期
必需相依性: io.ktor:ktor-server-core
程式碼範例: server-http-request-lifecycle
支援的引擎: Netty, CIO
Native 伺服器Ktor 支援 Kotlin/Native,可讓您在無需額外執行階段或虛擬機的情況下執行伺服器。 支援: ✖️
預設情況下,即使用戶端中斷連線,Ktor 也會繼續處理請求。HttpRequestLifecycle 外掛程式可讓你在用戶端中斷連線時立即取消請求處理。
這對於長時間執行或耗費資源的請求非常有用,這些請求在用戶端不再等待回應時應該停止執行。
安裝與設定 HttpRequestLifecycle
若要啟用 HttpRequestLifecycle 外掛程式,請在應用程式模組中使用 install 函式進行安裝,並設定 cancelCallOnClose 屬性:
import io.ktor.server.application.*
import io.ktor.server.http.HttpRequestLifecycle
fun Application.module() {
install(HttpRequestLifecycle) {
cancelCallOnClose = true
}
}當啟用 cancelCallOnClose 屬性時,HttpRequestLifecycle 外掛程式會為每個請求安裝一個取消處理常式。當用戶端中斷連線時,只會取消處理該特定路由的協同程式。
取消作業會透過結構化並行傳播,因此從請求協同程式啟動的任何子協同程式(例如使用 launch 或 async)也會被取消。在下一個掛焦點會擲出 CancellationException。
處理取消
你可以攔截 CancellationException 來執行清理作業,例如釋放資源或停止背景工作:
fun Application.module() {
install(HttpRequestLifecycle) {
cancelCallOnClose = true
}
routing {
get("/long-process") {
try {
while (isActive) {
delay(10_000)
log.info("Very important work.")
}
call.respond("Completed")
} catch (e: CancellationException) {
log.info("Cleaning up resources.")
}
}
}
}協同程式的取消是協作式的。阻塞或 CPU 密集型(CPU-bound)程式碼不會自動中斷。 如果請求處理執行長時間運行的工作,請呼叫 call.coroutineContext.ensureActive() 來對取消做出反應。
若要了解更多,請參閱 協同程式取消。
如需完整範例,請參閱 server-http-request-lifecycle。
限制
此外掛程式僅在 CIO 和 Netty 引擎上獲得完整支援。基於 Servlet 的引擎(或其他不支援的引擎)無法可靠地偵測用戶端中斷連線。只有在伺服器嘗試寫入回應時,才能偵測到取消。
