Ktor 文件

Ktor 是一個能輕鬆建構非同步伺服器端和用戶端應用程式的框架。

Ktor 伺服器入門

了解如何使用 Ktor 建立、執行和測試伺服器應用程式。

Ktor 用戶端入門

了解如何使用 Ktor 建立、執行和測試用戶端應用程式。

Ktor 伺服器

處理請求與產生回應

透過建立一個任務管理應用程式，了解 Ktor 中路由和請求的運作方式。

建立 RESTful API

了解如何使用 Ktor 建立 RESTful API。本教學涵蓋實際範例的設定、路由和測試。

建立網站

了解如何使用 Kotlin、Ktor 和 Thymeleaf 範本建構網站。

建立 WebSocket 應用程式

了解如何利用 WebSocket 的強大功能來傳送和接收內容。

整合資料庫

了解如何使用 Exposed SQL Library 將 Ktor 服務連接到資料庫儲存庫的過程。

伺服器配置

建立、開啟和執行新的 Ktor 專案

了解如何開啟、執行和測試 Ktor 伺服器應用程式。

新增伺服器依賴項

了解如何將 Ktor 伺服器依賴項新增至現有的 Gradle/Maven 專案。

建立伺服器

了解如何根據您的應用程式部署需求建立伺服器。

程式碼配置

了解如何在程式碼中配置各種伺服器參數。

檔案配置

了解如何在設定檔中配置各種伺服器參數。

伺服器外掛程式

外掛程式提供常見功能，例如序列化、內容編碼、壓縮等。

路由

路由

路由是處理伺服器應用程式中傳入請求的核心外掛程式。

型別安全路由

Resources 外掛程式允許您實作型別安全的路由。

應用程式結構

了解如何建構您的應用程式，使其隨著應用程式的成長而保持可維護性。

處理請求

了解如何在路由處理器中處理傳入請求。

傳送回應

了解如何傳送不同類型的回應。

提供靜態內容

了解如何提供靜態內容，例如樣式表、指令碼、圖像等。

外掛程式

Ktor 伺服器中的內容協商與序列化

ContentNegotiation 外掛程式主要有兩個目的：協商用戶端和伺服器之間的媒體型別，以及以特定格式序列化/反序列化內容。

模板

了解如何使用 HTML/CSS 或 JVM 模板引擎建構的視圖。

Ktor 伺服器中的驗證與授權

Authentication 外掛程式處理 Ktor 中的驗證與授權。

會話

Sessions 外掛程式提供一種在不同 HTTP 請求之間保留資料的機制。

Ktor 伺服器中的 WebSocket

Websockets 外掛程式允許您在伺服器和用戶端之間建立多向通訊會話。

Ktor 伺服器中的伺服器傳送事件

SSE 外掛程式允許伺服器透過 HTTP 連線向用戶端傳送基於事件的更新。

Swagger UI

SwaggerUI 外掛程式允許您為專案產生 Swagger UI。

/

OpenAPI

OpenAPI 外掛程式允許您為專案產生 OpenAPI 文件。

自訂伺服器外掛程式

了解如何建立您自己的自訂外掛程式。

執行、偵錯與測試

執行

了解如何執行 Ktor 伺服器應用程式。

自動重新載入

了解如何使用自動重新載入 (Auto-reload) 在程式碼變更時重新載入應用程式類別。

Ktor 伺服器中的測試

了解如何使用特殊的測試引擎測試您的伺服器應用程式。

部署

建立 Fat JAR

了解如何使用 Ktor Gradle 外掛程式建立和執行可執行 Fat JAR。

WAR

了解如何使用 WAR 檔案在 Servlet 容器中執行和部署 Ktor 應用程式。

GraalVM

了解如何在不同平台上使用 GraalVM 進行原生映像。

Docker

了解如何將您的應用程式部署到 Docker 容器。

Google App Engine

了解如何將您的專案部署到 Google App Engine 標準環境。

Heroku

了解如何準備 Ktor 應用程式並部署到 Heroku。

Ktor 用戶端

建立用戶端應用程式

使用 Ktor 建立用戶端應用程式。

建立跨平台行動應用程式

建立 Kotlin 多平台行動應用程式，並了解如何使用 Ktor Client 發送請求和接收回應。

用戶端設定

建立用戶端應用程式

建立您的第一個用戶端應用程式以傳送請求和接收回應。

新增用戶端依賴項

了解如何將用戶端依賴項新增至現有專案。

建立和配置用戶端

了解如何建立和配置 Ktor 用戶端。

用戶端引擎

了解處理網路請求的引擎。

用戶端外掛程式

熟悉提供常見功能的外掛程式，例如日誌記錄、序列化、授權等。

請求

發送請求

了解如何發送請求並指定各種請求參數：請求 URL、HTTP 方法、標頭和請求主體。

型別安全請求

了解如何使用 Resources 外掛程式建立型別安全的請求。

預設請求

DefaultRequest 外掛程式允許您配置所有請求的預設參數。

重試失敗的請求

HttpRequestRetry 外掛程式允許您配置失敗請求的重試策略。

回應

接收回應

了解如何接收回應、獲取回應主體並取得回應參數。

回應驗證

了解如何根據狀態碼驗證回應。

外掛程式

Ktor 用戶端中的驗證與授權

Auth 外掛程式處理用戶端應用程式中的驗證與授權。

Cookie

HttpCookies 外掛程式自動處理 cookie 並將其儲存在儲存空間中以供呼叫之間使用。

內容編碼

ContentEncoding 外掛程式允許您啟用指定的壓縮演算法（例如 'gzip' 和 'deflate'）並配置其設定。

BOM 移除器

BOMRemover 外掛程式允許您從回應主體中移除位元組順序標記 (BOM)。

快取

HttpCache 外掛程式允許您將先前獲取的資源儲存到記憶體或持久快取中。

Ktor 用戶端中的 WebSocket

Websockets 外掛程式允許您在伺服器和用戶端之間建立多向通訊會話。

Ktor 用戶端中的伺服器傳送事件

SSE 外掛程式允許用戶端透過 HTTP 連線從伺服器接收基於事件的更新。

自訂用戶端外掛程式

了解如何建立您自己的自訂用戶端外掛程式。

測試

Ktor 用戶端中的測試

了解如何使用 MockEngine 透過模擬 HTTP 呼叫來測試您的用戶端。

整合

使用 Kotlin 多平台建構全端應用程式

了解如何在 Kotlin 和 Ktor 中開發跨平台全端應用程式。

Kotlin RPC 入門

了解如何使用 Kotlin RPC 和 Ktor 建立您的第一個應用程式。