3.8.2 URL変換
日立APIポートレット内で,ポートレットユティリティタグライブラリおよびポートレットユティリティクラスライブラリを使用した相対パス形式のURLは,ドキュメントベースを基とした絶対URL形式,または{PROJECT_HOME}を基点とした絶対パス形式に変換されます。これをURL変換と呼びます。ポートレットユティリティタグライブラリを使用すると,相対パス形式のURLが自動変換されます。ポートレットユティリティクラスライブラリを使用すると,任意のURL変換種別を選択できます。ポートレットユティリティタグライブラリの詳細は,「14.2 ポートレットユティリティタグライブラリ」を,ポートレットユティリティクラスライブラリの詳細は,「14.4 ポートレットユティリティクラスライブラリ」を参照してください。
URL変換は,部分識別子("#fragment"),クエリ("?query")に対応します。";"パラメタには対応していません。また,URL属性値が絶対URL形式,または絶対パス形式である場合はURL変換されません。相対パス形式のURLだけがURL変換されます。絶対URL形式,絶対パス形式,および相対パス形式の例を次に示します。
- 絶対URL形式:http://server/portal/sample/index.jsp
- 絶対パス形式:/portlets/sample/index.jsp
- 相対パス形式:index.jsp
なお,SSLアクセラレーターまたはリバースプロキシを使用した環境でuCosminexus Portal Frameworkを使用する場合には,URL変換規則を切り替える必要があります。詳細は,マニュアル「uCosminexus Portal Framework システム管理者ガイド」の「SSLアクセラレーターまたはリバースプロキシ使用時の設定」の説明を参照してください。
- <この項の構成>
- (1) URL変換種別
(1) URL変換種別
URL変換には,次の図に示す変換種別があります。
図3-6 URL変換種別
![[図データ]](figure/zu030500.gif)
- ポートレットURL変換
- ポートレットURL変換は,ポートレットユティリティタグライブラリおよびポートレットユティリティクラスライブラリを使用した相対パス形式のURLから,日立APIポートレットをポータルの統合画面内で遷移させるためのURLに変換することです。ポータル画面でViewを統合するための統合アダプタを経由します。必要に応じてHttpServletResponse#encodeURLを呼び出して,URLRewritingをします。
- ポータルURL変換
- ポータルURL変換は,ポートレットユティリティタグライブラリおよびポートレットユティリティクラスライブラリを使用した相対パス形式のURLから,uCosminexus Portal Frameworkを経由してコンテンツを取得するためのURLに変換することです。uCosminexus Portal Frameworkを経由するので,uCosminexus Portal FrameworkのAPIを使用できます。また,ポートレットのアクセス制御も適用されます。ただし,統合アダプタを経由しないため,ポータルの統合画面内で遷移できません。
- ドキュメントベースURL変換
- ドキュメントベースURL変換は,ポートレットユティリティタグライブラリおよびポートレットユティリティクラスライブラリを使用した相対パス形式のURLから,uCosminexus Portal Frameworkを経由しないでコンテンツを外部Webサーバから直接取得するためのURLに変換することです。URLRewritingはしません。また,uCosminexus Portal FrameworkのAPIを使用できません。