PSMLロケータは、PSML参照を置くのに使われます。
PSMLのreference要素の中のpath属性では、
別のPSMLリソースへのロケータを規定します。
ロケータは、
PSMLリソースの全てを別のPSMLリソースに取り込むために使います。
一旦マークアップのグループを定義し、１つ以上のPSMLリソースでマークアップを共有する場合に、これは有効です。
ここで、Portlet参照のサンプルをお見せします。
ロケータは、path属性で定義されています：
 |
|
|
|
<portlets user="default" xmlns="http://xml.apache.org/jetspeed/2000/psml">
...
<portlets>
<controller name="org.apache.jetspeed.portal.controllers.RowColumnPortletController"/>
<reference id="P-ed09142736-10018" path="group/apache/page/news"/>
</portlets>
...
|
|
|
|
|
ロケータは常にパラメタの対で定義されます。
URLの一部として使う事もできます。
上のサンプルでは、キーワードと値の２つの対があります。
キーワードは"group"と"page"であり、値は"apache"と"news"です。
"apache"は、Jetspeed内でのグループ名です。
グループ（グループ化）はPSMLリソースを分類する一つのやり方です。
"page"はPSMLリソースの名前です。".psml"拡張子は必要ありません。
ロケータの形式は：
|
|
|
|
user/<name>/media-type/<mediaType>/language/<language>/country/<country>/page/<page>
あるいは
group/<name>/media-type/<mediaType>/language/<language>/country/<country>/page/<page>
あるいは
role/<name>/media-type/<mediaType>/language/<language>/country/<country>/page/<page>
|
|
|
|
|
キーワードが"group"で、"group"と"role"が相互に排他的で、全ての他のパラメタがオプションである場合です。
"page"パラメタが指定されていない場合、JetspeedResources.propertiesで規定されている
"default"のPSMLページが配置されます。
他のパラメタ全ては、もし指定されない場合、
media-type・language・countryコードは、リクエストされたデバイス（つまりブラウザ）の
状態に合わせられます。
いかなるリソースも指定できますが（別のユーザのPSMLをロケータとして使ったり）、
Jespeedは、PSMLリソースに取り込むための十分な権限があるかどうかのセキュリティチェックを行います。
|
キーワード
|
説明
|
|
user
|
パラメタ値与えられるユーザの'user'サブツリー下に置かれるリソースを明記します。'user'・'group'・'role'のいずれも指定されない場合、現在のユーザのサブツリーがデフォルト値となります。
|
|
group
|
パラメタ値で与えられるグループの'group'サブツリー下に置かれるリソースを明記します。
|
|
role
|
パラメタ値で与えられるロールの'role'サブツリー下に置かれるリソースを明記します。
|
|
media-type
|
パラメタ値で与えられるメディアタイプのリソースを明記します。代表的なメディアタイプは、"html"・"wml"・"xml"です。
|
|
language
|
パラメタ値で与えられる言語のリソースを明記します。言語は、ISO-639標準の２文字略語（訳注：例えば、jaやzhなど）で指定されなければなりません。
言語コードは、ISO-639標準の２文字略語です。
|
|
country
|
パラメタ値で与えられる国名のリソースを明記します。
言語は、ISO-639標準の２文字略語（訳注：例えば、jaやzhなど）で指定されなければなりません。
国コードは、ISO-3166標準の２文字略語（訳注：例えば、jpやcnなど）です。
|
|
page
|
リソースの名前をパラメタ値で明記します。指定されない場合、デフォルトのリソースが使われます。
|
