Struts ポートレット・プロジェクトの作成

IBM® ポートレット API と JSR 168 ポートレット API のどちらに基づいて Struts ポートレット・リソースを作成するかに応じて、Struts ポートレット・プロジェクトを作成するのに適切なウィザードを選択する必要があります。

デフォルトの Struts 対応ポートレット、およびオプションとして Web ダイアグラム・ファイルが、 プロジェクトの作成プロセスで追加されます。このウィザードにより、Struts ポートレット構成ファイル、 および web.xml ファイル、portlet.xml ファイルに対する必要なアップデートが自動的に生成され、 すべての SPF タグ・ライブラリーと JAR ファイルが、要求されているディレクトリー構造内のプロジェクトに追加されます。

Struts ポートレット・プロジェクトを作成する手順は、次のとおりです。

  1. IBM API ポートレットを含むポートレット・プロジェクトを作成するには、メニュー・バーから「ファイル」 > 「新規」 > 「ポートレット・プロジェクト」の順に選択する。JSR 168 API ポートレットを含むポートレット・プロジェクトを作成するには、メニュー・バーから「ファイル」 > 「新規」 > 「ポートレット・プロジェクト (JSR 168)」を選択します。 該当のポートレット・プロジェクト・タイプ用のウィザードが開きます。
  2. 必要に応じて、次のフィールドに値を入力する。
    プロジェクト名
    新規ポートレット・プロジェクトの名前
    プロジェクト・ロケーション
    プロジェクトが作成されるファイル・システムのロケーション。 ファイル・システムのロケーションは、「ブラウズ」を使用して変更できます。
    WebSphere® Portal バージョン
    ポートレット・プロジェクトに適切な WebSphere Portal バージョンを選択します。 選択によって、ご使用の開発環境に適切なサーブレットおよび対応するターゲット・ サーバーが設定されます。
    ポートレットの作成
    プロジェクトで初期ポートレット定義を作成したくない場合は、このチェック・ボックスをクリアしてください。 通常、ポートレット WAR ファイルをプロジェクトにインポートする場合は、ポートレットを作成する必要はありません。
    プロジェクトの J2EE 設定値を設定するか、プロジェクトのターゲット・ランタイム・サーバーを指定するには、「拡張を表示>>」ボタンをクリックし、次の値を指定します。
    注: 上記の「WebSphere Portal バージョン」値を 選択すると、「サーブレット・バージョン」「ターゲット・サーバー」の 両方が適切な値に設定されます。これらの 2 つのフィールドを編集することは お勧めできません
    サーブレット・バージョン
    ポートレット・アプリケーションに組み込むサーブレット仕様と JSP 仕様のバージョンを指定します。 デフォルトのバージョン 2.3 には、サーブレット仕様レベル 2.3 および JSP 仕様レベル 1.2 が含まれます。 このデフォルト値は、WebSphere Portal 5.0 または 5.1 サーバーを対象にするポートレット・プロジェクトを作成する場合に使用してください。

    サーブレット・バージョンにより、ドロップダウン・リストに表示されるターゲット・サーバーの選択項目が決まることに注意してください。

    ターゲット・サーバー
    ポートレット・アプリケーションがインストールされる先の WebSphere Portal のバージョンを選択します (WebSphere Portal v5.0 または v5.1)
    注: 誤って WebSphere Application Server オプションのいずれかを選択しないようにしてください。
    EAR プロジェクトにモジュールを追加
    ポートレットをデプロイしない場合のみ、このチェック・ボックスの選択を解除してください。このチェック・ボックスを選択したままにすることをお勧めします。そうしないと、ポートレットをデプロイできません。
    EAR プロジェクト
    デプロイメント目的のために、ポートレット・プロジェクトと関連付ける必要があるエンタープライズ・アプリケーション・プロジェクト (EAR プロジェクト) の名前。 テスト環境で WebSphere Portal へポートレット・プロジェクトをデプロイするのに使用される情報は、このプロジェクトで追加されます。 単一 EAR プロジェクトと関連付けられたポートレット・アプリケーションはすべて、テスト環境では単一セッションで実行されます。 ポートレット・アプリケーションを複数の EAR プロジェクトに分割することができます。関連のあるその他のプロジェクトには、同じ EAR プロジェクトを使用する必要があります。
    コンテキスト・ルート
    ポートレット・プロジェクトのコンテキスト・ルート。 テスト環境でポートレット・プロジェクトが WebSphere Portal にデプロイされる場合に、ポートレット・アプリケーションのトップレベル・ディレクトリーとして使用されます。 これは、他のプロジェクトが使用するコンテキスト・ルートと同じであってはなりません。
    注釈付き Java™ クラスのサポートの追加
    モデル注釈を使用してプロジェクトのコードを生成する予定である場合は、このチェック・ボックスが選択されていることを確認してください。
  3. 「次へ」をクリックする。
  4. 「Struts ポートレット」ラジオ・ボタンをクリックする。Struts 対応ポートレット・プロジェクトに関連したデフォルトをそのまま使用する場合は、 「完了」をクリックします。 プロジェクト・オプションをカスタマイズする場合は、「次へ」をクリックします。
  5. デフォルトでは、「Web プロジェクト・フィーチャー」リストの中から、 「Web ダイアグラム」が選択されています。 これは、プロジェクトの Web ダイアグラム (.gph) ファイルを作成します。 Web ダイアグラム・ファイルを使用すると、Struts ベースのアプリケーションまたは Faces アプリケーションのアプリケーション・フローを視覚的に設計できます。Web ページ、アクション、接続、 およびその他のアプリケーション・エレメントを追加してアプリケーションを設計すると、 要素を実現 し、Web ダイアグラムによってモデル化されたファイルを生成することができます。
  6. JSP 標準タグ・ライブラリー・タグを使用するポートレット・プロジェクトを作成するには、「Web プロジェクト・フィーチャー」リストの中から「JSP 標準タグ・ライブラリー」を選択する。 WebSphere Portal が JSP 標準タグ・ライブラリー (JSTL) のタグの使用をサポートする方法について詳しくは、WebSphere Portal Information Center"ポータル JSP での JSTL タグの使用" を参照してください。
  7. 「次へ」をクリックする。
  8. 「ポートレットの設定」ページで適切な一般設定を入力する。「次へ」をクリックする。
  9. 「Struts ポートレットの設定」ページで Struts ポートレット固有の設定を更新する。 デフォルトでは、ウィザードによりリソース・バンドルが作成されます。Java パッケージ名のデフォルトは、 指定したプロジェクト名を使用して作成されます。
  10. 「次へ」をクリックする。
  11. 「各種」ページで、 プロジェクトでポートレットに対して使用可能にしたい追加のマークアップとモードを指定する。
    1. Struts ポートレットは、常時 html マークアップをサポートしています。Compact HTML (chtml) または WML 1.3 (wml) マークアップ・サポートをプロジェクトに追加することができます。これらのマークアップは、 現在、Rational® Developer でサポートされていません
    2. ポートレットに対して使用可能にしたい追加のモードについて、適切なチェック・ボックスを選択する。「表示」モードは、 常にデフォルトで指定されています。
  12. 「完了」をクリックする。 web.xml および portlet.xml 内に Struts ポートレット定義がある新規ポートレット・プロジェクトが作成されます。
関連概念
Struts ポートレット・アプリケーション
Struts ポートレットとプロジェクトの作成
Struts ベースの Web アプリケーション - 概要
アプリケーション開発用の Struts ツール
Web ダイアグラムと Web ダイアグラム・エディター
関連タスク
Struts ポートレットの作成
Struts ポートレット JSP ファイルの作成
Struts を使用した適切な設計の Web アプリケーションの作成
新規アプリケーション用の Web ダイアグラムの作成
関連資料
Struts 1.1 タグ・ライブラリー・クラスと SPF タグ・ライブラリー・クラスの相違点

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