Ratpack入門 (2) - アーキテクチャー #Java

Ratpack入門シリーズ

Ratpackのアーキテクチャー

ここではRatpackの主要なクラスの概略を解説していきます。随時追記予定。

`RatpackServer`

サーバーを起動するための基本的なクラスです。

`ServerConfig`

サーバーに関する設定(ポートなど)をまとめるクラスです。

`Service`

Ratpackサーバーのライフサイクルにおけるフックを提供するインターフェースです。
@Deprecatedされている同名インターフェースがあるので注意。

`Registry`

Handler間で情報の受け渡しに使用されるクラスです。
...こう書くとあまり重要でないように見えますが、サーバー自体もRegistryを通して各依存関係を取得します(公式マニュアルではserver registry)。
従って、Handler自身やRendererといった各機能は全てRegistryを通して取得されるので、Ratpackの柔軟性を支える大切なクラスです。

Google Guiceを使用した拡張が用意されています。

`Action`

設定などを行うための汎用の関数型インターフェースです。
例えばRatpackServer.start()はAction<RatpackServerSpec>を引数にとりますし、RatpackServerSpec.handlers()はAction<Chain>を引数に持ちます。

`Chain`

複数のハンドラーをひとまとめにするクラスです。
各ハンドラーのルーティングなども行います。

`Handler`

あるリクエストを受け取りレスポンスを返すことをモデル化した、handle(Context)メソッドをもつ関数型インターフェースです。
イメージとしてはJava EEのHttpServletのようなものでしょうか。
渡されたContextに処理を記述していくことで、レスポンスを作成していきます。

`Context`

各Handlerの呼び出しに伴う「文脈」を提供するクラスです。
HTTPリクエストなどの情報も、このオブジェクトが保持しています。
Context.render(Object)を呼び出すことで、返却するレスポンスの中身が作成されます。

`Promise`

非同期処理をサポートするクラスです。JavaScriptのPromiseと同じようなもの。詳細解説記事を作成予定。

`Operation`

Promiseの値を返却しないバージョンです。

`Blocking`

PromiseやOperationを作成するためのユーティリティークラスです。ブロッキングIOをするときに使用します。

`Session`

ratpack-sessionが必要です。Ratpackの通信でセッションをサポートするためのクラスです。
Registry.get()から取得します。

`BaseDir`

静的アセットを提供するのに使用するクラスです。