shins****@users*****
shins****@users*****
2006年 2月 3日 (金) 21:57:44 JST
Update of /cvsroot/jetspeed-japan/jetspeed-2-trans/ja/xdocs/guides In directory sf-cvs:/tmp/cvs-serv27768/ja/xdocs/guides Modified Files: guide-profiler.xml Log Message: submitted by KATOH Yasufumi jetspeed-2-trans/ja/xdocs/guides/guide-profiler.xml 1.1.1.1 -> 1.2 (modified) http://cvs.sourceforge.jp/cgi-bin/viewcvs.cgi/jetspeed-japan/jetspeed-2-trans/ja/xdocs/guides/guide-profiler.xml.diff?r1=1.1.1.1&r2=1.2 =================================================================== RCS file: jetspeed-2-trans/ja/xdocs/guides/guide-profiler.xml,v retrieving revision 1.1.1.1 retrieving revision 1.2 diff -u -r1.1.1.1 -r1.2 --- guide-profiler.xml 2005/12/16 03:43:36 1.1.1.1 +++ guide-profiler.xml 2006/02/03 12:57:44 1.2 @@ -1,196 +1,329 @@ -<?xml version="1.0"?> -<!-- -Copyright 2004 The Apache Software Foundation - -Licensed under the Apache License, Version 2.0 (the "License"); -you may not use this file except in compliance with the License. -You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - -Unless required by applicable law or agreed to in writing, software -distributed under the License is distributed on an "AS IS" BASIS, -WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -See the License for the specific language governing permissions and -limitations under the License. ---> -<document> - <properties> - <title>Profiler</title> - <subtitle>Documentation for Jetspeed-2 Profiler</subtitle> - <authors> - <person name="David Sean Taylor" email="taylo****@apach*****"/> - </authors> - </properties> - <body> -<section name="Profiler Overview"> -<p> -The Jetspeed Profiler is a portal resource location rule-based engine. -As of Jetspeed version 2.0, the profiler locates the following kinds of portal resources: -<ul> - <li>PSML pages</li> - <li>Folders</li> - <li>Menus</li> -</ul> -When a request is received by the portal, the profiler will map the request to a resource -based on a normalized set of runtime parameters and state such as request parameters, HTTP headers, -and session attributes. The Profiler is invoked during the Jetspeed request processing pipeline in -the profiler valve. This valve requires that the request context is already populated with -the portal request and response, capabilities, language and user information. -The runtime parameters make up the profile criterion which the profiler uses to locate -portal resources. -</p> -<p> -The profiler works hand in hand with the Site and Page Manager components. -The profiler takes runtime information as input, generalized that information -into -</p> -</section> -<section name="Profiling Rules"> -<p> - -A ProfilingRule defines a list of criteria used when evaluating a request -to determine the location of a specific resource. Profiling rules are -used by the profiler to generically locate portal resources -based on the decoupled criteria for known portlet request data. -A rule consists of an ordered list of criteria which should be applied -in a given order. Following this rule's order, the profiling engine applies -each criteria of the rulusing a less-specific algorithm until the least -specific resource criterion is considered. When all criteria are exhausted, -the rule will fail and a fallback resource will be required. -</p> -<subsection name='Rule Criterion'> -<p> -RuleCriteria are templates for locating profile properties. -The default implementation has a profiling policy defined in this proposal based on resource-specific URLs, Mime-Types and language preferences. More complex implementations will need to use other inputs in mapping to resources such as Cookies, IP Address Ranges, Statistical Resource Usage Analysis, Business Rules inside of servlets or EJBs,... - -</p> -</subsection> -<subsection name='Rule Criterion Resolvers'> -<p> - -<table> - <tr> - <th>Resolver</th> - <th>Description</th> - <th>Example</th> - </tr> - <tr> - <td>request</td> - <td>resolve by matching to a request parameter name</td> - <td></td> - </tr> - <tr> - <td>session</td> - <td>resolve by matching to a session attribute name</td> - <td></td> - </tr> - <tr> - <td>request.session</td> - <td>resolve by matching to a request attribute name first, then matching to a session attribute name</td> - <td></td> - </tr> - <tr> - <td>hard.coded</td> - <td>resolve with a hard.coded value</td> - <td></td> - </tr> - <tr> - <td>group.role.user</td> - <td>fallback controller: search for resource under folders of the current users group, then role, then users own folder</td> - <td></td> - </tr> - <tr> - <td>user</td> - <td>match resources in the current user directory</td> - <td></td> - </tr> - <tr> - <td>group</td> - <td></td> - <td></td> - </tr> - <tr> - <td>role</td> - <td></td> - <td></td> - </tr> - <tr> - <td>mediatype</td> - <td>match media type in the request context</td> - <td></td> - </tr> - <tr> - <td>country</td> - <td></td> - <td></td> - </tr> - <tr> - <td>user.agent</td> - <td></td> - <td></td> - </tr> - <tr> - <td>language</td> - <td></td> - <td></td> - </tr> - <tr> - <td>roles</td> - <td>Role Fallback</td> - <td></td> - </tr> - <tr> - <td>path</td> - <td></td> - <td></td> - </tr> - <tr> - <td>page</td> - <td></td> - <td></td> - </tr> - <tr> - <td>path.session</td> - <td></td> - <td></td> - </tr> - <tr> - <td>user.attribute</td> - <td></td> - <td></td> - </tr> - <tr> - <td>navigation</td> - <td>change the current navigation path</td> - <td></td> - </tr> - -</table> - -</p> -</subsection> -<subsection name='Principal Rules'> -</subsection> -</section> -<section name="Profile Locators"> -<p> -Profile Locators are used to locate profiled portal resources such as -pages, documents, and fragments. A locator contains properties describing -the actually resource to be located. Since the locator is based on properties -that are usually related to a user or other subject's profile, it is referred -to as a profile locator. -</p> -<subsection name='Profile Locator Paths'> -<p> -</p> -</subsection> -</section> -<section name="Component Configuration"> -<p> -</p> -</section> - -</body> -</document> - +<?xml version="1.0"?> +<!-- +Copyright 2004 The Apache Software Foundation + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +--> +<document> + <properties> + <title>[Profiler] プロファイラ</title> + <subtitle>[Documentation for Jetspeed-2 Profiler] Jetspeed 2 のプロファイラに関する文書</subtitle> + <authors> + <person name="David Sean Taylor" email="taylo****@apach*****"/> + </authors> + <translators> + <person name="加藤泰文" email="karma****@prog*****" /> + </translators> + </properties> + <body> +<section name="[Profiler Overview] プロファイラの概要"> +<div class="original"> +<p> +The Jetspeed Profiler is a portal resource location rule-based engine. +As of Jetspeed version 2.0, the profiler locates the following kinds of portal resources: +<ul> + <li>PSML pages</li> + <li>Folders</li> + <li>Menus</li> +</ul> +When a request is received by the portal, the profiler will map the request to a resource +based on a normalized set of runtime parameters and state such as request parameters, HTTP headers, +and session attributes. The Profiler is invoked during the Jetspeed request processing pipeline in +the profiler valve. This valve requires that the request context is already populated with +the portal request and response, capabilities, language and user information. +The runtime parameters make up the profile criterion which the profiler uses to locate +portal resources. +</p> +</div> +<p> +Jetspeed のプロファイラは、ポータルのリソースの場所に関するルールベースのエンジンです。Jetspeed のバージョン 2.0 では、プロファイラは以下のような種類のポータルリソースの場所を決定します。 +<ul> + <li>PSML ページ</li> + <li>フォルダ</li> + <li>メニュー</li> +</ul> +リクエストがポータルで受信されたとき、プロファイラはリクエストを正規化された実行時パラメータやリクエストパラメータ、HTTP ヘッダ、セッションの属性のような、状態に基づいたリソースと結びつけます。プロファイラはプロファイラバルブ内の Jetspeed のリクエスト処理パイプラインの中で呼び出されます。このバルブはリクエストコンテキストが、ポータルのリクエストやレスポンス、機能、言語、ユーザ情報と関連づけられている必要があります。実行時のパラメータは、プロファイラがポータルのリソースを位置を決定するのに使われる判断規準を作ります。 +</p> +<div class="original"> +<p> +The profiler works hand in hand with the Site and Page Manager components. +The profiler takes runtime information as input, generalized that information +into +</p> +</div> +<p> +プロファイラはサイトマネージャとページマネージャコンポーネントと協調して動作します。プロファイラは実行時情報を入力として受け取り、その情報を一般化します。 +</p> +</section> +<section name="Profiling Rules"> +<div class="original"> +<p> + +A ProfilingRule defines a list of criteria used when evaluating a request +to determine the location of a specific resource. Profiling rules are +used by the profiler to generically locate portal resources +based on the decoupled criteria for known portlet request data. +A rule consists of an ordered list of criteria which should be applied +in a given order. Following this rule's order, the profiling engine applies +each criteria of the rulusing a less-specific algorithm until the least +specific resource criterion is considered. When all criteria are exhausted, +the rule will fail and a fallback resource will be required. +</p> +</div> +<p> +プロファイリングルールは、特定のリソースの場所を解決するリクエストを評価するときに使われる判断規準のリストを定義します。プロファイリングルールはプロファイラが使用します。これは、既知のポートレットリクエストデータ用の、細分化した判断規準によるポータルリソースの位置を決定するためです。ルールは与えられた順序に適用される判断規準の順序つきのリストから構成されます。このルールの順序に従って、プロファイリングエンジンは最も細かい特定が可能なリソースの判断規準とみなせるまで、少ない記述の設定によるアルゴリズムでそれぞれの条件を適用します。全ての条件が適用されつくした場合、ルールは失敗となりフォールバックリソースが要求されます。 +</p> +<subsection name='[Rule Criterion] ルール規準'> +<div class="original"> +<p> +RuleCriteria are templates for locating profile properties. +The default implementation has a profiling policy defined in this proposal based on resource-specific URLs, Mime-Types and language preferences. More complex implementations will need to use other inputs in mapping to resources such as Cookies, IP Address Ranges, Statistical Resource Usage Analysis, Business Rules inside of servlets or EJBs,... +</p> +</div> +<p> +RuleCriteria はプロファイルのプロパティの場所を示すためのテンプレートです。デフォルトの実装では、リソースを特定する URL、Mimeタイプ、言語のプリファレンスに基づいた提案で定義されたプロファイリングポリシを持っています。もっと複雑な実装を行うには、Cookie や IP アドレスの範囲や統計的なリソースの利用解析やサーブレットや EJB 内部のビジネスのルールのような、リソースとマッピングされる他の入力が必要となるでしょう。 +</p> +</subsection> +<subsection name='[Rule Criterion Resolvers] ルール規準のリゾルバ'> +<p> + +<div class="original"> +<table> + <tr> + <th>Resolver</th> + <th>Description</th> + <th>Example</th> + </tr> + <tr> + <td>request</td> + <td>resolve by matching to a request parameter name</td> + <td></td> + </tr> + <tr> + <td>session</td> + <td>resolve by matching to a session attribute name</td> + <td></td> + </tr> + <tr> + <td>request.session</td> + <td>resolve by matching to a request attribute name first, then matching to a session attribute name</td> + <td></td> + </tr> + <tr> + <td>hard.coded</td> + <td>resolve with a hard.coded value</td> + <td></td> + </tr> + <tr> + <td>group.role.user</td> + <td>fallback controller: search for resource under folders of the current users group, then role, then users own folder</td> + <td></td> + </tr> + <tr> + <td>user</td> + <td>match resources in the current user directory</td> + <td></td> + </tr> + <tr> + <td>group</td> + <td></td> + <td></td> + </tr> + <tr> + <td>role</td> + <td></td> + <td></td> + </tr> + <tr> + <td>mediatype</td> + <td>match media type in the request context</td> + <td></td> + </tr> + <tr> + <td>country</td> + <td></td> + <td></td> + </tr> + <tr> + <td>user.agent</td> + <td></td> + <td></td> + </tr> + <tr> + <td>language</td> + <td></td> + <td></td> + </tr> + <tr> + <td>roles</td> + <td>Role Fallback</td> + <td></td> + </tr> + <tr> + <td>path</td> + <td></td> + <td></td> + </tr> + <tr> + <td>page</td> + <td></td> + <td></td> + </tr> + <tr> + <td>path.session</td> + <td></td> + <td></td> + </tr> + <tr> + <td>user.attribute</td> + <td></td> + <td></td> + </tr> + <tr> + <td>navigation</td> + <td>change the current navigation path</td> + <td></td> + </tr> + +</table> +</div> +<table> + <tr> + <th>リゾルバ</th> + <th>説明</th> + <th>例</th> + </tr> + <tr> + <td>request</td> + <td>リクエストパラメータ名とのマッチングによる解決</td> + <td></td> + </tr> + <tr> + <td>session</td> + <td>セッションの属性名とのマッチングによる解決</td> + <td></td> + </tr> + <tr> + <td>request.session</td> + <td>最初にリクエストの属性名とのマッチングを行ってから、セッションの属性名とのマッチングを行って解決する</td> + <td></td> + </tr> + <tr> + <td>hard.coded</td> + <td>ハードコードされた値による解決</td> + <td></td> + </tr> + <tr> + <td>group.role.user</td> + <td>フォールバックコントローラ: 現在のユーザグループ、次にロール、次にユーザの所有するフォルダ以下のリソースを探す</td> + <td></td> + </tr> + <tr> + <td>user</td> + <td>現在のユーザのディレクトリ内のリソースとマッチさせる</td> + <td></td> + </tr> + <tr> + <td>group</td> + <td></td> + <td></td> + </tr> + <tr> + <td>role</td> + <td></td> + <td></td> + </tr> + <tr> + <td>mediatype</td> + <td>リクエストコンテキスト内のメディアタイプとマッチさせる</td> + <td></td> + </tr> + <tr> + <td>country</td> + <td></td> + <td></td> + </tr> + <tr> + <td>user.agent</td> + <td></td> + <td></td> + </tr> + <tr> + <td>language</td> + <td></td> + <td></td> + </tr> + <tr> + <td>roles</td> + <td>ロールのフォールバック</td> + <td></td> + </tr> + <tr> + <td>path</td> + <td></td> + <td></td> + </tr> + <tr> + <td>page</td> + <td></td> + <td></td> + </tr> + <tr> + <td>path.session</td> + <td></td> + <td></td> + </tr> + <tr> + <td>user.attribute</td> + <td></td> + <td></td> + </tr> + <tr> + <td>navigation</td> + <td>現在のナビゲーションパスを変える</td> + <td></td> + </tr> + +</table> + +</p> +</subsection> +<subsection name='[Principal Rules] プリンシパルルール'> +</subsection> +</section> +<section name="[Profile Locators] プロファイルロケータ"> +<div class="original"> +<p> +Profile Locators are used to locate profiled portal resources such as +pages, documents, and fragments. A locator contains properties describing +the actually resource to be located. Since the locator is based on properties +that are usually related to a user or other subject's profile, it is referred +to as a profile locator. +</p> +</div> +<p> +プロファイルロケータはポータルリソースの位置を決めるのに使われます。ポータルリソースとはページやドキュメントやフラグメントのようなものの事です．ロケータには位置が決められた実際のリソースについて記述されたプロパティが含まれます。ロケータは普通はユーザや他の対象のプロファイルに関係するプロパティに基づいているので、プロファイルロケータとして参照されます。 +</p> +<subsection name='[Profile Locator Paths] プロファイルロケータパス'> +<p> +</p> +</subsection> +</section> +<section name="[Component Configuration] コンポーネントの設定"> +<p> +</p> +</section> + +</body> +</document> +
