JavaServer Pages のコンパイルのオプションの提供の設定

JavaServer Pages (JSP) コンパイラーで使用するオプションを指定するには、このページを使用します。

この管理コンソール・ページは、アプリケーションのインストールおよび更新ウィザードにおけるステップの 1 つです。このページを表示するには、「インストール・オプションの選択 (Select installations options)」ページで「JavaServer Pages ファイルのプリコンパイル (Precompile JavaServer Pages files)」を選択しなければなりません。このため、このページを表示するには、「アプリケーション (Applications)」 > 「新規アプリケーション (New Application)」 > 「新規エンタープライズ・アプリケーション (New Enterprise Application)」 > 「application_path」 > 「次へ (Next)」 > 「詳細 - すべてのインストール・オプションおよびパラメーターを表示する (Show me all installation options and parameters)」 > 「次へ (Next)」 > 「次へ (Next)」あるいは「継続 (Continue)」 > 「JavaServer Pages ファイルのプリコンパイル (Precompile JavaServer Pages files)」 > 「次へ (Next)」 > 「ステップ: JSP をコンパイルするためのオプションを指定 (Step: Provide options to compile JSPs)」をクリックします。

JSP コンパイラー・オプションは、Web モジュールを含むアプリケーションをインストールまたは更新するときにのみ、このページで指定することができます。アプリケーションがインストールされた後では、JSP コンパイラー・オプションを変更するには、Web モジュールの WEB-INF/ibm-web-ext.xmi ファイルの JSP エンジンの構成パラメーターを編集する必要があります。

サポートされる構成: IBM® 拡張ファイルおよびバインディング・ファイルの場合、.xmi または .xml ファイル名拡張子は、Java EE 5 より前のアプリケーションまたはモジュールを使用しているか、あるいは Java EE 5 以降のアプリケーションまたはモジュールを使用しているかによって異なります。IBM 拡張ファイルまたはバインディング・ファイルは、ibm-*-ext.xmi または ibm-*-bnd.xmi という名前です。ここで * は拡張ファイルまたはバインディング・ファイルのタイプ (app、application、ejb-jar、または web など) です。以下の条件が適用されます。

バージョン 5 より前の Java EE バージョンを使用するアプリケーションまたはモジュールの場合、ファイル拡張子は .xmi でなければなりません。
Java EE 5 以降を使用するアプリケーションまたはモジュールの場合、ファイル拡張子は .xml でなければなりません。.xmi ファイルがアプリケーションまたはモジュールに付属している場合は、製品は .xmi ファイルを無視します。

ただし、Java EE 5 以降のモジュールが、Java EE 5 より前のファイルを含み .xmi ファイル名拡張子を使用するアプリケーション内に存在することは可能です。

ibm-webservices-ext.xmi、ibm-webservices-bnd.xmi、ibm-webservicesclient-bnd.xmi、ibm-webservicesclient-ext.xmi、および ibm-portlet-ext.xmi ファイルは、引き続き .xmi ファイル拡張子を使用します。

sptcfg

Web モジュール (Web module)

アプリケーションのモジュールの名前を指定します。

URI

アプリケーション (EAR ファイル) のルートに対するモジュールのロケーションを指定します。

JSP クラス・パス

アプリケーションのインストール中に JSP ファイルをコンパイルする際に使用する JSP コンパイラーの一時クラスパスを指定します。このクラスパスは、アプリケーションのインストールが完了し、アプリケーションが稼働しているときに使用されていない場合には保存されません。このクラスパスは、アプリケーションがインストールされた後で他の手段 (共有ライブラリーなど) で識別される、JSP のコンパイルに必要なアプリケーション以外のリソースを識別するためにのみ、使用されます。ネットワーク・デプロイメント構成では、このクラスパスはデプロイメント・マネージャー・マシンに固有です。

複数の Web モジュールが同じクラスパスを使用するように指定するには、次のようにします。

Web モジュールのリストで、特定のクラスパスを使用したい各 Web モジュールの横の「選択」チェック・ボックスを選択します。
「複数マッピングの適用」を展開します。
希望するクラスパスを指定します。
「適用」をクリックします。

完全なパッケージ名を使用する

JSP エンジンが完全パッケージ名を使用して JSP クラスを生成およびロードするかどうかを指定します。

完全なパッケージ名を使用する場合、プリコンパイルした JSP クラス・ファイルは、jsp-file 属性を使用する必要なく web.xml ファイルでサーブレットとして構成できます。完全なパッケージ名が使用されない場合は、すべての JSP クラスが同じパッケージで生成されます。これには、ファイル・システム・パスが少なくてすむという利点があります。

オプション useFullPackageNames と disableJspRuntimeCompilation が両方とも true の場合、JSP ファイルが web.xml ファイルでサーブレットとして構成されていなくても、単一のクラス・ローダーはすべての JSP クラスをロードするのに使用されます。

このオプションは、useFullPackageNames JSP エンジン・パラメーターと同じです。

JDK ソース・レベル

[2013 年 3 月更新] Java コンパイラーが JSP Java ソースをコンパイルするソース・レベルを指定します。有効な値は、13、14、15、16、および 17 です。デフォルト値は、Java EE 5 より前の Web モジュールの場合は 13 (ソース・レベル 1.3 を指定) で、 Java EE 5 およびそれ以降の Web モジュールの場合は 16 です。 [2013 年 3 月更新]

JSP ランタイム・コンパイルを使用不可にする

.class ファイルが存在しない場合であっても、実行時に JSP ファイルが変換されたりコンパイルされたりしないようにするかを指定します。

このオプションが true に設定されている場合、JSP エンジンは実行時に JSP ファイルを変換およびコンパイルしないため、JSP エンジンはプリコンパイルされたクラス・ファイルのみをロードします。クラス・ファイルをロードするために、JSP ソース・ファイルは必ずしも必要ありません。 JSP ソースなしでアプリケーションをインストールすることができますが、アプリケーションには、プリコンパイルされたクラス・ファイルが必要です。

単一 Web アプリケーション・クラス・ローダーがすべての JSP クラスパスをロードする場合、このコンパイラー・オプションと「 Use full package names」オプションの両方を true に設定する必要があります。

このオプションは、disableJspRuntimeCompilation JSP エンジン・パラメーターと同じです。

ファイル名: uweb_jspcompile.html