{"id":523865,"date":"2024-11-08T06:00:10","date_gmt":"2024-11-08T05:00:10","guid":{"rendered":"https:\/\/blog.jetbrains.com\/?post_type=kotlin&#038;p=523865"},"modified":"2024-11-11T05:03:41","modified_gmt":"2024-11-11T04:03:41","slug":"ktor-3-0","status":"publish","type":"kotlin","link":"https:\/\/blog.jetbrains.com\/zh-hans\/kotlin\/2024\/11\/ktor-3-0\/","title":{"rendered":"Ktor 3.0 \u73b0\u5728\u63a8\u51fa\u65b0\u529f\u80fd\uff0c\u6027\u80fd\u4e5f\u5f97\u5230\u63d0\u5347"},"content":{"rendered":"<p>\u6b64\u65b0\u7248\u672c\u4f7f\u7528 Kotlin 2.0\uff0c\u5e76\u5207\u6362\u5230 <a href=\"http:\/\/kotlinx.io\" target=\"_blank\" rel=\"noreferrer noopener\">kotlinx-io<\/a>\uff0c\u56e0\u6b64 Ktor \u66f4\u52a0\u73b0\u4ee3\u5316\uff0c\u4e0e\u5176\u4ed6 Kotlin \u5de5\u5177\u7684\u8fde\u63a5\u4e5f\u66f4\u597d\u3002 Ktor 3.0 \u7684\u8fd0\u884c\u901f\u5ea6\u66f4\u5feb\uff0c\u5e76\u63d0\u4f9b\u4e86\u66f4\u591a\u5ba2\u6237\u7aef-\u670d\u52a1\u5668\u5e94\u7528\u7a0b\u5e8f\u6784\u5efa\u9009\u9879\u3002<\/p>\n<p>\u5982\u679c\u60a8\u521a\u5f00\u59cb\u4f7f\u7528 Ktor \u6216\u9700\u8981\u4e86\u89e3\u5176\u8fd0\u4f5c\u65b9\u5f0f\uff0c\u8bf7\u9605\u8bfb\u6211\u4eec\u6700\u65b0\u53d1\u5e03\u7684\u535a\u6587 <a href=\"https:\/\/blog.jetbrains.com\/idea\/2024\/09\/ktor-101-efficient-jvm-http-toolkit\/\">Ktor 101\uff1a\u9ad8\u6548\u7684 JVM HTTP \u5de5\u5177\u5305<\/a>\uff0c\u5176\u4e2d\u4ecb\u7ecd\u4e86\u5b83\u7684\u4e3b\u8981\u529f\u80fd\u3002<\/p>\n<p>\u4ee5\u4e0b\u535a\u6587\u5c06\u4e3a\u60a8\u5168\u9762\u6982\u8ff0 Ktor 3.0 \u4e2d\u7684\u6700\u65b0\u53d8\u5316\u548c\u6539\u8fdb\u3002<\/p>\n<p align=\"center\"><a class=\"ek-link jb-download-button\" title=\"\u7acb\u5373\u4f7f\u7528 Ktor 3.0 \u8fdb\u884c\u6784\u5efa\uff01\" href=\"https:\/\/kotl.in\/rc94yb\" target=\"_blank\" rel=\"noopener\">\u7acb\u5373\u4f7f\u7528 Ktor 3.0 \u8fdb\u884c\u6784\u5efa\uff01<\/a><\/p>\n<p><!--more--><\/p>\n<h1 class=\"wp-block-heading\">\u8fc1\u79fb\u5230 kotlinx-io<\/h1>\n<p>\u6b64\u65b0\u7248\u672c\u4e2d\u6700\u5927\u7684\u66f4\u6539\u662f\u5207\u6362\u5230\u57fa\u4e8e <a href=\"https:\/\/github.com\/square\/okio\" target=\"_blank\" rel=\"noreferrer noopener\">Okio<\/a> \u7684 <a href=\"https:\/\/github.com\/Kotlin\/kotlinx-io\/\" target=\"_blank\" rel=\"noreferrer noopener\">kotlinx-io<\/a> \u5e93\u3002 \u5982\u679c\u60a8\u4f7f\u7528 Ktor \u7684\u4f4e\u7ea7 IO API\uff0c\u6b64\u66f4\u6539\u53ef\u80fd\u4f1a\u5f71\u54cd\u60a8\u3002 \u6211\u4eec\u8fdb\u884c\u6b64\u66f4\u6539\u662f\u4e3a\u4e86\u6807\u51c6\u5316\u5404\u4e2a Kotlin \u5e93\u7684 IO \u529f\u80fd\u5e76\u63d0\u9ad8\u6027\u80fd\uff0c\u5982\u6211\u4eec\u7684\u57fa\u51c6\u6d4b\u8bd5\u6240\u793a\u3002<\/p>\n<h2 class=\"wp-block-heading\">\u91cd\u5927\u66f4\u6539<\/h2>\n<p>\u66f4\u6539\u4e3b\u8981\u5f71\u54cd\u4f4e\u7ea7 IO API\uff0c\u5305\u62ec <a href=\"https:\/\/github.com\/ktorio\/ktor\/blob\/main\/ktor-io\/common\/src\/io\/ktor\/utils\/io\/core\/Input.kt\" target=\"_blank\" rel=\"noreferrer noopener\">Input<\/a>\u3001<a href=\"https:\/\/github.com\/ktorio\/ktor\/blob\/main\/ktor-io\/common\/src\/io\/ktor\/utils\/io\/core\/Output.kt\" target=\"_blank\" rel=\"noreferrer noopener\">Output<\/a>\u3001<a href=\"https:\/\/github.com\/ktorio\/ktor\/blob\/main\/ktor-io\/common\/src\/io\/ktor\/utils\/io\/ByteReadChannel.kt\" target=\"_blank\" rel=\"noreferrer noopener\">ByteReadChannel<\/a> \u548c <a href=\"https:\/\/github.com\/ktorio\/ktor\/blob\/main\/ktor-io\/common\/src\/io\/ktor\/utils\/io\/ByteWriteChannel.kt\" target=\"_blank\" rel=\"noreferrer noopener\">ByteWriteChannel<\/a> \u7b49\u7c7b\u3002 \u5982\u679c\u60a8\u76f4\u63a5\u4f7f\u7528\u8fd9\u4e9b\u7c7b\uff0c\u5c06\u4f1a\u770b\u5230\u5f03\u7528\u8b66\u544a\u3002 \u60a8\u5e94\u66f4\u65b0\u4ee3\u7801\uff0c\u4ee5\u4f7f\u7528 kotlinx-io \u5e93\u63d0\u4f9b\u7684\u66ff\u4ee3\u4ee3\u7801\u3002 \u522b\u62c5\u5fc3 \u2013 \u5728 4.0 \u7248\u672c\u53d1\u5e03\u4e4b\u524d\uff0c\u6211\u4eec\u5c06\u4e00\u76f4\u652f\u6301\u65e7 API\uff0c\u8ba9\u60a8\u6709\u5145\u8db3\u7684\u65f6\u95f4\u8fdb\u884c\u8fc1\u79fb\u3002<\/p>\n<p>\u65b0 kotlinx-io \u5e93\u63d0\u4f9b\u7684\u591a\u5e73\u53f0 API \u53ef\u4ee5\u5904\u7406\u5404\u79cd\u6570\u636e\u6e90\uff0c\u5e76\u63d0\u4f9b\u591a\u79cd\u529f\u80fd\uff0c\u5305\u62ec\u5904\u7406\u6587\u4ef6\u3001\u4f7f\u7528\u538b\u7f29\u7b49\u3002 \u6709\u5173\u8be6\u60c5\uff0c\u8bf7\u67e5\u9605 kotlinx-io <a href=\"https:\/\/kotlin.github.io\/kotlinx-io\/\" target=\"_blank\" rel=\"noreferrer noopener\">API \u6587\u6863<\/a>\u3002<\/p>\n<h2 class=\"wp-block-heading\">\u6027\u80fd\u6539\u8fdb<\/h2>\n<p>\u5207\u6362\u5230 kotlinx-io \u540e\uff0c\u6211\u4eec\u51cf\u5c11\u4e86 <code>ByteReadChannel<\/code>\u3001<code>ByteWriteChannel<\/code> \u4e0e\u7f51\u7edc\u63a5\u53e3\u4e4b\u95f4\u4e0d\u5fc5\u8981\u7684\u5b57\u8282\u590d\u5236\u3002 \u8fd9\u6837\u53ef\u4ee5\u66f4\u9ad8\u6548\u5730\u8fdb\u884c\u5b57\u8282\u8f6c\u6362\u548c\u89e3\u6790\uff0c\u4e3a\u672a\u6765\u7684\u6027\u80fd\u6539\u8fdb\u7559\u51fa\u4e86\u7a7a\u95f4\u3002<\/p>\n<p>\u57fa\u4e8e\u771f\u5b9e Ktor \u5e94\u7528\u7a0b\u5e8f\u7684 <a href=\"https:\/\/github.com\/ktorio\/ktor-benchmarks\/tree\/main\/io-benchmarks\" target=\"_blank\" rel=\"noreferrer noopener\">IO \u57fa\u51c6<\/a>\u6d4b\u8bd5\u7ed3\u679c\u4ee4\u4eba\u5370\u8c61\u6df1\u523b\u3002 \u4e00\u4e9b\u6d4b\u8bd5\u663e\u793a\uff0c\u6027\u80fd\u63d0\u9ad8\u4e86 90% \u4ee5\u4e0a\uff0c\u5e76\u4e14\u6211\u4eec\u6b63\u7740\u624b\u5b9e\u73b0\u66f4\u591a\u589e\u5f3a\u529f\u80fd\u3002<\/p>\n<figure class=\"wp-block-gallery has-nested-images columns-default is-cropped wp-block-gallery-1 is-layout-flex wp-block-gallery-is-layout-flex\">\n<figure class=\"wp-block-image size-large is-style-default\"><img decoding=\"async\" loading=\"lazy\" class=\"alignnone wp-image-524750 size-full\" src=\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2024\/11\/Screenshot-2024-10-29-at-11.58.22.webp\" alt=\"\" width=\"1976\" height=\"714\" data-id=\"516893\" \/><\/figure>\n<\/figure>\n<h1 class=\"wp-block-heading\">\u652f\u6301\u670d\u52a1\u5668\u53d1\u9001\u4e8b\u4ef6 (SSE)<\/h1>\n<p>\u5728 Ktor 3.0 \u4e2d\uff0c\u6211\u4eec\u540c\u65f6\u4e3a\u670d\u52a1\u5668\u548c\u5ba2\u6237\u7aef\u589e\u52a0\u4e86\u5bf9\u670d\u52a1\u5668\u53d1\u9001\u4e8b\u4ef6 (SSE) \u7684\u521d\u6b65\u652f\u6301\u3002<\/p>\n<p>\u5229\u7528\u670d\u52a1\u5668\u53d1\u9001\u4e8b\u4ef6\u8fd9\u9879\u6280\u672f\uff0c\u670d\u52a1\u5668\u53ef\u4ee5\u901a\u8fc7 HTTP \u8fde\u63a5\u5411\u5ba2\u6237\u7aef\u63a8\u9001\u4e8b\u4ef6\u3002 SSE \u63d0\u4f9b\u4ece\u670d\u52a1\u5668\u5230\u5ba2\u6237\u7aef\u7684\u5355\u5411\u901a\u4fe1\u901a\u9053\u3002 \u5982\u679c\u670d\u52a1\u5668\u9700\u8981\u53d1\u9001\u57fa\u4e8e\u4e8b\u4ef6\u7684\u66f4\u65b0\uff0c\u4f46\u4e0d\u9700\u8981\u5ba2\u6237\u7aef\u53cd\u590d\u8f6e\u8be2\u83b7\u53d6\u65b0\u4fe1\u606f\uff0c\u5219\u975e\u5e38\u9002\u5408\u4f7f\u7528\u8fd9\u79cd\u65b9\u5f0f\u3002<\/p>\n<p>\u8981\u5728 Ktor \u5e94\u7528\u7a0b\u5e8f\u4e2d\u5b9e\u73b0 SSE \u652f\u6301\uff0c\u8bf7\u5148\u5c06 SSE \u4f9d\u8d56\u9879\u6dfb\u52a0\u5230\u60a8\u7684\u9879\u76ee\u7684\u6784\u5efa\u811a\u672c\u4e2d\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"kotlin\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">implementation(\"io.ktor:ktor-server-sse-jvm\")<\/pre>\n<p>\u63a5\u4e0b\u6765\uff0c\u5728\u60a8\u7684 Ktor \u5e94\u7528\u7a0b\u5e8f\u4e2d\u5b89\u88c5 SSE \u63d2\u4ef6\uff0c\u5e76\u4f7f\u7528 <code>sse{}<\/code> \u51fd\u6570\u521b\u5efa\u7aef\u70b9\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"kotlin\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">import io.ktor.server.application.*\nimport io.ktor.server.engine.*\nimport io.ktor.server.netty.*\nimport io.ktor.server.routing.*\nimport io.ktor.server.sse.*\nimport io.ktor.sse.*\nimport kotlinx.coroutines.delay\n\nfun main() {\n   embeddedServer(Netty, port = 8080) {\n       install(SSE)\n       routing {\n           sse {\n               repeat(42) {\n                   val name = call.parameters[\"name\"] ?: \"World\"\n                   send(ServerSentEvent(data = \"Hello, $name! $it\"))\n                   delay(1000)\n               }\n               close()\n           }\n       }\n   }.start(wait = true)\n}<\/pre>\n<p>\u5728 <code>sse {...}<\/code> \u5757\u4e2d\uff0c\u60a8\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u529f\u80fd\u8bbf\u95ee <code>ServerSSESession<\/code> \u5b9e\u4f8b\u3002<\/p>\n<ul>\n<li><code>send()<\/code>\uff1a\u521b\u5efa <code>ServerSentEvent<\/code> \u5e76\u5c06\u5176\u53d1\u9001\u5230\u5ba2\u6237\u7aef\u3002<\/li>\n<li><code>call<\/code>\uff1a\u8bbf\u95ee\u542f\u52a8\u4f1a\u8bdd\u7684\u5173\u8054 <code>ApplicationCall<\/code>\u3002<\/li>\n<li><code>close()<\/code>\uff1a\u7ed3\u675f\u4f1a\u8bdd\u5e76\u7ec8\u6b62\u4e0e\u5ba2\u6237\u7aef\u7684\u8fde\u63a5\u3002<\/li>\n<\/ul>\n<p>\u8bf7\u6ce8\u610f\uff0cKtor \u76ee\u524d\u4e0d\u652f\u6301\u5bf9 SSE \u54cd\u5e94\u8fdb\u884c\u6570\u636e\u538b\u7f29\u3002 \u5982\u679c\u60a8\u4f7f\u7528 Compression \u63d2\u4ef6\uff0c\u5c06\u9ed8\u8ba4\u8df3\u8fc7\u5bf9 SSE \u54cd\u5e94\u7684\u538b\u7f29\u3002<\/p>\n<p>\u8981\u4f7f\u7528 Ktor \u5ba2\u6237\u7aef\u6d88\u8d39\u4e8b\u4ef6\uff0c\u5728\u6700\u7b80\u5355\u7684\u60c5\u51b5\u4e0b\uff0c\u53ea\u9700\u5728\u5ba2\u6237\u7aef\u5b9e\u4f8b\u4e0a\u8c03\u7528 <code>sse<\/code> \u51fd\u6570\u5373\u53ef\uff0c\u5177\u4f53\u5982\u4e0b\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"kotlin\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">import io.ktor.client.*\nimport io.ktor.client.engine.cio.*\nimport io.ktor.client.plugins.sse.*\nimport kotlinx.coroutines.runBlocking\n\nfun main() {\n   val client = HttpClient(CIO) {\n       install(SSE)\n   }\n\n   runBlocking {\n       client.sse(host = \"127.0.0.1\", port = 8080, path = \"\/sse\") {\n           incoming.collect { event -&gt; println(event) }\n       }\n   }\n}<\/pre>\n<p>\u5728\u4e0a\u4f8b\u4e2d\uff0c\u53ea\u8981\u670d\u52a1\u5668\u5728\u53d1\u9001\u6570\u636e\uff0c\u5ba2\u6237\u7aef\u5c31\u4f1a\u6d88\u8d39\u4e8b\u4ef6\u3002<\/p>\n<h1 class=\"wp-block-heading\">\u901a\u8fc7 ZIP \u5f52\u6863\u63d0\u4f9b\u9759\u6001\u8d44\u6e90<\/h1>\n<p>\u5229\u7528\u65b0\u51fd\u6570 <code>staticZip<\/code>\uff0c\u7528\u6237\u53ef\u4ee5\u63d0\u4f9b ZIP \u5f52\u6863\u7684\u5185\u5bb9\u4f5c\u4e3a\u9759\u6001\u5185\u5bb9\u3002<\/p>\n<p>\u4e0b\u9762\u7ed9\u51fa\u4e86\u8be5\u51fd\u6570\u4f7f\u7528\u65b9\u6cd5\u7684\u57fa\u672c\u793a\u4f8b\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"kotlin\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">routing {\n   staticZip(\n       remotePath = \"\/\",\n       basePath = \"base\", \n       Path(\"files\/text-files.zip\")\n   ) {\n       default(\"file.txt\")\n\n       \/\/modify the response by adding the HTTP Etag header\n       modify { path, call -&gt;\n           call.response.headers.append(HttpHeaders.ETag,\n        path.fileName.toString())\n       }\n   }\n}<\/pre>\n<p>\u6211\u4eec\u5c06\u793a\u4f8b\u5206\u89e3\u4e3a\u51e0\u4e2a\u4e3b\u8981\u90e8\u5206\uff1a<\/p>\n<ol>\n<li><code>remotePath<\/code> \u2013 \u57fa\u672c URL \u8def\u5f84\uff0c\u53ef\u4ee5\u5728\u8be5\u8def\u5f84\u4e2d\u8bbf\u95ee ZIP \u5185\u5bb9\u3002<\/li>\n<li><code>basePath<\/code> \u2013 \u60a8\u5e0c\u671b\u63d0\u4f9b\u7684 ZIP \u6587\u4ef6\u5185\u7684\u57fa\u672c\u8def\u5f84\u3002 \u5728\u6211\u4eec\u7684\u793a\u4f8b\u4e2d\uff0c\u5047\u5b9a ZIP \u5f52\u6863\u5305\u542b <code>base<\/code> \u76ee\u5f55\u3002 \u6307\u5b9a <code>basePath<\/code> \u5185\u7684\u6240\u6709\u8def\u5f84\u5747\u53ef\u5728 <code>remotePath\/path\/to\/resource<\/code> \u4e2d\u8fdb\u884c\u9012\u5f52\u8bbf\u95ee\u3002 \u8fd9\u610f\u5473\u7740\u60a8\u53ef\u4ee5\u4f7f\u7528\u5b50\u6587\u4ef6\u5939\u7ec4\u7ec7 ZIP \u6587\u4ef6\uff0c\u8fd9\u4e9b\u5b50\u6587\u4ef6\u5939\u5c06\u53cd\u6620\u5728 URL \u7ed3\u6784\u4e2d\u3002<\/li>\n<li><code>Path(\"files\/text-files.zip\")<\/code> \u2013 \u60a8\u8981\u63d0\u4f9b\u7684 ZIP \u6587\u4ef6\u7684\u8def\u5f84\u3002<\/li>\n<li><code>default()<\/code> \u51fd\u6570 \u2013 \u7528\u4e8e\u6307\u5b9a\u5728\u672a\u8bf7\u6c42\u7279\u5b9a\u6587\u4ef6\u65f6\u63d0\u4f9b\u7684\u9ed8\u8ba4\u6587\u4ef6\u3002<\/li>\n<li><code>modify<\/code> \u5757 \u2013 \u7528\u4e8e\u81ea\u5b9a\u4e49\u54cd\u5e94\u3002 \u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u57fa\u4e8e\u6587\u4ef6\u540d\u6dfb\u52a0 ETag \u6807\u5934\u3002<\/li>\n<\/ol>\n<p>\u8bbf\u95ee <a href=\"https:\/\/github.com\/ktorio\/ktor-documentation\/tree\/3.0.0-beta-2\/codeSnippets\/snippets\/static-zip\" target=\"_blank\" rel=\"noreferrer noopener\">GitHub \u4e0a\u7684 Ktor \u793a\u4f8b\u4ed3\u5e93<\/a>\u83b7\u53d6\u5b8c\u6574\u793a\u4f8b\u3002<\/p>\n<h1 class=\"wp-block-heading\">\u652f\u6301 CSRF<\/h1>\n<p>\u901a\u8fc7\u65b0\u63d2\u4ef6\u589e\u52a0\u4e86\u5bf9 CSRF\uff08<a href=\"https:\/\/owasp.org\/www-community\/attacks\/csrf\" target=\"_blank\" rel=\"noreferrer noopener\">\u8de8\u7ad9\u8bf7\u6c42\u4f2a\u9020<\/a>\uff09\u9632\u62a4\u7684\u652f\u6301\u3002 \u4e3a\u66f4\u6539\u72b6\u6001\u7684\u64cd\u4f5c\uff08\u5305\u62ec POST\u3001PUT \u548c DELETE\uff09\u542f\u7528\u4e86\u9632\u62a4\u3002<\/p>\n<p>\u4e00\u822c\u6765\u8bb2\uff0cCSRF \u9632\u62a4\u4ec5\u9002\u7528\u4e8e\u4f7f\u7528\u4f1a\u8bdd Cookie \u548c\u8868\u5355\u7684\u9879\u76ee\uff0c\u56e0\u4e3a\u542f\u7528 CSRF \u9632\u62a4\u4f1a\u5bfc\u81f4\u5e94\u7528\u7a0b\u5e8f\u590d\u6742\u6027\u4e0d\u5fc5\u8981\u5730\u63d0\u9ad8\u3002<\/p>\n<p>\u8981\u5728 Ktor \u5e94\u7528\u7a0b\u5e8f\u4e2d\u542f\u7528 CSRF \u652f\u6301\uff0c\u8bf7\u5148\u5c06\u4ee5\u4e0b\u4f9d\u8d56\u9879\u6dfb\u52a0\u5230\u60a8\u7684\u9879\u76ee\u7684\u6784\u5efa\u811a\u672c\u4e2d\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"kotlin\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">implementation(\"io.ktor:ktor-server-csrf-jvm\")<\/pre>\n<p>\u63a5\u4e0b\u6765\uff0c\u60a8\u53ef\u4ee5\u4e3a\u5e94\u7528\u7a0b\u5e8f\u4e2d\u7684\u6240\u9009\u4f8b\u7a0b\u542f\u7528 CSRF \u9632\u62a4\uff0c\u5982\u4e0b\u6240\u793a\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"kotlin\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">route(\"\/csrf\") {\n   install(CSRF) {\n       allowOrigin(\"https:\/\/localhost:8080\")\n\n       originMatchesHost()\n\n       checkHeader(\"X-CSRF\") { csrfHeader -&gt;\n           request.headers[HttpHeaders.Origin]?.let { origin -&gt;\n               csrfHeader == origin.hashCode().toString(32) \/\/ 1ndrgg9\n           } == true\n       }\n\n       onFailure {\n           respondText(\"Access denied!\", status = HttpStatusCode.Forbidden)\n       }\n   }\n   post {\n       call.respondText(\"CSRF check was successful\")\n   }\n}<\/pre>\n<p>\u5728\u914d\u7f6e\u5757\u4e2d\uff0c\u63d2\u4ef6\u63d0\u4f9b\u4e86\u51e0\u79cd\u65b9\u6cd5\u6765\u9a8c\u8bc1\u8bf7\u6c42\uff1a<\/p>\n<ul>\n<li><code>allowOrigin<\/code> \u6307\u5b9a\u4ec5\u5141\u8bb8\u6765\u81ea\u9884\u5b9a\u4e49\u6765\u6e90\u7684\u8bf7\u6c42\u3002 \u5728\u6211\u4eec\u7684\u793a\u4f8b\u4e2d\uff0c\u9884\u5b9a\u4e49\u6765\u6e90\u662f <code>https:\/\/localhost:8080<\/code>\u3002<\/li>\n<li><code>originMatchesHost<\/code> \u5f3a\u5236\u8981\u6c42\u8bf7\u6c42\u7684\u6765\u6e90\u5fc5\u987b\u4e0e\u5e94\u7528\u7a0b\u5e8f\u7684\u4e3b\u673a\u5339\u914d\u3002<\/li>\n<li><code>checkHeader<\/code> \u53ef\u4ee5\u5b9e\u73b0\u4efb\u610f\u6807\u5934\u9a8c\u8bc1\u3002<\/li>\n<\/ul>\n<p>\u5982\u679c\u60a8\u4f7f\u7528\u4ee5\u4e0a\u4ee3\u7801\u8fd0\u884c\u5e94\u7528\u7a0b\u5e8f\uff0c\u5e76\u4f7f\u7528 <code>curl<\/code> \u547d\u4ee4\u5411 <code>\/csrf<\/code> \u7aef\u70b9\u53d1\u9001 <code>POST<\/code> \u8bf7\u6c42\uff0c\u60a8\u5c06\u770b\u5230\u4ee5\u4e0b\u7ed3\u679c\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">curl -X POST -H \"Content-Type: application\/json\" --data '{}' http:\/\/localhost:8080\/csrf\nAccess denied!<\/pre>\n<p>\u6dfb\u52a0\u6240\u9700\u6807\u5934\u53ef\u4f7f\u5176\u901a\u8fc7\u68c0\u67e5\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">curl -X POST -H \"X-CSRF: 1ndrgg9\" -H \"Origin: http:\/\/localhost:8080\" -H \"Content-Type: application\/json\" --data '{}' http:\/\/localhost:8080\/csrf\nCSRF check passed!<\/pre>\n<h1 class=\"wp-block-heading\">\u9002\u7528\u4e8e Wasm \u7684 Ktor \u5ba2\u6237\u7aef<\/h1>\n<p>Ktor \u5ba2\u6237\u7aef\u73b0\u5728\u652f\u6301 WebAssembly (Wasm) \u4f5c\u4e3a\u6784\u5efa\u76ee\u6807\u3002 \u867d\u7136 <a href=\"https:\/\/kotlinlang.org\/docs\/wasm-overview.html\" target=\"_blank\" rel=\"noreferrer noopener\">Kotlin\/Wasm<\/a> \u4ecd\u5904\u4e8e\u65e9\u671f\u9636\u6bb5 (Alpha)\uff0c\u4f46\u5411 Ktor \u5ba2\u6237\u7aef\u6dfb\u52a0\u5bf9 Wasm \u7684\u652f\u6301\u662f\u6269\u5c55 Kotlin Multiplatform \u751f\u6001\u7cfb\u7edf\u7684\u91cd\u8981\u4e00\u6b65\u3002 \u4e3a\u4e86\u5c55\u793a\u8fd9\u4e00\u65b0\u529f\u80fd\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a<a href=\"https:\/\/github.com\/antonarhipov\/ktor-samples-fork\/tree\/main\/ktor-client-wasm\" target=\"_blank\" rel=\"noreferrer noopener\">\u793a\u4f8b Compose Multiplatform \u9879\u76ee<\/a>\uff0c\u8be5\u9879\u76ee\u5c06 Ktor \u5ba2\u6237\u7aef\u4e0e WebAssembly (<code>wasmJs<\/code>) \u76ee\u6807\u7ed3\u5408\u4f7f\u7528\u3002<\/p>\n<p>\u8981\u4f7f\u7528 Ktor \u5ba2\u6237\u7aef\uff0c\u60a8\u9700\u8981\u5c06\u76f8\u5e94\u4f9d\u8d56\u9879\u6dfb\u52a0\u5230\u9879\u76ee\u7684\u6784\u5efa\u811a\u672c\u4e2d\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"kotlin\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">implementation(\"io.ktor:ktor-client-core:$ktor_version\")<\/pre>\n<h1 class=\"wp-block-heading\">\u8fc1\u79fb\u6307\u5357<\/h1>\n<p>Ktor 3.0 \u5e26\u6765\u4e86\u4e00\u4e9b\u91cd\u8981\u53d8\u5316\u3002 \u6211\u4eec\u51c6\u5907\u4e86<a href=\"https:\/\/ktor.io\/docs\/migrating-3.html\" target=\"_blank\" rel=\"noreferrer noopener\">\u8fc1\u79fb\u6307\u5357<\/a>\u6765\u5e2e\u52a9\u60a8\u8f7b\u677e\u5b9e\u73b0\u8fc7\u6e21\u3002 \u5728\u672c\u6587\u4e2d\uff0c\u6211\u4eec\u91cd\u70b9\u4ecb\u7ecd\u6700\u663e\u8457\u7684\u53d8\u5316\u3002<\/p>\n<p>\u65e0\u8bba\u60a8\u662f\u5426\u5c06\u73b0\u6709\u9879\u76ee\u5347\u7ea7\u5230 Ktor 3.0\uff0c\u90fd\u53ef\u4ee5\u7acb\u5373\u5f00\u59cb\u4f7f\u7528 Ktor 3.0 \u6784\u5efa\u65b0\u9879\u76ee\uff01<\/p>\n<p align=\"center\"><a class=\"ek-link jb-download-button\" title=\"\u7acb\u5373\u4f7f\u7528 Ktor 3.0 \u8fdb\u884c\u6784\u5efa\uff01\" href=\"https:\/\/kotl.in\/mx6tmq\" target=\"_blank\" rel=\"noopener\">\u4f7f\u7528 Ktor 3.0 \u542f\u52a8\u65b0\u9879\u76ee<\/a><\/p>\n<h2 class=\"wp-block-heading\">\u5728 <code>TestApplication<\/code> \u4e2d\u663e\u5f0f\u52a0\u8f7d\u6a21\u5757<\/h2>\n<p>\u4ece\u73b0\u5728\u8d77\uff0c<a href=\"https:\/\/api.ktor.io\/ktor-server\/ktor-server-test-host\/io.ktor.server.testing\/-test-application\/index.html\" target=\"_blank\" rel=\"noreferrer noopener\">TestApplication<\/a> \u7c7b\u9700\u8981\u663e\u5f0f\u52a0\u8f7d\u6a21\u5757\u3002 \u4ee5\u4e0b\u6d4b\u8bd5\u5c06\u542f\u52a8\u4e00\u4e2a\u7a7a\u5e94\u7528\u7a0b\u5e8f\uff0c\u4e14\u4e0d\u4f1a\u52a0\u8f7d\u4efb\u4f55\u6a21\u5757\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"kotlin\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\"> @Test\n fun testRoot() = testApplication {\/\/ TestApplication scope\n   client.get(\"\/\").apply {\n     assertEquals(HttpStatusCode.OK, status)\n     assertEquals(\"Hello World!\", bodyAsText())\n   }\n }<\/pre>\n<p>\u76f8\u53cd\uff0c\u60a8\u5fc5\u987b\u5728 <a href=\"https:\/\/api.ktor.io\/ktor-server\/ktor-server-test-host\/io.ktor.server.testing\/test-application.html\" target=\"_blank\" rel=\"noreferrer noopener\">testApplication<\/a> \u51fd\u6570\u4e2d\u663e\u5f0f\u52a0\u8f7d\u6a21\u5757\uff0c\u6216\u624b\u52a8\u52a0\u8f7d\u914d\u7f6e\u6587\u4ef6\u3002<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"kotlin\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">@Test\n fun testRoot() = testApplication {\n   application {\n     configureRouting()\n   }\n   client.get(\"\/\").apply {\n     assertEquals(HttpStatusCode.OK, status)\n     assertEquals(\"Hello World!\", bodyAsText())\n   }\n }<\/pre>\n<h2 class=\"wp-block-heading\">\u63d2\u4ef6\u66f4\u65b0<\/h2>\n<p><code>CallLogging<\/code> \u63d2\u4ef6\u8f6f\u4ef6\u5305\u5df2\u91cd\u547d\u540d\uff0c\u4fee\u6b63\u4e86\u4e00\u5904\u62fc\u5199\u9519\u8bef\uff1a<\/p>\n<figure class=\"wp-block-gallery has-nested-images columns-default is-cropped wp-block-gallery-3 is-layout-flex wp-block-gallery-is-layout-flex\">\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" class=\"wp-image-516907\" src=\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2024\/10\/ktor-3-calllogging-fix.png\" alt=\"\" width=\"1310\" height=\"250\" data-id=\"516907\" \/><\/figure>\n<\/figure>\n<p><code>Locations<\/code> \u63d2\u4ef6<a href=\"https:\/\/ktor.io\/docs\/3.0.0-beta-2\/migrating-3.html#locations-plugin-has-been-removed\" target=\"_blank\" rel=\"noreferrer noopener\">\u5df2\u88ab\u66ff\u6362\u4e3a<\/a>\u65b0\u7684 <code>Resources<\/code> \u63d2\u4ef6\uff0c\u7528\u4e8e\u5b9e\u73b0\u7c7b\u578b\u5b89\u5168\u8def\u7531\u3002<\/p>\n<figure class=\"wp-block-gallery has-nested-images columns-default is-cropped wp-block-gallery-5 is-layout-flex wp-block-gallery-is-layout-flex\">\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" class=\"wp-image-516918\" src=\"https:\/\/blog.jetbrains.com\/wp-content\/uploads\/2024\/10\/ktor-3-migration.png\" alt=\"\" width=\"1302\" height=\"578\" data-id=\"516918\" \/><\/figure>\n<\/figure>\n<p>\u8fd9\u4e9b\u53d8\u52a8\u65e8\u5728\u6539\u5584 Ktor \u7684\u67b6\u6784\u3001\u5b89\u5168\u548c\u5f00\u53d1\u8005\u4f53\u9a8c\u3002 \u4ece Ktor 2.x \u5347\u7ea7\u7684\u7528\u6237\u5e94\u53c2\u8003\u8be6\u7ec6\u7684<a href=\"https:\/\/ktor.io\/docs\/3.0.0-beta-2\/migrating-3.html\" target=\"_blank\" rel=\"noreferrer noopener\">\u8fc1\u79fb\u6307\u5357<\/a>\uff0c\u4ee5\u786e\u4fdd\u987a\u5229\u8fc7\u6e21\u81f3\u65b0\u7248\u672c\u3002<\/p>\n<h1 class=\"wp-block-heading\">\u66f4\u591a\u6587\u7ae0\u548c\u89c6\u9891<\/h1>\n<ol>\n<li>? <a href=\"https:\/\/blog.jetbrains.com\/kotlin\/2024\/03\/the-ktor-roadmap-for-2024\/\">Ktor 2024 \u5e74\u8def\u7ebf\u56fe<\/a><\/li>\n<li>? <a href=\"https:\/\/blog.jetbrains.com\/kotlin\/2024\/04\/the-ktor-plugin-registry\/\">Ktor \u63d2\u4ef6\u6ce8\u518c\u8868\u5df2\u53d1\u5e03\uff01<\/a><\/li>\n<li>? <a href=\"https:\/\/blog.jetbrains.com\/idea\/2024\/09\/ktor-101-efficient-jvm-http-toolkit\/\">Ktor 101\uff1a\u9ad8\u6548\u7684 JVM HTTP \u5de5\u5177\u5305<\/a><\/li>\n<li>? <a href=\"https:\/\/youtu.be\/RiNRQNLcpj8?si=yYw9S13Lookl0HVb\" target=\"_blank\" rel=\"noopener\">\u4f7f\u7528 Ktor \u7ba1\u7406\u590d\u6742\u95ee\u9898<\/a><\/li>\n<li>? <a href=\"https:\/\/www.youtube.com\/live\/HAARGzM0ICs?si=Ejt1eesAIXLxzm_V\" target=\"_blank\" rel=\"noopener\">\u6269\u5c55 Ktor\uff1a\u91ca\u653e Kotlin Web \u6846\u67b6\u7684\u5168\u90e8\u6f5c\u80fd<\/a><\/li>\n<\/ol>\n<p>\u60a8\u7684 Ktor \u56e2\u961f<br \/><em>JetBrains<\/em><br \/><em>The Drive to Develop<\/em><\/p>\n<p>\u672c\u535a\u6587\u82f1\u6587\u539f\u4f5c\u8005\uff1a<\/p>\n\n    <div class=\"about-author \">\n        <div class=\"about-author__box\">\n            <div class=\"row\">\n                <div class=\"about-author__box-img\">\n                    <img decoding=\"async\" src=\"https:\/\/secure.gravatar.com\/avatar\/1a978606d0a933300f0540687d0baac3?s=200&#038;r=g\" width=\"200\" height=\"200\" alt=\"Anton Arhipov\" loading=\"lazy\"  class=\"avatar avatar-200 wp-user-avatar wp-user-avatar-200 photo avatar-default\">\n                <\/div>\n                <div class=\"about-author__box-text\">\n                                            <h4>Anton Arhipov<\/h4>\n                                                        <\/div>\n            <\/div>\n        <\/div>\n    <\/div>\n","protected":false},"author":1297,"featured_media":517707,"comment_status":"closed","ping_status":"closed","template":"","categories":[4897,89],"tags":[4292,477],"cross-post-tag":[6284],"acf":[],"_links":{"self":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/kotlin\/523865"}],"collection":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/kotlin"}],"about":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/types\/kotlin"}],"author":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/users\/1297"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/comments?post=523865"}],"version-history":[{"count":6,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/kotlin\/523865\/revisions"}],"predecessor-version":[{"id":524762,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/kotlin\/523865\/revisions\/524762"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/media\/517707"}],"wp:attachment":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/media?parent=523865"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/categories?post=523865"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/tags?post=523865"},{"taxonomy":"cross-post-tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/cross-post-tag?post=523865"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}