ホットデプロイハンドラ

開発時にアプリケーションのホットデプロイを行うハンドラ。

本ハンドラを使用することで、アプリケーションサーバを再起動することなくアクションクラスやフォームクラスの変更を即座に反映できる。 それにより、ソースコードを修正するたびにアプリケーションサーバを再起動するといった手間を省き、効率よく作業を進めることができる。

処理の流れは以下のとおり。

../../../../_images/flow31.png

重要

本ハンドラはリクエスト毎にクラスの再ロードを行うため、レスポンス速度の低下につながる可能性がある。 そのため、開発環境での使用のみ想定しており、 本番環境では絶対に使用してはならない。

重要

本ハンドラを使用した場合、リクエスト単体テストが正常に動作しない可能性があるため、リクエスト単体テスト時には本ハンドラを使用しないこと。

補足

本ハンドラを使用する場合は、サーバのホットデプロイ機能は無効化すること。

モジュール一覧

<dependency>
  <groupId>com.nablarch.framework</groupId>
  <artifactId>nablarch-fw-web-hotdeploy</artifactId>
</dependency>

制約

なし。

ホットデプロイ対象のパッケージを指定する

ホットデプロイ対象となるパッケージは、targetPackages プロパティに設定する。

設定例を以下に示す。

<component class="nablarch.fw.hotdeploy.HotDeployHandler">
  <property name="targetPackages">
    <list>
      <value>please.change.me.web.action</value>
      <value>please.change.me.web.form</value>
    </list>
  </property>
</component>

重要

以下に示す理由により、エンティティクラスはホットデプロイ対象にしてはならない。

  • リクエスト毎に対象パッケージ内の全てのクラスが再ロードされるため、 エンティティクラスのような頻繁に変更されないクラスもホットデプロイ対象にしてしまうとレスポンス速度の低下につながる恐れがある。
  • リクエスト毎にクラスローダが変わるため、 セッションストア を使用した場合などでエンティティクラスのキャストに失敗する場合がある。