JSP エンジン・パラメーターの構成

JSP エンジン構成パラメーターを追加、変更、または削除する方法を説明します。

このタスクについて

以下の注記は、このトピック内の .xmi 拡張子をもつファイル参照に適用されます。
サポートされる構成 サポートされる構成: 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.xmiibm-webservices-bnd.xmiibm-webservicesclient-bnd.xmiibm-webservicesclient-ext.xmi、 および ibm-portlet-ext.xmi ファイルは、引き続き .xmi ファイル拡張子 を使用します。

sptcfg
WebSphere® Application Server では、 管理コンソールまたは管理スクリプトを介したデプロイメント記述子拡張パラメーターの変更はサポートしていません。
ベスト・プラクティス ベスト・プラクティス: Rational Application Developer などの アセンブリー・ツールを使用して、IBM 拡張ファイルおよびバインディング・ファイルを 変更します。 IBM Bindings and Extensions Conversion Tool for Multi-Platforms を使用すると、 モジュール内の拡張ファイルおよびバインディング・ファイルを XMI から XML に変換できます。bprac

JSP エンジン構成パラメーターを追加、変更、または削除するには、 次のステップに従ってください。

手順

  1. WEB-INF/ibm-web-ext.xmi または WEB-INF/ibm-web-ext.xml ファイルを開きます。 [AIX Solaris HP-UX Linux Windows][z/OS]

    JSP エンジン構成パラメーターは、Web モジュールの構成ディレクトリー、 または Web モジュールのバイナリー・ディレクトリーにある WEB-INF/ibm-web-ext.xmi または WEB-INF/ibm-web-ext.xml ファイルに保管されています。 WEB-INF/ibm-web-ext.xmi または WEB-INF/ibm-web-ext.xml ファイルは、次のいずれかから開きます。

    [AIX Solaris HP-UX Linux Windows][z/OS]
    • 構成ディレクトリー。例えば、以下のようになります。
      {WAS_ROOT}/profiles/profilename/config/cells/cellname/applications/enterpriseappname/deployments/deployedname/webmodulename
    • バイナリー・ディレクトリー。 「バイナリー構成の使用」フラグを真に設定して、アプリケーションが WebSphere Application Server にデプロイされた場合。バイナリー・ディレクトリーの例は、次のようになります。
      {WAS_ROOT}/profiles/profilename/installedApps/nodename/EnterpriseAppName/WebModuleName/ 
    [IBM i]

    JSP エンジン構成パラメーターは、Web モジュールの構成ディレクトリー、 または Web モジュールのバイナリー・ディレクトリーにある WEB-INF/ibm-web-ext.xmi または WEB-INF/ibm-web-ext.xml ファイルに保管されています。 WEB-INF/ibm-web-ext.xmi または WEB-INF/ibm-web-ext.xml ファイルは、次のいずれかから開きます。

    [IBM i]
    • 構成ディレクトリー。例えば、以下のようになります。
      profile_root/config/cells/cellName/applications/enterpriseAppName/deployments/deployedName/webModuleName/WEB-INF/ibm-web-ext.xmi
      profile_root/config/cells/cellName/applications/enterpriseAppName/deployments/deployedName/webModuleName/WEB-INF/ibm-web-ext.xml
    • バイナリー・ディレクトリー。 「バイナリー構成の使用」フラグを真に設定して、アプリケーションが WebSphere Application Server にデプロイされた場合。バイナリー・ディレクトリーの例は、次のようになります。
      profile_root/installedApps/nodeName/applicationName.ear/applicationName.war/WEB-INF/ibm-web-ext.xmi
      profile_root/installedApps/nodeName/applicationName.ear/applicationName.war/WEB-INF/ibm-web-ext.xml
  2. WEB-INF/ibm-web-ext.xmi または WEB-INF/ibm-web-ext.xml ファイルを編集します。
    • WEB-INF/ibm-web-ext.xmi ファイルに構成パラメーターを追加するには、以下のフォーマットを使用します。
      xmi:id="JSPAttribute_6" name="parametername" value="parametervalue"/> 
    • WEB-INF/ibm-web-ext.xml ファイルに構成パラメーターを追加するには、以下のフォーマットを使用します。
      <jsp-attribute name="parametername" value="parametervalue"/>
    • 構成パラメーターを削除するには、ファイルから行を削除するか、 ステートメントを <!-- --> タグで囲みます。
  3. ファイルを保存します。
  4. エンタープライズ・アプリケーションを再始動します。パラメーターの変更を有効にする場合、 サーバーを再始動する必要はありません。 ただし、一部の JSP エンジン構成パラメーターは、JSP 用に生成される Java ソース・コードに影響を与えます。 このようなパラメーターを変更した場合は、Web モジュール内の JSP ファイルを再変換して、Java ソースを再生成する必要があります。 バッチ・コンパイラーを使用して、Web モジュール内のすべての JSP ファイルを再変換できます。バッチ・コンパイラーは、明確にオーバーライドしない限り、ibm-web-ext.xmi または ibm-web-ext.xml ファイルで設定した JSP エンジン構成パラメーターを使用します。『JSP エンジン構成パラメーター』トピックでは、 生成される Java ソースに影響するパラメーターが特定されます。

以下は、WEB-INF/ibm-web-ext.xmi ファイルのサンプルです。 太字の行が、JSP エンジン構成パラメーターです。
<?xml version="1.0" encoding="UTF-8"?>
<webappext:WebAppExtension xmi:version="2.0" xmlns:xmi=http://www.omg.org/XMI
   xmlns:webappext="webappext.xmi" xmlns:webapplication="webapplication.xmi" xmi:id="WebAppExtension_1"   
   reloadInterval="9" reloadingEnabled="true" defaultErrorPage="error.jsp" additionalClassPath="" 
   fileServingEnabled="true" directoryBrowsingEnabled="false" serveServletsByClassnameEnabled="true" 
   autoRequestEncoding="true" autoResponseEncoding="false">
   <webApp href="WEB-INF/web.xml#WebApp_1"/>
   <jspAttributes xmi:id="JSPAttribute_1" name="useThreadTagPool" value="true"/>
   <jspAttributes xmi:id="JSPAttribute_2" name="verbose" value="false"/>
   <jspAttributes xmi:id="JSPAttribute_3" name="deprecation" value="false"/>
   <jspAttributes xmi:id="JSPAttribute_4" name="reloadEnabled" value="true"/>
   <jspAttributes xmi:id="JSPAttribute_5" name="reloadInterval" value="5"/>
   <jspAttributes xmi:id="JSPAttribute_6" name="keepgenerated" value="true"/>
   <!--<jspAttributes xmi:id="JSPAttribute_7" name="trackDependencies" value="true"/> -->
   
</webappext:WebAppExtension>
以下は、WEB-INF/ibm-web-ext.xml ファイルの例です。 太字の行が、JSP エンジン構成パラメーターです。
<?xml version="1.0" encoding="UTF-8"?>
<web-ext
   	xmlns="http://websphere.ibm.com/xml/ns/javaee"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://websphere.ibm.com/xml/ns/javaee http://websphere.ibm.com/xml/ns/javaee/ibm-web-ext_1_0.xsd"
      version="1.0">

   <default-error-page uri="error.jsp"/>
   <jsp-attribute name="useThreadTagPool" value="true" />
   <jsp-attribute name="verbose" value="false" />
   <jsp-attribute name="deprecation" value="false" />
   <jsp-attribute name="reloadEnabled" value="true" />
   <jsp-attribute name="reloadInterval" value="5" />
   <jsp-attribute name="keepgenerated"  value="true" />
   <jsp-attribute name="trackDependencies" value="true" />
   <reload-interval value="9"/>
   <auto-encode-requests value="true"/>
   <auto-encode-responses value="false"/>
   <enable-directory-browsing value="false"/>
   <enable-file-serving value="false"/>
   <pre-compile-jsps value="false"/>
   <enable-reloading value="true"/>
   <enable-serving-servlets-by-class-name value="true"/>
</web-ext>
重要: JSPattribute_n の整数 n は、 ファイル内で固有でなければなりません。

トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tweb_jspengine
ファイル名:tweb_jspengine.html