2.6.7 JSPのオートリロード

JSPを使用したアプリケーションの開発中に、正しくJSPの表示ができるかどうかを確認するために、アプリケーションを作り直して再配備することなく、配備済みのアプリケーションのJSPを入れ替えることが可能です。これをJSPのオートリロード機能と呼びます。

JSPのオートリロード機能を利用する場合は、事前にGlassFish Web application deployment descriptor(glassfish-web.xml)の<jsp-config>に、以下のいずれかのプロパティを指定してください。

development：リクエストごとに、JSPが入れ替えられているかどうか判定を行うとき
checkInterval：一定間隔ごとに、JSPが入れ替えられているかどうか判定を行うとき

例

リクエストごとにJSPが入れ替えられているかどうか判定を行う場合のglassfish-web.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE glassfish-web-app PUBLIC
  "-//GlassFish.org//DTD GlassFish Application Server 3.1 Servlet 3.0//EN"
  "http://glassfish.org/dtds/glassfish-web-app_3_0-1.dtd">
<glassfish-web-app>
  <jsp-config>
    <property name="development" value="true" />
  </jsp-config>
</glassfish-web-app>

JSPのオートリロードを実施するためには、配備済みアプリケーションのJSPファイルを編集・置換します。

配備済みアプリケーションは、以下のディレクトリーに配備モジュールを展開した形式で格納されています。

DASの場合

[運用資産格納ディレクトリー]\domains\domain1\applications\[アプリケーション名]

[運用資産格納ディレクトリー]/domains/domain1/applications/[アプリケーション名]

GlassFish Serverクラスター配下のGlassFish Serverインスタンスの場合

[運用資産格納ディレクトリー]\nodes\localhost-domain1\[GlassFish Serverインスタンス名]\applications\[アプリケーション名]

[運用資産格納ディレクトリー]/nodes/localhost-domain1/[GlassFish Serverインスタンス名]/applications/[アプリケーション名]

注意

GlassFish Serverインスタンス配下のJSPファイルを更新した後で、GlassFish Serverクラスターを起動し直すと、同期化処理によりDASのファイルに置き換えられてしまいます。そのため、GlassFish Serverインスタンス配下のJSPファイルを更新する場合は、DAS配下のJSPファイルに対しても同じ変更をするようにしてください。
複数のGlassFish ServerインスタンスをもつGlassFish Serverクラスターの場合は、すべてのGlassFish Serverインスタンスに対して、配下のJSPファイルを編集/置き換えする必要があります。

JSPのオートリロードの対象となるファイルは、以下のとおりです。

JSP
JSPから静的include(注1)、動的include(注2)されているJSPやtxtなどのファイル
web.xmlの<jsp-config>-<jsp-property-group>配下の<include-prelude>または<include-coda>に指定したファイル
tldファイル(WEB-INF、またはそのサブディレクトリー配下)
tldファイルで定義されているタグファイル(WEB-INF/tags、またはそのサブディレクトリー配下)(注3)
JSPから参照されているタグファイル(WEB-INF/tags、またはそのサブディレクトリー配下)

以下のファイルは、JSPのオートリロードの対象外です。

tldファイル(WEB-INF/lib配下のjar内のMETA-INF、またはそのサブディレクトリー配下)
tldファイルから参照されているタグファイル（WEB-INF/lib配下のjar内のMETA-INF/tags、またはそのサブディレクトリー配下）
タグクラス

注1)

静的includeとは、以下のようにincludeディレクティブを使用してファイルをincludeすることです。

例

<%@ include file="include.txt"%>

注2)

動的includeとは、以下のように<jsp:include>タグを使用してファイルをincludeすることです。

なお、動的includeでは、JSPのオートリロード機能が有効でない場合も、txtなどの静的ファイルについては、リクエストごとに読み込まれるため、変更が反映されます。

例

<jsp:include page="include.txt" flush="true" />

注3)

tldファイルの<tag-file>タグ配下に、<path>タグで定義されている場合です。

例

<tag-file>
        <name>sampleTag</name>
        <path>/WEB-INF/tags/sample/sample.tag</path>
</tag-file>

注意

JSPの入れ替え方法に関する注意事項は、「1.4.3 Webアプリケーションの注意事項」の「JSPの入れ替えについて」を参照してください。