読んだ : RESTful Web Services with Dropwizard / Alexandros Dallas 著

Dropwizard に関わる仕事をしているので読んでみました。

作者: Alexandros Dallas
出版社/メーカー: Packt Publishing
発売日: 2014/02/19
メディア: Kindle版
この商品を含むブログを見る

Dropwizard について

Dropwizard は Java の web アプリケーションフレームワークです。基本的には既存ライブラリの組み合わせで web アプリケーションを構築するというもので、Dropwizard 固有の仕組みはさほど多くありません。 (例えば Web リクエストを受け取るのは Jersey で、DB アクセスには Hibernate か jDBI が使われる。)

Redirecting to http://www.dropwizard.io/1.0.6/docs/

特に Java EE 系の知識を持っている人であれば、とっつきやすい感じです。

本書について

本書は、Dropwizard を使って web アプリケーションを構築するための方法を説明するものです。プロジェクトの準備や、HTTP リクエストを受けるエンドポイントの記述、DB アクセス、ユーザー認証、HTML を返す View テンプレートについてなど、基本的な要素について、サンプルコードを交えながら仕組みが解説されます。

Java EE などについてある程度わかっている人が読むと Dropwizard の公式ドキュメントを読むのと大差ないと思いますが、初心者の人が読むと結構わかりやすいんじゃないかなと思います。 (ある程度わかってる人にとっても、Dropwizard についてざっと知ることができて良いかもしれませんが、そういう使い方だとちょっと値段は高めに感じる気がします。)

本書での学び

参考のリンクとしては現時点での最新バージョンのドキュメントへのリンクです。閲覧時の最新バージョンのドキュメントは各自探してください。

Dropwizard では、maven-shade プラグインを使って、単体で web アプリケーションとして実行可能な JAR ファイル (uber-jar) を作る。
- 参考 : Getting Started | Dropwizard
Hibernate Validator によるアプリケーション設定のバリデーションが可能。
- 参考 : Getting Started | Dropwizard
jDBI で DB から取得した結果をオブジェクトにマップする方法として、@MapResultAsBean アノテーションを使うという方法もある。
- 参考 : MapResultAsBean (jDBI 2.48.2 API)
- とはいえ公式的なドキュメントは何もなく、ドキュメント化されていない挙動に依存することになるので不安。 (JDBI の機能の多くがドキュメント化されてないのでまあこれに限った話ではないのだけど。)
HTTP リクエストパラメータのバリデーション周り。
- JAX-RS のリソースメソッドのパラメータのバリデーションを明示的に実行することも可能。 (@Valid アノテーションでのバリデーション実行しか知らなかった。)
- 複数フィールドにまたがるバリデーション。
- 参考 : Dropwizard Validation | Dropwizard
Dropwizard には HTTP クライアント用モジュールも含まれている。
- 参考 : Dropwizard Client | Dropwizard
認証周り。
- Basic 認証用のクラスが用意されている。
- オプションの認証も可能。 (認証されたユーザーの場合はそのユーザー専用のコンテンツを表示し、さもなければ一般ユーザー向けのコンテンツを表示する、みたいな。)
- CachingAuthenticator によるキャッシング。
- 参考 : Dropwizard Authentication | Dropwizard
Fixtures for Easy Software Testing (FEST) というプロジェクトがある。 TestNG や JUnit と一緒に使える。ソフトウェアテストを書きやすくするライブラリ。
- 公式サイト : Fixtures for Easy Software Testing — Project Kenai