{"id":34005,"date":"2020-02-13T19:18:42","date_gmt":"2020-02-13T10:18:42","guid":{"rendered":"https:\/\/blog.jetbrains.com\/kr\/?p=562"},"modified":"2020-02-13T19:18:42","modified_gmt":"2020-02-13T10:18:42","slug":"ktor-1-3-release","status":"publish","type":"post","link":"https:\/\/blog.jetbrains.com\/ko\/2020\/02\/13\/ktor-1-3-release\/","title":{"rendered":"Ktor 1.3\uc774 \ub9b4\ub9ac\uc2a4\ub418\uc5c8\uc2b5\ub2c8\ub2e4! \uc124\ubb38\uc870\uc0ac\ub3c4 \ucc38\uc5ec\ud574\uc8fc\uc138\uc694"},"content":{"rendered":"Ktor 1.3\uc774 \ucd5c\uadfc\uc5d0 \ucd9c\uc2dc\ub418\uc5c8\uc2b5\ub2c8\ub2e4. \uc774 \ube14\ub85c\uadf8 \uae00\uc5d0\uc11c\ub294 \uadf8 \uc790\uc138\ud55c \ub0b4\uc6a9\uc744 \uacf5\uc720\ud574 \ub4dc\ub9ac\uaca0\uc2b5\ub2c8\ub2e4.\r\n\r\nKtor\ub294 \uc11c\ubc84 \uc5d4\uc9c4\uacfc \uc720\uc5f0\ud55c \ube44\ub3d9\uae30 HTTP \ud074\ub77c\uc774\uc5b8\ud2b8, \ub450 \ubd80\ubd84\uc73c\ub85c \uad6c\uc131\ub429\ub2c8\ub2e4. \ud604\uc7ac \ub9b4\ub9ac\uc2a4\ub294 \uc8fc\ub85c HTTP \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0 \uc911\uc810\uc744 \ub461\ub2c8\ub2e4. \uc774 \ub9b4\ub9ac\uc2a4\uc758 \uc804\uccb4 \ubcc0\uacbd \ub85c\uadf8\ub294 \uc5ec\uae30\uc5d0\uc11c \ud655\uc778\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.\r\n\ud074\ub77c\uc774\uc5b8\ud2b8\ub294 JVM, JS, Android, iOS\ub97c \uc9c0\uc6d0\ud558\ub294 \uba40\ud2f0\ud50c\ub7ab\ud3fc \ub77c\uc774\ube0c\ub7ec\ub9ac\uc774\uba70 \ud604\uc7ac \ud06c\ub85c\uc2a4 \ud50c\ub7ab\ud3fc \ubaa8\ubc14\uc77c \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc5d0\uc11c \uc885\uc885 \uc0ac\uc6a9\ub429\ub2c8\ub2e4. \ub2e4\uc74c \ub9b4\ub9ac\uc2a4\uc758 \uc8fc\uc694 \ubaa9\ud45c\ub294 \uc11c\ubc84 \uc5d4\uc9c4\ub3c4 \uba40\ud2f0\ud50c\ub7ab\ud3fc\uc73c\ub85c \ub9cc\ub4dc\ub294 \uac83\uc785\ub2c8\ub2e4.\r\n\uadf8\uc678 \uc791\uc5c5\ud558\ub824\ub294 \ub2e4\ub978 \ubd80\ubd84\uc740 \ub2e4\uc74c\uacfc \uac19\uc2b5\ub2c8\ub2e4.\r\n\r\nkotlinx.serialization \ub77c\uc774\ube0c\ub7ec\ub9ac\uc640\uc758 \ud1b5\ud569 \uac1c\uc120\r\nKotlin\/Native\uc5d0\uc11c CIO(\ucf54\ub8e8\ud2f4 \uae30\ubc18 I\/O \ud074\ub77c\uc774\uc5b8\ud2b8 \uc5d4\uc9c4)\ub97c \uc9c0\uc6d0\ud558\uc5ec HttpClient\uc5d0\uc11c \uc0ac\uc6a9\ub418\ub294 \uae30\ubcf8 \uba40\ud2f0\ud50c\ub7ab\ud3fc \uc5d4\uc9c4\uc73c\ub85c \ub9cc\ub4e4\uae30\r\n\r\n\ud604\uc7ac Ktor(\uc11c\ubc84 \ub610\ub294 HttpClient)\uc744 \uc0ac\uc6a9 \uc911\uc774\uac70\ub098 \uc608\uc804\uc5d0 \uc0ac\uc6a9\ud574 \ubcf8 \uc801\uc774 \uc788\uc73c\uc2dc\ub2e4\uba74 \ub2e4\uc74c \uc124\ubb38\uc870\uc0ac\uc5d0 \ucc38\uc5ec\ud574 \uc8fc\uc138\uc694.\r\n\uc124\ubb38\uc870\uc0ac \ucc38\uc5ec\ud558\uae30\r\n\uc5ec\ub7ec\ubd84\uc758 \uacbd\ud5d8\uc744 \uacf5\uc720\ud574 \uc8fc\uc2dc\uba74 \uc815\ub9d0 \uac10\uc0ac\ud558\uaca0\uc2b5\ub2c8\ub2e4!\r\n\uc9c0\uae08\ubd80\ud130 Ktor 1.3 \ub9b4\ub9ac\uc2a4\uc5d0\uc11c \uc81c\uacf5\ud558\ub294 \uae30\ub2a5\uc744 \uc790\uc138\ud788 \uc0b4\ud3b4\ubcf4\uaca0\uc2b5\ub2c8\ub2e4.\r\nHttpClient\r\nHttpStatement \ub3c4\uc785\r\n\uc774\uc804 Ktor \ubc84\uc804\uc5d0\uc11c\ub294 HttpResponse\ub97c \uba85\uc2dc\uc801\uc73c\ub85c \ub2eb\uc544\uc57c \ud588\uc2b5\ub2c8\ub2e4. \uadf8\ub7ec\ub098 \uc774 \ub54c\ubb38\uc5d0 \ud63c\ub780\uc774 \ubc1c\uc0dd\ud558\ub294 \uacbd\uc6b0\uac00 \ub2e4\uc18c \uc788\uc5c8\uc2b5\ub2c8\ub2e4. \uc2ec\uc9c0\uc5b4 \uac04\ub2e8\ud55c \uc608\uc81c\uc5d0\uc11c\ub3c4 \ub204\uad70\uac00\uac00 HttpResponse\ub97c \ub2eb\ub294 \uac83\uc744 \uc78a\uc5b4\ubc84\ub824 \uba54\ubaa8\ub9ac \ub204\uc218\uac00 \ubc1c\uc0dd\ud558\ub294 \uc0ac\ub840\uac00 \ub9ce\uc774 \ubc1c\uacac\ub418\uc5c8\uc2b5\ub2c8\ub2e4. \uc774\ub7ec\ud55c \uc0c1\ud669\uc744 \uac1c\uc120\ud558\uae30 \uc704\ud574 Ktor 1.3\uc5d0\ub294 \ube44\ud638\ud658 \ubcc0\uacbd\uc774 \ub3c4\uc785\ub418\uc5c8\uc2b5\ub2c8\ub2e4. HttpResponse\ub294 \ub354 \uc774\uc0c1 Closeable \uc778\ud130\ud398\uc774\uc2a4\ub97c \uad6c\ud604\ud558\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4. \ub530\ub77c\uc11c 1.3.0 Ktor \ub9b4\ub9ac\uc2a4\ub294 \uc774\uc804 \ubc84\uc804 Ktor 1.2.X\uc640 \ud638\ud658\ub418\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4.\r\nHttpResponse\ub294 \uae30\ubcf8\uc801\uc73c\ub85c \uba54\ubaa8\ub9ac \ub0b4\uc5d0 \uc788\uc73c\ubbc0\ub85c \uc774\uc81c \ub2eb\uc744 \ud544\uc694\uac00 \uc5c6\uc2b5\ub2c8\ub2e4.\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\r\n\uc2a4\ud2b8\ub9ac\ubc0d \ub610\ub294 \ub300\uaddc\ubaa8 \uc751\ub2f5\uc744 \ucc98\ub9ac\ud574\uc57c \ud558\ub294 \uacbd\uc6b0 \uc0c8 HttpStatement \ud074\ub798\uc2a4\ub97c \uc0ac\uc6a9\ud574 \ubcf4\uc138\uc694. HttpStatement\ub294 \uc0ac\uc6a9\uc790\uac00 \uba85\uc2dc\uc801\uc73c\ub85c execute \uba54\uc18c\ub4dc\ub97c \ud638\ucd9c\ud560 \ub54c\uae4c\uc9c0 \ub124\ud2b8\uc6cc\ud06c \uc694\uccad\uc744 \uc218\ud589\ud558\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4.\r\n\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\r\n\uc608\ub97c \ub4e4\uc5b4 \ub370\uc774\ud130\ub97c \uccad\ud06c\ub85c \uc77d\uc744 \uc218 \uc788\uc2b5\ub2c8\ub2e4.\r\n\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\ud504\ub85d\uc2dc \uad6c\uc131\r\nHttpClient\ub294 \ud504\ub85d\uc2dc\uc5d0 \ub300\ud55c \uc2e4\ud5d8\uc801\uc778 \uc9c0\uc6d0\uc744 \ucd94\uac00\ud569\ub2c8\ub2e4. \ud504\ub85d\uc2dc\uc5d0\uc11c \uc694\uccad\uc744 \ubcf4\ub0b4\uc57c \ud558\ub294 \uacbd\uc6b0 \ud574\ub2f9 \ub9e4\uac1c\ubcc0\uc218\uc5d0\uc11c \uc8fc\uc18c\ub97c \uad6c\uc131\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.\r\n\r\nHttpClient { \r\n    engine { \r\n        proxy = ProxyBuilder.http("http:\/\/proxy-host:3128")\r\n    }\r\n}\r\n\r\n\ud50c\ub7ab\ud3fc \uc81c\ud55c\uc73c\ub85c \uc778\ud574 JVM \ubc0f Native \ub300\uc0c1(WatchOS \uc81c\uc678)\uc5d0\uc11c\ub9cc \uc9c0\uc6d0\ub418\uba70 JavaScript\uc5d0\uc11c\ub294 \uc9c0\uc6d0\ub418\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4. \ub2e4\uc591\ud55c \ud50c\ub7ab\ud3fc\uc5d0 \ub9de\uac8c \uad6c\uc131\ud558\ub294 \ubc29\ubc95\uc5d0 \uad00\ud55c \uc790\uc138\ud55c \ub0b4\uc6a9\uc740 \uc5ec\uae30\ub97c \ucc38\uc870\ud558\uc138\uc694.\r\niOS \uc5d4\uc9c4\uc5d0\uc11c NSURLSession \uc0ac\uc6a9\r\n\uc774\uc81c iOS \uc5d4\uc9c4\uc5d0\uc11c NSURLSession\uc744 \uad6c\uc131\ud558\ub294 \ubc29\ubc95\uc744 \uc81c\uacf5\ud569\ub2c8\ub2e4.\r\n\r\nHttpClient(Ios) {\r\n    engine {\r\n        configureSession {\r\n            networkServiceType = NSURLNetworkServiceTypeBackground\r\n        }\r\n    }\r\n}\r\n\r\nNSURLSession\uc740 iOS\uc5d0\uc11c HTTP\/HTTPS \ud504\ub85c\ud1a0\ucf5c\uacfc \uc0c1\ud638 \uc791\uc6a9\ud558\ub294 \uae30\ubcf8 API\uc774\ubbc0\ub85c \uc774\uc81c \ubaa8\ub4e0 iOS \uad00\ub828 \uc124\uc815\uc744 NSURLSession\uc73c\ub85c \uc870\uc815\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.\r\nJSON \uc791\uc5c5 \uac1c\uc120\r\n\ub2e4\uc74c \ubcc0\uacbd \uc0ac\ud56d\uc740 HttpClient\uc640 \uc11c\ubc84\uc5d0\uc11c \ubaa8\ub450 \uc9c0\uc6d0\ub418\uba70 \ud604\uc7ac \uc2e4\ud5d8 \uc0c1\ud0dc\uc785\ub2c8\ub2e4.\r\nJSON\uc5d0\uc11c \uceec\ub809\uc158 \uc9c1\ub82c\ud654 \uac04\uc18c\ud654\r\n\uc774\uc804 Ktor \ubc84\uc804\uc5d0\uc11c\ub294 \uceec\ub809\uc158\uc744 \uc9c1\ub82c\ud654\ud558\ub824\uba74 \ubcf4\uc870 \uc720\ud615\uc744 \ub4f1\ub85d\ud574\uc57c \ud588\uc2b5\ub2c8\ub2e4. \uc774\uc81c JsonFeature\uac00 \ucd94\uac00 \uad6c\uc131 \uc5c6\uc774 \uceec\ub809\uc158 \uc720\ud615\uc744 \ucc98\ub9ac\ud558\uc5ec \uc774 \ud504\ub85c\uc138\uc2a4\uac00 \uac04\uc18c\ud654\ub418\uc5c8\uc2b5\ub2c8\ub2e4. setMapper, setListMapper, register \ub4f1\uc758 \ubaa8\ub4e0 \uad00\ub828 \ud568\uc218\ub3c4 \uc9c0\uc6d0 \uc911\ub2e8\ub429\ub2c8\ub2e4.\r\nJsonFeature\uc5d0\uc11c \ub354 \uc774\uc0c1 List<User>\ub97c \ub4f1\ub85d\ud560 \ud544\uc694\uac00 \uc5c6\uc2b5\ub2c8\ub2e4.\r\n\r\ninstall(JsonFeature)\r\n\/\/ ...\r\nval list = client.get<List<User>>("https:\/\/example\/json\/users")\r\n\r\n\uc774\ub294 \uc11c\ubc84\uc5d0\uc11c JSON\uc73c\ub85c \uc791\uc5c5\ud560 \ub54c\ub3c4 \ub3d9\uc77c\ud558\uac8c \uc801\uc6a9\ub418\uba70, \ucf58\ud150\uce20\ub97c \uc218\uc2e0\ud560 \ub54c \uc608\uc0c1\ub418\ub294 \uc81c\ub124\ub9ad \uc778\uc218\ub85c \uceec\ub809\uc158 \uc720\ud615\uc744 \uc9c0\uc815\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.\r\n\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\n\uc774\uc81c Ktor\ub294 kotlinx.serialization DSL\uc744 \uc0ac\uc6a9\ud558\uc5ec JSON \ubcf8\ubb38\uc744 \uad6c\uc131\ud558\ub294 \ubc29\ubc95\uc744 \uc9c0\uc6d0\ud569\ub2c8\ub2e4.\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\r\n\ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uc11c \uc0ac\uc6a9\ud558\ub824\uba74 JsonFeature\ub97c \uc124\uce58\ud558\uace0 ktor-client-serialization \uc885\uc18d \uc694\uc18c\ub97c \ucd94\uac00\ud558\uc138\uc694. \uc11c\ubc84\uc5d0\uc11c\ub294 SerializationConverter\ub97c \uc0ac\uc6a9\ud558\uc138\uc694.\r\n\ub9c8\uc774\uadf8\ub808\uc774\uc158 \ub2e8\uacc4\r\nKtor \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc744 \uc0c8 \ubc84\uc804\uc73c\ub85c \ub9c8\uc774\uadf8\ub808\uc774\uc158\ud558\ub824\uba74 \ub2e4\uc74c\uc744 \uc218\ud589\ud574\uc57c \ud569\ub2c8\ub2e4.\r\n\r\nHttpResponse\uc758 \ubaa8\ub4e0 \uc0ac\uc6a9 \uc704\uce58\ub97c \uc5c5\ub370\uc774\ud2b8\ud569\ub2c8\ub2e4. \uac04\ub2e8\ud788 close \ud638\ucd9c\uc744 \uc81c\uac70\ud558\uace0 \ud544\uc694\ud55c \uacbd\uc6b0 HttpStatement\ub97c \uc0ac\uc6a9\ud558\uba74 \ub429\ub2c8\ub2e4.\r\n\r\nimport \ubb38\uc744 \uc5c5\ub370\uc774\ud2b8\ud569\ub2c8\ub2e4. kotlinx.io \uc885\uc18d \uc694\uc18c\uac00 \uc81c\uac70\ub418\uc5c8\uc73c\ubbc0\ub85c \ub2e4\uc74c \ubc29\ubc95\uc73c\ub85c import \ubb38\uc744 \uad50\uccb4\ud574\uc57c \ud569\ub2c8\ub2e4.\r\n\r\nimport kotlinx.io. -> import io.ktor.utils.io.\r\nimport kotlinx.coroutines.io. -> import io.ktor.utils.io.\r\n\r\n\r\n\r\n\ub2e8, 1.2.x\uc640 \ubc14\uc774\ub108\ub9ac \ud638\ud658\uc131\uc774 \uc5c6\uc73c\ubbc0\ub85c \uc678\ubd80 Ktor \uae30\ub2a5\uc744 \uc0ac\uc6a9\ud558\ub294 \uacbd\uc6b0 \ucd5c\uc2e0 \ubc84\uc804\uc5d0 \ub9de\uac8c \ub2e4\uc2dc \ucef4\ud30c\uc77c\ud574\uc57c \ud569\ub2c8\ub2e4. \ub610\ud55c 5.4.1 \ubc84\uc804 \uc774\ud6c4\uc758 Gradle \uba54\ud0c0\ub370\uc774\ud130\ub97c \uc0ac\uc6a9\ud558\uace0 \uc788\ub294\uc9c0 \ud655\uc778\ud558\uc138\uc694.\r\n\uae34 \uae00 \uc77d\uc5b4\uc8fc\uc154\uc11c \uac10\uc0ac\ub4dc\ub9ac\uba70 \uc124\ubb38\uc870\uc0ac \ucc38\uc5ec\ub3c4 \ubd80\ud0c1\ub4dc\ub9bd\ub2c8\ub2e4!\r\n\uc124\ubb38\uc870\uc0ac \ucc38\uc5ec\ud558\uae30\r\n\r\n\ubcf8\ubb38\uc740 Sergey Mashkov\uc758 Ktor 1.3 Release\ub97c \ubc88\uc5ed\ud55c \uae00\uc785\ub2c8\ub2e4.","protected":false},"excerpt":{"rendered":"Ktor 1.3\uc774 \ucd5c\uadfc\uc5d0 \ucd9c\uc2dc\ub418\uc5c8\uc2b5\ub2c8\ub2e4. \uc774 \ube14\ub85c\uadf8 \uae00\uc5d0\uc11c\ub294 \uadf8 \uc790\uc138\ud55c \ub0b4\uc6a9\uc744 \uacf5\uc720\ud574 \ub4dc\ub9ac\uaca0\uc2b5\ub2c8\ub2e4.Ktor\ub294 \uc11c\ubc84 \uc5d4\uc9c4\uacfc \uc720\uc5f0\ud55c \ube44\ub3d9\uae30 HTTP \ud074\ub77c\uc774\uc5b8\ud2b8, \ub450 \ubd80\ubd84\uc73c\ub85c \uad6c\uc131\ub429\ub2c8\ub2e4. \ud604\uc7ac \ub9b4\ub9ac\uc2a4\ub294 \uc8fc\ub85c HTTP \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0 \uc911\uc810\uc744 \ub461\ub2c8\ub2e4. \uc774 \ub9b4\ub9ac\uc2a4\uc758 \uc804\uccb4 \ubcc0\uacbd \ub85c\uadf8\ub294 \uc5ec\uae30\uc5d0\uc11c \ud655\uc778\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.\ud074\ub77c\uc774\uc5b8\ud2b8\ub294 JVM, JS, Android, iO","protected":false},"author":{"name":"Jessie Cho","link":"https:\/\/blog.jetbrains.com\/ko\/author\/jessie-chojetbrains-com"},"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[4113],"tags":[5318,5787],"cross-post-tag":[],"acf":[],"featured_image":null,"_links":{"self":[{"href":"https:\/\/blog.jetbrains.com\/ko\/wp-json\/wp\/v2\/posts\/34005"}],"collection":[{"href":"https:\/\/blog.jetbrains.com\/ko\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.jetbrains.com\/ko\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/ko\/wp-json\/wp\/v2\/users\/964"},{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/ko\/wp-json\/wp\/v2\/users\/964"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/ko\/wp-json\/wp\/v2\/comments?post=34005"}],"version-history":[{"count":0,"href":"https:\/\/blog.jetbrains.com\/ko\/wp-json\/wp\/v2\/posts\/34005\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.jetbrains.com\/ko\/wp-json\/wp\/v2\/media?parent=34005"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/ko\/wp-json\/wp\/v2\/categories?post=34005"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/ko\/wp-json\/wp\/v2\/tags?post=34005"},{"taxonomy":"cross-post-tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/ko\/wp-json\/wp\/v2\/cross-post-tag?post=34005"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}