{"id":347055,"date":"2023-05-02T04:46:33","date_gmt":"2023-05-02T03:46:33","guid":{"rendered":"https:\/\/blog.jetbrains.com\/?post_type=ktor&#038;p=347055"},"modified":"2023-05-02T04:46:36","modified_gmt":"2023-05-02T03:46:36","slug":"ktor-2-3-0","status":"publish","type":"ktor","link":"https:\/\/blog.jetbrains.com\/zh-hans\/ktor\/2023\/05\/02\/ktor-2-3-0\/","title":{"rendered":"Ktor 2.3.0 \u73b0\u5df2\u53d1\u5e03"},"content":{"rendered":"<p>\u6211\u4eec\u975e\u5e38\u9ad8\u5174\u5730\u5ba3\u5e03 Ktor 2.3.0 \u73b0\u5df2\u6b63\u5f0f\u53d1\u5e03\u3002 \u6b64\u6b21\u66f4\u65b0\u4e3a Ktor \u751f\u6001\u7cfb\u7edf\u5e26\u6765\u4e86\u8bb8\u591a\u65b0\u529f\u80fd\u548c\u6539\u8fdb\u3002 \u4ee5\u4e0b\u90e8\u5206\u5c06\u7b80\u8981\u4ecb\u7ecd\u6b64\u7248\u672c\u4e2d\u7684\u4e3b\u8981\u53d8\u5316\uff1a<\/p>\n<h2>\u6838\u5fc3\u6539\u8fdb<\/h2>\n<h3>WebSockets ContentNegotiation \u63d2\u4ef6\u7684\u663e\u5f0f\u7c7b\u578b<\/h3>\n<p>WebSocket ContentNegotiation \u63d2\u4ef6\u73b0\u5728\u652f\u6301\u6307\u5b9a\u663e\u5f0f\u7c7b\u578b\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\">client.webSocket(\"ws:\/\/localhost:8080\/echo\") {\n    val originalData: Any = Data(\"hello\")\n    sendSerialized(originalData, typeInfo&lt;Data&gt;())\n    val received = receiveDeserialized&lt;Data&gt;(typeInfo&lt;Data&gt;())\n\n    assertEquals(originalData, received)\n}<\/pre>\n<p>\u6b64\u529f\u80fd\u5728\u65e0\u6cd5\u4f7f\u7528\u5177\u4f53\u5316\u7684\u5f62\u53c2\u65f6\u975e\u5e38\u6709\u7528\u3002<\/p>\n<h3>\u652f\u6301\u5957\u63a5\u5b57\u7684\u7ed3\u6784\u5316\u5e76\u53d1<\/h3>\n<p><code>ktor-network<\/code> \u4e2d\u7684\u5957\u63a5\u5b57\u5b9e\u73b0\u73b0\u5728\u4e3a <code>CoroutineScope<\/code>\u3002 \u8fd9\u610f\u5473\u7740\u5b83\u652f\u6301 <code>cancel()<\/code> \u64cd\u4f5c\u6765\u7acb\u5373\u7ec8\u6b62\u8fde\u63a5\u3002<\/p>\n<p><code>close()<\/code> \u5c06\u7ee7\u7eed\u4f5c\u4e3a\u6b63\u5e38\u7684\u5173\u673a\u64cd\u4f5c\uff0c\u5e76\u5c06\u7b49\u5f85\u6240\u6709\u6302\u8d77\u7684\u64cd\u4f5c\u5b8c\u6210\u3002<\/p>\n<h3>\u5220\u9664\u65e7\u7248 JS \u914d\u7f6e<\/h3>\n<p>\u5373\u5c06\u53d1\u5e03\u7684 Kotlin 1.9.0 \u7248\u5c06\u79fb\u9664\u65e7\u7248 JS \u7f16\u8bd1\u5668\u3002 \u4ece Ktor 2.3.0 \u5f00\u59cb\uff0c\u4e0d\u518d\u652f\u6301\u65e7\u7248\u7f16\u8bd1\u5668\u3002 \u8bf7\u8003\u8651\u8fc1\u79fb\u5230\u65b0\u7684 <a href=\"https:\/\/kotlinlang.org\/docs\/js-ir-compiler.html\" target=\"_blank\" rel=\"noopener\">IR \u7f16\u8bd1\u5668<\/a>\u3002<\/p>\n<h2>\u670d\u52a1\u5668<\/h2>\n<h3>\u652f\u6301\u5728\u8def\u7531\u4e2d\u4f7f\u7528\u6b63\u5219\u8868\u8fbe\u5f0f<\/h3>\n<p>Ktor \u73b0\u5728\u5141\u8bb8\u5728\u5b9a\u4e49\u8def\u7531\u65f6\u4f7f\u7528<a href=\"https:\/\/kotlinlang.org\/api\/latest\/jvm\/stdlib\/kotlin.text\/-regex\/\" target=\"_blank\" rel=\"noopener\">\u6b63\u5219\u8868\u8fbe\u5f0f<\/a>\u3002 \u501f\u52a9\u6b63\u5219\u8868\u8fbe\u5f0f\u8def\u7531\uff0c\u60a8\u53ef\u4ee5\u8f7b\u677e\u5339\u914d\u590d\u6742\u7684\u8def\u7531\u5e76\u6355\u83b7\u8def\u7531\u5f62\u53c2\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\">\nrouting {\n    get(Regex(&quot;^(?&amp;ltname&amp;gt.+)$&quot;)) {\n        val name = call.parameters[&quot;name&quot;]\n        call.respondText(&quot;Hello, $name!&quot;)\n    }\n}<\/pre>\n<p>\u8fd0\u4f5c\u65b9\u5f0f\u5982\u4e0b\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\">$ curl http:\/\/0.0.0.0:8081\/Leonid\nHello, Leonid!<\/pre>\n<p>\u60a8\u53ef\u4ee5\u5728\u6b64<a href=\"https:\/\/ktor.io\/docs\/routing-in-ktor.html#regular_expression\" target=\"_blank\" rel=\"noopener\">\u6587\u6863<\/a>\u4e2d\u4e86\u89e3\u8be6\u60c5\u3002<\/p>\n<h3>\u9759\u6001\u5185\u5bb9 API \u6e05\u7406<\/h3>\n<p>\u9759\u6001\u5185\u5bb9 API \u7ecf\u8fc7\u5b8c\u5584\u548c\u7b80\u5316\uff0c\u53ef\u4ee5\u5b9e\u73b0\u66f4\u4eba\u6027\u5316\u7684\u7528\u6237\u4f53\u9a8c\u3002 \u8fd9\u4e00\u6b21\uff0c\u6211\u4eec\u91cd\u70b9\u5173\u6ce8\u6700\u5e38\u89c1\u7684\u60c5\u51b5\uff0c\u5e76\u4e3a\u5176\u5236\u4f5c\u4e86\u4e00\u4e2a\u7b80\u5355\u7684 API\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\">routing {\n    staticFiles(\"\/static\", File(\"files\"))\n}<\/pre>\n<p>\u5c06\u5728 <code>\/static<\/code> \u8def\u5f84\u4e0b\u63d0\u4f9b <code>files<\/code> \u76ee\u5f55\u4e2d\u7684\u6240\u6709\u6587\u4ef6\u3002<\/p>\n<p>\u6211\u4eec\u8fd8\u53ef\u4ee5\u4ece\u8d44\u6e90\u4e2d\u63d0\u4f9b\u6587\u4ef6\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\">routing {\n    staticResources(\"\/static\", \"assets\")\n}<\/pre>\n<p>\u5b83\u8fd8\u914d\u7f6e\u5c06 <code>index.html<\/code> \u4f5c\u4e3a\u9ed8\u8ba4\u6587\u4ef6\u63d0\u4f9b\uff0c\u5e76\u652f\u6301\u9884\u538b\u7f29\uff08\u751a\u81f3\u5bf9\u4e8e\u8d44\u6e90\uff09\u3001\u7f13\u5b58\u6807\u5934\u3001\u5185\u5bb9\u7c7b\u578b\u68c0\u6d4b\u7b49\u529f\u80fd\u3002<\/p>\n<p>\u5982\u9700\u8be6\u7ec6\u4e86\u89e3\u9759\u6001\u5185\u5bb9 API\uff0c\u8bf7\u53c2\u9605\u6b64<a href=\"https:\/\/ktor.io\/docs\/serving-static-content.html\" target=\"_blank\" rel=\"noopener\">\u6587\u6863<\/a>\u3002<\/p>\n<p>\u539f\u6709 API \u4ecd\u53ef\u4f7f\u7528\uff0c\u5e76\u5c06\u5f97\u5230\u652f\u6301\u3002<\/p>\n<h3>\u652f\u6301\u5728 CIO \u4e2d\u4f7f\u7528 <code>100 Continue<\/code><\/h3>\n<p>CIO \u5f15\u64ce\u73b0\u5728\u652f\u6301 <code>100 Continue<\/code> \u72b6\u6001\u3002 \u5b83\u5f00\u7bb1\u5373\u7528\uff0c\u65e0\u9700\u989d\u5916\u7684\u914d\u7f6e\u3002<\/p>\n<h3>\u591a\u914d\u7f6e\u6587\u4ef6\u652f\u6301<\/h3>\n<p>\u901a\u8fc7\u5141\u8bb8\u4f7f\u7528\u591a\u4e2a\u6587\u4ef6\uff0c\u914d\u7f6e\u7ba1\u7406\u5f97\u5230\u7b80\u5316\u3002 \u53ef\u4ee5\u4f7f\u7528 <code>-config<\/code> CLI \u9009\u9879\u4f20\u9012\u591a\u4e2a\u914d\u7f6e\u6587\u4ef6\u3002 \u914d\u7f6e\u6587\u4ef6\u5c06\u6309\u987a\u5e8f\u52a0\u8f7d\u4e0e\u5408\u5e76\u3002<\/p>\n<p>\u8bf7\u5728\u6587\u6863\u4e2d\u4e86\u89e3\u6709\u5173<a href=\"https:\/\/ktor.io\/docs\/configuration-file.html#command-line\" target=\"_blank\" rel=\"noopener\">\u914d\u7f6e\u6587\u4ef6<\/a>\u7684\u66f4\u591a\u4fe1\u606f\u3002<\/p>\n<h3>Jetty 11 \u548c Tomcat 10 \u652f\u6301<\/h3>\n<p>\u5bf9\u4e8e\u5df2\u5305\u542b\u5b58\u5728\u91cd\u5927\u66f4\u65b0\u7684 Jetty \u6216 Tomcat \u4f9d\u8d56\u9879\u7684\u9879\u76ee\uff0cKtor 2.3.0 \u589e\u52a0\u4e86\u5bf9 Jetty 11 \u548c Tomcat10 \u670d\u52a1\u5668\u5b9e\u73b0\u7684\u652f\u6301\u3002 \u5b83\u4eec\u4f5c\u4e3a\u5355\u72ec\u7684\u4f9d\u8d56\u9879\u63d0\u4f9b\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\">dependencies {\n    implementation(\"io.ktor:ktor-server-jetty-jakarta:2.3.0\")\n    implementation(\"io.ktor:ktor-server-tomcat-jakarta:2.3.0\")\n    implementation(\"io.ktor:ktor-server-servlet-jakarta:2.3.0\")\n}<\/pre>\n<p>\u5982\u679c\u60a8\u9700\u8981\u4f7f\u7528\u65b0\u7248\u672c\uff0c\u8bf7\u5c06\u4f9d\u8d56\u9879\u66f4\u6539\u4e3a <code>jakarta<\/code> \u7248\u3002 \u65e0\u9700\u8fc1\u79fb\u3002<\/p>\n<h2>\u5ba2\u6237\u7aef<\/h2>\n<h3>Expect \u6807\u5934\u548c <code>100 Continue<\/code><\/h3>\n<p>\u73b0\u5728\uff0c\u5ba2\u6237\u7aef\u652f\u6301 <a href=\"https:\/\/developer.mozilla.org\/en-US\/docs\/Web\/HTTP\/Headers\/Expect\" target=\"_blank\" rel=\"noopener\">Expect<\/a> \u6807\u5934\u3002 \u5982\u679c\u8981\u4f7f\u7528\uff0c\u8bf7\u5c06 <code>Expect<\/code> \u6807\u5934\u6dfb\u52a0\u5230\u8bf7\u6c42\u4e2d\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\">client.post(\"http:\/\/localhost:8080\/upload\") {\n    header(\"Expect\", \"100-continue\")\n    body = \"Hello, World!\"\n}<\/pre>\n<h3>Logging \u63d2\u4ef6\u4e2d\u7684\u654f\u611f\u6807\u5934\u51c0\u5316<\/h3>\n<p>Logging \u63d2\u4ef6\u73b0\u5728\u652f\u6301\u51c0\u5316\u654f\u611f\u6807\u5934\u3002 \u53ef\u4ee5\u4f7f\u7528 <strong>sanitizeHeader<\/strong> \u51fd\u6570\u8fdb\u884c\u914d\u7f6e\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\">val client = HttpClient {\n    install(Logging) {\n        sanitizeHeader(\"&lt;secret&gt;\") { it == HttpHeaders.Authorization }\n    }\n}<\/pre>\n<p>\u5bf9\u4e8e\u6240\u6709 <code>Authorization<\/code> \u6807\u5934\uff0c\u6b64\u914d\u7f6e\u4f1a\u5c06\u6807\u5934\u503c\u66ff\u6362\u4e3a\u5360\u4f4d\u7b26\u3002<\/p>\n<h3>\u7528\u4e8e mingwx64 \u76ee\u6807\u7684 libcurl \u7684\u9759\u6001\u94fe\u63a5<\/h3>\n<p>\u4e3a\u4e86\u7b80\u5316\u7248\u672c\u7ba1\u7406\uff0clibcurl \u5e93\u5df2\u9759\u6001\u94fe\u63a5\u5230 <code>ktor-client-curl<\/code>\u3002 \u4e0d\u518d\u9700\u8981\u5728\u7cfb\u7edf\u4e0a\u5b89\u88c5 libcurl \u5373\u53ef\u4f7f\u7528\u4f9d\u8d56\u9879\u3002<\/p>\n<h3>Apache 5 \u548c Jetty 11 \u652f\u6301<\/h3>\n<p>\u65b0\u7248 Apache \u548c Jetty \u4ee5\u5355\u72ec\u7684\u4f9d\u8d56\u9879\u5f62\u5f0f\u6dfb\u52a0\uff1a<\/p>\n<pre class=\"EnlighterJSRAW\">dependencies {\n    implementation(\"io.ktor:ktor-client-jetty-jakarta:2.3.0\")\n    implementation(\"io.ktor:ktor-client-apache5:2.3.0\")\n}<\/pre>\n<p>\u5982\u679c\u60a8\u9700\u8981\u4f7f\u7528\u65b0\u7248\u672c\uff0c\u8bf7\u76f8\u5e94\u5730\u66f4\u6539\u4f9d\u8d56\u9879\u3002 \u65e0\u9700\u8fc1\u79fb\u3002<\/p>\n<h2>\u65b0\u5efa\u9879\u76ee\u5411\u5bfc\u548c\u793a\u4f8b\u66f4\u65b0<\/h2>\n<p><a href=\"https:\/\/start.ktor.io\/\" target=\"_blank\" rel=\"noopener\">\u65b0\u5efa\u9879\u76ee\u5411\u5bfc<\/a>\u5df2\u66f4\u65b0\uff0c\u5305\u542b\u65b0\u7684 Exposed \u548c Postgres \u63d2\u4ef6\uff0c\u540c\u65f6\u6dfb\u52a0\u4e86\u65b0\u7684<a href=\"https:\/\/github.com\/ktorio\/ktor-samples\" target=\"_blank\" rel=\"noopener\">\u793a\u4f8b<\/a>\uff0c\u4fbf\u4e8e\u83b7\u5f97\u66f4\u5177\u5438\u5f15\u529b\u7684 Ktor \u4f53\u9a8c\u3002<\/p>\n<p>\u53ef\u4ee5\u5728 <a href=\"https:\/\/github.com\/ktorio\/ktor\/blob\/main\/CHANGELOG.md\" target=\"_blank\" rel=\"noopener\">GitHub<\/a> \u4e0a\u627e\u5230\u5b8c\u6574\u7684\u66f4\u6539\u5217\u8868\u3002<\/p>\n<h2>\u7279\u522b\u611f\u8c22\u6211\u4eec\u7684\u8d21\u732e\u8005<\/h2>\n<p>\u975e\u5e38\u611f\u8c22\u6240\u6709\u8d21\u732e\u8005\u4e3a\u6539\u8fdb Ktor \u800c\u4ed8\u51fa\u7684\u65f6\u95f4\u3001\u7cbe\u529b\u548c\u4e13\u4e1a\u77e5\u8bc6\u3002 \u7279\u522b\u611f\u8c22 <a href=\"https:\/\/github.com\/chedabob\" target=\"_blank\" rel=\"noopener\">chedabob<\/a>\u3001<a href=\"https:\/\/github.com\/ay4toh5i\" target=\"_blank\" rel=\"noopener\">ay4toh5i<\/a>\u3001<a href=\"https:\/\/github.com\/lkurcius\" target=\"_blank\" rel=\"noopener\">lkurcius<\/a>\u3001<a href=\"https:\/\/github.com\/InsanusMokrassar\" target=\"_blank\" rel=\"noopener\">InsanusMokrassar<\/a>\u3001<a href=\"https:\/\/github.com\/brianguertin\" target=\"_blank\" rel=\"noopener\">brianguertin<\/a>\u3001<a href=\"https:\/\/github.com\/sproctor\" target=\"_blank\" rel=\"noopener\">sproctor<\/a>\u3001<a href=\"https:\/\/github.com\/nesk\" target=\"_blank\" rel=\"noopener\">nesk<\/a>\u3001<a href=\"https:\/\/github.com\/Rattenkrieg\" target=\"_blank\" rel=\"noopener\">Rattenkrieg<\/a>\u3001<a href=\"https:\/\/github.com\/morki\" target=\"_blank\" rel=\"noopener\">morki<\/a>\u3001<a href=\"https:\/\/github.com\/pull-vert\" target=\"_blank\" rel=\"noopener\">pull-vert<\/a>\u3001<a href=\"https:\/\/github.com\/Sebmaster\" target=\"_blank\" rel=\"noopener\">Sebmaster<\/a>\u3002<\/p>\n<h2>\u7acb\u5373\u8bd5\u7528<\/h2>\n<p>\u6211\u4eec\u9080\u8bf7\u60a8\u53d1\u73b0 Ktor 2.3.0 \u4e2d\u7684\u589e\u5f3a\u529f\u80fd\uff0c\u5e76\u4e0e\u6211\u4eec\u5206\u4eab\u60a8\u7684\u5b9d\u8d35\u53cd\u9988\u3002 \u5982\u679c\u60a8\u521a\u5f00\u59cb\u63a5\u89e6 Ktor\uff0c\u53ef\u4ee5\u4f7f\u7528\u6211\u4eec\u7684<a href=\"https:\/\/start.ktor.io\/\" target=\"_blank\" rel=\"noopener\">\u65b0\u9879\u76ee\u751f\u6210\u5668<\/a>\u521b\u5efa\u65b0\u9879\u76ee\u3002 \u5982\u9700\u62a5\u544a\u95ee\u9898\u6216\u5efa\u8bae\u65b0\u529f\u80fd\uff0c\u8bf7\u8bbf\u95ee <a href=\"https:\/\/youtrack.jetbrains.com\/issues\/KTOR\" target=\"_blank\" rel=\"noopener\">YouTrack<\/a>\u3002<\/p>\n<p>\u611f\u8c22\u60a8\u4e00\u5982\u65e2\u5f80\u7684\u652f\u6301\uff01<\/p>\n<p>\u00a0<\/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\/?s=200&#038;r=g\" width=\"200\" height=\"200\" alt=\"\" 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                                                        <\/div>\n            <\/div>\n        <\/div>\n    <\/div>\n\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\/?s=200&#038;r=g\" width=\"200\" height=\"200\" alt=\"\" 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                                                        <\/div>\n            <\/div>\n        <\/div>\n    <\/div>\n","protected":false},"author":1297,"featured_media":75132,"comment_status":"closed","ping_status":"closed","template":"","categories":[907],"tags":[],"cross-post-tag":[],"acf":[],"_links":{"self":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/ktor\/347055"}],"collection":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/ktor"}],"about":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/types\/ktor"}],"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=347055"}],"version-history":[{"count":4,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/ktor\/347055\/revisions"}],"predecessor-version":[{"id":347329,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/ktor\/347055\/revisions\/347329"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/media\/75132"}],"wp:attachment":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/media?parent=347055"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/categories?post=347055"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/tags?post=347055"},{"taxonomy":"cross-post-tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/cross-post-tag?post=347055"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}