| Oracle® Fusion Middleware Oracle WebCenter Sitesでの開発 12c (12.2.1) E72540-01 |
|
 前 |
WebCenter SitesのURLアセンブラの使用の詳細は、次の項を参照してください。
URLアセンブラは、URL生成タグとともに、WebCenter SitesのURLの生成や、URLアセンブラが生成するURLの逆アセンブルに使用されます。
URLアセンブラは、URL管理のレガシー・メソッドです。バニティURLが現在のメソッドであることを確認します。詳細は、「WebページのバニティURLリンク」および『Oracle Fusion Middleware Oracle WebCenter Sitesの管理』を参照してください。
この項には次のトピックが含まれます:
WebCenter SitesのURL生成タグ(<satellite.link>、<satellite.blob>、<render.getpageurl>、<render.getbloburl>、<render.satelliteblob>、<rendergettemplateurl>)は、ページやBLOBなど、WebCenter Sitesのリソースへのリンクの構成に使用されます。タグの使用時に指定するタグ属性やネストされた引数タグなどのデータは、URL定義と呼ばれる抽象オブジェクトに変換されます。URL定義はURLアセンブラに渡されます。次に、URLアセンブラはその定義を、返される文字列URLに変換します。
2つのアセンブラはWebCenter Sitesとともにインストールされますが、URLの外観を直接制御するために独自のアセンブラを作成するというオプションがあります。作成するアセンブラを使用できるようにするには、まずWebCenter Sitesにアセンブラを登録しておく必要があります。
デフォルトとして構成されているアセンブラは、WebCenter SitesのすべてのURLの作成に使用されます。デフォルトのアセンブラは変更できます。個々のリンク・タグで、このデフォルトのアセンブラの使用をオーバーライドすることもできます。
アセンブラは、アセンブラの作成者が求めるいずれのフォームでもURLを作成できるため、アセンブルされたリンクが要求される場合は、アプリケーション・サーバーによってURLをパラメータにデコードできない場合があります。デコードを実行するには、アセンブラが文字列URLをその定義に逆アセンブルできる必要があります。したがって、アセンブラは可逆性であり、アセンブルしたどのURLも逆アセンブルできます。
URLがデフォルトのアセンブラ以外のアセンブラを使用して作成されている場合は、デフォルトのアセンブラはそのURLを逆アセンブルできません。その時点で、次の上位ランクのアセンブラがそのURLの逆アセンブルを試みます。定義の作成に成功した場合は、アセンブラ・エンジンがそのアセンブラを検出しており、定義がパラメータに変換されて処理されます。次の上位ランクのアセンブラがそのURLの逆アセンブルに失敗した場合は、3番目の上位ランクのアセンブラがコールされ、そのURLを逆アセンブルします。このプロセスは、URLが逆アセンブルに成功するまで続行します。このプロセスでは、アセンブラが、アセンブルしたURLを自己のものであると認識し、他のすべてのURLを外部のものであると認識できることが必要です。
アセンブラの作成、登録、ランク付けの詳細は、「アセンブラの作成」および「アセンブラの登録とランク付け」を参照してください。
URLアセンブラは、GETリクエストでのみ呼び出されます。これらはPOSTリクエストでは呼び出されません。たとえば、GETリクエストでページにアクセスする際、URLアセンブラが呼び出され、URLを逆アセンブルします。その後、WebCenter Sitesがそのページを開くために必要な適切なパラメータ(c、cid、pagenameなど)を定義に追加することで提供します(定義に存在しない場合)。ただし、method=postを使用したフォームなどのリクエストがPOSTされる場合は、URLアセンブラはURLの逆アセンブルには呼び出されません。したがって、WebCenter Sitesがページを開くために必要なパラメータは、postリクエスト自体の一部である必要があります。
これは、ページのテンプレートまたはエレメントに次のタグをエンコードすることで実行できます(サンプル値を、WebCenter SitesがページのURLに必要とするパラメータに置換)。
<satellite:form method="post" id="assetid"><render:gettemplateurlparameters list="args" ... /><!-- add all parameters that are normally part of a URL --><ics:listloop listname="args"><input type="hidden" name="<string:stream list="args" column="name"/>" value="<string:stream list="args" column="value"/>"/></ics:listloop>
WebCenter Sitesとともにインストールされる2つのアセンブラは、QueryアセンブラとQueryAsPathInfoアセンブラです。
この項には次のトピックが含まれます:
Queryアセンブラは、問合せ文字列でURLを作成します。これはデフォルトのアセンブラで、WebCenter Sitesに自動的に登録されています。したがって、(デフォルトのアセンブラの変更やリンク・タグにおけるデフォルトのオーバーライドなどを)変更するまで、QueryアセンブラはすべてのURLの生成に使用されます。
この項では、独自のアセンブラの作成と登録の方法について説明します。この項では、デフォルトのアセンブラの使用をオーバーライドするようにリンク・タグを変更する方法も説明します。
この項には次のトピックが含まれます:
WebCenter SitesのURLアセンブリ・モジュールを使用して、独自のアセンブラを作成できます。このオプションにより、URLの外観を直接制御できます。
アセンブラを作成するには::
URLの作成にアセンブラを使用できるようにするには、まずWebCenter Sitesに登録しておく必要があります。登録は、ショート・フォームに対応するアセンブラ・クラス名をプロパティ・ファイルに列記することで実行されます。登録には、アセンブラの使用順序を示すランキングも含まれます。
アセンブラを登録するには::
アセットに、name引数で渡されたテンプレートのバニティURLが含まれていると、タグはバニティURLを返すようになります。アセットにバニティURLが含まれていない場合、タグはSitesのURLを返します。<render:gettemplateurl>タグは、バニティURLリンクの生成に使用できます。これにより、リダイレクトされるURLは、常にバニティURL (存在する場合)を返すようになります。このような場合に既存のリンクにアクセスすると(たとえば、ブックマークから)、それ以降のすべてのURLはバニティURLになります。
特定のWebRootに対するバニティURLを作成するには、hostparamという追加のパラメータをrender: gettemplateurlに渡す必要があります。hostparamの値は、WebRootのhostname属性と一致する必要があります。これを使用すると、別のWebサイトや、同一Webサイト内のサブドメインへのリンクを生成できます。例:
<render:gettemplateurl outstr="pageURL" webrootname=<name of WebRoot used for retrieving URL> tname='<%=ics.GetVar("template")%>' args="c,cid" />
