= モジュールは速く副作用の無いこと =

コンフィギュレーションのための外部XMLではなく、Guiceでは通常のJavaコードを使ってモジュールを記述する。
Javaならわかりやすく、IDEで操作可能で、リファクタリングしてもおかしくならない。

しかし、Java言語のフルパワーを生かすにはコストがかかる。モジュール内で「やりすぎ」がたやすくできてしまう。
モジュール内でHTTPサーバを開始しデータベースに接続するというような誘惑にかられる。
こんなことをしないように！
重量級のモジュールでは問題が発生しかねない。

 * モジュールがスタートアップするが、シャットダウンしない。モジュール内でデータベース接続を開始するとそれをクローズする方法がない。
 * モジュールをテストしなければならなくなる。モジュール内でデータベース接続をオープンすると、それをテストするのは難しい。
 * モジュールはオーバライド可能である。Guiceモジュールはオーバライドをサポートしており、製品向けサービスを軽いテスト用のものに代替することが可能であるが、製品サービスをモジュール実行の一部として起動してしまうと、そのようなオーバライドが意味をなさなくなる。

モジュール自体の中でそのような仕事をさせるのではなく、特定の抽象の中でそのような仕事ができるようなインターフェースを定義すべきである。
例えばこのように。
{{{
public interface Service {
  /**
   * サービスをスタートする。このメソッドはサービスが完全に開始するまでブロックする。
   */
  void start() throws Exception;

  /**
   * サービスを停止する。完全にシャットダウンするまでブロックする。
   */
  void stop();
}
}}}

インジェクタを作成した後は、そのサービスを開始することでアプリのブートストラップを終了する。
アプリをストップさせるときは、リソースを完全に解放するためのシャットダウンフックも提供する。
{{{
  public static void main(String[] args) throws Exception {
    Injector injector = Guice.createInjector(
        new DatabaseModule(),
        new WebserverModule(),
        ...
    );

    Service databaseConnectionPool = injector.getInstance(
        Key.get(Service.class, DatabaseService.class));
    databaseConnectionPool.start();
    addShutdownHook(databaseConnectionPool);

    Service webserver = injector.getInstance(
        Key.get(Service.class, WebserverService.class));
    webserver.start();
    addShutdownHook(webserver);
  }
}}}