portal開發(fā)的一個重要工作就是portlet的開發(fā)，網(wǎng)上一大堆hello world，都是最簡單的，用PrintWriter輸出字符串。今天介紹一下稍微復(fù)雜的，用戶轉(zhuǎn)到portlet的edit Model，該頁面是有一個輸入框和一個按鈕，輸入你的名字，然后提交，將轉(zhuǎn)到此portlet的view Model并輸出hello,your name。
portlet與servlet非常相似，因為portlet就是在servlet規(guī)范的基礎(chǔ)上擴展的，并且portlet容器也是在servlet容器的基礎(chǔ)上擴展，同serlvet一樣，我們的HelloWorldPorlet需要強制繼承自GenericPortlet類，GenericPortlet實現(xiàn)了Portlet接口,看看完整代碼：
package net.rubyeye.portlets;
import javax.portlet.ActionResponse;
import javax.portlet.GenericPortlet;
import javax.portlet.PortletException;
import javax.portlet.PortletRequestDispatcher;
import javax.portlet.RenderRequest;
import javax.portlet.RenderResponse;
public class HelloWorldPortlet extends GenericPortlet {
@Override
protected void doEdit(RenderRequest req, RenderResponse res)
throws PortletException, IOException {
res.setContentType("text/html");
//獲取初始參數(shù)，在init-param中定義
String jspName = getPortletConfig().getInitParameter("edit-jsp");
PortletRequestDispatcher rd = getPortletContext().getRequestDispatcher(
jspName);
rd.include(req, res);
}
@Override
protected void doView(RenderRequest req, RenderResponse res)
throws PortletException, IOException {
res.setContentType("text/html");
//執(zhí)行完processAction后設(shè)置了renderParamter，這里得到
String msg = req.getParameter("msg");
PrintWriter out = res.getWriter();
System.out.println(msg);
//有就輸出
if (msg != null)
out.write(msg);
//默認輸出是Hello World
else
out.write("Hello World!View!");
}
//actionURL調(diào)用的processAction
@Override
public void processAction(ActionRequest req, ActionResponse res)
throws PortletException, IOException {
// TODO Auto-generated method stub
String name = req.getParameter("name");
System.out.println(name);
res.setRenderParameter("msg", "hello," + name);
}
}
解釋下代碼,portlet默認有三種Model：view、edit和help，顧名思義分別對照瀏覽、編輯和幫助狀態(tài)，其中只有view是必須的，當然還可以自定義model。在portlet就有相應(yīng)的doXXX方法用于呈現(xiàn)相應(yīng)的片段，portlet還有一個render(RenderRequest，RenderResponse),這個方法與doView等方法的關(guān)系類似serlvet中service與doGet、doHelp的關(guān)系，一般我們都不直接覆寫render，而是實現(xiàn)具體的doXXX方法。回到這個例子,HelloWorldPortlet有兩個Model：view和edit。
在doView方法中很簡單，首先需要設(shè)置ContentType，然后獲取前面processAction設(shè)置的renderParamter，當然，一開始進入portlet是view，這個值根本沒有，默認就用PrintWriter輸出Hello World。
processAction用于處理ActionRequest的方法，和一般的servlet編程沒有什么不同，請注意，processAction執(zhí)行之后才是執(zhí)行相應(yīng)的render方法，并且與render
不共享parameter，因此為了在doView中獲得msg參數(shù)，我們需要通過ActionResponse的setRenderParameter來設(shè)定RenderRequest的Parameter。
doEdit方法就比較簡單了，通過PortletConfig的getInitParameter(與ServletConfig一樣了）獲得屬性edit-jsp的值——編輯頁面的位置，然后將該頁面include進portlet。
portlet需要一個配置文件來告訴portlets容器具體信息，這個文件同樣放在WEB-INF目錄下，并且名為portlet
.xml：
<?xml version="1.0" encoding="UTF-8"?>
<portlet-app version="1.0"
xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<portlet>
<portlet-name>HelloWorldPorlet_1</portlet-name>
<portlet-class>
net.rubyeye.porlets.HelloWorldPorlet
</portlet-class>
<init-param>
<name>edit-jsp</name>
<value>/portlets/edit.jsp</value>
</init-param>
<supports>
<mime-type>text/html</mime-type>
<portlet-mode>view</portlet-mode>
<portlet-mode>edit</portlet-mode>
</supports>
<portlet-info>
<title>HelloWorld</title>
</portlet-info>
</portlet>
</portlet-app>
信息非常清楚，就不多做解釋了，edit-jsp的值是/portlets/edit.jsp，portlets容器就會去portlets目錄下尋找edit.jsp。supports元素指定了portlet支持的Model以及Mime類型。更詳細的配置請參考官方規(guī)范
最后就是edit.jsp，需要用到portlets規(guī)范規(guī)定的標簽，我們這里用到了actionURL，該標簽用于form的action的生成，觸發(fā)帶有參數(shù)的request請求的processAction調(diào)用，當然還有一個renderURL，顧名思義僅是用于呈現(xiàn)，而非action的觸發(fā)。請注意，form的method必須是post，因為portlets容器可能將一些狀態(tài)信息寫在url，使用post提交避免沖突。
<%@taglib uri="http://java.sun.com/portlet" prefix="portlet" %>
<portlet:defineObjects/>
<div>
<form method="post" action="<portlet:actionURL portletMode="view" windowState="normal"/>" >
please input your name:
<input type="text" name="name" size="10"/>
<input type="submit" value="submit"/>
</form>
在使用portlet規(guī)范規(guī)定的標簽前，一定要先使用<portlet:defineObjects/>
標簽，以便定義下列變量讓jsp使用：
renderRequest
renderResponse
portletConfig
我們通過actionURL標簽產(chǎn)生指向本portlet的url，并且指定沒有錯誤發(fā)生時這個portlet應(yīng)該具有的Model是view，窗口大小為normal。最后部署并運行，因為不同的portal的部署方式和所需要的其他配置文件各不相同，這里就不詳細介紹了。下面是在Bea Portal 10.0上的效果圖：
1.一開始看到的是view Model，輸出Hello World!View!:
2.點擊左上角的edit鏈接進入edit model:
3.輸入dennis,提交，轉(zhuǎn)到view model:
