{"id":34460,"date":"2020-02-12T18:27:37","date_gmt":"2020-02-12T10:27:37","guid":{"rendered":"https:\/\/blog.jetbrains.com\/cn\/?p=621"},"modified":"2020-02-20T11:57:56","modified_gmt":"2020-02-20T03:57:56","slug":"ktor-1-3","status":"publish","type":"post","link":"https:\/\/blog.jetbrains.com\/zh-hans\/2020\/02\/12\/ktor-1-3\/","title":{"rendered":"Ktor 1.3 \u65b0\u7248\u672c\u73b0\u5df2\u53d1\u5e03\uff01"},"content":{"rendered":"Ktor 1.3 \u65b0\u7248\u672c\u6700\u8fd1\u53d1\u5e03\uff01\u6211\u4eec\u5f88\u9ad8\u5174\u5728\u6b64\u535a\u5ba2\u6587\u7ae0\u4e2d\u4e0e\u60a8\u5206\u4eab\u8be6\u7ec6\u4fe1\u606f\u3002\r\n\r\nKtor \u7531\u4e24\u90e8\u5206\u7ec4\u6210\uff1a\u670d\u52a1\u5668\u5f15\u64ce\u548c\u7075\u6d3b\u6027\u5f02\u6b65 HTTP \u5ba2\u6237\u7aef\u3002\u5f53\u524d\u7248\u672c\u4e3b\u8981\u96c6\u4e2d\u5728 HTTP \u5ba2\u6237\u7aef\u4e0a\u3002\u60a8\u53ef\u4ee5\u5728\u6b64\u5904\u627e\u5230\u6b64\u7248\u672c\u7684\u5b8c\u6574\u53d8\u66f4\u65e5\u5fd7\u3002\r\n\u5ba2\u6237\u7aef\u662f\u4e00\u4e2a\u652f\u6301 JVM\u3001JS\u3001Android \u548c iOS \u7684\u591a\u5e73\u53f0\u5e93\uff0c\u73b0\u5728\u7ecf\u5e38\u5728\u8de8\u5e73\u53f0\u79fb\u52a8\u5e94\u7528\u4e2d\u4f7f\u7528\u3002\u6211\u4eec\u4e0b\u4e00\u4e2a\u7248\u672c\u7684\u4e3b\u8981\u76ee\u6807\u662f\u4f7f\u670d\u52a1\u5668\u5f15\u64ce\u4e5f\u53ef\u4ee5\u8de8\u5e73\u53f0\u8fd0\u4f5c\u3002\r\n\u6211\u4eec\u5c06\u8981\u7814\u7a76\u7684\u5176\u4ed6\u9886\u57df\u662f\uff1a\r\n\r\n\r\n\t\r\n\u6539\u8fdb\u4e0e\u00a0kotlinx.serialization\u00a0\u5e93\u7684\u96c6\u6210\u3002\r\n\r\n\t\r\n\u5728 Kotlin \/ Native \u4e0a\u652f\u6301\u00a0CIO\u00a0\uff08\u57fa\u4e8e\u534f\u540c\u7a0b\u5e8f\u7684 I \/ O \u5ba2\u6237\u7aef\u5f15\u64ce\uff09\uff0c\u4f7f\u5176\u6210\u4e3a HttpClient \u4e2d\u4f7f\u7528\u7684\u9ed8\u8ba4\u591a\u5e73\u53f0\u5f15\u64ce\u3002\r\n\r\n\r\n\u5982\u679c\u60a8\u5f53\u524d\u4f7f\u7528\u7684\u662f\u670d\u52a1\u5668\u6216 HttpClient \u7684 Ktor \uff0c\u6216\u8005\u4e4b\u524d\u66fe\u5c1d\u8bd5\u8fc7\uff0c\u8bf7\u53c2\u52a0\u4ee5\u4e0b\u8c03\u67e5\uff1a\r\n\u53c2\u4e0e\u8c03\u67e5\r\n\u5982\u679c\u60a8\u80fd\u4e0e\u6211\u4eec\u5206\u4eab\u60a8\u7684\u7ecf\u9a8c\uff0c\u6211\u4eec\u4f1a\u975e\u5e38\u611f\u6fc0\uff01\r\n\u73b0\u5728\uff0c\u8ba9\u6211\u4eec\u6df1\u5165\u4e86\u89e3 Ktor 1.3 \u7248\u672c\u7684\u7ec6\u8282\u3002\r\n\r\nHttpClient\r\nHttpStatement \u7b80\u4ecb\r\n\u5728\u4ee5\u524d\u7684 Ktor \u7248\u672c\u4e2d\uff0c\u60a8\u9700\u8981\u660e\u786e\u5173\u95ed\u00a0HttpResponse\u00a0\u3002\u4f46\u662f\uff0c\u8fd9\u901a\u5e38\u4f1a\u4f7f\u7528\u6237\u611f\u5230\u56f0\u60d1\u3002\u6211\u4eec\u53d1\u73b0\u5728\u5f88\u591a\u60c5\u51b5\u4e0b\uff0c\u5373\u4f7f\u5728\u7b80\u5355\u7684\u793a\u4f8b\u4e2d\uff0c\u4e5f\u6709\u4eba\u5fd8\u8bb0\u4e86\u5173\u95ed\u00a0HttpResponse\u00a0\uff0c\u5e76\u56e0\u6b64\u800c\u5bfc\u81f4\u5185\u5b58\u6cc4\u6f0f\u3002\u4e3a\u4e86\u6539\u5584\u8fd9\u79cd\u60c5\u51b5\uff0c\u6211\u4eec\u5728 Ktor 1.3 \u4e2d\u5f15\u5165\u4e86\u4e0d\u517c\u5bb9\u7684\u66f4\u6539\uff1a\u00a0HttpResponse\u00a0\u4e0d\u518d\u5b9e\u73b0\u00a0Closeable\u00a0\u63a5\u53e3\u3002\u56e0\u6b64\uff0c1.3.0 Ktor \u53d1\u884c\u7248\u4e0e\u5148\u524d\u7248\u672c\u7684 Ktor 1.2.X\u00a0\u5411\u540e\u4e0d\u517c\u5bb9\u3002\r\n\u73b0\u5728\u5728\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u00a0HttpResponse\u00a0\u5904\u4e8e\u5185\u5b58\u4e2d\uff0c \u65e0\u518d\u9700\u624b\u52a8\u5173\u95ed\u5b83\uff1a\r\n\r\nfun main(): Unit = runBlocking {\r\n    val client = HttpClient()\r\n    val url = \"http:\/\/kotlinlang.org\/\"\r\n    val response = client.get<HttpResponse>(url)\r\n    val text = response.readText()\r\n    println(text)\r\n    \/\/ no longer need to 'close' the response\r\n}\r\n\u5982\u679c\u9700\u8981\u5904\u7406\u6d41\u5f0f\u5904\u7406\u6216\u8f83\u5927\u7684\u54cd\u5e94\uff0c\u8bf7\u4f7f\u7528\u65b0\u7684\u00a0HttpStatement\u00a0\u7c7b\u3002\u5728\u60a8\u660e\u786e\u5730\u8c03\u7528\u00a0execute\u00a0\u65b9\u6cd5\u4e4b\u524d\uff0c\u00a0HttpStatement\u00a0\u4e0d\u4f1a\u6267\u884c\u4efb\u4f55\u7f51\u7edc\u8bf7\u6c42\uff1a\r\nval statement = client.request<HttpStatement>(\"$TEST_SERVER\/content\/stream\")\r\n\/\/ ...\r\nstatement.execute { response: HttpResponse ->\r\n    \/\/ working with the response\r\n}\r\n\u4f8b\u5982\uff0c\u60a8\u53ef\u4ee5\u6309\u90e8\u5206\u8bfb\u53d6\u6570\u636e\uff1a\r\nclient.get<HttpStatement>(url).execute { response ->\r\n    val channel = response.receive<ByteReadChannel>()\r\n    while (!channel.isClosedForRead) {\r\n        val packet = channel.readRemaining(size)\r\n        println(packet.readText())\r\n    }\r\n}\r\n\r\n\u914d\u7f6e\u4ee3\u7406\r\nHttpClient\u00a0\u6dfb\u52a0\u4e86\u5bf9\u4ee3\u7406\u7684\u5b9e\u9a8c\u6027\u652f\u6301\u3002\u5982\u679c\u9700\u8981\u5728\u4ee3\u7406\u4e0b\u53d1\u9001\u8bf7\u6c42\uff0c\u5219\u53ef\u4ee5\u5728\u76f8\u5e94\u7684\u53c2\u6570\u4e2d\u914d\u7f6e\u5176\u5730\u5740\uff1a\r\n\r\nHttpClient { \r\n    engine { \r\n        proxy = ProxyBuilder.http(\"http:\/\/proxy-host:3128\")\r\n    }\r\n}\r\n\u8bf7\u6ce8\u610f\uff0c\u7531\u4e8e\u5e73\u53f0\u7684\u9650\u5236\uff0c\u5b83\u4ec5\u652f\u6301 JVM \u548c Native \u76ee\u6807\uff08WatchOS \u9664\u5916\uff09\uff0c\u800c JavaScript \u4e0d\u652f\u6301\u3002\u53ef\u4ee5\u5728\u6b64\u5904\u627e\u5230\u6709\u5173\u5982\u4f55\u9488\u5bf9\u4e0d\u540c\u5e73\u53f0\u8fdb\u884c\u914d\u7f6e\u7684\u66f4\u591a\u8be6\u7ec6\u4fe1\u606f\u3002\r\n\r\n\u5c06\u00a0NSURLSession\u00a0\u7528\u4e8e iOS \u5f15\u64ce\r\niOS \u5f15\u64ce\u73b0\u5728\u63d0\u4f9b\u4e86\u4e00\u79cd\u914d\u7f6e NSURLSession \u7684\u65b9\u6cd5\uff1a\r\n\r\nHttpClient(Ios) {\r\n    engine {\r\n        configureSession {\r\n            networkServiceType = NSURLNetworkServiceTypeBackground\r\n        }\r\n    }\r\n}\r\nNSURLSession\u00a0\u662f\u4e0e iOS \u4e0a\u7684 HTTP \/ HTTPS \u534f\u8bae\u8fdb\u884c\u4ea4\u4e92\u7684\u9ed8\u8ba4 API \uff0c\u56e0\u6b64\u73b0\u5728\u60a8\u53ef\u4ee5\u4f7f\u7528\u5b83\u6765\u8c03\u6574\u6240\u6709\u4e0e iOS \u76f8\u5173\u7684\u8bbe\u7f6e\u3002\r\n\r\n\u4f7f\u7528 JSON \u7684\u6539\u8fdb\r\n\u5230\u76ee\u524d\u4e3a\u6b62\uff0cHttpClient \u548c\u670d\u52a1\u5668\u5747\u652f\u6301\u4ee5\u4e0b\u66f4\u6539\uff0c\u76ee\u524d\u5904\u4e8e\u8bd5\u9a8c\u72b6\u6001\u3002\r\n\r\nJSON \u4e2d\u7684\u7b80\u5316\u96c6\u5408\u5e8f\u5217\u5316\r\n\u5728\u4ee5\u524d\u7684 Ktor \u7248\u672c\u4e2d\uff0c\u60a8\u9700\u8981\u6ce8\u518c\u8f85\u52a9\u7c7b\u578b\u4ee5\u5e8f\u5217\u5316\u96c6\u5408\u3002\u73b0\u5728\uff0c\u6b64\u8fc7\u7a0b\u5df2\u5f97\u5230\u7b80\u5316\uff1a\u00a0JsonFeature\u00a0\u65e0\u9700\u9644\u52a0\u914d\u7f6e\u5373\u53ef\u5904\u7406\u96c6\u5408\u7c7b\u578b\u3002\u73b0\u5728\u4e0d\u63a8\u8350\u4f7f\u7528\u6240\u6709\u76f8\u5173\u529f\u80fd\uff0c\u4f8b\u5982\u00a0setMapper\u00a0\uff0c\u00a0setListMapper\u00a0\uff0c\u5bc4\u5b58\u5668\u3002\r\n\u4e0d\u518d\u9700\u8981\u5728\u00a0JsonFeature\u00a0\u4e2d\u6ce8\u518c\u00a0List <User>\u00a0\uff1a\r\n\r\ninstall(JsonFeature)\r\n\/\/ ...\r\nval list = client.get<List<User>>(\"https:\/\/example\/json\/users\") <br>\r\n\u5728\u670d\u52a1\u5668\u4e0a\u4f7f\u7528 JSON \u65f6\u4e5f\u662f\u5982\u6b64\uff0c\u53ef\u4ee5\u5728\u63a5\u6536\u5185\u5bb9\u65f6\u4f7f\u7528\u9884\u671f\u7684\u6cdb\u578b\u53c2\u6570\u6307\u5b9a\u96c6\u5408\u7c7b\u578b\uff1a\r\ninstall(ContentNegotiation) {\r\n    register(ContentType.Application.Json, SerializationConverter())\r\n}\r\n\r\nrouting {\r\n    post(\"\/entity\") {\r\n        val receivedList = call.receive<List<MyEntity>>()\r\n        \/\/ process the list\r\n    }\r\n}\r\n \r\nkotlinx.serialization DSL\r\nKtor \u73b0\u5728\u652f\u6301\u4f7f\u7528\u00a0kotlinx.serialization\u00a0DSL \u6784\u9020 JSON \u6b63\u6587\u7684\u65b9\u6cd5\uff1a\r\n\r\nclient.post<String>(\"http:\/\/localhost:9090\") {\r\n    contentType(ContentType.Application.Json)\r\n    body = json {\r\n        \"key1\" to 123\r\n        \"map\" to json {\r\n            \"key2\" to \"abc\"\r\n        }\r\n    }\r\n}\r\n\u8981\u5728\u5ba2\u6237\u7aef\u4e0a\u4f7f\u7528\u5b83\uff0c\u8bf7\u5b89\u88c5 JsonFeature \u5e76\u6dfb\u52a0 ktor-client-serialization \u4f9d\u8d56\u9879\u3002\u5728\u670d\u52a1\u5668\u4e0a\uff0c\u4f7f\u7528\u00a0SerializationConverter\u00a0\u3002\r\n\r\n \r\n\u8fc1\u79fb\u6b65\u9aa4\r\n\u8981\u5c06 Ktor \u5e94\u7528\u7a0b\u5e8f\u8fc1\u79fb\u5230\u65b0\u7248\u672c\uff0c\u60a8\u9700\u8981\uff1a\r\n\r\n\r\n\t\r\n\u66f4\u65b0\u60a8\u5bf9\u00a0HttpResponse\u00a0\u7684\u6240\u6709\u7528\u6cd5\uff1a\u53ea\u9700\u5220\u9664\u00a0close\u00a0\u8c03\u7528\uff0c\u5e76\u5728\u9700\u8981\u65f6\u4f7f\u7528\u00a0HttpStatement\u00a0\u3002\r\n\r\n\t\r\n\u66f4\u65b0\u5bfc\u5165\u3002\r\nkotlinx.io\u00a0\u4f9d\u8d56\u6027\u5df2\u88ab\u5220\u9664\uff0c\u56e0\u6b64\u60a8\u9700\u8981\u901a\u8fc7\u4ee5\u4e0b\u65b9\u5f0f\u66ff\u6362\u5bfc\u5165\uff1a\r\n\r\n\r\n\t\r\nimport kotlinx.io.\u00a0->\u00a0import io.ktor.utils.io.\r\n\r\n\t\r\nimport kotlinx.coroutines.io.\u00a0->\u00a0import io.ktor.utils.io.\r\n\r\n\r\n\r\n\r\n\u8bf7\u6ce8\u610f\uff0c\u5b83\u4e0e 1.2.x \u6ca1\u6709\u4e8c\u8fdb\u5236\u517c\u5bb9\u6027\uff0c\u56e0\u6b64\uff0c\u5982\u679c\u60a8\u4f7f\u7528\u4efb\u4f55\u5916\u90e8 Ktor \u529f\u80fd\uff0c\u5219\u9700\u8981\u6839\u636e\u6700\u65b0\u7248\u672c\u91cd\u65b0\u7f16\u8bd1\u5b83\u4eec\u3002\r\n\u53e6\u5916\uff0c\u8bf7\u786e\u4fdd\u60a8\u4f7f\u7528\u7684\u662f 5.4.1+ Gradle \u5143\u6570\u636e\u7248\u672c\u3002\r\n\u611f\u8c22\u60a8\u9605\u8bfb\u672c\u6587\uff0c\u8bf7\u4e0d\u8981\u5fd8\u8bb0\u53c2\u52a0\u8c03\u67e5\uff01\u539f\u6587\u53d1\u8868\u4e8e2020\u5e741\u670829\u65e5\uff0c\u4f5c\u8005Sergey Mashkov\r\n\u53c2\u4e0e\u8c03\u67e5","protected":false},"excerpt":{"rendered":"Ktor 1.3 \u65b0\u7248\u672c\u6700\u8fd1\u53d1\u5e03\uff01\u6211\u4eec\u5f88\u9ad8\u5174\u5728\u6b64\u535a\u5ba2\u6587\u7ae0\u4e2d\u4e0e\u60a8\u5206\u4eab\u8be6\u7ec6\u4fe1\u606f\u3002Ktor \u7531\u4e24\u90e8\u5206\u7ec4\u6210\uff1a\u670d\u52a1\u5668\u5f15\u64ce\u548c\u7075\u6d3b\u6027\u5f02\u6b65 HTTP \u5ba2\u6237\u7aef\u3002\u5f53\u524d\u7248\u672c\u4e3b\u8981\u96c6\u4e2d\u5728 HTTP \u5ba2\u6237\u7aef\u4e0a\u3002\u60a8\u53ef\u4ee5\u5728\u6b64\u5904\u627e\u5230\u6b64\u7248\u672c\u7684\u5b8c\u6574\u53d8\u66f4\u65e5\u5fd7\u3002\u5ba2\u6237\u7aef\u662f\u4e00\u4e2a\u652f\u6301 JVM\u3001JS\u3001Android \u548c iOS \u7684\u591a\u5e73\u53f0\u5e93\uff0c\u73b0\u5728\u7ecf\u5e38\u5728\u8de8\u5e73\u53f0\u79fb\u52a8\u5e94\u7528\u4e2d\u4f7f\u7528\u3002\u6211\u4eec\u4e0b\u4e00\u4e2a\u7248\u672c\u7684\u4e3b\u8981\u76ee\u6807\u662f\u4f7f\u670d\u52a1\u5668\u5f15\u64ce\u4e5f\u53ef\u4ee5\u8de8\u5e73\u53f0\u8fd0\u4f5c\u3002\u6211\u4eec","protected":false},"author":{"name":"Lei","link":"https:\/\/blog.jetbrains.com\/zh-hans\/author\/lei-zhaojetbrains-com"},"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[4897,1027,4896],"tags":[5320,5788],"cross-post-tag":[],"acf":[],"featured_image":null,"_links":{"self":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/posts\/34460"}],"collection":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/users\/814"},{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/users\/814"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/comments?post=34460"}],"version-history":[{"count":0,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/posts\/34460\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/media?parent=34460"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/categories?post=34460"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/tags?post=34460"},{"taxonomy":"cross-post-tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/cross-post-tag?post=34460"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}