AkkaHTTPの紹介とAkkaStreams連携(公開用)

ReactiveSystemMeetupin大阪
https://connpass.com/event/98181/

Transcript

1. Akka HTTP の紹介と Akka Streams 連携 Reactive System Meetup in 大阪 2018/09/20 Reactive System Meetup in 大阪 1 @にしかわささき
2. 自己紹介 にしかわささき @nishikawasasaki • 広島@M4 → 神戸のシステム屋さん • Java Scala JavaScript … • インフラ AWS KVS … • 検索 データ分析 GIS … • Vim → Emacs → vscode • マネージャー, , 2018/09/20 Reactive System Meetup in 大阪 2
3. 目次 1. Akka HTTP とは 2. Akka HTTP の簡単な例 3. Akka HTTP のルーティングとディレクティブ 4. Akka HTTP と Akka Streams の関係 5. Akka HTTP と Akka Streams の連携 2018/09/20 Reactive System Meetup in 大阪 3
4. Akka HTTP とは 基本の紹介 2018/09/20 Reactive System Meetup in 大阪 4
5. Akka HTTP とは 2018/09/20 Reactive System Meetup in 大阪 5  Akka Streams ベース  旧 spray.io → Akka HTTP (多少の差異あり)  HTTP を扱うモジュール群 (≠フレームワーク)
6. Akka HTTP とは 2018/09/20 Reactive System Meetup in 大阪 6 ×フレームワーク → ◦「ライブラリスイート」  ユースケースにあわせて必要な部分だけを 組み合わせて使える  同じ機能でも抽象化の違う API を用意している
7. Akka HTTP とは 2018/09/20 Reactive System Meetup in 大阪 7 Akka HTTP を構成するモジュール  akka-http 高レベルサーバーサイドAPI  akka-http-core 低レベルサーバーサイドAPI  akka-http-testkit テストユーティリティ  akka-http-spray-json JSON 変換ユーティリティ  akka-http-xml XML 変換ユーティリティ
8. Akka HTTP とは 2018/09/20 Reactive System Meetup in 大阪 8 akka-http  抽象度 高  HTTP を便利に扱うための DSL 等を含む akka-http-core  抽象度 低  HTTP を扱うコア機能に限定し軽量・簡潔  HTTP クライアント機能
9. Akka HTTP (akka-http) の簡単な例 具体例 2018/09/20 Reactive System Meetup in 大阪 9
10. Akka HTTP の簡単な例 • 依存するライブラリと import 2018/09/20 Reactive System Meetup in 大阪 10 https://doc.akka.io/docs/akka-http/current/introduction.html#using-akka-http
11. Akka HTTP の簡単な例 2018/09/20 Reactive System Meetup in 大阪 11 https://doc.akka.io/docs/akka-http/current/introduction.html#using-akka-http 全体像 レスポンス
12. Akka HTTP の簡単な例 2018/09/20 Reactive System Meetup in 大阪 12 https://doc.akka.io/docs/akka-http/current/introduction.html#using-akka-http 全体像 用意 HTTP 待受 停止 ルーティング
13. Akka HTTP の簡単な例 2018/09/20 Reactive System Meetup in 大阪 13 https://doc.akka.io/docs/akka-http/current/introduction.html#using-akka-http 用意
14. Akka HTTP の簡単な例 2018/09/20 Reactive System Meetup in 大阪 14 https://doc.akka.io/docs/akka-http/current/introduction.html#using-akka-http • Actor を使うための準備 • Actor で処理を実行するために必要な ActorMaterializer の準備 • ExecutionContext の用意 (import scala.concurrent.ExecutionContext.Implicits.global でも可) Actor System は全体で 1 つ デフォルトは fork-join-executor
15. Akka HTTP の簡単な例 2018/09/20 Reactive System Meetup in 大阪 15 https://doc.akka.io/docs/akka-http/current/introduction.html#using-akka-http ルーティング
16. Akka HTTP の簡単な例 2018/09/20 Reactive System Meetup in 大阪 16 https://doc.akka.io/docs/akka-http/current/introduction.html#using-akka-http • DSL を使ってルーティングを定義 • 単純な HTML をレスポンス GET の場合の処理 レスポンスの content-type は HTML を指定
17. Akka HTTP の簡単な例 2018/09/20 Reactive System Meetup in 大阪 17 https://doc.akka.io/docs/akka-http/current/introduction.html#using-akka-http HTTP 待受
18. Akka HTTP の簡単な例 2018/09/20 Reactive System Meetup in 大阪 18 https://doc.akka.io/docs/akka-http/current/introduction.html#using-akka-http • 前ページで用意したルーティングを使って localhost:8080 で待受開始 レスポンス
19. Akka HTTP の簡単な例 2018/09/20 Reactive System Meetup in 大阪 19 https://doc.akka.io/docs/akka-http/current/introduction.html#using-akka-http 停止
20. Akka HTTP の簡単な例 2018/09/20 Reactive System Meetup in 大阪 20 https://doc.akka.io/docs/akka-http/current/introduction.html#using-akka-http • 何か入力されるまで停止 • 待受を停止して終了する
21. Akka HTTP の簡単な例 2018/09/20 Reactive System Meetup in 大阪 21 https://doc.akka.io/docs/akka-http/current/introduction.html#using-akka-http 全体像 (再掲) ルーティング
22. akka-http の ルーティングとディレクティブ 慣れると便利？ 2018/09/20 Reactive System Meetup in 大阪 22
23. ルーティングとディレクティブ • ディレクティブ (Directive) • 用意されたディレクティブや 自作のディレクティブを ネスト・組み合わせ = ルーティングツリーの作成 2018/09/20 Reactive System Meetup in 大阪 23
24. ルーティングとディレクティブ 例1: complete ディレクティブ リクエストの状態や方法、内容によらず 文字列を単純に返す 2018/09/20 Reactive System Meetup in 大阪 24
25. ルーティングとディレクティブ 例1: complete ディレクティブ プレースホルダ _ を利用して短縮も可能 2018/09/20 Reactive System Meetup in 大阪 25
26. ルーティングとディレクティブ 例2-a: get ディレクティブ GET リクエストの場合にだけ 中のディレクティブが有効となる 2018/09/20 Reactive System Meetup in 大阪 26 GETした場合 GET以外 (POST) した場合
27. ルーティングとディレクティブ 例2-b: post ディレクティブ MethodDirectives として GET や POST、DELETE などが用意されている 2018/09/20 Reactive System Meetup in 大阪 27 POSTした場合 POST以外 (GET) した場合
28. ルーティングとディレクティブ 例3-1: path 系ディレクティブ (path) /foo/ へのリクエストも当てはまらない 2018/09/20 Reactive System Meetup in 大阪 28 /foo にリクエストした場合 /foo 以外にリクエストした場合 当てはめたい場合は……？
29. ルーティングとディレクティブ 例3-2: pathPrefix ディレクティブ /foooooo や /foooooo/// へのリクエストも 当てはまってしまう 2018/09/20 Reactive System Meetup in 大阪 29 /foo/ にリクエストした場合 /foo 以外にリクエストした場合
30. ルーティングとディレクティブ 例3-3: pathEndOrSingleSlash ディレクティブ 2018/09/20 Reactive System Meetup in 大阪 30 /foo にリクエストした場合 /foo/ にリクエストした場合 それ以外にリクエストした場合
31. ルーティングとディレクティブ 例4: ディレクティブの連結 /foo と /bar の両方を受け付けるようにしたい 2018/09/20 Reactive System Meetup in 大阪 31
32. ルーティングとディレクティブ 例4: ディレクティブの連結 「~ 」を使うとディレクティブの連結が可能 2018/09/20 Reactive System Meetup in 大阪 32 ~
33. ルーティングとディレクティブ • ディレクティブの組み合わせと連結によって 複雑なルーティングを柔軟に表現することが可能 • 他にもキャッシュや認証のディレクティブなど 便利なディレクティブが標準で多く用意されている 2018/09/20 Reactive System Meetup in 大阪 33 https://doc.akka.io/docs/akka-http/current/routing-dsl/ directives/alphabetically.html
34. Akka HTTP と Akka Streams の関係 そもそものはなし…… 2018/09/20 Reactive System Meetup in 大阪 34
35. Akka HTTP と Akka Streams の関係 2018/09/20 Reactive System Meetup in 大阪 35  「Akka Streams ベース」 Akka HTTP もストリームを扱っている → akka-http では うまく akka-stream が隠されている
36. Akka HTTP と Akka Streams の関係 2018/09/20 Reactive System Meetup in 大阪 36 HTTP 待受部分の抜粋 (抽象度高)
37. Akka HTTP と Akka Streams の関係 2018/09/20 Reactive System Meetup in 大阪 37 HTTP 待受部分の抜粋 (抽象度低) https://doc.akka.io/docs/akka-http/current/server-side/ low-level-api.html#starting-and-stopping
38. Akka HTTP と Akka Streams の関係 2018/09/20 Reactive System Meetup in 大阪 38 HTTP 待受部分の抜粋 (抽象度低) https://doc.akka.io/docs/akka-http/current/server-side/ low-level-api.html#starting-and-stopping Akka Streamsっぽさ
39. Akka HTTP と Akka Streams の関係 Source Output のみ 2018/09/20 Reactive System Meetup in 大阪 39 Source Akka Streams の部品 Flow Input と Output の両方 Flow Sink Input のみ Sink
40. Akka HTTP と Akka Streams の関係 Source 1 つと Flow いくつかと Sink 1 つを 組み合わせて両端が「閉じた」処理の流れを形成する (→ RunnableGraph) 2018/09/20 Reactive System Meetup in 大阪 40 Source Sink Source Flow Sink Flow Sink Source Flow Flow は 使わなくても良い 組み合わせ方は自由。 それぞれ 再利用も可能。
41. Akka HTTP と Akka Streams の関係 は Scala のソースにすると 2018/09/20 Reactive System Meetup in 大阪 41 Source Sink ソケットへのバインディングが Source
42. Akka HTTP と Akka Streams の関係 2018/09/20 Reactive System Meetup in 大阪 42 ルーティング (処理) 部分の抜粋 (抽象度低)
43. Akka HTTP と Akka Streams の関係 2018/09/20 Reactive System Meetup in 大阪 43 ルーティング (処理) 部分の抜粋 (抽象度低) Akka Streamsっぽさ
44. Akka HTTP と Akka Streams の関係 2018/09/20 Reactive System Meetup in 大阪 44 ルーティング (処理) 部分の抜粋 (抽象度低) 1 接続あたりで考えると ・リクエストがSource ・処理が Flow ・レスポンスが Sink Flow[リクエスト→レスポンス]
45. Akka HTTP と Akka Streams の関係  Akka Streams を意識しなくても便利に使える  Akka HTTP にも Akka Streams が隠れている 2018/09/20 Reactive System Meetup in 大阪 45
46. Akka HTTP と Akka Streams の連携 応用 2018/09/20 Reactive System Meetup in 大阪 46
47. Akka HTTP と Akka Streams の連携 2018/09/20 Reactive System Meetup in 大阪 47  クライアントからファイルが ストリーミングでアップロードされる場合 →サーバーサイドの処理の状況に応じて 背圧制御をおこないたい (対応している場合)
48. Akka HTTP と Akka Streams の連携 2018/09/20 Reactive System Meetup in 大阪 48 JSON ファイルをストリームで受け付ける例 https://doc.akka.io/docs/akka-http/current/routing-dsl/ source-streaming-support.html#consuming-json-streaming-uploads
49. Akka HTTP と Akka Streams の連携 2018/09/20 Reactive System Meetup in 大阪 49 JSON ファイルをストリームで受け付ける例 リクエスト (ストリーム) を Measurement 型の Source として 取り扱う https://doc.akka.io/docs/akka-http/current/routing-dsl/ source-streaming-support.html#consuming-json-streaming-uploads
50. Akka HTTP と Akka Streams の連携 2018/09/20 Reactive System Meetup in 大阪 50 JSON ファイルをストリームで受け付ける例 Akka Streams をつかって 処理を実行 途中処理は Flow https://doc.akka.io/docs/akka-http/current/routing-dsl/ source-streaming-support.html#consuming-json-streaming-uploads
51. Akka HTTP と Akka Streams の連携 2018/09/20 Reactive System Meetup in 大阪 51 JSON ファイルをストリームで受け付ける例 ストリームが終了して Future から結果を取り出せたら レスポンスを返す https://doc.akka.io/docs/akka-http/current/routing-dsl/ source-streaming-support.html#consuming-json-streaming-uploads
52. まとめ さいごに 2018/09/20 Reactive System Meetup in 大阪 52
53. まとめ 2018/09/20 Reactive System Meetup in 大阪 53 Akka HTTP では必要最小限な処理だけを 利用することができる Akka HTTP のディレクティブは 組み合わせしだいで複雑なルーティングを表現できる Akka Streams は意識しなくても便利に使えるが ある程度の理解があった方が捗る
54. 紹介 2018/09/20 Reactive System Meetup in 大阪 54 Akka HTTPでWeb APIに仕立てる Think IT（シンクイット） https://thinkit.co.jp/article/15235 Scala関西Summit 2018 11/10(土),11/11(日) https://2018.scala-kansai.org/#top-timetable Akka実践バイブル アクターモデルによる 並行・分散システムの実現 https://www.shoeisha.co.jp/book/ detail/9784798153278