ポートレット・プロジェクトでの Faces リソースのマイグレーション

元々 WebSphere® Studio Site Developer V5.1.2 で出荷された JavaServer Faces サポートは、 Rational® Web Developer V6.0 で更新されました。 WebSphere Studio Site Developer V5.1.2 の Portal Toolkit 5.0.2.2 で作成したポートレット・プロジェクトを V6.0 で継続して開発したい場合は、 Faces プロジェクトのランタイム・リソースを最新レベルにアップグレードすることをお勧めします。

注: Faces Client コンポーネントが含まれた JavaServer Page (JSP) を 作成した場合は、別に Faces Client コンポーネント・ランタイム・リソースを 最新レベルにマイグレーションする必要があります。「Faces Client コンポーネントを持つ JavaServer Faces リソースのマイグレーション」 を参照してください。
WebSphere Studio Site Developer V5.1.2 の Portal Toolkit 5.0.2.2 からマイグレーションされたポートレット・プロジェクトで JSP を作成または編集すると、ポートレット・プロジェクトのランタイム・リソースを 最新レベルにマイグレーションするよう求めるプロンプトが表示されます。マイグレーションを完了するには、「OK」 をクリックしてください。
注: 初期マイグレーション・プロンプトが表示されたときに 「いいえ」を選択して、意図的に JAR ファイルをバックレベルに留めた場合、 プロンプトは再び表示されません。後で必要になった場合は、以下の手順で、 ポートレット・プロジェクト・リソースを手動でマイグレーションする必要があります。
  1. Faces コンテンツを持つ既存のポートレット・プロジェクトを Rational Web Developer V6.0 ワークスペースにインポートする。
  2. 2 ページ目で「Faces ポートレット」オプションを選択して、 JSFP60 という名前の新規ポートレット・プロジェクトを作成する。このプロジェクトは、 最新ランタイム成果物のソースとしてのみ使用します。これはマイグレーションが完了した後に 削除することができます。
  3. プロジェクト・エクスプローラー」で 「JSFP60」というプロジェクトを右クリックし、メニューから 「プロパティー」を選択する。「Web プロジェクト・フィーチャー」 のタブに切り替えて、「ポートレット・プロジェクトの Faces クライアント・フレームワークの追加」 を選択します。
  4. アップグレードしたい既存の Faces プロジェクトごとに以下を実行する。
    1. プロジェクト・エクスプローラーでオリジナル・プロジェクトを展開して、 「WebContent/WEB-INF/lib/」フォルダーのファイルを表示する。このディレクトリーにある 以下の JAR ファイルをすべて見つけて削除します。
      • jsf-api.jar
      • jsf-ibm.jar
      • jsf-impl.jar
      • jsf-portlet.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>
      		<variable-resolver>com.ibm.faces.application.WPPortletVariableResolver</variable-resolver>
      		<property-resolver>com.ibm.faces.databind.SelectItemsPropResolver</property-resolver>
      	</application>
      注: ポートレット・プロジェクトが JSR 168 API を使用している場合は、 com.ibm.faces.application.WPPortletVariableResolver ではなく、 com.ibm.faces.application.PortletVariableResolver を指定してください。
  5. 削除した JAR ファイルについては、JSFP60 プロジェクトの WebContent/WEB-INF/lib ディレクトリーから同じ名前の JAR ファイルをコピーし、同じ場所のオリジナル・プロジェクトに貼り付ける。 構成によってはこれらすべての JAR ファイルがプロジェクトに存在している必要はありません。 オリジナル・プロジェクトに特定の JAR ファイルがない場合は、それをコピーしないでください。
    1. ポートレット・プロジェクトが IBM® ポートレット API または個人のリンク・コンポーネントを使用している場合は、 jsf-portlet-wp.jar ファイルをオリジナル・プロジェクトにコピーしてください。
    2. odc-jsf.jar ファイルをコピーする場合は、odc-jsf-portlet.jar ファイルもコピーしてください。
これらのステップを実行すると、古いポートレット・プロジェクトが Rational Web Developer V6.0 で最新レベルの Faces 機能に更新されます。

関連タスク
WebSphere Studio V5.1、5.1.1、または 5.1.2 からのマイグレーション
Faces Client コンポーネントを持つ JavaServer Faces リソースのマイグレーション

(C) Copyright IBM Corporation 2000, 2004. All Rights Reserved.