svnno****@sourc*****
svnno****@sourc*****
2007年 6月 1日 (金) 06:05:51 JST
Revision: 171
http://svn.sourceforge.jp/cgi-bin/viewcvs.cgi?root=pal&view=rev&rev=171
Author: shinsuke
Date: 2007-06-01 06:05:51 +0900 (Fri, 01 Jun 2007)
Log Message:
-----------
fixed source tag problem.
Modified Paths:
--------------
pal-portal/trunk/docs/ja/portlet-developers-guide/xdocs/guide-api-based-portlet.xml
pal-portal/trunk/docs/ja/portlet-developers-guide/xdocs/guide-teeda-based-portlet.xml
-------------- next part --------------
Modified: pal-portal/trunk/docs/ja/portlet-developers-guide/xdocs/guide-api-based-portlet.xml
===================================================================
--- pal-portal/trunk/docs/ja/portlet-developers-guide/xdocs/guide-api-based-portlet.xml 2007-05-31 21:00:49 UTC (rev 170)
+++ pal-portal/trunk/docs/ja/portlet-developers-guide/xdocs/guide-api-based-portlet.xml 2007-05-31 21:05:51 UTC (rev 171)
@@ -34,12 +34,15 @@
</p>
<p>
まずは、ディレクトリを作成します。
+ </p>
<source><![CDATA[
$ cd
$ mkdir -p Projects/helloworld
$ cd Projects/helloworld/
]]></source>
+ <p>
この helloworld ポートレットプロジェクトでは、次のファイルを作成します。
+ </p>
<source><![CDATA[
pom.xml
src/main/webapp/WEB-INF/portlet.xml
@@ -49,6 +52,7 @@
src/main/java/com/marevol/portlet/helloworld/resources/HelloWorldResources.properties
src/main/java/com/marevol/portlet/helloworld/HelloWorldPortlet.java
]]></source>
+ <p>
pom.xml は、Maven 2 のプロジェクトファイルです。
そして、それ以外のファイルが、ポートレットを構築・実行する上で必要になるファイルになります。
</p>
@@ -66,6 +70,7 @@
ポートレット用にビルドするために、依存関係に portlet-api を指定しておけば、ポートレットを作成することができます。
今回の helloworld ポートレットでは、ビューに JSP を利用して、JSTL を利用しているので、それに必要な依存関係を追加します。
もし、独自にポートレットを作成する場合には、必要なライブラリがあれば、追加してください。
+ </p>
<source><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
@@ -103,7 +108,6 @@
</dependencies>
</project>
]]></source>
-</p>
</section>
<section name="ポートレットの構成ファイル">
<p>
@@ -156,6 +160,7 @@
</p>
<p>
src/main/webapp/WEB-INF/portlet.xml は以下のとおりです。
+ </p>
<source><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<portlet-app id="helloworld" version="1.0">
@@ -182,11 +187,11 @@
</portlet>
</portlet-app>
]]></source>
-</p>
<p>
web.xml は、通常の Web アプリケーションと同様に、Web アプリケーションのリソースなどを指定しています。
今回は、特に指定することもないので、display-name と description 要素にこのポートレットについてを記述するだけになっています。
src/main/webapp/WEB-INF/web.xml は以下のようになります。
+ </p>
<source><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
@@ -195,7 +200,6 @@
<description>HelloWorld Portlet</description>
</web-app>
]]></source>
-</p>
<p>
HelloWorldPortlet は、portlet.xml で portlet-class 要素で指定したポートレットのクラスです。
ポートレットにアクセスすると、このクラスが呼ばれ、必要な処理を実行します。
@@ -238,6 +242,7 @@
</p>
<p>
src/main/java/com/marevol/portlet/helloworld/HelloWorldPortlet.java は以下のとおりです。
+ </p>
<source><![CDATA[
package com.marevol.portlet.helloworld;
@@ -293,7 +298,6 @@
}
}
]]></source>
-</p>
<p>
helloworld.jsp は、今回のポートレットのビューの部分にあたります。
この JSP ファイルは、HelloWorldPortlet クラスから呼ばれて、実行されます。
@@ -312,6 +316,7 @@
</p>
<p>
src/main/webapp/WEB-INF/view/helloworld.jsp は以下のとおりです。
+ </p>
<source><![CDATA[
<%@ taglib uri="http://java.sun.com/portlet" prefix="portlet" %>
<%@ taglib uri="http://java.sun.com/jstl/fmt" prefix="fmt" %>
@@ -336,6 +341,7 @@
</table>
</form>
]]></source>
+ <p>
ポートレットでは、ポータル上の 1 つのページで、その中の一部のフラグメントとして表示されるため、htmlタグ、headタグや body タグなどは記述する必要はありません。
</p>
<p>
@@ -351,6 +357,7 @@
</p>
<p>
src/main/java/com/marevol/portlet/helloworld/resources/HelloWorldResources_ja.properties は以下のとおりです。
+ </p>
<source><![CDATA[
# portlet info
javax.portlet.title=\u30CF\u30ED\u30FC\u30EF\u30FC\u30EB\u30C9
@@ -364,15 +371,15 @@
helloworld.lable.YourName=\u540D\u524D:
helloworld.lable.Submit=\u9001\u4FE1
]]></source>
-
+ <p>
src/main/java/com/marevol/portlet/helloworld/resources/HelloWorldResources.properties は以下のとおりです。
+ </p>
<source><![CDATA[
# helloworld.jsp
helloworld.lable.Hello=Hello!
helloworld.lable.YourName=Your Name:
helloworld.lable.Submit=Submit
]]></source>
-</p>
</section>
<section name="ポートレットのビルド">
<p>
@@ -380,6 +387,7 @@
ビルド方法は、非常に簡単です。
ここでは、Maven 2 を実行できる環境が用意済みであることを想定しています。
Maven 2 のインストール方法については、<a href="http://maven.apache.org/">http://maven.apache.org/</a> を参照してください。
+ </p>
<source><![CDATA[
$ ls
pom.xml src
@@ -393,14 +401,15 @@
.
.
]]></source>
+ <p>
通常の Maven 2 のビルドと同様、mvn install を実行します。
このことからも、基本的には、普通の Web アプリケーションと同じであることがわかると思います。
ビルドに成功していると、target ディレクトリの下に helloworld.war が作成されます。
+ </p>
<source><![CDATA[
$ ls target/helloworld.war
target/helloworld.war
]]></source>
-</p>
<p>
これで、JSR 168 に準拠しているポートレットを作成できたことになります。
これを、JSR 168 に準拠しているポータルサーバー上に持っていき、そのポータルサーバーの配備手順に従って、配備すれば、動作させることができます。
Modified: pal-portal/trunk/docs/ja/portlet-developers-guide/xdocs/guide-teeda-based-portlet.xml
===================================================================
--- pal-portal/trunk/docs/ja/portlet-developers-guide/xdocs/guide-teeda-based-portlet.xml 2007-05-31 21:00:49 UTC (rev 170)
+++ pal-portal/trunk/docs/ja/portlet-developers-guide/xdocs/guide-teeda-based-portlet.xml 2007-05-31 21:05:51 UTC (rev 171)
@@ -55,6 +55,7 @@
<section name="portlet.xml の追加">
<p>
次に、portlet.xml ですが、これは JSR 168 で定義されているポートレット配備子です。 ポータルサーバー上に表示するポートレットの情報を記述します。 たとえば、以下のような内容をこのファイルに記述します。
+ </p>
<source><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<portlet-app version="1.0">
@@ -98,6 +99,7 @@
</portlet>
</portlet-app>
]]></source>
+ <p>
まず、portlet-name 要素の値には、ポータルにより利用される一意なポートレット名が入ります。 display-name 要素の値はポータルにより表示される(たとえば、ユーザーがポートレット一覧からポートレットを選択するときなど)ポートレットの名前で、次の description 要素の値がその説明になります。 portlet-class 要素と init-param 要素にある portlet-class および portlet-filters は変更する必要はありません。 init-param 要素の view-page の値は、表示モードでアクセスされたときにデフォルトで表示されるページのパスを記述します(編集モードで表示するページは、edit-page で指定します)。ポートレットで表示されるポートレットには、表示モードや編集モードなどいくつかのモードがあり、たとえば、ポートレットの小窓の右上にある編集ボタンを押すと、編集モードが呼ばれます。 サポートされるポートレットモードは、supports 要素の portlet-mode 要素としてサポートするモードを指定できます。あとは、potlet-info 要素の title、short-title、keywords 要素を変更してください。 title 要素はポートレットの小窓のバーなどに表示されるタイトルで、short-title はその短いタイトルで、ポータルがモバイル環境で表示されるときに短いタイトルが必要なときに表示されます。 keywords 要素は、そのポートレットのキーワードで , 区切りで複数指定できます。 ポータルのポートレット一覧で検索するときなどに利用されます。必要な場所を変更して、portlet.xml として、WEB-INF の下に保存してください(他にもいろいろな要素がありますが、必要に応じて、追加してください)。
</p>
</section>