JavaServer Pages のコンパイルのオプションの提供の設定
JavaServer Pages (JSP) コンパイラーで使用するオプションを指定するには、このページを使用します。
この管理コンソール・ページは、アプリケーションのインストールおよび更新ウィザードにおけるステップの 1 つです。 このページを表示するには、「インストール・オプションの選択 (Select installations options)」ページで「JavaServer Pages ファイルのプリコンパイル (Precompile JavaServer Pages files)」を選択しなければなりません。 そのため、このページを表示するには、 とクリックするか、 とクリックします。
JSP コンパイラー・オプションは、Web モジュールを含むアプリケーションをインストールまたは更新するときにのみ、このページで指定することができます。 アプリケーションがインストールされた後では、JSP コンパイラー・オプションを変更するには、Web モジュールの WEB-INF/ibm-web-ext.xmi ファイルの JSP エンジンの構成パラメーターを編集する必要があります。

ただし、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 ファイル拡張子 を使用します。
sptcfgWeb モジュール (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 ソース・レベル
Java コンパイラーが JSP Java ソースをコンパイルするソース・レベルを指定します。有効な値は、13、14、15、16、17、および 18 です。デフォルト値は 17 です。
JSP ランタイム・コンパイルを使用不可にする
.class ファイルが存在しない場合であっても、実行時に JSP ファイルが変換されたりコンパイルされたりしないようにするかを指定します。
このオプションが true に設定されている場合、JSP エンジンは実行時に JSP ファイルを変換およびコンパイルしないため、JSP エンジンはプリコンパイルされたクラス・ファイルのみをロードします。クラス・ファイルをロードするために JSP ソース・ファイルは必ずしも必要ありません。 JSP ソースなしでアプリケーションをインストールすることができますが、 アプリケーションには、プリコンパイルされたクラス・ファイルが必要です。
単一 Web アプリケーション・クラス・ローダーがすべての JSP クラスパスをロードする場合、 このコンパイラー・オプションと 「 Use full package names」オプションの両方を true に設定する必要があります。
このオプションは、disableJspRuntimeCompilation JSP エンジン・パラメーターと同じです。