Ktorを試してみた - Speaker Deck

Ktorを試してみた

by 虎の穴ラボ株式会社

Slide 1

Slide 1 text

Slide 2

Slide 2 text

Slide 3

Slide 3 text

Slide 4

Slide 4 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 1.はじめに 4 ● 本日の内容

Slide 5

Slide 5 text

Slide 6

Slide 6 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 6 Copyright © 2019 Toranoana Inc. All Rights Reserved. ● Featuresと呼ばれるHTML Template、認証機能などの各種機能をプラグイン形式で追加が可能 ● 非同期処理を行うサーバの開発を容易にできる ● 標準のサーブレットエンジンの他に、Jetty、 Nettyなどのサーブレットエンジンと差し替え可能 2.Ktorについて

Slide 7

Slide 7 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 7 Copyright © 2019 Toranoana Inc. All Rights Reserved. ● Featuresと呼ばれるHTML Template、認証機能などの各種機能をプラグイン形式で追加が可能 ● 非同期処理を行うサーバの開発を容易にできる ● 標準のサーブレットエンジンの他に、Jetty、 Nettyなどのサーブレットエンジンと差し替え可能 2.Ktorについて

Slide 8

Slide 8 text

Slide 9

Slide 9 text

Slide 10

Slide 10 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 10 Copyright © 2019 Toranoana Inc. All Rights Reserved. 1.Ktorプラグインの追加 3.事前準備 Plugin画面で、画面上部の検索欄に「Ktor」と入力すると、Ktorプラグインが表示されるので、プラグインの「Install」ボタンをクリックします。 1. Ktorと入力 2. Install をクリック

Slide 11

Slide 11 text

Slide 12

Slide 12 text

Slide 13

Slide 13 text

Slide 14

Slide 14 text

Slide 15

Slide 15 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 15 Copyright © 2019 Toranoana Inc. All Rights Reserved. 2.Ktorプロジェクトの作成手順 3.事前準備「Project name」を入力すると「Project location」（プロジェクトのディレクトリの作成場所）が自動的に変更されます。内容を確認後、「Finish」ボタンをクリックします。 1. Project name を入力 2. Finishボタンをクリック

Slide 16

Slide 16 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 16 Copyright © 2019 Toranoana Inc. All Rights Reserved. 2.Ktorプロジェクトの作成手順 3.事前準備 Gradleの設定画面が表示されるので「Use auto-import」をチェック状態に変更後、「OK」ボタンをクリックします。 1. Use auto-import をチェック 2. OKボタンをクリック

Slide 17

Slide 17 text

Slide 18

Slide 18 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 18 Copyright © 2019 Toranoana Inc. All Rights Reserved. Ktorの公式サイトで紹介されている Guides を参考に、Ktorにプラグインとして提供されているFeatures（機能）を見ていきます。 https://ktor.io/quickstart/guides.html 4. Features

Slide 19

Slide 19 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 19 Copyright © 2019 Toranoana Inc. All Rights Reserved. Routing 4.Features import io.ktor.routing.* （中略） routing { get("/") { call.respondText("HELLO WORLD!", contentType = ContentType.Text.Plain) } get("/html-dsl") { call.respondHtml { （中略） } } （以下略）

Slide 20

Slide 20 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 20 Copyright © 2019 Toranoana Inc. All Rights Reserved. Routing 4.Features import io.ktor.routing.* （中略） routing { get("/") { call.respondText("HELLO WORLD!", contentType = ContentType.Text.Plain) } get("/html-dsl") { call.respondHtml { （中略） } } （以下略）構造化ルートと関連するハンドラを定義することができます。つまり、リクエストを受け付けるURLと、それに対するアクションを指定できるようになります。 Locations というFeaturesを利用することで、タイプセーフなURLパラメータを扱うことも可能です。

Slide 21

Slide 21 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 21 Copyright © 2019 Toranoana Inc. All Rights Reserved. HTML DSL 4.Features get("/html-dsl") { call.respondHtml { head { link(rel = "stylesheet", href = "/styles.css", type = "text/css") } body { h1 { +"HTML" } ul { for (n in 1..10) { li { +"$n" } } } p("myclass") { +"I am using myclass" } } } } Kotlinのコードを使用してHTMLを生成できるようになります。

Slide 22

Slide 22 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 22 Copyright © 2019 Toranoana Inc. All Rights Reserved. CSS DSL 4.Features get("/styles.css") { call.respondCss { body { backgroundColor = Color.red } p { fontSize = 2.em } rule("p.myclass") { color = Color.blue } } } Kotlinのコードを使用してCSSを生成できるようになります。

Slide 23

Slide 23 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 23 Copyright © 2019 Toranoana Inc. All Rights Reserved. StatusPages 4.Features install(StatusPages) { exception { cause -> call.respond(HttpStatusCode.Unauthorized) } exception { cause -> call.respond(HttpStatusCode.Forbidden) } } class AuthenticationException : RuntimeException() class AuthorizationException : RuntimeException() 例外が発生した際のアクションを定義できるようになります。

Slide 24

Slide 24 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 24 Copyright © 2019 Toranoana Inc. All Rights Reserved. Sessions 4.Features install(Sessions) { cookie("MY_SESSION") { cookie.extensions["SameSite"] = "lax" } } get("/session/increment") { val session = call.sessions.get() ?: MySession() call.sessions.set(session.copy(count = session.count + 1)) call.respondText("Counter is ${session.count}. Refresh to increment.") } data class MySession(val count: Int = 0)

Slide 25

Slide 25 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 25 Copyright © 2019 Toranoana Inc. All Rights Reserved. Sessions 4.Features install(Sessions) { cookie("MY_SESSION") { cookie.extensions["SameSite"] = "lax" } } get("/session/increment") { val session = call.sessions.get() ?: MySession() call.sessions.set(session.copy(count = session.count + 1)) call.respondText("Counter is ${session.count}. Refresh to increment.") } data class MySession(val count: Int = 0) セッションのサポートを追加します。

Slide 26

Slide 26 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 26 Copyright © 2019 Toranoana Inc. All Rights Reserved. Static Content 4.Features // Static feature. Try to access `/static/ktor_logo.svg` static("/static") { resources("static") } 定義された場所から静的ファイルを配信します。左記のようなコードの場合、 /static/ktor_logo.svg を指定されると/resources/static/ ktor_logo.svg を求めます。

Slide 27

Slide 27 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 27 Copyright © 2019 Toranoana Inc. All Rights Reserved. Freemarker 4.Features install(FreeMarker) { templateLoader = ClassTemplateLoader(this::class.java.classLoader, "templates") } get("/html-freemarker") { call.respond(FreeMarkerContent("index.ftl", mapOf("data" to IndexData(listOf(1, 2, 3))), "")) } レスポンスとして、 FreeMarkerContent に指定されたテンプレートindex.ftiと、mapOf データを渡しています。

Slide 28

Slide 28 text

${item}

(index.fti)

Slide 29

Slide 29 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 29 Copyright © 2019 Toranoana Inc. All Rights Reserved. CORS 4.Features install(CORS) { method(HttpMethod.Options) method(HttpMethod.Put) method(HttpMethod.Delete) method(HttpMethod.Patch) header(HttpHeaders.Authorization) header("MyCustomHeader") allowCredentials = true anyHost() // @TODO: Don't do this in production if possible. Try to limit it. } オリジン間リソース共有（CORS）を有効にする為の設定が行えます。（HTTPメソッドの追加、ヘッダーの追加等）

Slide 30

Slide 30 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 30 Copyright © 2019 Toranoana Inc. All Rights Reserved. Jackson 4.Features install(ContentNegotiation) { jackson { enable(SerializationFeature.INDENT_OUTPUT) } } get("/json/jackson") { call.respond(mapOf("hello" to "world")) } Jacksonライブラリを使用して JSONのシリアル化を処理します。

Slide 31

Slide 31 text

Slide 32

Slide 32 text

Slide 33

Slide 33 text

Slide 34

Slide 34 text

Slide 35

Slide 35 text

Slide 36

Slide 36 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 36 Copyright © 2019 Toranoana Inc. All Rights Reserved. ・サーバーは新規のKtorプロジェクトで、Features にRoutingだけを指定して作成したものを、そのまま使用します。 7.実践 fun main(args: Array): Unit = io.ktor.server.netty.EngineMain.main(args) @Suppress("unused") // Referenced in application.conf @kotlin.jvm.JvmOverloads fun Application.module(testing: Boolean = false) { routing { get("/") { call.respondText("HELLO WORLD!", contentType = ContentType.Text.Plain) } } }

Slide 37

Slide 37 text

虎の穴　虎の穴　虎の穴　虎の穴　虎の穴　虎の穴 37 Copyright © 2019 Toranoana Inc. All Rights Reserved. ・クライアント側はKotlinのコルーチンを使用して作成した非常に簡単なものです。 7.実践 import kotlinx.coroutines.runBlocking fun main() = runBlocking { repeat(100) { launch { val result : = clientCall() println("$result") } } } fun clientCall(): String { val requestUrl = "http://127.0.0.1:8080/"