Web プロジェクトでの Faces ランタイム・リソースの更新

WebSphere® Studio Site Developer V5.1.x に付属 していた JavaServer Faces ランタイム・リソースは、 Rational® Web Developer V6.0.1 用に更新されました。 この旧製品バージョンで作成された Web プロジェクトでの開発を継続したい場合は、Faces ランタイム・リソースを最新レベルに更新することをお勧めします。

Rational Web Developer V6.0.1 では、 Faces ランタイム・リソースの更新は、古いリソースが含まれた Web プロジェクトがインポ ートされるか、古いリソースが含まれたワークスペースが開かれたときに自動的に行われます。 WebSphere Studio Site Developer V5.1.x から Rational Web Developer V6.0.1 に Web プロジェクト をインポートするかワークスペースを開いた後で、Faces ランタイム・リソースを最新レベ ルに更新するように指示するプロンプトが表示されます。

ランタイム・リソースを自動的に更新する

Web プロジェクトに対して Faces ランタイム ・リソースを自動的に更新するには、以下のようにします。
  1. Faces コンテンツが含まれた Web プロジェクト (またはワークスペース) を WebSphere Studio Site Developer V5.1.x からインポートする。 「プロジェクトのマイグレーション」ウィンドウが開きます。
    注: 「プロジェクトのマイグレーション」ウィンドウが開かない場合は、自動ビルドの設定が おそらく無効になっています。 プロジェクト・エクスプローラーで Web プロジェクトを右クリックして、 「ビルド」 > 「プロジェクト」を選択します。これにより、プロジェクトの再ビルド・プロセスが 実行されて、「プロジェクトのマイグレーション」ウィンドウが開き ます。
  2. Faces コンテンツが含まれた他の Web プロジェクトがワークスペース内にある場合 は、「アップグレードの必要がある他のプロジェクトにこの選択を適用する」チェック・ボックスを選択すると、すべての Web プロジェクトが更新される。
  3. 次のいずれかをクリックする。
    • 更新を自動的に完了するには、「適用する」をクリックする。
    • 更新を延期するには、「後で適用する」をクリックする。 「後で適用する」の選択後にランタイム・リソースを自動的に更新 するには、Web プロジェクトを再ビルドする前に、Web プロジェクトを閉じ てから再び開くかワークベンチを再始動する必要があります。 自動ビルドを無効にしている場合は、Web プロジェクトを右クリックして 「プロジェクトのビルド」を選択します。
    • ランタイム・リソースをバックレベルのままにするには、「適用しない」をクリックする。 「適用しない」を選択してバックレベルのランタイム・リソースを 意図的に保持した場合は、これらのランタイム・リソースを更新するように指示するプロンプトは再表示されません。 今後は、これらのランタイム・リソースが必要な場合は、これらを手動で更新する必要があります。
注: Faces Client コンポーネントが含まれた Faces JSP を作成した場合は、Faces Client コンポーネント・ランタイム・リソースを別個に最新レベルに更新する必要があります。「Web プロジェクトでの Faces Client ランタイム・リソースの更新」を参照してください。

ランタイム・リソースを手動で更新する

Web プロジェクトに対して Faces ランタイム・リソー スを手動で更新するには、以下のようにします。
  1. Faces コンテンツが含まれた既存の Web プロジェクトを Rational Web Developer V6.0.1 ワークスペースにインポー トする。
  2. JSF601 という名前の新しい Web プロジェクトを作成する (または EGL で 作業をしている場合は JSF601 という名前の新しい EGL Web プロジェクトを作成する)。 このプロジェクトは、最新ランタイム・リソースのソースとしてのみ使用し、更新の完了後には削除できます。
  3. プロジェクト・エクスプローラーで JSF601 プロジェクトを右クリックし、 メニューから「プロパティー」を選択する。
  4. Web プロジェクト・フィーチャー 」をクリックして、「Faces 基本コンポーネントの追加」と「Faces Client Framework の追加」を選択し、「OK」をクリックする。
  5. EGL で作業をしている場合は、以下の手順で JSF ページを作成してください。
    1. 新規 EGL Web プロジェクトの WebContent フォルダーを右クリックする。
    2. 「新規」 > 「その他」 > 「Faces JSP ファイル」を選択する。
    eglintdebug.jar ファイルと eglintdebugsupport.jar ファイルが プロジェクトに追加されます。
  6. 更新したい既存の Faces プロジェクトごとに以下を実行する。
    1. プロジェクト・エクスプローラーで既存のプロジェクトを展開して、 WebContent/WEB-INF/lib/ フォルダー内のファイルを表示する。このディレクトリーにある 以下の JAR ファイルをすべて見つけて削除します。
      • eglintdebug.jar (EGL のみ)
      • eglintdebugsupport.jar (EGL のみ)
      • fda.jar (EGL のみ)
      • fdaj.jar (EGL のみ)
      • jsf-api.jar
      • jsf-ibm.jar
      • jsf-impl.jar
      • odc-jsf.jar
    2. WebContent/WEB-INF/faces-config.xml ファイルを見つけて開く。 以下のエレメントが まだこの構成ファイルにない場合、追加します。
      	<lifecycle>
      		<phase-listener>com.ibm.faces.webapp.ValueResourcePhaseListener</phase-listener>
      	</lifecycle>
      	
      	<application>
      		<variable-resolver>com.ibm.faces.databind.SelectItemsVarResolver</variable-resolver>
      		<property-resolver>com.ibm.faces.databind.SelectItemsPropResolver</property-resolver>
      	</application>
    3. 削除した JAR ファイルについて、JSF601 プロジェクトの WebContent/WEB-INF/lib ディレクトリーから同じ名前の JAR ファイルをコ ピーし、同じ場所のオリジナル・プロジェクトに貼り付ける。構成によっては、これらすべての JAR ファ イルがプロジェクトに含まれている必要はありません。したがって、オリジ ナル・プロジェクトになかった特定の JAR ファイルはコピーしないでください。
    4. オリジナル・プロジェクトの web.xml デプロイメント記述子を開き、 構成に以下を追加する。
      	<context-param>
      		<param-name>com.ibm.ws.jsf.JSP_UPDATE_CHECK</param-name>
      		<param-value>true</param-value>
      	</context-param>	<context-param>
      		<param-name>com.ibm.ws.jsf.LOAD_FACES_CONFIG_AT_STARTUP</param-name>
      		<param-value>true</param-value>
      	</context-param>
    5. オリジナル・プロジェクトでデータ・アクセスのために WebSphere Data Object (WDO) を使用していた場合は、以下の追加ステップを実行する。
      1. オリジナル・プロジェクトで、「ファイル」 > 「新規」 > 「Faces JSP ファイル」をクリック して、新しい一時 Faces JSP ファイルを作成する。
      2. パレットのデータ・ドロワーからリレーショナル・レコード・リスト・コンポーネントを ページにドラッグする。
      3. 任意の接続とデータ・ソースを選出して、「終了」をクリックする。 選択されるデータは重要ではありません。このプロセスによりこのプロジェクトで WDO の使用 を継続するために必要な構成が生成されます。
      4. 一時 JSP ファイルを削除する。
    6. EGL で作業をしている場合 は、 それぞれの EGL Web プロジェクトの名前を右クリックし、 「生成」をクリックする。その後、自動的にプロジェクトを ビルドしているのでない場合は、「プロジェクト」 > 「すべてビルド」をクリックします。
  7. JSF601 Web プロジェクトを削除する。

親トピック: WebSphere Studio V5.1、5.1.1、または 5.1.2 からのマイグレーション

関連タスク
Rational Web Developer V6.0 の Web プロ ジェクトに対する Faces ランタイム・リソースの更新
Web プロジェクトでの Faces Client ランタイム・リソースの更新