Ratpack入門 (3) - hello world 詳解
Ratpack入門シリーズ
- Ratpack入門 (1) - Ratpackとは
- Ratpack入門 (2) - アーキテクチャー
- Ratpack入門 (3) - hello world 詳解
- Ratpack入門 (4) - ルーティング & 静的コンテンツ
- Ratpack入門 (5) - Json & Registry
- Ratpack入門 (6) - Promise
- Ratpack入門 (7) - Guice & Spring
- Ratpack入門 (8) - セッション
- Ratpack入門 (9) - Thymeleaf
hello world 詳解
ここでは、最初の記事のHello Worldサンプルをもう少し複雑にして、Ratpackという「水に慣れる」ことを目指します。
なおここでは型を明示するため、あえて冗長に書いています。石を投げないでください。
public final class Sample3_HelloWorldRevisited {
public static void main( String[] args ) throws Exception {
ServerConfig config = ServerConfig.builder()
.port( 5050 )
.connectTimeoutMillis( 10000 )
.threads( 8 )
.development( true )
.build();
Registry registry = Registry.empty();
Action<Chain> handlers = ( Chain chain ) -> {
Handler handler = ( Context ctx ) -> {
ctx.render( "hello, world" );
};
chain.get( handler );
};
RatpackServer.of( spec -> spec.serverConfig( config )
.registry( registry )
.handlers( handlers ) )
.start();
}
}
ServerConfig
サーバーの設定を変更するためのクラスです。ポート番号などがここから設定できます。
ServerConfigBuilder
が用意されているのでこれを使うのが一番簡単だと思います。
json()
、yaml()
等、ファイルから設定値を読み込むためのメソッドも用意されています。
他にもシステムプロパティーや引数などから設定するためのメソッドがあるので、好みの方法でServerConfig
を作成できます。
development(boolean)
開発中モードを有効化するフラグです。
有効な場合、エラー発生時のハンドラーが自動的に追加されます。
※いまいちドキュメント化されていないので、他にも違いがあるのかもしれないです
実際に404エラーを発生させた場合の比較が、下記になります。
Ratpackの404エラーページ有無のほか、ログに独自ハンドラーを定義するよう警告されます。
19:02:26.231 [ratpack-compute-1-2] ERROR ratpack.error.internal.DefaultDevelopmentErrorHandler - 404 client error for request to /hoge
19:00:55.861 [ratpack-compute-1-4] WARN ratpack.error.internal.DefaultProductionErrorHandler - Default production error handler used to render client error, please add a ratpack.error.ClientErrorHandler instance to your application (method: GET, uri: /hoge)
development(true)
は手軽に使えますが、本番環境では独自のErrorHandler
を作成することが推奨されているようです。
エラーハンドラーにはClientErrorHandler
とServerErrorHandler
の二種類があります。
ClientErrorHandler
は404など、クライアントのリクエストに問題があった時に呼び出されます。
Context
とint
ステータスコードを引数にとるerror()
メソッドをオーバーライドします。
ServerErrorHandler
はハンドラーでエラーが発生したときに呼び出されます。
Context
と発生した例外を表すThrowable
を引数にとるerror()
メソッドがあります。
ServerErrorHandler
はRatpackにおけるエラー処理の最後の砦なので、基本的に例外を投げないことが推奨されています。
ところでこのメソッド、Exception
ではなくThrowable
を引数に持っている通り、Error
が発生した場合も処理されます。
Javaでは一般的にError
をキャッチしないことが推奨されていますので、その場合無理に復帰を試みないほうが良いと思われます。
Registry
Ratpackサーバーにモジュールなど部品を登録していくクラスです。今回は何も使わないので、空の実装を使用します。
上記のエラーハンドラーなどは、このレジストリに登録することで利用可能になります。
handlers
Ratpackは、Chain
によってまとめられた複数のHandler
によってルーティングを行います。
Chain.get(String, Handler)
メソッドは、HTTPのGETリクエストを、引数のハンドラーに結びつけています。
第一引数の文字列はパスです。今回のように省略するとルートにマッピングされます。
Context.render(Object)
が、レスポンスのボディーを出力するメソッドです。
今回はStringを引数に渡しているので、そのままその文字列が出力されることになりますが、文字列以外のオブジェクトを渡すこともできます。
render()
はRegistry
に登録されたRenderer
が、型に応じて呼び出され、レスポンスに変換する仕組みになっています。
Stringには(正確にはCharSequenceには)組み込みのRenderer
があるため、明示的にレンダラーを登録しなくても、Context.render()
で呼び出せるという仕組みになっています。
RatpackServer.of( spec -> spec.serverConfig( config )
.registry( registry )
.handlers( handlers ) )
.start();
of()
メソッドでServerConfig
、Registry
、Handler
を設定し、RatpackServer
インスタンスを作成します。
start()
メソッドでサーバーが起動され、リクエストの受け付けを開始します。
RatpackServerSpec
の各メソッド(serverConfig()
、registry()
、handler()
およびhandlers()
)は、対応するクラスのインスタンスを引数に持つものと、Action
経由で設定するものなどいろいろあります。
個人的には例に挙げたように、コンフィグとレジストリに関してはインスタンスを、ハンドラーにはAction
を使うのがやりやすい気がします。この辺は主観なのでいろいろ試してみることをお勧めします。
Author And Source
この問題について(Ratpack入門 (3) - hello world 詳解), 我々は、より多くの情報をここで見つけました https://qiita.com/minebreaker/items/b26d7d0677f91f17a7b5著者帰属:元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。
Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .