ポートレット・プロジェクトでの 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, 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005.