http://wsx23410.blogchina.com/blog/article_95465.511451.html
Portlet開發(fā)基知識(shí)。
1.portlet.xml文件,放置在WEB_INF/portlet.xml下面。典型的例子:
<portlet>
<description>Description goes here</description>
<portlet-name>first</portlet-name>
<portlet-class>com.malani.examples.portlets.jsr168.FirstPortlet
</portlet-class>
<portlet-info>
<title>First</title>
</portlet-info>
</portlet>
portlet-class就是實(shí)現(xiàn)的類。可以和web.xml對(duì)照比較一下。
2.實(shí)現(xiàn)的Portlet類。和傳統(tǒng)的servlet一樣,portal容器來管理protlet的生命周期。它必須實(shí)現(xiàn)javax.portlet.Portlet接口。但是jsr168標(biāo)準(zhǔn)提供了一個(gè)方便類:GenericPortlet你可以直接
繼承它就ok了。
1)生命周期,同servlet一樣Portlet必須有自己生命周期。這定義在javax.portlet.Portlet接口中。它的方法是:init(),render(),processAction(),destroy().但創(chuàng)建portlet實(shí)例的時(shí)候調(diào)用init()方法。它完成一些需要花費(fèi)昂貴的資源的動(dòng)作。但實(shí)例被銷毀的時(shí)候,容器調(diào)用destroy方法來釋放這些資源。
Portlet規(guī)范清晰的區(qū)分了render請(qǐng)求和action請(qǐng)求的區(qū)別。renderRequest()會(huì)調(diào)用該portlet上的render()方法,actionRequst()會(huì)調(diào)用processAction()方法.要注意的是一次用戶完整的請(qǐng)求將是:portal頁面上的所有的protlet的 render()調(diào)用,該請(qǐng)求protlet的processAction()調(diào)用。具體看圖:

3.Portlet模式
VIEW模式是你必須實(shí)現(xiàn)的,EDIT,HELP模式是可選的。你可以通過修改doEdit()和doHelp()
方法來實(shí)現(xiàn)這些模式。另外還需要在portlet.xml配置模式:
<supports>
<mime-type>text/html</mime-type>
<portlet-mode>edit</portlet-mode>
<portlet-mode>help</portlet-mode>
</supports>
修改本文件但沒有實(shí)現(xiàn)該模式容器會(huì)拋出javax.portlet.PortletException異常.
實(shí)現(xiàn)window狀態(tài),注意JSR 168并沒有對(duì)這個(gè)進(jìn)行規(guī)定,但webLogic 完成了:
<portlet>
<portlet-name>state</portlet-name>
<supports>
<mime-type>text/html</mime-type>
<excluded-window-state>minimized</excluded-window-state>
<excluded-window-state>maximized</excluded-window-state>
</supports>
</portlet>
包含JSP文件:
上面的例子中我們?cè)赿oView方法中通過方法得到Writer實(shí)例,這樣可以輸出HTML片斷。但是,
我們并不推薦您這樣做。我們推薦您使用JSP來達(dá)到視圖-java的分離。為了包含一個(gè)特定的jsp
首先你必須得到PortletContext.在PortletContext中,通過調(diào)用getRequestDispatcher()方法
得到PorletRequestDispatcher,通過它的includer()方法來包含JSp例如;
// execute the necessary logic here...
PortletRequestDispatcher aDispatcher =
getPortletContext().getRequestDispatcher(
"/IncludePortlet/includeView.jsp"
);
aDispatcher.include(aRequest, aResponse);
處理動(dòng)作
在標(biāo)準(zhǔn)的web應(yīng)用程序中,提交表單,或者一個(gè)動(dòng)作url常見的。JSR168規(guī)范中定義了portlet taglib
來幫助我們完成這些工作:
<form action="<portlet:actionURL/>" method="post">
...
</form>
提交的話會(huì)自動(dòng)調(diào)用該portlet的processAction(ActionRequest aRequest, ActionResponse aResponse)方法,這就跟你傳統(tǒng)方式一樣了reqeust的getParameter()或者是getAttribute()來
得到傳來的參數(shù)。
processAction()方法設(shè)置response對(duì)象中的值。不要使用ActionRequest或ActionResponse對(duì)象的setAttribute()方法。值不會(huì)從processAction()傳遞到render()方法,而且在JSP中是不可用的。相反要使用ActionResponse對(duì)象的setRenderParameter()方法。這些render參數(shù)將對(duì)所有后續(xù)render請(qǐng)求可用,這一點(diǎn)與典型的Web應(yīng)用程序請(qǐng)求屬性很不相同。典型的Web application請(qǐng)求屬性只對(duì)于一個(gè)請(qǐng)求可用。另一方面,render請(qǐng)求參數(shù)對(duì)于許多后續(xù)render請(qǐng)求可用。render參數(shù)保持可用直到值被動(dòng)作的重新執(zhí)行顯式地修改或刪除。
所呈現(xiàn)的參數(shù)是怎樣顯示在JSP上的呢?應(yīng)使用來自portlet標(biāo)簽庫的defineObjects標(biāo)簽來定義portlet對(duì)象。該標(biāo)簽使renderRequest、renderResponse和portletConfig portlet對(duì)象在頁面中可用。參數(shù)通過調(diào)用renderRequest對(duì)象的getParameter()方法來顯示。請(qǐng)參考與所包含的源代碼示例中的favoriteColorView.jsp。
portlet FavoriteColor也展示了其他概念。第一個(gè)是如何在processAction()方法中用編程的方法改變portlet模式。調(diào)用ActionResponse對(duì)象的setPortletMode()方法來修改portlet模式。第二個(gè)概念是如何使用一個(gè)HTML鏈接來修改portlet模式。該鏈接使用來自portlet標(biāo)簽庫的renderURL標(biāo)簽生成。根據(jù)希望的portlet模式指定portletMode屬性的值。請(qǐng)參考源代碼示例中的FavoriteColorPortlet類和favoriteColorView.jsp頁面。