Spring I/O 2017での拡張のお話
•Download as PPTX, PDF•
1 like•2,139 views
JSUG Spring I/O 2017 報告会でのスライドです。
Recommended
More Related Content
What's hot
What's hot (19)
Similar to Spring I/O 2017での拡張のお話
Similar to Spring I/O 2017での拡張のお話 (20)
Spring I/O 2017での拡張のお話
- 3. • Spring Cloud Functionのお話 • Spring Auto REST Docsの拡張のお話 おしながき 3
- 4. Spring Cloud Function について 4 聴講セッション Road to Serverless by Dave Sayer @Pivotal http://presos.dsyer.com/decks/road-to-serverless.html
- 5. • ServerlessとFunction • Spring Cloud Functionのメリット • Spring Cloud Functionのもつ機能 • 実行の流れ • サンプル おしながき 5
- 6. サーバーレスな環境を提供してくれるサービスたち ServerlessとFunction 6 • AWS lambda • Google Cloud Functions • Azure Function • IBM OpenWhisk • Fission • Kubeless • … イベントやストリームデータを トリガーにしてコードを実行できる インフラのメンテナンスを気にしなくて良い
- 8. Spring Cloud Function 8 サーバレスアーキテクチャに対する Spring Bootのアプローチ SpringでFunctionを書いて サーバレスな環境で実行できる https://github.com/markfisher/spring-cloud-function ※Experimental project Springプロジェクトに入ることが決定しました! (by @making)
- 9. • Spring(DI,連携、autoconfiguration)と ビルドツール(テスト・CI、ローカル実行)を使って サーバレスの恩恵を受けられる Spring Cloud Functionのメリット 9 Spring使ってる開発者 FaaS API/UIをネイティブで利用するより 少なくわかりやすいステップで書ける Function信者 Springについて知る必要がない
- 10. Spring Cloud Functionのメリット 10 • 実行プラットフォームからビジネスロジックのライフスタイル を疎結合にする 同じコードをwebエンドポイント/ストリームプロセッサ/タスク として実行できる サーバレスプロバイダ、スタンドアロンな環境(ローカルやPaaS)でも 同じプログラミングモデルで実行することができる
- 11. • @Bean としてjava.util.Function(Supplier, Consumerも)を登録でき る • @FunctionScan(Function向けのComponentScan) • function のコードをコンパイルして実行できる • 孤立したクラスローダでデプロイできる(JVM Packing) • AWS Lambdaなどサーバレスなサービスプロバイダに対するアダ プタを提供 Spring Cloud Functionの機能 11
- 15. 実行の流れ 15 AWS Lambdaの#handleRequestが呼ばれる Springコンテナの初期化(1回だけ) SpringコンテナからfunctionのBeanを取得 ※AWS Lambda Functionの場合 ❶ ❷ ❸ Configurationクラスを探してコンテナ作る functionを探す FluxFunction で wrap される❹ 実行される❺
- 17. 17 AWS Lambdaの#handleRequestが呼ばれる public class SpringBootRequestHandler<E, O> extends SpringFunctionInitializer implements RequestHandler
- 18. 18
- 19. 19
- 21. Spring Auto REST Docs について 21 聴講セッション Introducing Spring Auto REST Docs by Florian Benz @ScalableCapital https://www.slideshare.net/fbenz/introducing-spring-auto-rest-docs
- 22. • ドキュメント作成の方法 • Spring REST Docs? • 書き方 • Spring Auto REST Docs おしながき 22
- 25. 25 テストドリブンなドキュメンテーション ドキュメント作成の方法 テストを通った内容がドキュメント化される コードとドキュメントが同期される = 正確なドキュメント コード ドキュメント テスト Spring REST Docs
- 26. • テストを通ると HTTPリクエストやレスポンスが記載された ドキュメントのもと(スニペット, 部品)を 生成してくれるツール • asciidoc形式で生成される(Markdownもサポート) • 対応しているテストコード： • Junit + Spring MVC Test, TestNG, REST Assured Spring REST Docs? 26 https://www.slideshare.net/jylee1229/spring-rest-doc-58313717
- 28. 28 作り方 pom.xml or build.gradleにビルドの設定を記述 **Documentation.java クラスを作る テストコードを書き、 ドキュメント用の記述を追記 テスト実行 テストが通ったAPIごとに スニペットが生成される ちょっとまとめる できあがり!!! ❶ ❷ ❸ ❹ ❺
- 30. デフォルトで生成されるスニペット • curl-request.adoc • http-request.adoc • http-response.adoc • httpie-request.adoc • request-body.adoc • response-body.adoc 生成されるスニペット 30 [source,bash] ---- $ curl 'http://localhost:8080/tags' -i -X POST -H 'Content-Type: application/hal+json' -d '{ "name" : "REST" }' ---- |=== |Path|Type|Description |`name` |`String` |The name of the tag |=== [source,http,options="nowrap"] ---- HTTP/1.1 201 Created Location: http://localhost:8080/tags/7 ---- curl-request.adoc request-fields.adoc http-response.adoc
- 31. 31 [[resources-tags-create]] === Creating a tag A `POST` request is used to create a note operation::tags-create-example[snippets='request- fields,curl-request,http-response'] [[resources-note]] == Note The Note resource is used to retrieve, update, and delete individual notes [[resources-note-links]] === Links include::{snippets}/note-get-example/links.adoc[] スニペットをまとめる snippet.adoc まとめ.adoc snippet.adoc snippet.adoc snippet.adoc
- 32. 32
- 34. 34 テストコードにDSLを書く JSONを表すPOJOとJavadocを使って ドキュメンテーションを生成する サードパーティーなライブラリ Spring Auto REST Docs Benzさん
- 35. • JSON構造全体を認識し、フィールドのJavadocと一般的 なvalidationアノテーションをドキュメント化してくれる (@NotNull, @NotEmpty,@NotBlank,独自制約(個別・グループ) • パスパラメータ、クエリパラメータが自動でドキュメント化 される • 他のスニペットをインクルードしたスニペットを作ってくれ るので少ないコードで書ける • ドキュメント認証 Auto REST Docsが持つ機能 35
- 36. 36
- 37. 37
- 39. 39
- 40. 40
- 42. 42
- 43. 43
- 44. https://github.com/ScaCap/spring-auto-restdocs https://scacap.github.io/spring-auto-restdocs/#gettingstarted 使ってみたい！ 44 Spring REST Docsのプロジェクトを用意 pom.xml or build.gradleに拡張の記述を追記 MockMvcの設定 ❶ ❷ ❸
- 45. Thank you!
Editor's Notes
- イベントをトリガーして関数を実行
- 設定ファイルにコードを文字で書いちゃってもコンパイルしてfunctionとして実行できる
- 関数を用意してwebのエンドポイントとして提供
- 関数を用意してストリームのイベントプロセッサ
- サーバレスのPaaSにデプロイするためのアダプターが用意されてます
- テストドリブンなドキュメンテーション
- Weatherというディレクトリにスニペットを出力する。これはRestDocumentationResultHandlerというもので記載される MockMvcRestDocumentationのstatic documentメソッドでこのクラスのインスタンスが取得できる
- You can change the default snippet configuration during setup using the RestDocumentationConfigurer API. For example, to only produce the curl-request snippet by default:
- NotNull (Bean Validation) NotEmpty (Hibernate Validator) NotBlank (Hibernate Validator) JSON、Controllerのjavadoc,レクエスト・レスポンスのアノテーション