uCosminexus Portal Framework ポートレット開発ガイド
Strutsフレームワークを使用しStrutsアプリケーションを開発する場合にはポートレットに対応した開発を行う必要があります。ポートレットに対応させるためには通常のStrutsアプリケーションの開発に加えて以下の対応が必要です。
- <この項の構成>
- (1) ウィンドウ状態について
- (2) 拡張Strutsタグライブラリの使用
- (3) ポートレットとして動作するための制限事項
- (4) リクエストのフォワード
- (5) ライブラリファイル
ポートレットはポータル画面に複数のポートレットを配置するため,ウィンドウ状態に応じて画面のサイズが変わります。このため,ウィンドウ状態により画面レイアウトが崩れることがありますのでウィンドウ状態に合わせた画面設計が必要です。
- NORMALステートの場合
ポータル画面の一部として表示されるため,文字サイズやテーブルサイズが大きすぎてレイアウトが崩れないように設計してください。
- MAXIMIZEDステートの場合
ポータル画面全体に表示されるため,文字サイズやテーブルサイズが小さすぎてウィンドウの大きさに対してコンテンツが小さくなりすぎないように設計してください。
Strutsアプリケーションをポートレットとして動作させるため,拡張Strutsタグライブラリを提供しています。拡張Strutsタグライブラリを使用することでアプリケーション実行にウィンドウ状態やポートレットモードの制御を行うことができるようになります。拡張Strutsタグライブラリの詳細については「14.21 拡張Strutsタグライブラリ」を参照してください。
ポートレットとして動作するため,Strutsアプリケーションからリダイレクトの処理を行うことはできません。
uCosminexus Portal Frameworkでは以下のリクエストパラメタを予約しています。このリクエストパラメタを使用することはできません。
- リクエストパラメタ
- _spage
- _sorig
- _kra
- リクエストパラメタ(接頭部)
- hptl.
- java.
- javax.
uCosminexus Portal Frameworkでは以下のリクエスト属性予約しています。このリクエスト属性を使用することはできません。
- リクエスト属性(接頭部)
- org.apache.portlet.bridges.struts.
- jp.co.hitachi.soft.portal.
サーブレットAPIから取得できる情報が以下の通り制限されます。
- HttpServletRequestクラス
- getPathTranslated()メソッド
nullが返却されます。
- getRealPath()メソッド
nullが返却されます。
- getParameter()メソッド
レンダーパラメタが取得できます。レンダーパラメタはアクションモードで標準APIポートレットを呼び出した時のリクエストパラメタが設定されます。
getParameterNames()メソッド,getParameterValues()メソッド,getParameterMap()メソッドについても同様にレンダーパラメタが取得できます。
- HttpServletResponseクラス
- EncodeRedirectUrl()メソッド
引数に指定した値が返却されます。
(e) ポータル画面からのポートレットモードおよびウィンドウステートの変更
ポータル画面からポートレットモードおよびウィンドウステートが変更される場合があります。この場合は,レンダーモードとして実行されるため,レンダーパラメタの引継ぎは行われません。
リクエストをフォワードしてもポータル画面全体の描画を変更することはできません。ポートレット内容表示領域の描画変更となります。
Strutsアプリケーションを標準APIポートレットとして動作させるためのライブラリおよびTLDファイルは,標準APIポートレットのデプロイ時にアーカイブ内にコピーされます。コピーされるファイルは,以下のディレクトリに格納されています。
{uCosminexus Portal Frameworkインストールディレクトリ}\container\
All Rights Reserved. Copyright (C) 2009, 2013, Hitachi, Ltd.
All Rights Reserved. Copyright (C) 2009, 2013, Hitachi INS Software, Ltd.