shins****@users*****
shins****@users*****
2006年 4月 30日 (日) 23:44:32 JST
Update of /cvsroot/jetspeed-japan/jetspeed-2-trans/ja/xdocs In directory sf-cvs:/tmp/cvs-serv20502/ja/xdocs Modified Files: j1-users.xml j2-maven-plugin.xml Log Message: translated jetspeed-2-trans/ja/xdocs/j1-users.xml 1.1.1.1 -> 1.2 (modified) http://cvs.sourceforge.jp/cgi-bin/viewcvs.cgi/jetspeed-japan/jetspeed-2-trans/ja/xdocs/j1-users.xml.diff?r1=1.1.1.1&r2=1.2 jetspeed-2-trans/ja/xdocs/j2-maven-plugin.xml 1.1.1.1 -> 1.2 (modified) http://cvs.sourceforge.jp/cgi-bin/viewcvs.cgi/jetspeed-japan/jetspeed-2-trans/ja/xdocs/j2-maven-plugin.xml.diff?r1=1.1.1.1&r2=1.2 =================================================================== RCS file: jetspeed-2-trans/ja/xdocs/j1-users.xml,v retrieving revision 1.1.1.1 retrieving revision 1.2 diff -u -r1.1.1.1 -r1.2 --- j1-users.xml 2005/12/16 03:43:36 1.1.1.1 +++ j1-users.xml 2006/04/30 14:44:32 1.2 @@ -1,216 +1,414 @@ -<?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>For Jetspeed-1 Users</title> - <subtitle>For Jetspeed-1 Users</subtitle> - <authors> - <person name="David Le Strat" email="dlest****@apach*****" /> - </authors> - </properties> - <body> - <section name="For Jetspeed-1 Users"> - <p>Jetspeed-2 is a new project, written from groundup and does not have any dependencies on Jetspeed-1. - Jetspeed-2 is based on industry standards, designed for high-volume enterprise portals applications. - The foremost difference is Jetspeeds Component Oriented Architecture, all assembled together with Spring. - Components replace Turbine services with a standardized component model. - Deployment of new portlet applications, which was completely missing in Jetspeed-1, - is implemented to the Portlet API specification. Turbines file-based configuration - for properties are replaced managed components. Jetspeed-2 is fully decoupled from - the legacy projects that were intertwined in the Jetspeed-1 architecture. - </p> - </section> - <section name="Whats New in Jetspeed-2"> - <ul> - <li>1. Fully Compliant with Java Portlet API Standard</li> - <li>2. Separation of Portlet Applications From Portal</li> - <li>3. Live Deployment Model for Portlet Applications and Portal Layouts</li> - <li>4. Spring Component Based Architecture</li> - <li>5. Multi-threaded Portlet Aggregation Engine</li> - <li>6. Scalable Architecture</li> - <li>7. Pipeline-based Request Processing</li> - <li>8. JAAS Security</li> - <li>9. Bridges Integration with Struts, JSF, PHP, Perl, Velocity</li> - <li>19. CMS-based Site Navigations</li> - </ul> - </section> - <section name="Whats the same in Jetspeed-2"> - <p>Not much.</p> - <p> - In fact Jetspeed-2 does not re-use any of the code in Jetspeed-1. - Some concepts are continued in Jetspeed-2, but with new design and implementations. - The table below shows some of the concepts continued in Jetspeed-2 from Jetspeed-1. - Note that even though the concepts are continued, they are have changed, - in some cases significantly: - </p> - <ul> - <li>1. PSML ?? Portlet Structured Markup Language. - Defines the layout of portlets on a page. - While the purpose is still the same, the XML format has changed. - Porting is possible, requires a migration tool. - PSML now fits into an overall Jetspeed Navigation Site as a page-type resource. - No PSML porting tool is currently available. However, an XSLT transform could be a good choice. - </li> - <li>2. Portal Wide Security Policy and Constraints ?? Jetspeed-2 has two kinds of security - mechanisms: JAAS-based security policies, and declarative security constraints - much like Jetspeed-1 constraints. Where as Jetspeed-1 constraints were limited - to PSML, Jetspeed-2 declarative security constraints are also applied to folders - and links.</li> - <li>3. Portlets ?? Portlets now must adhere to the new Portlet API. - No porting tool is currently available. - The Jetspeed-1 Portlet API will not be continued in Jetspeed-2. - </li> - <li>4. Turbine Services are out (Fulcrum). Jetspeed-2 is based on Spring components.</li> - <li>5. Registries ?? The Jetspeed-1 Registries are discontinued in Jetspeed-2. - All portlets are now stored in a Registry database in Jetspeed-2. - No porting tool is available. - Recommend converting your portlets to JSR-168 portlets, - packaging all portlets in a portlet application, - and deploying as standard WAR file. - Other registries are all deprecated.</li> - <li>6. JSP and Velocity Templates ?? Templates can be re-used to some extend. - Any references to Rundata or any other Turbine or Jetspeed-1 tools or - tags must be converted.</li> - <li>7. Controls and Controllers ?? These concepts have changed, and are now called - decorators and layouts. The Turbine module concept, which backed controls - and controllers, is no longer supported. Layouts and decorators are now - only implemented as portlets, or as just plain markup. Layouts and templates - can be deployed to the portal as a deployable unit.</li> - <li>8. Jetspeed Configurations and Jetspeed Component Assemblies replace Property Files. - Component (services) should be assembled, not defined in property files. - Many of the features in Jetspeed-1 were represented as read-only properties in - the Jetspeed-1 static property files. Jetspeed-2 components can be configured with JMX.</li> - </ul> - </section> - <section name='Turbine Gone'> - <p> - Jetspeed-1 is tightly coupled to the Turbine MVC-2 framework, and this coupling permeates - many areas of the Jetspeed API. Jetspeed-2 does not rely on Turbine as the MVC-2 controller. - Instead, we follow the separation of concerns pattern, and concentrates on doing one thing and doing it well. - That is, implementing a portal. Where as Jetspeed-1 coupled MVC Controller, portal engine, and portlet container - all into one deeply coupled servlet, Jetspeed-2 separates these concerns clearly in its architecture. - The portal engine is Jetspeed-2. It is the MVC for page aggregation, leveraging the dispatching nature - of the servlet architecture, and delegating the actual rendering of portlets to portlet application frameworks. - These portlet applications can in turn have their own MVC frameworks, such as Struts portlet applications, - JSF portlet applications, or Turbine portlet application frameworks. - </p> - </section> - <section name='RunData No More'> - <p> - Most notably missing from Portlet API portlets is the RunData class. - The Jetspeed-1 API uses the RunData class ubiquitously, serving as a wrapper for both the servlet request and response. - Other dependencies on Turbine include Portlet Actions, Portlet Aggregation Engine (ECS), - the Service Architecture, Configuration and Turbine Modules. None of these exist in the newer version. - </p> - <table> - <tr> - <th>Jetspeed-1</th> - <th>Jetspeed-2</th> - </tr> - <tr> - <td>Run Data</td> - <td>Portlet API: Portlet Request and Portlet Response</td> - </tr> - <tr> - <td>Portlet Aggregation Engine (ECS)</td> - <td>Jetspeed-2 Multi-threaded Portlet Container Engine</td> - </tr> - <tr> - <td>Turbine Service Architecture</td> - <td>Jetspeed-2 Components</td> - </tr> - <tr> - <td>Property Configuration Files</td> - <td>Spring Configurations, JMX</td> - </tr> - <tr> - <td>Turbine Modules (Actions)</td> - <td>Portlet API Actions </td> - </tr> - - </table> - </section> - <section name='Pluto is the Portlet Container'> - <p>The Jetspeed-2 portal does not implement the Portlet container. - <a href='http://portals.apache.org/pluto'>Pluto</a> implements the JSR 168 interface - contract for portlets running inside our portal. - The Pluto container handles all communication with portlets for the portal. - </p> - </section> - <section name='Aggregating, Isnt It?'> - <p>The aggregation engine and the Jetspeed-1 Portlet API are both coupled to a deprecated Jakarta package ECS - (Element Construction Set). ECS generates HTML with Java code, storing the content in temporary - Java objects before sending the HTML out to the servlet output stream. This wasteful use of Java objects - leads to fragmentation on memory, accelerated garbage collection, and paging in high volume sites. - The servlet API clearly provides a content stream for streaming out portlet content. Jetspeed-2 models - its aggregation engine upon the Portlet APIs streams and readers, analogous to the stream-based Servlet - API for rendering content.</p> - </section> - <section name='State and Life Cycle'> - <p>The Portlet API clearly defines the lifecycle of a portlet, the event sequences for actions, - and how the container can cache content from a portlet. The Portlet Lifecycle was not clearly - defined in Jetspeed-1. The portlet API clearly states that only one instance of a portlet will - reside in memory inside a container. The state of the portlet is directly related to the servlet state - for the current user session. While this may seem obvious, portlet state and lifetime was not clearly - defined in Jetspeed-1. - </p> - </section> - <section name='Actions'> - <p>In version 1, actions were coupled to Turbine and not properly integrated into the Portlet class. - In fact, actions were separate objects from portlets. In the Portlet API, actions are methods on the portlet. - Action event handling and sequencing is clearly defined in the specification.</p> - </section> - <section name='Standard Deployment'> - <p>Jetspeed-1 does not have a standardized method of deploying portlets and their supporting files, - commonly referred to as portlet applications. In order to import an application, one must package - registry files, class and jar files, PSML and templates so that they match the Jetspeed web application format.</p> - <p>In Jetspeed-2, the Portlet API defines a standard deployment descriptor for deploying Portal Applications into Jetspeed. - Portal applications must be deployed to the portal. Analogous to the servlets packaged in a web-application (WAR) - deployment model, portals support portlets packaged in a portal-application deployment model. - The Portal Application archive follows the same format as the WAR format defined in the Servlet specification - with an additional Portlet deployment descriptor file. The clear advantage in Jetspeed-2 is the ability to deploy - live portlet applications to the server in a standardized format.</p> - </section> - <section name='Resources and Deployment'> - <p>Jetspeed-1 resources such as portal templates, images, skins, controllers, controls, are all merged into the single - Jetspeed web application with no deployment model. For example, to override the default skin or top banner, the - resource files are copied into the portal directory, property files updated to point to the new resources, and the - server must be restarted. This made for the process of tailoring Jetspeed-1 portals to real production portals - a process of property and file merging. In fact Jetspeed-1 now has a Maven plug-in to manage production portals - separately from the core Jetspeed-1 portal. The need for this kind of tool covers up the fact that Jetspeed-1 - is missing a good deployment model for portal resources, requiring difficult portal maintenance procedures.</p> - <p>For a Jetspeed-2 production portal, portal resources are packaged in a Jetspeed-specific archive format. - Thus portal resources (top banners, skins, images, style sheets) can all be deployed to dynamically tailor - the portal at runtime.</p> - </section> - <section name='the Standard'> - <p>JSR168 is the Portlet specification enables interoperability between Portlets and Portals. - The specification defines a set of APIs that addresses standardization of portlet aggregation, - personalization, presentation and security. The goals of JSR168 are to: </p> - <ul> - <li>Define common Portal metaphor </li> - <li>Define a standard Portlet Java API </li> - <li>Ensure interoperability and portability</li> - <li>Enable multiple markups support </li> - <li>Ensure compatibility with other technologies </li> - </ul> - <p>The Jetspeed-2 Portlet Server supports the JSR 168 standard. - This is an important initiative, introducing true portlet portability.</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>[For Jetspeed-1 Users]Jetspeed-1 ユーザーに関して</title> + <subtitle>[For Jetspeed-1 Users]Jetspeed-1 ユーザーに関して</subtitle> + <authors> + <person name="David Le Strat" email="dlest****@apach*****" /> + </authors> + <translators> + <person name="菅谷信介" email="shins****@yahoo*****" /> + </translators> + </properties> + <body> + <section name="[For Jetspeed-1 Users]Jetspeed-1 ユーザーに関して"> +<div class="original"> + <p>Jetspeed-2 is a new project, written from groundup and does not have any dependencies on Jetspeed-1. + Jetspeed-2 is based on industry standards, designed for high-volume enterprise portals applications. + The foremost difference is Jetspeeds Component Oriented Architecture, all assembled together with Spring. + Components replace Turbine services with a standardized component model. + Deployment of new portlet applications, which was completely missing in Jetspeed-1, + is implemented to the Portlet API specification. Turbines file-based configuration + for properties are replaced managed components. Jetspeed-2 is fully decoupled from + the legacy projects that were intertwined in the Jetspeed-1 architecture. + </p> +</div> + <p>Jetspeed-2 は新規のプロジェクトで、土台から書き直され、Jetspeed-1 への依存性はありません。 + Jetspeed-2 は業界標準に基づき、大量の企業ポータルアプリケーション用にデザインされています。 + 一番の違いは、Jetspeed コンポーネント指向アーキテクチャです。すべては、Spring で組み合わされます。 + コンポーネントは、Turbine のサービスを標準化されたコンポーネントモデルに置き換えています。 + Jetspeed-1 では完全にかけていた、新しいポートレットアプリケーションの配備は、 + ポートレット API 仕様に実装されました。プロパティによる Turbine のファイルベース設定は、 + 管理されたコンポーネントに置き換えられています。 + Jetspeed-2 では、Jetspeed-1 アーキテクチャに結びついた既存のプロジェクトから完全に切り離されました。 + </p> + </section> + <section name="[Whats New in Jetspeed-2]Jetspeed-2では何が新しくなったか"> +<div class="original"> + <ul> + <li>1. Fully Compliant with Java Portlet API Standard</li> + <li>2. Separation of Portlet Applications From Portal</li> + <li>3. Live Deployment Model for Portlet Applications and Portal Layouts</li> + <li>4. Spring Component Based Architecture</li> + <li>5. Multi-threaded Portlet Aggregation Engine</li> + <li>6. Scalable Architecture</li> + <li>7. Pipeline-based Request Processing</li> + <li>8. JAAS Security</li> + <li>9. Bridges Integration with Struts, JSF, PHP, Perl, Velocity</li> + <li>19. CMS-based Site Navigations</li> + </ul> +</div> + <ul> + <li>1. Java ポートレット API 標準に完全準拠</li> + <li>2. ポータルからポートレットアプリケーションの分離</li> + <li>3. ポートレットアプリケーションおよびポータルレイアウトの動的な配備モデル</li> + <li>4. Spring コンポーネントベースのアーキテクチャ</li> + <li>5. マルチスレッド化されたポートレット集約エンジン</li> + <li>6. 拡張可能なアーキテクチャ</li> + <li>7. パイプラインベースのリクエスト処理</li> + <li>8. JAAS セキュリティ</li> + <li>9. Struts, JSF, PHP, Perl, Velocity のブリッジを統合</li> + <li>19. CMS ベースのサイトナビゲーション</li> + </ul> + </section> + <section name="[Whats the same in Jetspeed-2]Jetspeed-2 で同じものはなにか"> +<div class="original"> + <p>Not much.</p> +</div> + <p>ほとんどありません。</p> +<div class="original"> + <p> + In fact Jetspeed-2 does not re-use any of the code in Jetspeed-1. + Some concepts are continued in Jetspeed-2, but with new design and implementations. + The table below shows some of the concepts continued in Jetspeed-2 from Jetspeed-1. + Note that even though the concepts are continued, they are have changed, + in some cases significantly: + </p> +</div> + <p> + 実際に、Jetspeed-2 は Jetspeed-1 のどんなコードも再利用していません。 + いくつかの概念は、Jetspeed-2 でも継続されています。しかし、新しいデザインと実装をしています。 + 以下の表は、Jetspeed-1 から Jetspeed-2 で継続されているいくつかの概念です。 + その概念は継続されていますが、その中のいくつかの場合は、完全に異なるので注意してください。 + </p> +<div class="original"> + <ul> + <li>1. PSML ?? Portlet Structured Markup Language. + Defines the layout of portlets on a page. + While the purpose is still the same, the XML format has changed. + Porting is possible, requires a migration tool. + PSML now fits into an overall Jetspeed Navigation Site as a page-type resource. + No PSML porting tool is currently available. However, an XSLT transform could be a good choice. + </li> + <li>2. Portal Wide Security Policy and Constraints ?? Jetspeed-2 has two kinds of security + mechanisms: JAAS-based security policies, and declarative security constraints + much like Jetspeed-1 constraints. Where as Jetspeed-1 constraints were limited + to PSML, Jetspeed-2 declarative security constraints are also applied to folders + and links.</li> + <li>3. Portlets ?? Portlets now must adhere to the new Portlet API. + No porting tool is currently available. + The Jetspeed-1 Portlet API will not be continued in Jetspeed-2. + </li> + <li>4. Turbine Services are out (Fulcrum). Jetspeed-2 is based on Spring components.</li> + <li>5. Registries ?? The Jetspeed-1 Registries are discontinued in Jetspeed-2. + All portlets are now stored in a Registry database in Jetspeed-2. + No porting tool is available. + Recommend converting your portlets to JSR-168 portlets, + packaging all portlets in a portlet application, + and deploying as standard WAR file. + Other registries are all deprecated.</li> + <li>6. JSP and Velocity Templates ?? Templates can be re-used to some extend. + Any references to Rundata or any other Turbine or Jetspeed-1 tools or + tags must be converted.</li> + <li>7. Controls and Controllers ?? These concepts have changed, and are now called + decorators and layouts. The Turbine module concept, which backed controls + and controllers, is no longer supported. Layouts and decorators are now + only implemented as portlets, or as just plain markup. Layouts and templates + can be deployed to the portal as a deployable unit.</li> + <li>8. Jetspeed Configurations and Jetspeed Component Assemblies replace Property Files. + Component (services) should be assembled, not defined in property files. + Many of the features in Jetspeed-1 were represented as read-only properties in + the Jetspeed-1 static property files. Jetspeed-2 components can be configured with JMX.</li> + </ul> +</div> + <ul> + <li>1. PSML ?? ポートレット構造化マークアップ言語(Portlet Structured Markup Language) + ページ上でポートレットのレイアウトを定義します。 + その目的は同じですが、XML フォーマットは変更されています。 + 移行は可能で、移行ツールが必要になります。 + 現在、PSML はページタイプのリソースとしての Jetspeed ナビゲーションサイトに適合しています。 + 現在、PSML 移行ツールはありません。しかし、XSLT 変換で行うのが良い選択かもしれません。 + </li> + <li>2. ポータル全体のセキュリティポリシーと制約?? Jetspeed-2 は 2 種類のセキュリティ機構を持ちます。 + JAAS ベースのセキュリティポリシーと、Jetspeed-1 のような宣言的セキュリティ制限です。 + Jetspeed-1 の制約は PSML に対して制限するものでしたが、Jetspeed-2 の宣言的セキュリティ制約は、 + それに加えてフォルダやリンクに対しても適用されます。 </li> + <li>3. ポートレット?? Pポートレットは新しいポートレット API に従わなければなりません。 + 移行ツールは現在ありません。 + Jetspeed-1 ポートレット API は Jetspeed-2 では利用できません。 + </li> + <li>4. Turbine サービス (Fulcrum) はなくなりました。Jetspeed-2 は Spring コンポーネントベースです。</li> + <li>5. レジストリ?? TJetspeed-1 レジストリは Jetspeed-2 で継続していません。 + すべてのポートレットは Jetspeed-2 のレジストリデータベース内に保存されます。 + 移行ツールは現在ありません。 + ご利用のポートレットは、JSR 168 ポートレットへ変換して、すべてのポートレットを一つのポートレットアプリケーションにパッケージングして、 + 標準の WAR ファイルとして配備することをおすすめします。 + そのほかのレジストリは、すべて廃止しています。</li> + <li>6. JSP および Velocity テンプレート?? テンプレートはいくつかの拡張として再利用できます。 + RunData またはその他の Turbine や Jetspeed ツール、タグなどへの参照は、 + 変換する必要があります。 + </li> + <li>7. 制御とコントローラ?? これらの概念は変更され、デコレータおよびレイアウトと現在呼ばれています。ています。 + 制御とコントローラの Turbine モジュールの概念は、サポートされていません。 + レイアウトとデコレータはポートレットとして実装されています。 + つまり、簡単なマークアップになっています。レイアウトとテンプレートは、 + 配備可能な単位としてポータルへ配備することができます。</li> + <li>8. Jetspeed の設定と Jetspeed コンポーネントアセンブリはプロパティーファイルを置き換えます。 + コンポーネント (サービス) は、プロパティファイルで定義されるのではなく、組み立てられます。 + Jetspeed-1 の多くの機能は、Jetspeed-1 の静的なプロパティファイルで読み込みのみ可のプロパティとして表現されています。 + Jetspeed-2 コンポーネントは、JMX を用いて、構成することができます。 + </li> + </ul> + </section> + <section name='[Turbine Gone]Turbine は利用していません'> +<div class="original"> + <p> + Jetspeed-1 is tightly coupled to the Turbine MVC-2 framework, and this coupling permeates + many areas of the Jetspeed API. Jetspeed-2 does not rely on Turbine as the MVC-2 controller. + Instead, we follow the separation of concerns pattern, and concentrates on doing one thing and doing it well. + That is, implementing a portal. Where as Jetspeed-1 coupled MVC Controller, portal engine, and portlet container + all into one deeply coupled servlet, Jetspeed-2 separates these concerns clearly in its architecture. + The portal engine is Jetspeed-2. It is the MVC for page aggregation, leveraging the dispatching nature + of the servlet architecture, and delegating the actual rendering of portlets to portlet application frameworks. + These portlet applications can in turn have their own MVC frameworks, such as Struts portlet applications, + JSF portlet applications, or Turbine portlet application frameworks. + </p> +</div> + <p> + Jetspeed-1 は Turbine の MVC-2 フレームワークと強く結びつき、この結びつきが、Jetspeed API の多くの箇所に及んでいます。 + Jetspeed-2 では、MVC-2 コントローラとしての Turbine に依存しません。 + それに代わり、関連するパターンを分離して、１つのことに実行かつ、それをうまく動かすことに集中します。 + つまり、ポータルの実装をすることです。一方、Jetspeed-1 は MVC コントローラ、ポータルエンジン、ポートレットコンテナ、などすべてがサーブレットに強く結びついた１カ所に結びついています。 + Jetspeed-2 は、そのアーキテクチャの中で、これらの関連することを明確に分けています。 + ポータルエンジンは、Jetspeed-2 です。それは、ページ集約用の MVC で、作業を振り分けるサーブレットアーキテクチャの特性を利用し、ポートレットの実際の描画をポートレットアプリケーションに委譲します。 + これらのポートレットアプリケーションでもやはり、Strutc ポートレットアプリケーション、JSF ポートレットアプリケーション、または、Turbine ポートレットアプリケーションフレームワークのような、独自の MVC フレームワークを持っています。 + </p> + </section> + <section name='[RunData No More]RunData はもうない'> +<div class="original"> + <p> + Most notably missing from Portlet API portlets is the RunData class. + The Jetspeed-1 API uses the RunData class ubiquitously, serving as a wrapper for both the servlet request and response. + Other dependencies on Turbine include Portlet Actions, Portlet Aggregation Engine (ECS), + the Service Architecture, Configuration and Turbine Modules. None of these exist in the newer version. + </p> +</div> + <p> + ポートレット API ポートレットからもっとも顕著に欠けているものは、RunData クラスです。 + Jetspeed-1 API は、偏在的に RunData クラスを私用して、サーブレットリクエストとサーブレットレスポンスの両方へのラッパーとして扱われています。 + Turbine への他の依存関係は、ポートレットアクション、ポートレット集約エンジン(ECS)、サービスアーキテクチャ、設定および Turbine モジュールが含まれます。 + これらの依存関係は、新しいバージョンではありません。 + </p> +<div class="original"> + <table> + <tr> + <th>Jetspeed-1</th> + <th>Jetspeed-2</th> + </tr> + <tr> + <td>Run Data</td> + <td>Portlet API: Portlet Request and Portlet Response</td> + </tr> + <tr> + <td>Portlet Aggregation Engine (ECS)</td> + <td>Jetspeed-2 Multi-threaded Portlet Container Engine</td> + </tr> + <tr> + <td>Turbine Service Architecture</td> + <td>Jetspeed-2 Components</td> + </tr> + <tr> + <td>Property Configuration Files</td> + <td>Spring Configurations, JMX</td> + </tr> + <tr> + <td>Turbine Modules (Actions)</td> + <td>Portlet API Actions </td> + </tr> + + </table> +</div> + <table> + <tr> + <th>Jetspeed-1</th> + <th>Jetspeed-2</th> + </tr> + <tr> + <td>Run Data</td> + <td>ポートレット API: ポートレットリクエストおよびポートレットレスポンス</td> + </tr> + <tr> + <td>ポートレット集約エンジン (ECS)</td> + <td>Jetspeed-2 マルチスレッドポートレットコンテナエンジン</td> + </tr> + <tr> + <td>Turbine サービスアーキテクチャ</td> + <td>Jetspeed-2 コンポーネント</td> + </tr> + <tr> + <td>プロパティ設定ファイル</td> + <td>Spring の設定、JMX</td> + </tr> + <tr> + <td>Turbine モジュール (アクション)</td> + <td>ポートレット API のアクション</td> + </tr> + + </table> + </section> + <section name='[Pluto is the Portlet Container]Pluto はポートレットコンテナです'> +<div class="original"> + <p>The Jetspeed-2 portal does not implement the Portlet container. + <a href='http://portals.apache.org/pluto'>Pluto</a> implements the JSR 168 interface + contract for portlets running inside our portal. + The Pluto container handles all communication with portlets for the portal. + </p> +</div> + <p>Jetspeed-2 ポータルは、ポートレットコンテナを実装していません。 + <a href='http://portals.apache.org/pluto'>Pluto</a> は、ポータル内で実行するポートレット用の JSR 168 インターフェース規約を実装しています。 + Pluto コンテナは、ポータル用のポートレットとのすべての通信を処理します。 + </p> + </section> + <section name='[Aggregating, Isnt It?]集約しているでしょ？'> +<div class="original"> + <p>The aggregation engine and the Jetspeed-1 Portlet API are both coupled to a deprecated Jakarta package ECS + (Element Construction Set). ECS generates HTML with Java code, storing the content in temporary + Java objects before sending the HTML out to the servlet output stream. This wasteful use of Java objects + leads to fragmentation on memory, accelerated garbage collection, and paging in high volume sites. + The servlet API clearly provides a content stream for streaming out portlet content. Jetspeed-2 models + its aggregation engine upon the Portlet APIs streams and readers, analogous to the stream-based Servlet + API for rendering content.</p> +</div> + <p>集約エンジンおよび Jetspeed-1 ポートレット API は、廃止された Jakarta ぱっけーじの ECS (Element Construction Set) と結びついています。 + ECS は、Java コードを用いて HTML を生成し、HTML をサーブレット出力ストリームへ送り出す前に、一時的な Java オブジェクト内にコンテンツを保存します。 + この Java オブジェクトの無駄な使用は、メモリ上の断片化、短期間でのガーベッジコレクション、大容量サイトでのページングを引き起こします。 + サーブレット API は、ポートレットコンテンツ出力ストリーム用のコンテンツストリームを提供します。 + Jetspeed-2 は、コンテンツ描画用のストリームベースのサーブレットに類似している、ポートレット API のストリームおよび読み込み部分の上にその集約エンジンを構成しています。 + </p> + </section> + <section name='[State and Life Cycle]状態とライフサイクル'> +<div class="original"> + <p>The Portlet API clearly defines the lifecycle of a portlet, the event sequences for actions, + and how the container can cache content from a portlet. The Portlet Lifecycle was not clearly + defined in Jetspeed-1. The portlet API clearly states that only one instance of a portlet will + reside in memory inside a container. The state of the portlet is directly related to the servlet state + for the current user session. While this may seem obvious, portlet state and lifetime was not clearly + defined in Jetspeed-1. + </p> +</div> + <p>ポートレット API は、ポートレットのライフサイクル、アクションのイベント処理手順、および、コンテナがどのようにポートレットからコンテンツをキャッシュできるかを定義しています。 + ポートレットのライフサイクルは、Jetspeed-1 では明確に定義されていませんでした。 + ポートレット API ではポートレットの１つのインスタンスだけがコンテナ内のメモリに存在することを明記してあります。 + ポートレットの状態は、現在のユーザーセッションに関するサーブレットの状態に直接関連しています。 + これで明確であるかもしれないが、ポートレットの状態とライフサイクルは Jetspeed-1 では明確に定義されていませんでした。 + </p> + </section> + <section name='[Actions]アクション'> +<div class="original"> + <p>In version 1, actions were coupled to Turbine and not properly integrated into the Portlet class. + In fact, actions were separate objects from portlets. In the Portlet API, actions are methods on the portlet. + Action event handling and sequencing is clearly defined in the specification.</p> +</div> + <p>バージョン 1 では、アクションは Turbine に結びついていて、適切にポートレットのクラスには統合されていませんでした。 + 実際に、アクションは、ポートレットから分けられたオブジェクトでした。ポートレット API では、アクションはポートレット上のメソッドです。 + アクションイベント処理と順序は、仕様で明確に定義されています。</p> + </section> + <section name='[Standard Deployment]標準による配備'> +<div class="original"> + <p>Jetspeed-1 does not have a standardized method of deploying portlets and their supporting files, + commonly referred to as portlet applications. In order to import an application, one must package + registry files, class and jar files, PSML and templates so that they match the Jetspeed web application format.</p> +</div> + <p>Jetspeed-1 は、一般的なポートレットアプリケーションとしてのポートレットの配備やそれらをサポートするファイルに関する標準的な方法がありませんでした。 + アプリケーションをインポートするために、開発者は、Jetspeed ウェブアプリケーション形式に合うように、レジストリファイル、クラスや JAR ファイル、PSML やテンプレートなどをパッケージ化しなければなりません。 + </p> +<div class="original"> + <p>In Jetspeed-2, the Portlet API defines a standard deployment descriptor for deploying Portal Applications into Jetspeed. + Portal applications must be deployed to the portal. Analogous to the servlets packaged in a web-application (WAR) + deployment model, portals support portlets packaged in a portal-application deployment model. + The Portal Application archive follows the same format as the WAR format defined in the Servlet specification + with an additional Portlet deployment descriptor file. The clear advantage in Jetspeed-2 is the ability to deploy + live portlet applications to the server in a standardized format.</p> +</div> + <p>Jetspeed-2 では、ポートレット API が Jetspeed にポータルアプリケーションを配備するために、標準の配備記述子を定義しています。 + ポータルアプリケーションは、ポータルへ配備されます。 + ウェブアプリケーション (WAR) 配備モデルでパッケージ化されたサーブレットに似て、ポータルはポートレットアプリケーション配備モデルでパッケージ化されたポートレットをサポートします。 + ポータルアプリケーションアーカイブは、追加のポートレット配備記述子ファイルを含め、サーブレット仕様で定義された WAR 形式と同じフォーマットに従います。 + Jetspeed-2 の明確な利点は、標準形式でポートレットアプリケーションをサーバーへ動的配備が可能なことです。 + </p> + </section> + <section name='[Resources and Deployment]リソースと配備'> +<div class="original"> + <p>Jetspeed-1 resources such as portal templates, images, skins, controllers, controls, are all merged into the single + Jetspeed web application with no deployment model. For example, to override the default skin or top banner, the + resource files are copied into the portal directory, property files updated to point to the new resources, and the + server must be restarted. This made for the process of tailoring Jetspeed-1 portals to real production portals + a process of property and file merging. In fact Jetspeed-1 now has a Maven plug-in to manage production portals + separately from the core Jetspeed-1 portal. The need for this kind of tool covers up the fact that Jetspeed-1 + is missing a good deployment model for portal resources, requiring difficult portal maintenance procedures.</p> +</div> + <p>ポータルテンプレート、画像、スキン、コントローラ、制御などの Jetspeed-1 のリソースは、配備モデルのない一つの Jetspeed ウェブアプリケーションに統合されました。 + たとえば、標準のスキンや上部のバナーを上書きするには、リソースファイルをポータルディレクトリ上にコピーして、適切なファイルを新しいリソースとして更新し、サーバーを再起動する必要があります。 + これは、プロパティやファイルを統合するプロセスなどの、Jetspeed-1 を実際の本稼働ポータルに仕上げるプロセスに有効です。 + 実際に Jetspeed-1 では、今、Jetspeed-1 ポータル本体から本稼働ポータルを分けて管理するために Maven プラグイン持っています。 + この手のツールの必要性は、困難なポータルメンテナンス処理が必要とされる、ポータルリソース用の有用な配備モデルを Jetspeed-1 が持っていないという事実を取り繕うことから来ます。 + </p> +<div class="original"> + <p>For a Jetspeed-2 production portal, portal resources are packaged in a Jetspeed-specific archive format. + Thus portal resources (top banners, skins, images, style sheets) can all be deployed to dynamically tailor + the portal at runtime.</p> +</div> + <p>Jetspeed-2 本稼働用ポータルについては、ポータルリソースは Jetspeed 固有のアーカイブフォーマットでパッケージ化します。 + つまり、ポータルリソース (上部のバナー、スキン、画像、スタイルシート) は、実行時に動的にポータルを調整するためにすべて配備することができます。 + </p> + </section> + <section name='[the Standard]標準'> +<div class="original"> + <p>JSR168 is the Portlet specification enables interoperability between Portlets and Portals. + The specification defines a set of APIs that addresses standardization of portlet aggregation, + personalization, presentation and security. The goals of JSR168 are to: </p> +</div> + <p>JSR168 はポートレットの仕様で、ポートレットとポータル間の相互運用性を実現します。 + この仕様は、ポートレットの集約、パーソナライズ、表示およびセキュリティの標準に関する API 群を定義しています。 + JSR168 のゴールは、以下のことです。</p> +<div class="original"> + <ul> + <li>Define common Portal metaphor </li> + <li>Define a standard Portlet Java API </li> + <li>Ensure interoperability and portability</li> + <li>Enable multiple markups support </li> + <li>Ensure compatibility with other technologies </li> + </ul> +</div> + <ul> + <li>共通のポータル隠喩の定義</li> + <li>標準のポートレット Java API の定義</li> + <li>相互運用性と移植性の確認</li> + <li>複数のマークアップサポートが可能</li> + <li>ほかの技術のと互換性の確認</li> + </ul> +<div class="original"> + <p>The Jetspeed-2 Portlet Server supports the JSR 168 standard. + This is an important initiative, introducing true portlet portability.</p> +</div> + <p>Jetspeed-2 ポータルサーバーは JSR 168 標準をサポートします。 + これは、真のポートレット移植性を導入するための、重要な第一歩です。</p> + </section> + </body> +</document> + =================================================================== RCS file: jetspeed-2-trans/ja/xdocs/j2-maven-plugin.xml,v retrieving revision 1.1.1.1 retrieving revision 1.2 diff -u -r1.1.1.1 -r1.2 --- j2-maven-plugin.xml 2005/12/16 03:43:36 1.1.1.1 +++ j2-maven-plugin.xml 2006/04/30 14:44:32 1.2 @@ -16,15 +16,19 @@ --> <document> <properties> - <title>Jetspeed 2 Maven Plugin</title> - <subtitle>Documentation for Using Jetspeed 2 Maven Plugin</subtitle> + <title>[Jetspeed 2 Maven Plugin]Jetspeed 2 Maven プラグイン</title> + <subtitle>[Documentation for Using Jetspeed 2 Maven Plugin]Jetspeed 2 Maven プラグインの仕様に関する資料</subtitle> <authors> <person name="David Le Strat" email="dlest****@apach*****" /> <person name="Ate Douma" email="ate****@douma*****" /> </authors> + <translators> + <person name="菅谷信介" email="shins****@yahoo*****" /> + </translators> </properties> <body> - <section name="Plugin Overview"> + <section name="[Plugin Overview]プラグインの概要"> +<div class="original"> <p> Adding functionality to Maven is done through the Maven plugin mechanism. Maven comes shipped with numerous plugins and provides an extensible framework for writing custom plugins. @@ -32,10 +36,23 @@ <a href="http://maven.apache.org/using/developing-plugins.html">Writing a Plugin</a> section of Maven's web site. </p> +</div> + <p> + Maven への機能の追加は、Maven プラグイン機構を通して、行われます。Maven は多数のプラグインとともに配布され、カスタムプラグインを記述するための拡張可能なフレームワークを提供しています。 + カスタム Maven プラグインの詳細については、Maven のウェブサイトの + <a href="http://maven.apache.org/using/developing-plugins.html">プラグインの記述(Writing a Plugin)</a>で見つけることができます。 + </p> +<div class="original"> <p> Jetspeed 2 has developed a custom Maven plugin that centralizes most common build goals required to build a Jetspeed 2 based portal application. This provides many benefits: </p> +</div> + <p> + Jetspeed 2 は、Jetspeed 2 ベースのポータルアプリケーションを構築するために必要な、多くで共通の構築ゴールをまとめた、カスタム Maven プラグインを開発しました。 + これは、次の多くの利点があります。 + </p> +<div class="original"> <ul> <li> Better reusability of common build goals. Developers creating a new portal application can leverage the @@ -52,9 +69,24 @@ M2 should be much easier. </li> </ul> +</div> + <ul> + <li> + 共通の構築ゴールのより良い再利用性。新たなポータルアプリケーションを作成する開発者は共通の構築操作に関する Jetspeed 2 Maven プラグインを活用することができます。 + </li> + <li> + すばやくポータルアプリケーションを始める機能。<code>j2:portal.genapp</code> を用いて、 + 新しいポータルアプリケーションを作成できます。新しいアプリケーションの開発者は、quickStart、ポートレットの配備など、共通ののビルド操作用 Jetspeed 2 Maven プラグインのゴールを再利用できます。 + </li> + <li> + Maven 2 (M2) への将来的な移行の準備。M2 を利用して、カスタムゴールはプラグイン内にカプセル化され、maven.xml は廃止されます。 + Jetspeed 2 Maven プラグインへの多くの Jetspeed 2 構築ゴールを集中することで、M2 への移行は非常に簡単になります。 + </li> + </ul> </section> - <section name="Portal Application creation and configuration Goals"> - <subsection name="Creating a new Portal Application"> + <section name="[Portal Application creation and configuration Goals]ポータルアプリケーションの作成と設定のゴール"> + <subsection name="[Creating a new Portal Application]新しいポータルアプリケーションの作成"> +<div class="original"> <table> <tr> <th>Goal</th> @@ -81,12 +113,44 @@ </td> </tr> </table> +</div> + <table> + <tr> + <th>ゴール</th> + <th>説明</th> + </tr> + <tr> + <td><code>j2:portal.genapp</code></td> + <td> + カスタムポータルアプリケーションの生成または更新。 + このゴールの基本利用方法に関して、<a href="getting-started.html#4__Creating_a_new_Portal_Application">導入</a> + ドキュメントを確認してください。 + <br /> + </td> + </tr> + <tr> + <td><code>j2:portal.genapp.minimal</code></td> + <td> + <code>j2:portal.genapp</code> と同様に動作します。しかし、<code>WEB-INF/pages</code> から 以下のディレクトリとファイルだけをコピーします。 + <ul> + <li>/WEB-INF/pages/Administrative/** (all contents)</li> + <li>/WEB-INF/pages/page.security</li> + </ul> + </td> + </tr> + </table> </subsection> - <subsection name="Configuring and updating a Portal Application"> + <subsection name="[Configuring and updating a Portal Application]ポータルアプリケーションの設定と更新"> +<div class="original"> <p> The <code>j2:portal.genapp</code> goal above is actually no more than a wrapper around several (sub)goals which can also be used individually to update and configure your portal application: </p> +</div> + <p> + 上の <code>j2:portal.genapp</code> ゴールは、実際には、以下のようなポータルアプリケーションを個々に更新や設定するために使用することができるいくつのゴールに関するラッパーでしかありません。 + </p> +<div class="original"> <table> <tr> <th>Goal</th> @@ -206,14 +270,126 @@ </td> </tr> </table> +</div> + <table> + <tr> + <th>ゴール</th> + <th>説明</th> + </tr> + <tr> + <td><code>j2:portal.copy.webapp</code></td> + <td> + プラグインから <code>${org.apache.jetspeed.portal.webapp.dir}</code> フォルダへ (静的な) Jetspeed 2 ポータルウェブリソースをコピーします。 + <br /> + <br /> + このゴールの再実行は、前回のリソースを削除しませんが、既存のリソースは<i>上書きされます</i>。 + <br /> + <br /> + Jetspeed 2 ポータルの新しいバージョンへアップグレードする必要がある場合は、まず、これらのリソースを削除しなければなりません。 + デフォルトでは、対象フォルダが Maven デフォルトの対象フォルダ内で構成され、<code>clear</code> ゴールの実行でそれが実行されます。 + </td> + </tr> + <tr> + <td><code>j2:portal.copy.webapp.minimal</code></td> + <td> + <code>j2:portal.copy.webapp</code> と同様。しかし、<code>WEB-INF/pages</code> から以下のディレクトリとファイルをコピーするだけです。 + <ul> + <li>/WEB-INF/pages/Administrative/** (すべてのコンテンツ)</li> + <li>/WEB-INF/pages/page.security</li> + </ul> + </td> + </tr> + <tr> + <td><code>j2:portal.conf.project</code></td> + <td> + 新規に Maven プロジェクトを作成、または、<code>${org.apache.jetspeed.portal.home.dir}</code> フォルダ内の既存のポータルプロジェクト設定を更新します。 + <br /> + 次の 5 つの Maven プロジェクトファイルの階層が作成されます。 + <ul> + <li><code>project-info.xml</code></li> + <li><code>core-build.xml は project-info.xml を extend します</code></li> + <li><code>jetspeed-components.xml は core-build.xml を extend します</code></li> + <li><code>full-portal.xml は jetspeed-components.xml を extend します</code></li> + <li><code>project.xml は full-portal.xml を extend します</code></li> + </ul> + 上のファイルで、始めと最後のもの (project-info.xml と project.xml) は、追加的なプロジェクト情報や設定を提供するために修正されるかもしれません。そして、それらはこのゴールによって再度更新されません。他の 3 つのファイルだけは、このゴールによって再記述されます。 + Jetspeed 2 の最新バージョンにアップグレードする必要がある場合は、独自にカスタマイズしたものを保存しておきます。 + <br /> + <br /> + 追加的に、ポータルをさらにカスタマイズするために独自の maven.xmlを追加したり、project.properties または build.properties を追加できます。 + このゴールを再度実行するときには、これらを保存しておきます。 + </td> + </tr> + <tr> + <td><code>j2:portal.conf.sql</code></td> + <td> + <code>${org.apache.jetspeed.portal.sql.dir}</code> 以下に、設定されたデータベース用にポータル SQL スキーマ DDL を生成します。 + 静的に定義された共通および選択されたデータベース固有の SQL の DML および DDL (生成された DDL が優先可能なら) も同様にコピーします。 + <br /> + <br /> + このゴールが実行されると、SQL 対象フォルダの内容は、はじめに削除されます。 + </td> + </tr> + <tr> + <td><code>j2:portal.conf.ojb</code></td> + <td> + OJB 設定、現在の選択された本稼働用データベース用フィルタされて、<code>${org.apache.jetspeed.portal.target.dir}</code> へコピーします。 + <br /> + <br /> + 標準では、上記の対象フォルダは標準の Maven WAR 対象フォルダ以下に構成されます。 + Maven <code>clear</code> ゴールは、このフィルタされた OJB 設定を削除します。 + </td> + </tr> + <tr> + <td><code>j2:portal.conf.ldap</code></td> + <td> + <code>${org.apache.jetspeed.portal.target.dir}</code> フォルダへ LDAP 設定をコピーします。 + </td> + </tr> + <tr> + <td><code>j2:portal.conf.jetspeed</code></td> + <td> + <code>${org.apache.jetspeed.portal.target.dir}</code> フォルダへフィルタされた <code>jetspeed.properties</code> ポータル設定をコピーします。 + <br /> + <br /> + デフォルトで、上記の対象フォルダは標準の Maven の WAR 対象フォルダ以下に構成されます。 + Maven <code>clear</code> ゴールは、このフィルタされた <code>jetspeed.properties</code> ファイルも削除します。 + </td> + </tr> + <tr> + <td><code>j2:portal.conf.tomcat</code></td> + <td> + <code>${org.apache.jetspeed.portal.conf.dir}</code> フォルダへの現在のデータベース接続設定を含めた、フィルタされた Tomcat コンテキスト記述子をコピーします。 + <br /> + <br /> + <code>${org.apache.jetspeed.catalina.major.version}</code> 設定に基づき、Tomcat 5.0.x または 5.5.x タイプのテンプレートコンテキスト記述子が使用されます。 + <br /> + <br /> + フィルタされた Tomcat コンテキスト記述子は、<code>j2:portal.deploy</code> ゴールによって、Tomcat サーバーへコピーされます。 + <br /> + <br /> + Tomcat のメジャーバージョンおよびデータベース接続設定を変更したい場合、ポータルを (再) 配備する前に再度、このゴールを実行する必要があります。 + <br /> + <br /> + デフォルトでは、上記の対象フォルダは、標準の Maven 対象フォルダ以下に構成されます。 + Maven <code>clear</code> ゴールは、このフィルタされたコンテキスト記述子ファイルを削除します。 + </td> + </tr> + </table> </subsection> </section> - <section name="Portal Application Deployment Goals"> - <subsection name="Quickstart deployment goals"> + <section name="[Portal Application Deployment Goals]ポータルアプケーション配備ゴール"> + <subsection name="[Quickstart deployment goals]クイックスタート用の配備ゴール"> +<div class="original"> <p> Several goals are available for quickly deploying the Portal Application together with a predefined set of Portlet Applications and optionally with creating and seeding the portal database. </p> +</div> + <p> + いくつかのゴールは、すばやくポータルアプリケーションを前もって定義されたポータルアプリケーション群と、状況に応じて、ポータル用のデータベース生成を含めて、ポータルアプケーションを配備するために利用可能です。 + </p> +<div class="original"> <table> <tr> <th>Goal</th> @@ -283,8 +459,71 @@ </td> </tr> </table> +</div> + <table> + <tr> + <th>ゴール</th> + <th>説明</th> + </tr> + <tr> + <td><code>j2:doStart</code></td> + <td> + ポータルアプリケーションを配備して、設定された Tomcat サーバー (共有ライブラリ、ポータルアプリケーションのコンテキストなど) 用の必要な依存関係を設定するための汎用的なゴールです。 + <br /> + <br /> + このゴールは、設定するために <code>deployType</code> プラグインプロパティが必要です。デフォルト値は + <code>"j2:fullDeploy"</code> です (以下参照)。 + <br /> + <br /> + <code>recreateDB</code> プラグインプロパティが設定されている場合、<code>j2:db.recreate</code> ゴールが呼び出されます。 + <br /> + すべての既存の Jetspeed 2 標準およびデモポートレットアプリケーションは、<code>j2:remove.wars</code> ゴールを通して、削除されます。 + <br /> + 共有の依存関係は、<code>j2:copy.shared.deps</code> を用いて、Tomcat サーバーへコピーされます。 + <br /> + そして、最後に、設定された <code>deployType</code> プラグインプロパティの値は、指定された配備ゴールを実行するために使用されます。 + </td> + </tr> + <tr> + <td><code>j2:quickStart</code></td> + <td> + <code>deployType="j2:fullDeploy"</code> および <code>recreateDB=true</code> を用いて、<code>j2:doStart</code> を呼び出します。 + </td> + </tr> + <tr> + <td><code>j2:nodbQuickStart</code></td> + <td> + <code>deployType="j2:nodbfullDeploy"</code> および <code>recreateDB=false</code> を用いて、<code>j2:doStart</code> を呼び出します。 + </td> + </tr> + <tr> + <td><code>j2:basicStart</code></td> + <td> + <code>deployType="j2:basicDeploy"</code> および <code>recreateDB=true</code> を用いて、<code>j2:doStart</code> を呼び出します。 + </td> + </tr> + <tr> + <td><code>j2:nodbBasicStart</code></td> + <td> + <code>deployType="j2:nodbBasicDeploy"</code> および <code>recreateDB=false</code> を用いて、<code>j2:doStart</code> を呼び出します。 + </td> + </tr> + <tr> + <td><code>j2:minStart</code></td> + <td> + <code>deployType="j2:minDeploy"</code> および <code>recreateDB=true</code> を用いて、<code>j2:doStart</code> を呼び出します。 + </td> + </tr> + <tr> + <td><code>j2:nodbMinStart</code></td> + <td> + <code>deployType="j2:nodbMinDeploy"</code> および <code>recreateDB=false</code> を用いて、<code>j2:doStart</code> を呼び出します。 + </td> + </tr> + </table> </subsection> - <subsection name="Deployment supporting Goals"> + <subsection name="[Deployment supporting Goals]配備をサポートしているゴール"> +<div class="original"> <table> <tr> <th>Goal</th> @@ -329,8 +568,53 @@ </td> </tr> </table> +</div> + <table> + <tr> + <th>ゴール</th> + <th>説明</th> + </tr> + <tr> + <td>j2:remove.wars</td> + <td> + Tomcat サーバーから、ポータル、すべての標準およびデモポートレットアプリケーション (以下の <code>j2:fullDeploy</code> を参照) と (存在すれば) それらのコンテンツ記述子を削除します。 + </td> + </tr> + <tr> + <td><code>j2:catalina.base.shared</code></td> + <td> + 共通のポートレットコンテナ用に必要なすべての基本 JAR ファイルをコピーします。 + </td> + </tr> + <tr> + <td><code>j2:catalina.shared</code></td> + <td>共通コンテナ用に必要なすべての JAR ファイルをコピーします。</td> + </tr> + <tr> + <td><code>j2:copy.shared.deps</code></td> + <td> + <code>j2:catalina.base.shared</code> および <code>j2:catalina.shared</code> を呼び出すラッパーゴール。 + </td> + </tr> + <tr> + <td><code>j2:portal.deploy</code></td> + <td> + Tomcat サーバーへポータルアプリケーションおよびそれに依存するものだけを配備します。 + <br /> + <br /> + はじめに、<code>j2:remove.wars</code> ゴールで現在のインストールされたポータルを削除します。 + <br/> + 次に、ローカル Maven リポジトリからアプリケーションサーバーへ構築されたポータル WAR をコピーして展開します。 + <br /> + そして、ポータル用に Tomcat コンテンツ記述子をコピーします。(<code>j2:portal.conf.tomcat</code> ゴールも参照してください) + <br /> + 最後に、<code>j2:copy.shared.deps</code> ゴールで共有される依存するものをインストールします。 + </td> + </tr> + </table> </subsection> - <subsection name="Standard and Demo Portlet Application deployment goals"> + <subsection name="[Standard and Demo Portlet Application deployment goals]標準およびデモポートレットアプリケーション配備ゴール"> +<div class="original"> <table> <tr> <th>Goal</th> @@ -418,9 +702,92 @@ </td> </tr> </table> +</div> + <table> + <tr> + <th>ゴール</th> + <th>説明</th> + </tr> + <tr> + <td><code>j2:deploy</code></td> + <td> + <code>${maven.war.final.name}</code> プロパティによって特定されたポートレットアプリケーションを配備するための標準ゴール。 + <br /> + <br /> + ポートレットアプリケーションは、ローカル Maven リポジトリの Jetspeed2 グループ内で検索されます。 + リポジトリ内でポートレットを検索するときに、このゴールは、プラグイン内で設定された Jetspeed 2 のバージョン番号で与えられたポートレットアプリケーションを検索します。 + <code>${maven.war.final.name}-${jetspeed.version}.war</code> の書式に従ったリポジトリ内で検索されたファイル名で、<code>${maven.war.final.name}.war</code> として配備されます。 + </td> + </tr> + <tr> + <td><code>j2:pam.layoutdeploy</code></td> + <td>Jetspeed ローカルレイアウトポートレットアプリケーションを配備します。</td> + </tr> + <tr> + <td><code>j2:pam.admindeploy</code></td> + <td>Jetspeed 管理ポートレットアプリケーションを配備します。</td> + </tr> + <tr> + <td><code>j2:pam.tsdeploy</code></td> + <td>Pluto テストスイートポートレットアプリケーションを配備します。</td> + </tr> + <tr> + <td><code>j2:pam.strutsdeploy</code></td> + <td>Struts メールリーダーデモポートレットアプリケーションを配備します。</td> + </tr> + <tr> + <td><code>j2:pam.jpetstoredeploy</code></td> + <td>iBatis Jpetstore ベースのデモポートレットアプリケーションを配備します。</td> + </tr> + <tr> + <td><code>j2:pam.jsfdeploy</code></td> + <td>Jetspeed で汎用的な JSF ポートレットブリッジを使用した JSF デモポートレットアプリケーションを配備します。</td> + </tr> + <tr> + <td><code>j2:pam.jsfmyfacesdeploy</code></td> + <td>MyFaces に含まれる JSF ポートレットブリッジを使用した JSF デモポートレットアプリケーションを配備します。</td> + </tr> + <tr> + <td><code>j2:pam.phpdeploy</code></td> + <td>Jetspeed PHP ブリッジデモポートレットアプリケーションを配備します。</td> + </tr> + <tr> + <td><code>j2:pam.perldeploy</code></td> + <td>Jetspeed Perl ブリッジデモポートレットアプリケーションを配備します。</td> + </tr> + <tr> + <td><code>j2:pam.rssdeploy</code></td> + <td>RSS フィードデモポートレットアプリケーションを配備します。</td> + </tr> + <tr> + <td><code>j2:nodbMinDeploy</code></td> + <td> + <code>j2:portal.deploy</code> ゴールを使用したポータルを配備し、<code>j2:pam.layoutdeploy</code> と <code>j2:pam.admindeploy</code> を使用して、レイアウトポートレットと管理ポートレットだけを配備します。 + </td> + </tr> + <tr> + <td><code>j2:minDeploy</code></td> + <td> + <code>j2:nodbMinDeploy</code> と同様な機能に加えて、<code>j2:db.entities</code> ゴールを使用して、ポータルデータベースを作成します。 + </td> + </tr> + <tr> + <td><code>j2:nodbfullDeploy</code></td> + <td> + <code>j2:nodbMinDeploy</code> と同様な機能ですが、追加で、他のすべてのデモポートレットアプリケーション (上のすべてのリストを参照) を配備します。 + </td> + </tr> + <tr> + <td><code>j2:fullDeploy</code></td> + <td> + <code>j2:nodbFullDeploy</code> と同様な機能に加えて、<code>j2:db.entities</code> ゴールを使用して、ポータルデータベー>スを作成します。 + </td> + </tr> + </table> </subsection> </section> - <section name="Database Management Goals"> + <section name="[Database Management Goals]データベース管理ゴール"> +<div class="original"> <table> <tr> <th>Goal</th> @@ -478,8 +845,62 @@ </td> </tr> </table> +</div> + <table> + <tr> + <th>ゴール</th> + <th>説明</th> + </tr> + <tr> + <td><code>j2:start.production.server</code></td> + <td>ポータルによって使用される標準の HSQLDB 本稼働用データベースを起動します。</td> + </tr> + <tr> + <td><code>j2:start.test.server</code></td> + <td> + Jetspeed 2 のビルド中にテスト用で使用するために、標準の HSQLDB テスト用データベースを起動します。 + </td> + </tr> + <tr> + <td><code>j2:db.create.test</code></td> + <td> + テスト用データベースのテーブルを作成します。もし、標準の HSQLDB を利用する場合、<code>j2:start.test.server</code> ゴール内で先に起動されていなければなりません。 + <br /> + 既存のポータルのテーブルは始めに削除されます。初めて実行する場合は、「table does not exist」エラーメッセージが表示されますが、それらは無視することができます。 + </td> + </tr> + <tr> + <td><code>j2:db.create.production</code></td> + <td> + 本稼働用のデータベースのテーブルを作成します。もし、標準の HSQLDB を利用する場合、<code>j2:start.production.server</code> ゴール内で先に起動されていなければなりません。 + <br /> + 既存のポータルのテーブルは始めに削除されます。初めて実行する場合は、「table does not exist」エラーメッセージが表示され>ますが、それらは無視することができます。 + </td> + </tr> + <tr> + <td><code>j2:db.recreate</code></td> + <td> + <code>j2:db.create.production</code> ゴールを利用して、本稼働用データベースを再作成しますが、まず、<code>j2:portal.conf.sql</code> 使用して、SQL スクリプトを (再) 生成します。 + </td> + </tr> + <tr> + <td><code>j2:db.drop.test</code></td> + <td>テスト用データベースのポータルに関するテーブルを削除します。</td> + </tr> + <tr> + <td><code>j2:db.drop.production</code></td> + <td>本稼働用データベースのポータルに関するテーブルを削除します。</td> + </tr> + <tr> + <td><code>j2:db.entities</code></td> + <td> + Jetspeed 2 で構成された標準の PSML 構成用のユーザー情報を投入します。 + </td> + </tr> + </table> </section> - <section name="LDAP Management Goals"> + <section name="[LDAP Management Goals]LDAP 管理ゴール"> +<div class="original"> <table> <tr> <th>Goal</th> @@ -491,11 +912,29 @@ <i><a href="http://svn.apache.org/viewcvs.cgi/portals/jetspeed-2/trunk/etc/apacheds/apacheds-server.xml?view=markup">apacheds-server.xml</a></i> configuration.</td> </tr> </table> +</div> + <table> + <tr> + <th>ゴール</th> + <th>説明</th> + </tr> + <tr> + <td><code>j2:start.ldap.server</code></td> + <td>標準の Apache Directory Server を起動し、標準の + <i><a href="http://svn.apache.org/viewcvs.cgi/portals/jetspeed-2/trunk/etc/apacheds/apacheds-server.xml?view=markup">apacheds-server.xml</a></i> 設定を読み込みます。</td> + </tr> + </table> </section> - <section name="Auxillary Jetspeed Components Deployment Goals"> + <section name="[Auxillary Jetspeed Components Deployment Goals]補助的な Jetspeed コンポーネント配備ゴール"> +<div class="original"> <p> Generic set of goals for redeploying a specific Jetspeed component. </p> +</div> + <p> + 特定の Jetspeed コンポーネントを再配備するための一般的なゴール群です。 + </p> +<div class="original"> <table> <tr> <th>Goal</th> @@ -527,6 +966,37 @@ </td> </tr> </table> +</div> + <table> + <tr> + <th>ゴール</th> + <th>説明</th> + </tr> + <tr> + <td><code>j2:jar.deploy</code></td> + <td> + ローカル Maven リポジトリから配備ディレクトリへ Jetspeed コアコンポーネントを配備します。 + </td> + </tr> + <tr> + <td><code>j2:jar.deploy.shared</code></td> + <td> + ローカル Maven リポジトリから Tomcat の共有ライブラリディレクトリへ Jetspeed コアコンポーネントを配備します。 + </td> + </tr> + <tr> + <td><code>j2:deployDecorations</code></td> + <td> + WEB-INF/decorations ディレクトリから配備されたポータルへすべてのデコレーションを配備します。 + </td> + </tr> + <tr> + <td><code>j2:deployTemplates</code></td> + <td> + WEB-INF/templates ディレクトリから配備されたポータルへすべてのテンプレートを配備します。 + </td> + </tr> + </table> </section> </body> </document>
