JES: Portal Server を使ってみよう (6): ポートレットチャネルを作ろう
SDC に次のようなドキュメントがポストされています。
Sun Java System Portal Server 6 2005Q1 での JavaServer Faces テクノロジに基づくポートレットの 実行
今回はこのドキュメントを参考にしながら JSR 168 に準拠したポートレットを Sun Java System Portal Server に配備してチャネルを作ってみましょう。手順としては、
- pdeploy コマンドでポートレットの WAR ファイルを配備
- 配備されたポートレットをもとにポートレットチャネルを作成する
- 表示するコンテナに追加する
サンプルアプリケーション
サンプルアプリケーションの javaserverfaces_portlet.class をダウンロードし次のコマンドでインストールすると jsf-portlet/samples ディレクトリの下に portlet-guessNumber.war が作成されます。この war ファイルを配備し、チャネルを作ります。(私は今回はこのファイルをまったく編集していません)
% java -cp . javaserverfaces_portlet
pdeploy コマンドで WAR ファイルを配備
war ファイルを配備するには pdeploy コマンドを使用します。dpadmin の引数に似ていますね。管理者 DN とパスワード、-p では Web コンテナ(この場合は Sun Java System Web Server) の管理者パスワードです。
実際に実行してみましょう。先ほどの war ファイルを指定します。
# /opt/SUNWps/bin/pdeploy deploy -u "uid=amAdmin,ou=People,dc=xyz,dc=com" \
-w passwd -p passwd -g \
/tmp/jsf-portlet/samples/portlet-guessNumber.war
Done Updating Display Profile! Deploying War File to Web Container...
[wdeploy] The war file name is /var/opt/SUNWps/tmp/portlet/portlet-guessNumber.war
[wdeploy] The directory /var/opt/SUNWps/tmp/deploy/web-apps/https-test.japan.sun.com/portlet-guessNumber doesn't exist. Creating it.
[wdeploy] Deploying web application
[wdeploy] Loading new configuration
[wdeploy] Web application deploy successful
SUCCESS.
#
無事に配備されたようですね。次の二つを確認しましょう。
- Web コンテナの管理コンソールを開いてその Web アプリケーションが配備されたかどうか確認する
- Access Manager の管理コンソールからチャネルを作成する時にポートレットとして認識されているか確認する
ポートレットチャネルを作成する
チャネルの作成方法は URL スクレーパーチャネル、XML チャネルの場合とまったく同じです。Access Manager の管理コンソールからポータルデスクトップのサービスを選択し、「新規ポートレットチャネル」を選択します。
「ポートレット」とあるプルダウンリストをチェックしましょう。配備が正しければここに配備されたポートレットが表示されるはずです。
portlet-guessNumber.guessNumber がありましたね、これを選択します。
配備したポートレットがメニューに表示されない場合:
この guessNumber ポートレットはそのまま配備できましたが、別のポートレットでここのメニューで配備したポートレットが表示されない場合は portlet.xml を確認してみて下さい。 フォーラム にもあるように portlet-app タグを変更すると表示されるようになることがあります。
チャネルが作成したら MyFrontPageTabPanelContainer コンテナに追加してユーザーから使えるようにします。
表示してみた
実際に表示してみました。無事 GuessNumber ポートレットが表示されています。
pdeploy の詳細については Sun Java System Portal Server 6 2004Q2 管理ガイド の pdeploy を参照して下さい。
