OpenDoc版權(quán)說明：
本文檔版權(quán)歸原作者所有。
在免費、且無任何附加條件的前提下，可在網(wǎng)絡(luò)媒體中自由傳播。
如需部分或者全文引用，請事先征求作者意見。
如果本文對您有些許幫助，表達謝意的最好方式，是將您發(fā)現(xiàn)的問題和文檔改進意見及時反饋給作者。當(dāng)然，倘若有時間和能力，能為技術(shù)群體無償貢獻自己的所學(xué)為最好的回饋。
序
隨著信息化建設(shè)的深入，Portal 門戶已經(jīng)成為新型辦公環(huán)境的一個重要組成部分。 Portal所提供的單點登錄、權(quán)限控制、個性化定制、內(nèi)容集成、文件管理等獨特的功能， 已經(jīng)大大占據(jù)公眾的眼球，并在信息集成和消除信息孤島方面發(fā)揮了重要的左右。
隨著Portal技術(shù)的成熟，以MyNestcape、MyYahoo、MSN-Space等為代表大型網(wǎng)站也較多的采用Portal架構(gòu)來實現(xiàn)個性化的內(nèi)容聚合和定制，以實現(xiàn)靈活的擴展的服務(wù)策略。
Liferay Portal作為一個開源的Portal項目，利用Hibernate、Struts、Spring等開源框架，實現(xiàn)了JCP JSR168規(guī)范中提出的Portal功能，在開源Portal系統(tǒng)中有比較典型的代表性。
本
文從Liferay Portal的架構(gòu)入手，詳細講解Portal的用戶策略、內(nèi)容布局、桌面和品質(zhì)的要素，引導(dǎo)讀者完成Liferay
Portal初步的二次開發(fā)，在Liferay Portal上定制自己的Portlet。Liferay
Portal程序框架和源碼分析不在本文的討論范圍。
目錄
第一部分 Liferay Portal 架構(gòu)解析
第一章 Liferay Portal
第一節(jié) Portal規(guī)范
1.1.1 JSR168
1.1.2 WSRP
第二節(jié) 什么是Portal
1.2.1 Portal 服務(wù)器
1.2.2 Portlet容器
第三節(jié) 什么是Portlet
1.3.1 Portlet
1.3.2 Portlet與Servlet的關(guān)系
1.3.3 Portlet的生命周期
第四節(jié) Liferay Portal工作原理
1.4.1 Portlet 樣式以及窗口狀態(tài)
1.4.2 Portal頁面
第二章Liferay Portal的使用
第一節(jié) Liferay Portal安裝
第二節(jié) Liferay Portal的用戶策略
2.2.1 定義用戶
2.2.2 添加用戶
2.2.3 修改用戶
2.2.4 定義用戶組
2.2.5 新增、重命名用戶組
2.2.6 修改用戶組
2.2.7 定義角色
2.2.8 新增、重命名角色
2.2.9 修改用戶組角色
2.2.10 定義Portlet的角色
第三節(jié) Liferay Portal內(nèi)容和布局
2.3.1 什么是布局
2.3.2 什么是內(nèi)容
2.3.3 內(nèi)容布局與Portlet的關(guān)系
2.3.4 選擇內(nèi)容和布局
第四節(jié) Liferay Portal的桌面
2.4.1 什么是桌面
2.4.2 定義個性化的桌面
第五節(jié) Liferay Portal的品質(zhì)
2.5.1 什么是品質(zhì) 30
2.5.2 品質(zhì)和Portlet、Portal的關(guān)系
2.5.3 定義個性化的品質(zhì)
第六節(jié) Liferay Portal的部署描述文件
2.6.1 web.xml
2.6.2 portlet.xml
2.6.3 liferay-Portlet.xml
2.6.4 liferay-display.xml
2.6.5 liferay-layout-templates.xml
2.6.7 liferay-look-and-feel。xml
第二部分 Liferay Portal 二次開發(fā)
第三章 開發(fā)自己的Portlet
第一節(jié) 重要的基類：GenericPortlet
第二節(jié) Portlet標(biāo)簽
3.2.1 defineObjects標(biāo)簽
3.2.2 renderURL標(biāo)簽
3.2.3 actionURL標(biāo)簽
3.2.4 param標(biāo)簽
3.2.5 namespace標(biāo)簽
第三節(jié) Portal的對象
3.3.1 Request對象
3.3.2 Response對象
3.3.3 PortletConfig對象
3.3.4 Session對象
3.3.5 Preference對象
第四節(jié) 編寫自己的Portlet類
3.4.1 開發(fā)環(huán)境
3.4.2 準(zhǔn)備工作
3.4.3 HelloWorldPortlet
3.4.4 HelloJSPPortlet
第五節(jié) 修改Web部署描述文件
第六節(jié) 創(chuàng)建Liferay Portal部署描述文件
第三部分 Liferay Portal部署
第四章 部署自己的Portlet
第一節(jié) 手動部署
第二節(jié) Ant自動部署
第三節(jié) 加入Liferay Portal自有列表
第四節(jié) 普通Java Web應(yīng)用轉(zhuǎn)化為Portlet應(yīng)用
第四部分 附錄
第五章 相關(guān)資源
第一節(jié) 資源網(wǎng)站
第二節(jié) 示例
第六章 參考資料
后序
第一部分 Liferay Portal 架構(gòu)解析
本部分主要內(nèi)容
Portal 服務(wù)器 Portal 容器 Portlet
第一章 Liferay Portal
作為一個開源Portal產(chǎn)品，Liferay Portal提供對多個獨立系統(tǒng)的內(nèi)容集成，幫助多個組織實現(xiàn)更有效的合作。與其他商業(yè)的Portal產(chǎn)品相比，Liferay Portal有著一系列的優(yōu)良特性，而且不需要付費。
第一節(jié) Portal規(guī)范
隨著Portal的興起，越來越多的公司開始涉足Portal產(chǎn)品開發(fā)，并組建各自的Portal組件和基于其的產(chǎn)品，比如IBM、BEA、MicroSoft、SAP、Apache等。各個廠商的接口互不兼容，給軟件開發(fā)商以及開發(fā)人員帶來諸多不便。
1.1.1 JSR168
為
此，JCP組織發(fā)布了JSR168(Java Specification Request)，Portlet Specification
V1.0，用來提供不同的Portal和Portlet之間的互通性。只要開發(fā)的Portlet遵循JSR168，則就可以在所有遵循JSR168的
Portal上部署運行。
JSR168中定義了Portal的實現(xiàn)規(guī)范和接口，并對理想的Portlet進行了詳細的規(guī)劃和描述。
1.1.2 WSRP
WSRP
是OASIS Web Service for Remote Portlet的縮寫。WSRP是Web
Service的一種新的商業(yè)應(yīng)用，一種新的標(biāo)準(zhǔn)，主要用來簡化Portal對于各種資源或者程序整合的復(fù)雜度，可以避免編程帶來的整合麻煩和問題。而且
Portal管理員可以從海量的WSRP服務(wù)中選擇需要的功能用以整合到目前所用的Portal中。它有三種角色：
①、生產(chǎn)者 提供Portlet
②、消費者 使用Portlet
③、終端用戶 最終用戶
它的特點在于生產(chǎn)者將消費者所需要的信息通過WSRP返回給消費者，這些信息是相對標(biāo)記片斷，例如HTML、XHTML等，可以直接嵌入用戶的頁面中，而不用像Web Service一樣開發(fā)用戶端接口。
實現(xiàn)這個規(guī)范，Portal可以跟各式各樣的數(shù)據(jù)源打交道，徹底終結(jié)信息孤島的窘境。
第二節(jié) 什么是Portal
Portal是基于Web的，以“應(yīng)用整合”和“消除信息孤島”為最終目的，提供單點登錄、內(nèi)容聚合、個性化門戶定制等功能的綜合信息系統(tǒng)。
完整的Portal通常由Portal服務(wù)器、Portlet容器、Portlet構(gòu)成。
1.2.1 Portal 服務(wù)器
Portal
服務(wù)器是容納Portlet容器，支持Portlet呈現(xiàn)的普通或者特殊Web服務(wù)器。Portal服務(wù)器通常會提供個性化設(shè)置、單點登錄、內(nèi)容聚合、信
息發(fā)布、權(quán)限管理等功能，支持各種信息數(shù)據(jù)來源，并將這些數(shù)據(jù)信息放在網(wǎng)頁中組合而成，提供個性化的內(nèi)容定制，不同權(quán)限的瀏覽者能夠瀏覽不同的信息內(nèi)容。
通常，Portal提供以下功能:
單點登錄：Portal通常采用ACL、SSL、LDAP等業(yè)界標(biāo)準(zhǔn)的安全技術(shù)，提供對所有現(xiàn)有應(yīng)用系統(tǒng)的安全
集成，只需在Portal的唯一入口上登錄一次，就可以訪問所有應(yīng)用系統(tǒng)和數(shù)據(jù)。對于安全性要求較高的應(yīng)用系統(tǒng)，如電子商務(wù)平臺、交易系統(tǒng)等，通過擴展接
口傳遞用戶身份信息，如數(shù)字證書信息、數(shù)字簽名信息等，進行二次身份認證，保證單點登陸的安全性。
權(quán)限控制:系統(tǒng)采用LDAP對用戶資源進行統(tǒng)一的管理，同時提供二次開發(fā)接口，可以與其他應(yīng)用系統(tǒng)的用戶管理模塊對接，并能隨相關(guān)業(yè)務(wù)系統(tǒng)實時更新訪問權(quán)限。通過完善的授權(quán)機制及存取控制，用戶訪問權(quán)限控制到字段級別，確保用戶只能訪問具有權(quán)限的應(yīng)用系統(tǒng)及相關(guān)信息。
內(nèi)容管理: 實現(xiàn)應(yīng)用系統(tǒng)之間實時交換信息。采用多種緩存機制，保證內(nèi)容交換的性能和準(zhǔn)確性。采用基于XML的Rich Site Summary (RSS)標(biāo)準(zhǔn)，迅速在各應(yīng)用系統(tǒng)之間傳播最新變化。
信息發(fā)布: 實現(xiàn)信息門戶內(nèi)容的動態(tài)維護。動態(tài)網(wǎng)站系統(tǒng)可與OA協(xié)同辦公系統(tǒng)、知識管理系統(tǒng)等集成，網(wǎng)站信息須經(jīng)OA系統(tǒng)的審批流程流轉(zhuǎn)通過后或知識管理平臺設(shè)置具有外部共享權(quán)限后才可正式發(fā)布，真正實現(xiàn)內(nèi)外信息發(fā)布的同步。
文
件管理:
系統(tǒng)實現(xiàn)無縫集成多種數(shù)據(jù)源，包括：數(shù)據(jù)庫、文檔（Office文檔、PDF、AutoCAD、甚至ZIP文檔）、Web網(wǎng)頁、FTP站點等，并對數(shù)據(jù)按
業(yè)務(wù)要求和職務(wù)特點加以分析整理，通過統(tǒng)一Web界面主動推送(Push)至用戶的門戶桌面，幫助用戶做出及時、正確的決策。
1.2.2 Portlet容器
Portlet容器提供Portlet執(zhí)行的環(huán)境，包含很多Portlet并管理它們的生命周期，保存Portlet的定制信息。
一
個Portal容器接收到來自Portal的請求后，接著將這個請求傳遞給存在Portal容器的Portlet
執(zhí)行。Portlet容器沒有義務(wù)去組合Portlet 產(chǎn)生的信息內(nèi)容，這個工作必須由Portal來處理。Portal和
Portal容器可以放在一起視為同一個系統(tǒng)的組件，或者分開成為兩個獨立的組件。
Portlet容器是普通Web
Servlet容器的擴展，所以一個Portlet容器可以構(gòu)建于一個已經(jīng)存在的Servlet容器或者可能實現(xiàn)全部Web
Servlet容器的全部功能。無論Portlet容器怎么實現(xiàn)，它的運行環(huán)境總是假定它支持Servlet2.3規(guī)范。
通常，Portlet容器擴展自普通的Servlet容器。
第三節(jié) 什么是Portlet
Portlet是Portal中最重要的
組件，負責(zé)在Portal中呈現(xiàn)信息內(nèi)容，有相應(yīng)的生命周期。通過自定義Portlet，用戶很容易定義個性化的Portal頁面。Portlet由
Portlet容器負責(zé)管理、處理請求并返回動態(tài)頁面，可以作為Portal的可即插即用的界面組件。
1.3.1 Portlet
一個Portlet是以Java技術(shù)為技術(shù)的Web組件，由Portlet容器所管理，專門處理客戶的 信息請求以及產(chǎn)生各種動態(tài)的信息內(nèi)容。Portlet 為可插式的客戶界面組件，提供呈現(xiàn)層成為一個信息系統(tǒng)。
這
些由Portlet產(chǎn)生的內(nèi)容也被稱為片段，而片段是具有一些規(guī)則的標(biāo)記( HTML、XHTML、WML
)，而且可以和其他的片段組合而成一個復(fù)雜的文件。一個或多個 Portlet 的內(nèi)容聚合而成為一個 Portal 網(wǎng)頁。而 Portlet
的生命周期是被 Portlet 容器所管理控制的。
客戶端和Portlet的互動是由Portal通過典型的請求/響應(yīng)方式實現(xiàn)，正常來說，客
戶會和Portlet所產(chǎn)生的內(nèi)容互動，舉例來說，根據(jù)下一步的連接或者是確認送出的表單，結(jié)果
Portal將會接收到Portlet的動作，將這個處理狀況轉(zhuǎn)向到目標(biāo)Portlet。這些Portlet
內(nèi)容的產(chǎn)生可能會因為不同的使用者而有不同的變化，完全是根據(jù)客戶對于這個Portlet的設(shè)置。
1.3.2 Portlet與Servlet的關(guān)系
Portlet
被定義成為一個新的組件，具有新的明確的界面與行為。為了盡可能與現(xiàn)有的 Servlet 結(jié)合達到重復(fù)使用的目的，Portlet 的規(guī)范利用了
Servlet 的規(guī)范，許多觀念都很相似的，結(jié)合 Portlet、Servlet 及 Jsp 在同一個網(wǎng)站系統(tǒng)中，我們稱為Portlet 應(yīng)用
。在同一個 Portlet 應(yīng)用 中，他們將分享同一個類加載器(ClassLoader)，上下文(Context) 及 Session。
①、Portlet 和 Servlet 的相似之處
@ Portlet 也是 Java 技術(shù)的 web 組件
@ Portlet 也是有特定的 container 在管理
@ Portlet 可以動態(tài)產(chǎn)生各種內(nèi)容
@ Portlet 的生命周期由 container 所管理
@ Portlet 和客戶端的互動是通過 request/response 的機制
②、Portlet 和 Servlet 也有一些不同
@ Portlet 只產(chǎn)生 markup 信息片段，不是完整的網(wǎng)頁文件。而 Portal 會將所有的 Portlet markup 信息片段放到一個完整的 Portal 網(wǎng)頁。
@ Portlet 不會和 URL 有直接的關(guān)系
@ 客戶端必須通過 portal 系統(tǒng)才能和 Portlet 互動
@ Portlet 有一些定義好的 request 處理，action request 以及 render request。
@ Portlet 默認定義 Portlet modes 及窗口狀態(tài)可以指出在網(wǎng)頁中該 Portlet 的哪個功能正在執(zhí)行及現(xiàn)在的 狀態(tài)。
@ Portlet 可以在同一個 portal 網(wǎng)頁之中存在多個。
③、Portlet 有一些附加的功能是 Servlet 所沒有的
@ Portlet 能夠存取及儲存永久配置文件及定制資料。
@ Portlet 可以存取使用者數(shù)據(jù)
@ Portlet 具有 URL 的重寫功能在文件中去動態(tài)建立連結(jié)，允許 portal server 不用去知道如何在網(wǎng)頁的片 段之中建立連結(jié)及動作。
@ Portlet 可以儲存臨時性的數(shù)據(jù)在 Portlet session 之中，擁有兩個不同的范圍 ：
application-wide scope 及 Portlet private scope 。
④、Portlet 不具有一些功能， 但是 Servlet 卻有提供
@ Servlet 具有設(shè)置輸出的文字編碼( character set encoding)方式
@ Servlet可以設(shè)置 HTTP 輸出的 header
@ Servlet才能夠接收客戶對于 portal 發(fā)出的 URL 請求
1.3.3 Portlet的生命周期
一個Portlet有著良好的生命周期管理，定義了怎樣裝載，實例化和初始化，怎樣響應(yīng)來自客戶端的請求及怎樣送出服務(wù)。這個Portlet生命周期由Portlet接口的init，processAction，render和destroy方法來表達。
載入和實例化:Portlet容器負責(zé)載入和實例化Portlet。當(dāng)Portlet容器運行Portlet應(yīng)用或者延遲到Portlet需要服務(wù)使用者的請求時，Portlet就會被載入并實例化。載入Portlet類后，Portlet類隨即被實例化。
初
始化:Portlet類實例化后，Portlet容器還需要初始化Portlet。以調(diào)用Portlet去響應(yīng)客戶端的請求。Portlet容器呼叫
Portlet接口中的init方法初始化Portlet。擴展自PortletConfig的類可以取出定義在部署描述文件中的初始化參數(shù)，以及
Resource Bundle。
初始化異常:在 Portlet初始化期間，Portlet可能會丟出
UnavailableException 或 PortletException 異常。此時，Portlet容器不能把
Portlet置入已啟動的服務(wù)，并且 Portlet容器必需釋放這個 Portlet。
destory方法不能被呼叫，因為初始化被認為執(zhí)行失敗。發(fā)生 失敗后，Portlet容器會嘗試著重新實例化及初始化
Portlet。這個異常處理的規(guī)則是：由一個UnavailableException
指定一個不能執(zhí)行的最小時間，當(dāng)此異常發(fā)生時，Portlet容器必需等到指定時間過去后才產(chǎn)生并且初始化一個新的 Portlet。
在初始化過程中所丟出的 Runtime Exception異常，被當(dāng)作 PortletException 來處理。
第四節(jié) Liferay Portal工作原理
Portal系統(tǒng)根據(jù)需要由一個或者多個Portal頁面組成，每個Portal頁面包含零個或者多個的Portlet。每個Portlet呈現(xiàn)自己的信息內(nèi)容，以此實現(xiàn)內(nèi)容聚合。通過定義每個Portlet的可用權(quán)限，實現(xiàn)個性化的桌面信息定制。
1.4.1 Portlet 樣式以及窗口狀態(tài)
圖1.4.1-1
圖1.4.1-2
JCP
組織提出的JSR168規(guī)范定義了Portlet的實現(xiàn)標(biāo)準(zhǔn)。每個Portlet對外表現(xiàn)為一個小窗口，有自己的默認樣式和窗口狀態(tài)。如上圖，
Portlet有自己的標(biāo)題，瀏覽狀態(tài)下支持編輯、關(guān)閉、上移、下移、最大化、最小化功能，編輯狀態(tài)下支持返回和關(guān)閉功能。從各種數(shù)據(jù)來源提取的信息以
Portlet內(nèi)容的形式呈現(xiàn)在Portal中。
Portlet樣式指出 Portlet正處于什么模式，Portlet通常會根據(jù)所處的模式而執(zhí)行不同的工作并產(chǎn)生不同的內(nèi)容。
Portlet模式讓 Portlet決定它該顯示什么內(nèi)容和執(zhí)行什么動作。調(diào)用一個 Portlet的時候，Portlet 容器會提供一個 Portlet模式給那個 Portlet。當(dāng)在處理一個請求動作時，Portlet 的模式是可以用程序來改變的。
JSR168規(guī)范定義了三個Portlet模式： 瀏覽、編輯和幫助，Liferay Portal支持其中的全部三個模式。同時Portal是可以根據(jù)使用者的角色，來決定是要提供(顯示)哪幾個 Portlet 模式給使用者操作。
例如，匿名使用者可以操作瀏覽和幫助等 Portlet 模式的內(nèi)容， 而只有授權(quán)過的使用者可以操作編輯這個 Portlet 模式所提供的內(nèi)容或動作。
在瀏覽這個Portlet模式里，所被期望要提供的功能是產(chǎn)生標(biāo)記語言來表現(xiàn)此時 Portlet的狀態(tài)。 舉例來說， Portlet的 瀏覽 模式可以包含一個或多個畫面讓使用者可以瀏覽與互動， 或是一些不需要與使用者互動的靜態(tài)內(nèi)容。
在編輯這個Portlet模式里， Portlet 需要提供內(nèi)容和邏輯來讓使用者定制 Portlet 的行為。典型的說， 編輯模式的 Portlet 會設(shè)定或更新 Portlet 的參數(shù)設(shè)定值。
在幫助這個模式里，Portlet應(yīng)該提供有關(guān)這個 Portlet的幫助信息。這個幫助信息可以是有關(guān)這個 Portlet的簡單且條理清楚的視窗說明或是詳細的說明整個來龍去脈。所有的Portlet并不需要都提供幫助這個模式。
一
個 Portlet可以根據(jù)窗口狀態(tài)來決定在一個頁面里該占多少空間。 當(dāng)調(diào)用一個 Portlet時， Portlet容器 需要告訴該
Portlet目前的窗口狀態(tài)。 此時 Portlet可以根據(jù)窗口狀態(tài)來決定它該對多少信息作處理。 在處理請求的過程中，
Portlet可以通過程序的方式來改變窗口狀態(tài)。
1.4.2 Portal頁面
圖1.4.2-1
每個Portal
頁面包含零個或者多個Portlet小窗口，構(gòu)成一個完整的信息呈現(xiàn)頁面。Portal在啟動之后根據(jù)Portlet配置文件等信息，給Portlet的
標(biāo)題等屬性賦值，賦予Portlet編輯、關(guān)閉等各種控制按鈕，使Portlet成為一個標(biāo)準(zhǔn)的Portlet窗口。Portlet合并這些
Portlet窗口，組成一個完整的文檔，即Portal頁面。每個Portlet都處于相應(yīng)的布局當(dāng)中，呈現(xiàn)事先定義的內(nèi)容，表現(xiàn)Portal公共的品
質(zhì)。而且Portlet可以在不同的布局之間切換。Portlet響應(yīng)客戶端的請求，并將請求提交到相應(yīng)的URL進行邏輯處理。
Portlet開發(fā)完畢之后，部署到Portal服務(wù)器，由Portal服務(wù)器負責(zé)組織、權(quán)限控制和呈現(xiàn)。Portal頁面創(chuàng)建過程如下:
Portlet 在 Portlet容器內(nèi)執(zhí)行，Portlet容器接收 Portlet產(chǎn)生的內(nèi)容。通常 Portlet容器將這些內(nèi)容提交給 Portlet服務(wù)器，Portlet服務(wù)器依照這些內(nèi)容建立Portal頁面，然后將它傳給客戶端呈現(xiàn)。具體流程如下圖:
Portlet 在 Portlet容器內(nèi)執(zhí)行，Portlet容器接收 Portlet產(chǎn)生的內(nèi)容。通常 Portlet容器將這些內(nèi)容提交給 Portlet服務(wù)器，Portlet服務(wù)器依照這些內(nèi)容建立Portal頁面，然后將它傳給客戶端呈現(xiàn)。具體流程如下圖:
Portal頁面的請求過程如下:
使
用者經(jīng)由客戶端設(shè)備（例如瀏覽器）存取 Portal，Portal 根據(jù)接收到的請求決定哪些 Portlet 需要被執(zhí)行以滿足需求。Portal
通過Portlet容器呼叫 Portlet，然后由 Portlet產(chǎn)生的片段建立Portal頁面，再傳回客戶端呈現(xiàn)給使用者。具體流程如下圖:
|
第二章Liferay Portal的使用
Liferay Portal分為Professional 和 Enterprise兩個版本。
Liferay
Portal支持多個應(yīng)用服務(wù)器和Servlet容器。Liferay Portal
Ent版本需要一個健壯的J2EE服務(wù)器，而Pro版本只要一個普通的Servlet服務(wù)器就可以運行。如果需要運行EJB，建議使用Pro版本。兩個版
本的源碼和應(yīng)用接口都是一樣的。
默認的，Pro版本分別集成Tomcat / Jetty / Resin作為Web服務(wù)器，采用Struts作為Web框架，實現(xiàn)輕量級的系統(tǒng)架構(gòu)。Enterprise集成JBoss作為Web服務(wù)器，采用Spring作為Web框架，兼顧EJB。
Liferay Portal默認集成HSQL數(shù)據(jù)庫，來持久化保存用戶自定義的數(shù)據(jù)。通過修改集成在Liferay Portal的Tomcat的部署描述文件，用戶可以更改數(shù)據(jù)源。Liferay Portal官方網(wǎng)站提供了數(shù)據(jù)庫表的生成腳本。
下面以Pro版本(Tomcat服務(wù)器)為例，講述Liferay Portal的用戶策略、內(nèi)容布局、桌面和品質(zhì)。
第一節(jié) Liferay Portal安裝
由于Liferay Portal Pro版本集成了Tomcat服務(wù)器V5，所以只要把應(yīng)用包下載解壓就可以直接運行。
1、
從 http://www.iferay.om/web/guest/downloads/portal_pro 下載Pro版本zip包，
解壓到目錄{PORTAL_HOME}， 目錄結(jié)構(gòu)相對普通的Tomcat增加了Liferay文件夾。Liferay是默認的Web應(yīng)用。
2、正確安裝JDK1.4或者JDK1.5，并在環(huán)境變量里面正確配置JAVA_HOME變量。
圖2.1-1
3、從命令行啟動{PORTAL_HOME}/bin/startup.bat，啟動Liferay Portal。
4、在瀏覽器地址欄輸入http://localhost ，訪問Portal首頁。
5、用Login為test@liferay.com密碼為test的用戶登錄Portal系統(tǒng)，得到的是一個Demo的首頁。如果啟動呈現(xiàn)異常，請查看Tomcat控制臺查找原因。
Liferay Portal啟動之后，HSQL數(shù)據(jù)庫自動啟動。
登錄系統(tǒng)后，點擊右上角“My Account”鏈接，在“Display”選項卡中將Language改為“Chinese(China)”，以便中文化Portal界面。
第二節(jié) Liferay Portal的用戶策略
Liferay Portal通過定義嚴(yán)謹?shù)挠脩舨呗?、靈活的可個性化定制的內(nèi)容和布局以及豐富可定制的品質(zhì)策略，實現(xiàn)靈活的可定制的產(chǎn)品理念。
Liferay
Portal采用用戶－用戶組－角色－Portlet的關(guān)聯(lián)方式來實現(xiàn)用戶權(quán)限的管理。用戶錄屬于用戶組（也可以單獨存在），該用戶組具有某種（多種）角
色，角色分配給用戶組，也可以直接分配給用戶。而操作某個Portlet 需要具有其指定的角色。下面通過實例操作，來了解和體驗一下Liferay
Portal的用戶管理策略。
2.2.1 定義用戶
Liferay
Portal的用戶管理在系統(tǒng)管理的Portlet中。缺省只有系統(tǒng)管理員才能使用。登錄Portal后，可以在默認的桌面上找到“系統(tǒng)管理”
Portlet。如果沒有，從頁面底部的選擇框中選擇“系統(tǒng)管理”添加上。也可以通過右上角“CMS”桌面的“內(nèi)容和布局”頁面找到管理入口。
從“系統(tǒng)管理”Portlet中選擇“用戶”項，進入用戶管理界面。2.2.2 添加用戶
圖2.2.1-2所示頁面右邊為“新增用戶”列，
填入你所要增加的用戶名稱，姓氏，用戶標(biāo)識（可自動生成），郵件地址，密碼（可自動生成）等?？梢孕薷脑撚脩羲哂械挠脩艚M和角色信息（也可創(chuàng)建之后再修
改）。用戶標(biāo)識必須是系統(tǒng)唯一的，所以請確保你所輸入的用戶標(biāo)識與已有的不沖突。
點擊“新增用戶”，我們成功增加一位用戶標(biāo)示為“educhina”的用戶，如圖2.2.1-2所示。左側(cè)列表中新增一項“educhina eamoi”。然后我們就可修改這位用戶的用戶組，角色，個人檔案等信息了。
2.2.3 修改用戶
選擇用戶列表中一項，然后點擊底部的三個編輯按鈕，就可以分別編輯該用戶的用戶組、角色、檔案等信息了。
此處我們選擇用戶“educhina eamoi”，然后選擇“編輯檔案”，出現(xiàn)檔案編輯頁面。如圖2.2.3-3所示。填寫你想要修改的信息，點擊對應(yīng)的“更新”按鈕即可完成修改。需要注意的是整個檔案頁面分成幾個部分，需要分別修改更新。
選
擇用戶“educhina
eamoi”，然后選擇“編輯角色”，進入角色編輯頁面，如圖2.2.3-4所示。左側(cè)列表框為當(dāng)前該用戶所具有的角色，右側(cè)列表為所有可用的角色。要賦
給用戶新角色，則從右側(cè)選擇一項或多項，通過中間的轉(zhuǎn)移按鈕，從右側(cè)添加至左側(cè)。要刪減用戶角色，則從左側(cè)移至右側(cè)。最后點擊底部的“更新”即可。更新完
頁面會自動返回。
編輯用戶組的操作同上。2.2.4 定義用戶組
用戶組是對具有相同角色的用戶的聚合。只要把用戶需要的角色賦給用戶組，則該用戶組內(nèi)所有的用戶就都具備了該角色，具有該角色所有的權(quán)限，這樣子就簡化了用戶權(quán)限管理。
用戶組還有一個共用首頁面的概念，是該用戶組所有用戶共享的頁面。這些用戶可以看到一個內(nèi)容布局一致的頁面，用以在用戶組中共享信息。
從系統(tǒng)管理中選擇[用戶組]項，進入用戶組定義頁面。如圖2.2.4-1所示：
圖2.2.4-1
2.2.5 新增、重命名用戶組
圖中左側(cè)為用戶組列表，右側(cè)為新增，和重命名。
在新增部分直接添入用戶組名稱，點擊“新增用戶組”即可。
選擇列表中一個用戶組，然后在右側(cè)下方添入要修改的新組名，點擊“更新”既可。
“友好的URL”為該用戶組的共用首頁面設(shè)置URL。
2.2.6 修改用戶組
對于用戶組我們可以修改它的角色，所包含的用戶和該用戶組的共用首頁面。
選擇用戶組列表中一項，然后點擊底部的“編輯角色”，進入用戶組角色編輯頁面，如圖2.2.6-1所示。頁面左側(cè)為用戶組當(dāng)前已具備的角色，右側(cè)為所有可用角色。添加刪除操作同[2.2.3修改用戶]。更新完會自動返回用戶組列表頁面。
圖2.2.6-1
選擇用戶組列表中一項，然后點擊底部的“編輯用戶”，進入用戶組用戶編輯頁面，如圖2.2.6-2所示。頁面左側(cè)為用戶組 當(dāng)前包含的用戶，右側(cè)為所有用戶。添加刪除操作同[2.2.3修改用戶]。更新完會自動返回用戶組列表頁面。
圖2.2.6-2
選擇用戶組列表中一項，然后點擊底部的“編輯頁面”，進入用戶組首頁編輯頁面，如圖2.2.6-3所示。
首先增加一個新頁。在“處理子頁”一欄，填入新頁的名字，選擇類型，點擊“新增頁面”，左側(cè)樹狀列表中會增添一個以新頁名字為標(biāo)題的新項。
然后為新頁設(shè)置布局。點擊左側(cè)列表中的新頁，右側(cè)出現(xiàn)布局編輯頁面，如圖2.2.6-4所示。詳細設(shè)置布局的操作可參考所述。
圖2.2.6-4
2.2.7 定義角色
角色是對用戶身份的一種定義。不同的角色具有不同的權(quán)限。被賦予這種角色的用戶自然就獲得了該角色的權(quán)限。
從系統(tǒng)管理中選擇[角色]項，進入角色定義頁面。如圖2.2.7-1所示。
圖2.2.7-1
2.2.8 新增、重命名角色
圖中左側(cè)為角色列表，右側(cè)為新增，和重命名。
在新增部分輸入角色名稱，點擊“新增角色”即可新增一個角色。
選擇列表中一個角色，然后在右側(cè)下方對應(yīng)欄位填入新角色名，點擊“重命名角色”即可重命名該角色。
2.2.9 修改用戶組角色
對于角色，我們可以修改它的用戶組和用戶。該操作可以通過修改用戶組和用戶的角色來完成。
選擇角色列表中一項，然后點擊底部的“編輯用戶組”，進入角色的用戶組編輯頁面，如圖2.2.9-1所示。頁面左側(cè)為已具備當(dāng)前角色的用戶組，右側(cè)為所有用戶組。添加刪除操作同[2.2.3修改用戶]。更新后自動返回角色列表頁面。
|
選擇角色列表中一項，然后點擊底部的“編輯用戶”，進入角色的用戶編輯頁面，如圖2.2.9-2所示。頁面左側(cè)為已具備當(dāng)前角色的用戶，右側(cè)為所有用戶。添加刪除操作同[2.2.3修改用戶]。更新后自動返回角色列表頁面。
圖2.2.9-2
2.2.10 定義Portlet的角色
通過為Portlet設(shè)置必需的角色，我們實現(xiàn)了用戶與Portlet的關(guān)聯(lián)。只有當(dāng)用戶或所屬的用戶組具有Portlet所必需的角色，他才能操作該Portlet。
從系統(tǒng)管理中選擇[Portlet]項，進入Portlet定制頁面。如圖2.2.10-1所示。頁面中顯示了目前系統(tǒng)中可用的Portlet列表，列表中顯示了Portlet目前的狀態(tài)和必需的角色。
圖2.2.10-1
選擇一個Portlet，點擊“編輯”進入Portlet定制頁面，如圖2.2.10-2所示。頁面左側(cè)為Portlet必需的角色，右側(cè)為所有角色。添加刪除操作同[2.2.3修改用戶]。
圖2.2.10 - 2
第三節(jié) Liferay Portal內(nèi)容和布局
Portlet
容器采用布局來對包含的Portlet進行管理并呈現(xiàn)，不同的布局決定了不同的Portlet呈現(xiàn)效果。每個加入到Portal服務(wù)器的Portlet必
須屬于某個布局，才能夠被使用者所看到。內(nèi)容則是Portlet對外呈現(xiàn)的信息片斷，是Portlet的核心。兩者都是Portal的重要組成部分。
Liferay Portal采用開源框架Struts的Tiles來管理內(nèi)容和布局。
2.3.1 什么是布局
布局，即Layout，也可以稱為布局管理器，是Portlet容器管理Portlet的一個重要工具。一個布局，在生成的Portal頁面中，呈現(xiàn)出單行多列或者多行多列的效果。而Portlet就內(nèi)嵌在某一列中。
在Liferay Portal中，將列分為寬欄和窄欄。通常，寬欄占據(jù)頁面2/3的寬度，窄欄占據(jù)頁面1/3的寬度。每個Portlet在部署的時候都必須在部署描述符文件中指定Portlet是被部署在寬欄或者窄欄當(dāng)中，默認是部署在寬欄中。
圖 2.3.1-1
Liferay
Portal采用tpl文件來定義布局，這些tpl文件存儲在{PORTAL_HOME}
/liferay/html/layouttpl文件夾中。在tpl文件中，規(guī)定每個列的寬度。當(dāng)Portlet加入到列中時，取得當(dāng)前列的寬度，然后根
據(jù)這個寬度確定Portlet窗口的顯示寬度。tpl文件采用標(biāo)準(zhǔn)的HTML代碼和Liferay Portal自定義的標(biāo)簽來定義布局。如下圖:
圖2.3.1-2
只要把定義的tpl文件路徑加入到部署描述文件中，Liferay Portal在啟動的時候就可以自動載入，供系統(tǒng)調(diào)用。如下圖:
Liferay Portal默認的布局允許有一列、二列、三列的布局。二次開發(fā)的時候可以定義自己的布局文件。
在每個列的底部，有一個下拉列表框，列出本列可用的所有Portlet。列表框旁邊的“添加”按鈕，則可以將選中的按鈕添加到列中顯示。
圖2.3.1-4
圖2.3.1-5
圖2.3.1-6
2.3.2 什么是內(nèi)容
內(nèi)容具體指Portlet顯示出來的標(biāo)記片斷，稱為Portlet內(nèi)容。通常，當(dāng)Portlet窗口處于瀏覽或者編輯狀態(tài)的時候，就會表現(xiàn)相應(yīng)的Portlet內(nèi)容。內(nèi)容在開發(fā)Portlet的時候確定。
Portlet對各種來源的數(shù)據(jù)進行加工和邏輯處理，最后輸出為一些規(guī)則的標(biāo)記(HTML、XHTML、WML)，最后在Portlet容器中形成Portlet窗口，供Portal組合成為Portal頁面。
內(nèi)容是Portlet的信息主體，它形成的表單、鏈接等同時接受使用者的信息請求或者數(shù)據(jù)提交，并將系統(tǒng)對使用者請求的響應(yīng)呈現(xiàn)在客戶端。下圖為以日歷為內(nèi)容的Portlet。
圖2.3.2-1
2.3.3 內(nèi)容布局與Portlet的關(guān)系
通
過定義布局，對Portlet進行有效管理，是Liferay
Portal容器組織Portlet的有效方式。在相同的列中，Portlet可以很容易的調(diào)整位置。當(dāng)列中的Portlet數(shù)量超過一個的時候，通過
Portlet右上角的“上移”和“下移”按鈕，可以調(diào)整相鄰Portlet的上下位置。當(dāng)Portlet的內(nèi)容較長的時候，可以把Portlet部署到
寬欄中，占據(jù)更大的屏幕空間，以有效的顯示數(shù)據(jù)。相應(yīng)的，如果Portlet內(nèi)容較少時，可以把Portlet部署到窄欄中。
圖2.3.3-1
每個Portlet在定義的時候，可以在部署描述文件中定義Portlet所屬的類(Category)，每個類可用的布局，這些定義也可以啟動Portal之后在“內(nèi)容與布局”選項卡中修改。
在“修改布局”子選項卡中可以修改的包括桌面的標(biāo)識，如果是單行兩列的布局，還可以調(diào)整寬欄和窄欄的位置。如下圖:利用Liferay Portal提供的工具，可以很方便的修改布局內(nèi)容和它被顯示在Portal頁面的什么地方。
|
在“處理孩子”子選項卡中，可以定義每個Portal頁面的子頁面，形成頁面樹。根節(jié)點的子頁面會平行的出現(xiàn)在桌面上。如下圖:
圖2.3.3-4
Portal
是大量信息和系統(tǒng)的集成。Portlet內(nèi)容往往來源與集成的各個系統(tǒng)。Portlet面向的用戶通常也是復(fù)雜的。除了在用戶策略中合理定義
Portlet的用戶策略外，也可以對Portlet內(nèi)容進行過濾，針對相應(yīng)的用戶顯示適當(dāng)?shù)男畔?。?dāng)然，這種方法沒有定義用戶策略那樣來得直觀。
2.3.4 選擇內(nèi)容和布局
Liferay Portal內(nèi)置了數(shù)個Portlet應(yīng)用，包括系統(tǒng)管理、日歷、書簽等等。目前，Liferay Portal支持單行單列、單行兩列、單行三列的布局顯示，可以在相應(yīng)桌面的“內(nèi)容和布局”中選擇。
每個默認的Portlet則來自于各個數(shù)據(jù)源的既有數(shù)據(jù)，或者對該數(shù)據(jù)的重新加工處理。通過定義Portlet所屬類別和相應(yīng)的用戶策略，成功實現(xiàn)Portlet的合理顯示。
Liferay Portal提供了基于Web的工具，可以很方便的在幾種默認的布局之間切換。
①、登錄系統(tǒng)后，選擇桌面當(dāng)中的“內(nèi)容和布局”，進入布局管理頁面。
②、選中桌面的第一級節(jié)點，然后在“列數(shù)”中選擇需要的列數(shù)。
③、點擊底部的“更新頁”按鈕，提交選擇。布局修改生效。返回桌面。
可以看到，單行單列的布局默認是一個寬欄；單行兩列的布局默認是一個寬欄和一個窄欄；單行三列的布局默認是三個窄欄。
第四節(jié) Liferay Portal的桌面
2.4.1 什么是桌面
定義個性化的桌面是Portal的標(biāo)準(zhǔn)功能之一。用戶可以把任何允許的Portlet添加到桌面上，構(gòu)建符合自己需求的信息集合。
桌面是用戶定義的Portlet的集合，也是Portlet內(nèi)容的最終呈現(xiàn)媒介之一，可以是一個Portal頁面，或者是一個Portal頁面集合，里面包含一個或者多個的Portlet。每個桌面通常用一個或者多個布局來管理桌面上的Portlet。
Portlet
在部署之前，會在部署描述文件中定義該Portlet可用的用戶組和角色。在定義了用戶所屬的用戶組和角色之后，就可以在桌面下方的添加列表中看到該用戶
可用的所有Portlet。用戶可以把任何符合該用戶角色權(quán)限的Portlet添加到相應(yīng)的布局中。這些Portlet和桌面的定制信息會被Portal
服務(wù)器持久化保存。
圖2.4.1-1
Portal啟動之后，根據(jù)定制的Portlet和桌面信息，搜索并實例化Portlet，構(gòu)建Portal頁面，把Portlet內(nèi)容顯示在用戶定制的桌面上。
2.4.2 定義個性化的桌面
在
完成用戶策略、Portlet定義之后，登錄Liferay
Portal，就可以進行個性化桌面的定制了。用戶登錄進入到相應(yīng)的桌面后，在相應(yīng)的布局列底部可以看到可用的全部Portlet列表。選中某個
Portlet，點擊“添加”按鈕，將選中的Portlet添加到列中。對已經(jīng)添加到列中的全部Portlet，可以通過點擊Portlet窗口右上角的
“上移”、 “下移”按鈕，調(diào)整Portlet窗口的位置。也可以點擊Portlet窗口右上角的“最大化”
、“最小化”按鈕，改變窗口的狀態(tài)。定制完畢的桌面效果如下圖:第五節(jié) Liferay Portal的品質(zhì)
Liferay Portal支持個性化的皮膚和外觀設(shè)計，并將此作為品質(zhì)單獨管理。
2.5.1 什么是品質(zhì)
品質(zhì)是Liferay Portal的外觀，包括題材和色彩設(shè)計兩個部分。題材主要影響Portlet窗口的樣式和Portal的整體效果，包括Portlet邊框格式、功能按鈕、Portal頁面效果等等。色彩設(shè)計主要影響Portal的CSS樣式效果。
Liferay Portal默認定義了多種題材效果和色彩設(shè)計效果。使用者可以在“品質(zhì)”選項卡中很容易的選擇自己滿意的品質(zhì)。
2.5.2 品質(zhì)和Portlet、Portal的關(guān)系
品質(zhì)跟Portlet和Portal的呈現(xiàn)效果有很大的關(guān)系。通常應(yīng)該根據(jù)Portlet內(nèi)容選擇適當(dāng)?shù)钠焚|(zhì)即題材和色彩設(shè)計。
題材對Portal的影響主要體現(xiàn)在背景和整體風(fēng)格上面，以及Portlet和其他功能菜單的布局位置。色彩設(shè)計主要影響Portal的字體大小以及顏色等效果。
題材主要控制Portlet生成的窗口的樣式效果，包括邊框效果、標(biāo)題樣式等等。色彩主要控制Portlet窗口的字體效果，包括字體大小、字體顏色等等。
選擇合適的題材和色彩設(shè)計對于Portal頁面的整體呈現(xiàn)效果有明顯的影響。如下圖:
圖2.5.2-1 采用不同的色彩設(shè)計得到的Portal頁面
圖2.5.2-2 采用不同的題材效果得到的Portal頁面
2.5.3 定義個性化的品質(zhì)
用戶登錄Portal系統(tǒng)之后，點擊功能菜單上的“品質(zhì)”，進入品質(zhì)定制頁面。選擇適當(dāng)?shù)念}材和色彩設(shè)計，相應(yīng)的品質(zhì)效果立即生效。
返回桌面查看品質(zhì)效果。
使用者可以在二次開發(fā)的時候定義自己的品質(zhì)，只要按照規(guī)范，在部署描述文件中定義可用的品質(zhì)，Liferay Portal就可以自動調(diào)用。如下圖:
第六節(jié) Liferay Portal的部署描述文件
跟所有的Web應(yīng)
用一樣，Liferay
Portal采用多個XML部署描述文件，來初始化部署信息，規(guī)范操作模式，比如Portlet的初始化信息、可用的Portlet列表、Portlet
所屬角色和用戶組等等。通過這些部署描述文件，Liferay
Portal可以在啟動的時候自動加載Portlet，根據(jù)需要生成所需的Portlet頁面。普通的Web應(yīng)用，也可以很方便的轉(zhuǎn)換成可部署的
Portlet。這種實現(xiàn)也是JSR168所規(guī)定的。
2.6.1 web.xml
web.xml是所有Java Web應(yīng)用的部署描述文件。其正式的規(guī)范由http://java.sun.com/dtd/web-app_2_3.dtd 定義。
與其他普通Web應(yīng)用相比，Liferay Portal的Portlet 應(yīng)用還需要在web.xml中增加如下內(nèi)容：
a、監(jiān)聽器：
這個要求web 服務(wù)器監(jiān)聽所有跟Portlet有關(guān)的請求信息，并將監(jiān)聽到的內(nèi)容交給Liferay Portal的Portlet容器處理。
b、Portlet Servlet映射：
其
中，servlet-name為部署的servlet名稱；init-param中定義自己的Portlet類，這個param-name要跟
portlet.xml、liferay-portlet.xml、liferay-display.xml中的portlet-name節(jié)點值一致。
c、標(biāo)簽庫映射：
定義了這個標(biāo)簽庫映射，在JSP文件中才可以使用諸如<portlet:defineObjects />在內(nèi)的一些特定的Portlet標(biāo)簽。
如果在應(yīng)用中有用到其他的元素，可以按照web.xml規(guī)范加入到相應(yīng)的位置當(dāng)中。
Liferay Portal默認的liferay應(yīng)用，由于使用了Struts、Hibernate、Spring在內(nèi)的多個開源框架，所以{PORTAL_HOME}/liferay/WEB-INF/web.xml文件會相對復(fù)雜些。
在自定義的Portlet，可以使用getPortletConfig().getInitParameter(“ ”)和getPortletConfig().getParameterNames(“”)兩個方法來取得在web.xml中定義的參數(shù)。
2.6.2 portlet.xml
portlet.xml
用來定義Portlet的諸如部署名稱、初始化參數(shù)、支持模式、resource
bundle等普通的初始化信息，包括：portlet-name、display-name、portlet-class、init-param、
expiration-cathe、supports、portlet-info、security-role-ref等等。其正式的規(guī)范請參考：
http://java.sun.com/xml/ns/Portlet/Portlet-app_1_0.xsd
。根目錄為portlet-webapp。
portlet-name：Portlet的規(guī)范名稱，在Portlet應(yīng)用中必須唯一，主要用在Portlet部署和映射中。
display-name：供部署工具調(diào)用的Portlet簡稱，在Portlet應(yīng)用中必須唯一。
portlet-class：Portlet對應(yīng)的類，這個類必須直接或者間接的繼承javax.Portlet.GenericPortlet。
init-param：初始化參數(shù)，有成對的<name>和<value>子元素。通常定義Portlet相應(yīng)模式下可用的JSP頁面。
expiration-cathe：定義Portlet加載允許最長的過期時間，以秒為單位。-1代表用不過期。
supports：定義Portlet支持的模式。所有的Portlet都必須支持瀏覽模式。
其他的元素含義請參照：http://java.sun.com/xml/ns/Portlet/Portlet-app_1_0.xsd
當(dāng)Web 應(yīng)用中有多個的Portlet時，可以統(tǒng)一的在Portlet。xml中定義一組的<portlet>元素。2.6.3 liferay-Portlet.xml
定義Portlet默認可用的用戶組、默認模板、是否支持多個實例等，規(guī)范由http://www.liferay.com/dtd/liferay-Portlet-app_3_5_0.dtd 定義。
liferay
-portlet.xml主要包含單獨或者成組的<portlet>、<role-mapper>。其中，<
portlet>下包含<portlet-name>、<struts-path>、<use-default-
template>、<instanceable>等子元素，<portlet-name>在應(yīng)用中必須唯一，且要跟
portlet.xml相同；<role-mapper>下包含成對的<role-name>、<role-
link>子元素。具體的元素含義請查看上述dtd定義。
2.6.4 liferay-display.xml
定義
Portlet默認的所屬類別。Liferay
Portal對Portlet實行按類別管理和劃分用戶權(quán)限。正如我們在用戶策略中提到的，可以制定某個類別可用的用戶組、用戶和角色，方便權(quán)限控制。
Liferay-display.xml規(guī)范由http://www.liferay.com/dtd/liferay-
display_3_5_0.dtd 定義。
Liferay-display.xml中，<display>下成組的<category>描述了可用的類別，其中portlet元素的id必須與liferay-portlet.xml的portlet-name保持一致，且在應(yīng)用中唯一。
2.6.5 liferay-layout-templates.xml
定
義Portal可用的布局。正如我們在布局與品質(zhì)中提到的那樣，Portal采用tpl文件來規(guī)劃桌面的布局。liferay-layout-
templates。xml采用成組的layout-template來構(gòu)建一個可用的布局列表。此xml的規(guī)范由http:
//www.liferay.com/dtd/liferay-layout-templates_3_6_0.dtd 來定義。
本文采用Liferay Portal默認的布局，暫時不需要定義自己的布局，故不準(zhǔn)備深入討論。讀者有興趣可以自己查看相關(guān)資料。
2.6.7 liferay-look-and-feel。xml
定
義Portal可用品質(zhì)的模板、圖片、樣式表等等，定義完畢后，Portal可以通過“布局與品質(zhì)”管理工具來進行品質(zhì)的切換。Liferay-look
-and-feel.xml規(guī)范由http://www.liferay.com/dtd/liferay-look-and-
feel_3_5_0.dtd 定義。
本文采用Liferay Portal默認的品質(zhì)，不準(zhǔn)備對品質(zhì)的自定義深入探討。有興趣的讀者可以查看相關(guān)資料。
第二部分 Liferay Portal 二次開發(fā)
本部分主要內(nèi)容
GenericPortlet 自定義Portlet類 部署描述文件
第三章 開發(fā)自己的Portlet
在
了解了Liferay Portal的基礎(chǔ)架構(gòu)，初步體會Liferay Portal良好的個性化定制之后，本章將開始Liferay
Portal二次開發(fā)之旅，講述并擴展Portlet的超類GenericPortlet，創(chuàng)建或者修改部署描述文件，構(gòu)建屬于自己的Portlet。
第一節(jié) 重要的基類：GenericPortlet
像Servlet
一樣，編寫的Portlet也必須直接或者間接的擴展基類GenericPortlet，這個是由JCP針對Portal提出的JSR168規(guī)范定義的。
只要擴展自規(guī)范的GenericPortlet，所有的Portlet都可以在支持JSR168規(guī)范的Portal服務(wù)器上運行。
GenericPortlet統(tǒng)一定義了可供Portal容器識別和調(diào)用的方法，包括：
public Init()：初始化；
public Init(PortletConfig) ：初始化；
public getInitParameter(String)：取得在Portlet。xml中定義的初始化參數(shù)；
public getInitParameterNames()：取得在Portlet。xml中定義的全部初始化參數(shù)；
public getPortletConfig()：取得包含初始化參數(shù)的配置對象PortletConfig實例；
public getPortletContext()：取得Portlet上下文；
public getPortletName()：取得在Portlet。xml中定義的Portlet名稱。
public getResourceBundle(Locale) ：取得Portlet國際化的Resource Bundle；
protected getTitle(RenderRequest) ：取得Portlet的標(biāo)題；
protected doView(RenderRequest，RenderResponse) ：Portlet瀏覽模式的處理方法；
protected doEdit(RenderRequest，RenderResponse) ：Portlet編輯模式的處理方法；
protected doHelp(RenderRequest，RenderResponse) ：Portlet幫助模式的處理方法；
protected doDispatch(RenderRequest，RenderResponse) ：Portlet行為分發(fā)；
protected processAction(RenderRequest，RenderResponse) ：Portlet處理Action Request的方法；
protected render(RenderRequest，RenderResponse)：Portal處理Render Request的方法；
public destroy()：Portlet銷毀，終止其生命周期。
在Portlet
Portal運行的時候，doView、doEdit、doHelp三個方法分別被調(diào)用，用以生成Portlet標(biāo)記。同樣也可以調(diào)用Servlet生成
Portlet標(biāo)記，或者不調(diào)用JSP或者Servlet，直接在方法中得到PrintWriter然后用最簡單的pw.println()打印出內(nèi)容。
這個過程類似Servlet，如下：
PrintWriter pw = renderResponse.getWriter();
pw.println(“Hello，world!”);
與Servlet類似，可以使用getInitParamter(String s)得到配置文件中Portlet的初始值，只不過Servlet在web.xml中，而Portlet在portlet.xml中。
portlet.xml：
<init-param>
<name>jspView</name>
<value>/jsp/view。jsp</value>
</init-param>
針對如上portlet.xml中的初始化信息，可以采用如下的調(diào)用方式：
SimplePortlet.java：
String jspName = getPortletConfig()。getInitParameter("jspView");
|
第二節(jié) Portlet標(biāo)簽
跟Servlet一樣，Portlet也自
定義了很多靈活的標(biāo)簽。通過這些標(biāo)簽，可以調(diào)用Portlet內(nèi)部的參數(shù)比如renderResponse、renderRequest、
PortletConfig等，在JSP中跟Portlet通信。當(dāng)然，在使用之前，除了要在web。xml中聲明標(biāo)簽庫外，還要在JSP的頭部聲明標(biāo)簽
庫調(diào)用：<%@ taglib uri="http://java。sun。com/Portlet" prefix="Portlet"
%>
3.2.1 defineObjects標(biāo)簽
在使用Portlet典型標(biāo)簽之前，要見聲明<portlet:defineObjects/>，這樣才可以使用其他的標(biāo)簽。defineObjects中間不允許定義任何屬性和包含任何內(nèi)容。
3.2.2 renderURL標(biāo)簽
屬性 值類型 對應(yīng)值
windowState String minimized
normal
maximized。
PortletMode String view， edit ， help
var String
secure
String true
false
創(chuàng)建一個當(dāng)前RenderURL，當(dāng)訪問它時將使Portlet窗口變?yōu)樽畲蠡癄顟B(tài)，模式變?yōu)闉g覽。<portlet:param/>子元素會在生成的RenderURL中增加number、page兩個參數(shù)和值。
3.2.3 actionURL標(biāo)簽
屬性 值類型 對應(yīng)值
windowState String minimized
normal
maximized。
portletMode String view， edit ， help
var String
secure
String true
false
<portlet:actionURL windowState="normal" PortletMode="edit">
<portlet:param name="action" value="login"/>
</portlet:actionURL>
創(chuàng)建一個當(dāng)前ActionURL，當(dāng)訪問它時將使Portlet窗口變?yōu)檎顟B(tài)，模式變?yōu)榫庉嫛?lt;Portlet:param/>子元素會在生成的ActionURL中增加action參數(shù)和值。
renderURL和actionURL兩個標(biāo)簽在諸如生成form表單的action等方面特別有用。
3.2.4 param標(biāo)簽
屬性 值類型
name String
用在renderURL和actionURL標(biāo)簽內(nèi)部，用來在生成的URL中增加參數(shù)和值。param標(biāo)簽不運行body內(nèi)容存在。
3.2.5 namespace標(biāo)簽
為目前的Portlet產(chǎn)生一個唯一的Value，防止與其他Portlet或者Portal上面的Value沖突。
上述標(biāo)簽的具體屬性及其約束，請參閱{PORTAL_HOME}/liferay/WEB-INF/tld/liferay-portlet.tld 。
第三節(jié) Portal的對象
JSR168
給Portal定義了幾個特別的對象，用來操作Portal特有的信息。這些對象跟Servlet的對象有點類似，又有點不同。這些對象都封裝在
{PORTAL_HOME}/common/lib/ext/portlet.jar包中，具體支持實現(xiàn)要視Portal服務(wù)器而定。
3.3.1 Request對象
Portlet
中的Request與Servlet的Request一樣接受客戶端發(fā)送的請求，但是與Servlet不同，Portlet的Request分為
Action Request及Render
Request兩種類型，因此Portlet接口中定義了兩種方法用來處理不同的Request。分別是processAction
(ActionRequest request，ActionResponse response) 和render(RenderRequest
request，RenderResponse response)，分別用以處理Action Request和Render
Request。某種意義上來講，render方法類似Servlet中的service方法，doView，doEdit，doHelp方法又類似
doGet，doPost方法。
①、RenderRequest和ActionRequest
PortletRequest分為
RenderRequest和ActionRequest兩種，分別由renderURL和actionURL來觸發(fā)。renderURL是
actionURL的一種優(yōu)化。Portlet的開發(fā)過程中盡量使用renderURL而避免actionURL。actionURL適用于有確實的
Action（行為）的情況下。比如說，表單form提交后Persistent狀態(tài)的改變、session的改變、perference的修改等等。
renderURL通常用來處理Portlet的導(dǎo)航。舉個例子：
使用actionURL：
<%
PortletURL pu = renderResponse.createActionURL();
pu.setParameter("ACTION"，"LOGIN");
<form name="usrform" method="post" action="<%=pu.toString()%>">
%>
說明：表單提交最好使用Post方法而不是Get方法，因為某些Portal服務(wù)器可能會將內(nèi)部狀態(tài)編碼到URL的Query字符串中。
使用renderURL：
<%
PortletURL pu=renderResponse.createRenderURL();
Pu.setParameter("PAGE"，Number);
%>
<a href="<%=pu%>">下一頁</a>
②、renderURL和actionURL的處理方式
當(dāng)客戶端請求是由一個renderURL觸發(fā)的時候，Portal服務(wù)器會調(diào)用該Portal頁面所有Portlet的render方法。
而當(dāng)客戶端請求是由一個actionURL觸發(fā)的時候，Portal服務(wù)器會先按用該頁面所有Portlet的processAction方法再調(diào)用render方法。所以，要明確自己到底使用那種URL來出發(fā)客戶端請求。
③、RenderRequest和ActionRequest的parameter參數(shù)作用范圍
當(dāng)客戶端請求由一個actionRequest觸發(fā)時，所有parameter參數(shù)的取得都必須在processAction方法中進行。比如：
public void processAction(ActionRequest req，ActionResponse res){
String str = req.getParameter("ACTION");
//response.setRenderParameter("ACTION"，action);
}
public void doView(ActionRequest req，ActionResponse res){
String str = req.getParameter("ACTION");
}
如
上processAction方法中，getParameter方法將能成功得到表單中的參數(shù)ACTION所對應(yīng)的值，因為我們知道，當(dāng)目標(biāo)
Portlet的processAction方法運行完后，Portlet
Container將調(diào)用Portal頁面中所有Portlet的render方法．但是實際上doView方法中使用getParameter不會得到
任何值．但是如果把processAction方法中注釋了的一行解除注釋的話，你就可以在doView方法中的得到參數(shù)ACTION對應(yīng)的值．
這說明action request的參數(shù)，render方法中不可以直接取到．必須使用了setRenderParameter方法，再次傳遞一次．3.3.2 Response對象
與Request對象一樣，
Response對象也有兩種：RenderResponse和ActionResponse，分別用來封裝對應(yīng)的RenderRequest和
ActionRequest的返回信息，比如重定向、窗口狀態(tài)、Portlet模式等。他們兩者的父類PortletResponse擁有
serPorperty和getPorperty兩個方法，用來傳遞信息給Portal容器。
ActionResponse主要用來處理以下功能：
a、 重定向
b、 改變窗口狀態(tài)、Portlet模式
c、 傳遞parameter參數(shù)到RenderRequest中去
RenderResponse主要用來提供以下功能：
a、 設(shè)置ContentType
b、 得到OutputStream和Writer對象，用來輸出頁面內(nèi)容
c、 Buffering緩沖
d、 設(shè)定Portlet的標(biāo)題，但是必須在Portlet輸出前調(diào)用，否則將被忽略
3.3.3 PortletConfig對象
和ServletConfig對象類似，PortletConfig對象提供對Portlet初始化信息以及PortletContext對象存取的方法。
和ServletConfig對象不同的是，PortletConfig對象提供對Portlet的標(biāo)題等資源的I18N支持，可以通過設(shè)定不同的Resource Bundle文件以提供多種語言支持。
3.3.4 Session對象
由于容器不同，Portal的Session對象與Servlet的Session對象略有不同。
由于Portlet處于Portal服務(wù)器的緣故，Portlet的Session分為Application Scope和Portlet Scope。兩者的區(qū)別在于：
①、Application Scope范圍的Session中保存的對象，對于同一個Portlet應(yīng)用范圍內(nèi)的所有Portlet都是可用的。
②、Portlet Scope范圍的Session中保存的對象，只對本Portlet可用，其他Portlet即使在同一個應(yīng)用中，也不可用。
但是對于Portlet應(yīng)用來說，可以通過HttpSession來訪問。畢竟Portlet應(yīng)用也是Web應(yīng)用。在使用Session對象的時候，最好能明確指出使用的是那個Scope范圍的Session。比如：
<portlet:actionURL windowState="NORMAL" PortletMode="view" var="pu1">
<portlet:param name="ACTION" value="ApplicationScope"/>
</portlet:actionURL>
<portlet:actionURL windowState="NORMAL" PortletMode="view" var="pu2">
<portlet:param name="ACTION" value="PortletScope"/>
</portlet:actionURL>
這個JSP創(chuàng)建了兩個ActionURL，分別產(chǎn)生了兩種PortletSession對象。
PortletSession ps = req.getPortletSession();
if(ps.getAttribute("PortletSession.AS"，PortletSession.APPLICATION_SCOPE)!=null){
app=ps.getAttribute("PortletSession.AS"，PortletSession.APPLICATION_SCOPE).
toString();
}
if(ps.getAttribute("PortletSession.PS"，PortletSession.PORTLET_SCOPE)!=null){
Portlet=ps.getAttribute("PortletSession.PS"，PortletSession.PORTLET_SCOPE).
toString();
}
以上代碼根據(jù)需要取得不同Scope范圍的Session對象值。
同一個應(yīng)用下，可以直接通過ServletSession取得PortletSession。APPLICATION_SCOPE范圍下的Session對象值。
HttpSession se = request.getSession();
if(se.getAttribute("PortletSession.AS")!=null){
app=se.getAttribute("PortletSession.AS");
}
3.3.5 Preference對象
Preference對象被設(shè)計用來實現(xiàn)用戶的個性化設(shè)置，可以幫助用戶對Portlet進行符合用戶需求的顯示定制和行為定制，可以替代部分的數(shù)據(jù)庫功能。需要指出的是，Preference對象只是用來存取簡單的配置信息，并不能完全替代數(shù)據(jù)庫應(yīng)用。
Preference對象對于配置信息采用鍵-值的形式存取，用戶可以將需要的信息暫時保存在Preference中。
PortletPreference p= req.getPortletPreferences();
p.setValue("educhina.username"，"educhina");
p.store();
Preference對象用來存取用戶的個性化信息，所以不同用戶的Preference對象不能共享，這點跟Session不同。
可以在Portlet.xml中配置Preference信息，如下：
<Portlet-preferences>
<preference>
<name>educhina。username</name>
<value>educhina</value>
<read-only>true</read-only>
</preference>
</Portlet-preferences>
另外，還可以配套使用PreferencesValidator對象，對Portlet的Preference在存儲之前進行驗證，以確保Preference的正確性。
具體規(guī)范可以參照http://java.sun.com/xml/ns/Portlet/Portlet-app_1_0.xsd 的<complexType name="preferenceType">部分。第四節(jié) 編寫自己的Portlet類
Liferay
Portal內(nèi)部集成了78個Portlet，包括直接用PrintWriter輸出的、調(diào)用JSP輸出的、調(diào)用Servlet輸出的，數(shù)據(jù)來源有直接從
數(shù)據(jù)庫取得的、通過Web
Service取得的等等。這里，我們只講述直接用PrintWriter輸出的和調(diào)用JSP輸出的，目的在于講述如何編寫自己的Portlet類。其他
的與此類似，不贅述。
3.4.1 開發(fā)環(huán)境
IDE：Eclipse V3.0.1
JDK：V1.4.2_06
ANT：V1.6.2
Tomcat：V5.0（集成在Liferay Portal中）
Liferay Portal：liferay-portal-pro-3.6.0-tomcat
3.4.2 準(zhǔn)備工作
①、安裝JDK V1.4.2_06，在系統(tǒng)環(huán)境變量中增加變量JAVA_HOME，指向JDK安裝目錄。
②、安裝ANT，在系統(tǒng)環(huán)境變量中增加變量ANT_HOME，指向ANT安裝目錄。
③、下載并啟動Eclipse V3.0.1.
④、下載并解壓縮liferay-portal-pro-3.6.0-tomcat.zip到某一文件夾，該文件夾即為{PORTAL_HOME}。
⑤、
在Eclipse中新建一個Java項目，命名為TestPortal，路徑為D:"TestPortal，將{PORTAL_HOME}"common
"ext"portlet.jar以外部jar的形式添加到庫中。下文中，D:"TestPortal將以{APP_HOME}代稱。在
{APP_HOME}下創(chuàng)建文件夾webapp、deploy、bak。項目缺省輸出文件夾為{APP_HOME}"webapp"WEB-INF"
classes 。
⑥、在{APP_HOME}"webapp"WEB-INF目錄下創(chuàng)建web.xml，內(nèi)容如下：
<?xml version="1。0"?>
<!DOCTYPE
web-app PUBLIC "-//Sun Microsystems, Inc。//DTD Web Application 2。3//EN"
"http://java。sun。com/dtd/web-app_2_3。dtd">
<web-app>
<display-name>TestPortal</display-name>
</web-app>
⑦、在{APP_HOME}"webapp"WEB-INF下創(chuàng)建tld文件夾，將{PORTAL_HOME}"liferay"WEB-INF"tld/liferay-portlet.tld拷貝到創(chuàng)建的tld文件夾下，備用。
⑧、新建一個Java包com.educhina.portal 。
3.4.3 HelloWorldPortlet
HelloWorldPortlet
類計劃用單純的PrintWriter輸出Portlet標(biāo)記片斷。在包com.educhina.portal下新建Java類
HelloWorldPortlet，這個類必須擴展自javax.Portlet.GenericPortlet類。設(shè)計讓
HelloWorldPortlet支持瀏覽和編輯兩種模式，所以HelloWorldPortlet重寫doView和doEdit方法。簡單的代碼如
下：
package com.educhina.portal;
import java.io.IOException;
import javax.Portlet.GenericPortlet;
import javax.Portlet.PortletException;
import javax.Portlet.RenderRequest;
import javax.Portle.RenderResponse;
public class HelloWorldPortlet extends GenericPortlet{
public void doView(RenderRequest req, RenderResponse res)
throws IOException, PortletException {
res.setContentType("text/html");
res.getWriter().println("HelloWorld!");
}
public void doEdit(RenderRequest req,RenderResponse res)
throws IOException,PortletException {
res.setContentType("text/html");
res.getWriter().println("HelloWorld!");
}
}
doView和doEidt方法從RenderRequest取得PrintWriter對象，直接輸出一個String字符“HelloWorld！”。這個String字符將作為HelloWorldPortlet的片斷內(nèi)容。
3.4.4 HelloJSPPortlet
HelloJSPPortlet
類計劃調(diào)用外部JSP輸出。同樣的，HelloJSPPortlet也要擴展自GenericPortlet類。HelloJSPPortlet調(diào)用
getPortletConfig().getInitParameter("..")方法，取得在Portlet。xml中配置的view-jsp和
edit-jsp參數(shù)值，以此確定JSP頁面的具體位置。然后調(diào)用PortletRequestDispatcher的include方法，將JSP頁面
加載到RenderResponse。代碼如下：
package com.educhina.portal;
import java.io.IOException;
import javax.Portlet.GenericPortlet;
import javax.Portlet.PortletException;
import javax.Portlet.PortletRequestDispatcher;
import javax.Portlet.RenderRequest;
import javax.Portlet.RenderResponse;
public class HelloJSPPortlet extends GenericPortlet{
public void doView(RenderRequest req, RenderResponse res)
throws IOException, PortletException {
res.setContentType("text/html");
String jspName = getPortletConfig().getInitParameter("view-jsp");
PortletRequestDispatcher rd = getPortletContext().getRequestDispatcher(jspName);
rd.include(req,res);
}
public void doEdit(RenderRequest req,RenderResponse res)
throws IOException,PortletException {
res.setContentType("text/html");
String jspName = getPortletConfig().getInitParameter("edit-jsp");
PortletRequestDispatcher rd = getPortletContext().getRequestDispatcher(jspName);
rd.include(req,res);
}
}
在{APP_HOME}/webapp目錄下創(chuàng)建view.jsp和edit.jsp，view.jsp代碼如下，edit.jsp類似：
<table cellpadding="8" cellspacing="0" width="100%">
<tr>
<td>
<font class="Portlet-font" style="font-size: x-small;">
This is a <b>Sample JSP Portlet</b> used in viewing model。 Use this as a quick way to include JSPs。
</font>
</td>
</tr>
</table>
JSP
文件不能包含關(guān)于HTML的<head>、<body>、<html>的信息，只能包含原來位于<
body></body>內(nèi)部的HTML內(nèi)容。那些<head>、<body>、<html>信
息由Portal頁面來提供。
只有在JSP頁面中使用<%@ taglib
uri="http://java.sun.com/portlet" prefix="portlet"
%>和<portlet:defineObjects/>，JSP頁面才可以直接操作Portlet的一些變量，比如：
renderResponse、renderRequest、portletConfig。
|
第五節(jié) 修改Web部署描述文件
正如2.6.1所指出的那樣，要保證
Portlet能夠在Liferay
Portal成功部署，必須對web.xml進行必要的修改，添加Portlet監(jiān)聽器、Servlet映射、Portlet標(biāo)簽庫。在先前
web.xml的<display>節(jié)點下增加如下內(nèi)容：
<listener>
<listener-class>com.liferay.portal.servlet.PortletContextListener</listener-class>
</listener>
<servlet>
<servlet-name>HelloWorldPortlet</servlet-name>
<servlet-class>com.liferay.portal.servlet.PortletServlet</servlet-class>
<init-param>
<param-name>Portlet-class</param-name>
<param-value>com.educhina.portal.HelloWorldPortlet</param-value>
</init-param>
<load-on-startup>0</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>HelloWorldPortlet</servlet-name>
<url-pattern>/HelloWorldPortlet/*</url-pattern>
</servlet-mapping>
<servlet>
<servlet-name>HelloJSPPortlet</servlet-name>
<servlet-class>com.liferay.portal.servlet.PortletServlet</servlet-class>
<init-param>
<param-name>Portlet-class</param-name>
<param-value>com.educhina.portal.HelloJSPPortlet</param-value>
</init-param>
<load-on-startup>0</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>HelloJSPPortlet</servlet-name>
<url-pattern>/HelloJSPPortlet/*</url-pattern>
</servlet-mapping>
<taglib>
<taglib-uri>http://java.sun.com/Portlet</taglib-uri>
<taglib-location>/WEB-INF/tld/liferay-Portlet.tld</taglib-location>
</taglib>
其
中，<listener>節(jié)點是增加一個監(jiān)聽器，以便Liferay
Portal監(jiān)聽所有針對Portlet的操作。<servlet>以及<servlet-mapping>是將上述兩個
Portlet類加入Servlet容器中。Portlet類實質(zhì)上也是Servlet。<tablib>是將Liferay
Portal標(biāo)簽庫加入列表中，以便JSP調(diào)用。第六節(jié) 創(chuàng)建Liferay Portal部署描述文件
修改完web.xml之后，還要創(chuàng)建2.6所說的三個Portlet部署描述文件：portlet.xml、liferay-portlet.xml、liferay-display.xml。
①、portlet.xml
portlet.xml
定義Portlet的初始化信息。這里，我們在portlet.xml中增加兩個Portlet節(jié)點，分別代表HelloWorldPortlet和
HelloJSPPortlet。其中，HelloWorldPortlet支持PringWriter輸出，HelloJSPPortlet支持JSP
輸出；兩者都支持瀏覽和編輯兩種模式。HelloJSPPortlet需要定義兩個init參數(shù)，告訴系統(tǒng)JSP文件的位置。
<portlet>
<portlet-name>HelloWorldPortlet</portlet-name>
<display-name>HelloWorldPortlet</display-name>
<portlet-class>com.educhina.portal.HelloWorldPortlet</portlet-class>
<expiration-cache>0</expiration-cache>
<supports>
<mime-type>text/html</mime-type>
</supports>
<supports>
<mime-type>text/html</mime-type>
<Portlet-mode>edit</Portlet-mode>
</supports>
<portlet-info>
<title>HelloWorldPortlet</title>
<short-title>HelloWorldPortlet</short-title>
<keywords>HelloWorldPortlet</keywords>
</portlet-info>
<security-role-ref>
<role-name>guest</role-name>
</security-role-ref>
<security-role-ref>
<role-name>power-user</role-name>
</security-role-ref>
<security-role-ref>
<role-name>user</role-name>
</security-role-ref>
</portlet>
<portlet>
<portlet-name>HelloJSPPortlet</portlet-name>
<display-name>HelloJSPPortlet</display-name>
<portlet-class>com。Educhina.portal.HelloJSPPortlet</portlet-class>
<init-param>
<name>view-jsp</name>
<value>/view。jsp</value>
</init-param>
<init-param>
<name>edit-jsp</name>
<value>/edit。jsp</value>
</init-param>
<expiration-cache>0</expiration-cache>
<supports>
<mime-type>text/html</mime-type>
</supports>
<supports>
<mime-type>text/html</mime-type>
<Portlet-mode>edit</Portlet-mode>
</supports>
<portlet-info>
<title>HelloJSPPortlet</title>
<short-title>HelloJSPPortlet</short-title>
<keywords>HelloJSPPortlet</keywords>
</portlet-info>
<security-role-ref>
<role-name>guest</role-name>
</security-role-ref>
<security-role-ref>
<role-name>power-user</role-name>
</security-role-ref>
<security-role-ref>
<role-name>user</role-name>
</security-role-ref>
</portlet>
②、liferay-Portlet.xml
Liferay-Portlet.xml主要定義Portlet的模板、實例總數(shù)、是否允許重復(fù)定義等。同樣的，我們增加了兩個<Portlet>節(jié)點，代表HelloWorldPortlet和HelloJSPPortlet。
<?xml version="1。0"?>
<!DOCTYPE
liferay-Portlet-app PUBLIC "-//Liferay//DTD Portlet Application
3。5。0//EN"
"http://www。liferay。com/dtd/liferay-Portlet-app_3_5_0。dtd">
<liferay-portlet-app>
<portlet>
<Portlet-name>HelloWorldPortlet</Portlet-name>
<struts-path>HelloWorldPortlet</struts-path>
<use-default-template>true</use-default-template>
<instanceable>true</instanceable>
</portlet>
<portlet>
<Portlet-name>HelloJSPPortlet</Portlet-name>
<struts-path>HelloJSPPortlet</struts-path>
<use-default-template>true</use-default-template>
<instanceable>true</instanceable>
</portlet>
<role-mapper>
<role-name>administrator</role-name>
<role-link>Administrator</role-link>
</role-mapper>
<role-mapper>
<role-name>guest</role-name>
<role-link>Guest</role-link>
</role-mapper>
<role-mapper>
<role-name>power-user</role-name>
<role-link>Power User</role-link>
</role-mapper>
<role-mapper>
<role-name>user</role-name>
<role-link>User</role-link>
</role-mapper>
</liferay-portlet-app>
③、liferay-display.xml
liferay-display.xml定義Portlet所屬類別。Liferay Portal默認定義了一個category.test類別，這里，我們將HelloWorldPortlet和HelloJSPPortlet歸屬到category.test。
<?xml version="1。0"?>
<!DOCTYPE display PUBLIC "-//Liferay//DTD Display 3。5。0//EN" "http://www。liferay。com/dtd/liferay-display_3_5_0。dtd">
<display>
<category name="category。test">
<Portlet id="HelloWorldPortlet" />
<Portlet id="HelloJSPPortlet" />
</category>
</display>
至此，一個簡單的Portlet就開發(fā)完成了。接下來，我們把它部署到Liferay Portal上。第三部分 Liferay Portal部署
本部分主要內(nèi)容
Portlet部署 ANT 管理Portlet
第四章 部署自己的Portlet
Liferay
Portal跟Tomcat5.0集成在一起，從本質(zhì)上講，liferay-portal-pro-3.6.0-tomcat.zip是一個Tomcat
壓縮包，只是其中將liferay作為默認應(yīng)用，并將跟Portlet有關(guān)的操作都交給liferay應(yīng)用處理而已。因此，Liferay
Portal支持所有針對Tomcat5.0的部署方式，包括：手動部署、Ant部署，并且支持熱部署。
第一節(jié) 手動部署
手動部署可以采用拷貝文件夾、war部署、編寫部署文件三種方式：
①、
拷貝文件夾：與單純的Tomcat一樣，我們可以將{APP_HOME}"webapp目錄拷貝到{PORTAL_HOME}"webapps"下，該
webapp目錄名為TestPortal。啟動Liferay
Portal（雙擊{PORTAL_HOME}"bin"startup。bat）即可。
②、war部署：或者將{APP_HOME}"
webapp打包成TestPortal.war，拷貝war到{PORTAL_HOME}"webapps"下，啟動Liferay
Portal，讓Tomcat自動解壓。在命令行模式下切換到{APP_HOME}"webapp目錄，執(zhí)行 jar cvf
TestPortal.war * 。
③、編寫部署文件：
{PORTAL_HOME}"conf"Catalina"localhost目錄下，創(chuàng)建TestPortal.xml文件，內(nèi)容如下：
<Context path="/TestPortal" docBase="D:"TestPortal"webapp" debug="0" reloadable="true" crossContext="true">
</Context>
部署成功后，登錄Liferay Portal，可以在桌面底部的下拉列表中看到HelloWorldPortlet和HelloJSPPortlet兩個Portlet。將它們添加到桌面中。
第二節(jié) Ant自動部署
確保之前已經(jīng)安裝Apache Ant，并正確添加ANT_HOME到系統(tǒng)環(huán)境變量。
①、拷貝之前打包的TestPortlet.war到{APP_HOME}/deploy目錄；
②、
從http://prdownloads。sourceforge。net/lportal/Portlet-deployer-3。6。0。xml
下載Portlet-deployer-3.6.0.xml 到{APP_HOME}"deploy，改名為build。xml以便Ant自動加載；
③、確保JDK1.4.2和Ant 1.6安裝成功，并配置到系統(tǒng)環(huán)境變量；
④、確保Tomcat或者其他服務(wù)器已經(jīng)正確安裝，或者Liferay Portal正常安裝。
編
輯build.xml，使其只想你的應(yīng)用服務(wù)器或者Servlet容器。比如，如果你安裝JBoss+Jetty到/opt/liferay目錄，那么編
輯build.xml，確保只有JBoss+Jetty部分沒有被注釋，修改app.server屬性為/opt/liferay。
Build.xml默認是開啟JBoss+Jetty部分，本文采用的是Tomcat集成包，所以將JBoss+Jetty部分注釋掉，開始Tomcat部分。修改app.server.dir屬性，指向{PORTAL_HOME}。如下圖：
⑤、
命令行切換到到{APP_HOME}/deploy目錄，執(zhí)行 ant deploy
，系統(tǒng)會自動將TestPortal。war解壓，必要時修改web.xml、portlet.xml等部署文件，將解壓后的TestPortal文件夾
拷貝到{PORTAL_HOME}"webapps目錄下。
啟動Liferay Portal之前，建議先確認修改后的web.xml、portlet.xml等部署文件是否正確。
第三節(jié) 加入Liferay Portal自有列表
之
前我們提到過，Liferay
Portal集成了78個默認的Portlet應(yīng)用。這些應(yīng)用都通過{PORTAL_HOME}"liferay"WEB-INF"目錄下的
portlet.xml、liferay-portlet.xml、liferay-display。xml描述。我們只要更改這些描述文件，就可以將我
們自己的應(yīng)用加入到Liferay Portal的Portlet列表中了，效果跟手動部署和Ant自動部署一樣。
①、拷貝{APP_HOME}"webapp目錄的內(nèi)容到{PORTAL_HOME}"liferay"html"Portlet目錄下，更改文件夾名稱為TestPortal。
②、將TestPortal"WEB-INF"classes文件夾剪切到{PORTAL_HOME}"liferay"WEB-INF目錄下。
③、
將TestPortal"WEB-INF"web。xml中<servlet>、<servlet-mapping>的內(nèi)容合并
到{PORTAL_HOME}"liferay"WEB-INF"web.xml中。刪除TestPortal"WEB-INF"web.xml。
④、
將TestPortal"WEB-INF"Portlet.xml中關(guān)于HelloWorldPortlet和HelloJSPPortlet的<
portlet>的內(nèi)容合并到{PORTAL_HOME}"liferay"WEB-INF"portlet.xml中。刪除TestPortal
"WEB-INF" portlet.xml。
⑤、將TestPortal"WEB-INF"liferay-portlet.xml中關(guān)于
HelloWorldPortlet和HelloJSPPortlet的<portlet>的內(nèi)容合并到{PORTAL_HOME}"
liferay"WEB-INF"liferay-portlet.xml中。刪除TestPortal"WEB-INF"liferay-
portlet.xml。
⑥、將TestPortal"WEB-INF"liferay-display.xml中關(guān)于
HelloWorldPortlet和HelloJSPPortlet的<portlet>的內(nèi)容合并到{PORTAL_HOME}"
liferay"WEB-INF"liferay- display.xml中。刪除TestPortal"WEB-INF" liferay-
display.xml。
這個方法比較復(fù)雜，而且不容易擴展和調(diào)試，通常不建議采用。
第四節(jié) 普通Java Web應(yīng)用轉(zhuǎn)化為Portlet應(yīng)用
隨
著開發(fā)的深入，我們希望能夠?qū)⒃瓉淼腏ava Web應(yīng)用遷移到Liferay Portal，構(gòu)建真正的企業(yè)門戶。Liferay
Portal靈活的二次開發(fā)機制，允許用戶將各種各樣的內(nèi)容集成到Portal平臺上來，消除信息孤島。將一個Java
Web應(yīng)用轉(zhuǎn)化為Portlet應(yīng)用的步驟如下：
①、撰寫擴展自GenericPortlet的Portlet和JSP頁面。這個Portlet可以使用PrintWriter輸出或者調(diào)用JSP頁面輸出方式。通常，如果Java Web應(yīng)用是采用MVC三層模式，那么只需要更改View層就可以了。
②、修改web.xml，增加2。6。1所述的Portlet監(jiān)聽器和Portlet標(biāo)簽庫，增加針對上步驟所寫的servlet和servlet映射。
<servlet>
<servlet-name>yourPortlet</servlet-name>
<servlet-class>com.liferay.portal.servlet.PortletServlet</servlet-class>
<init-param>
<param-name>Portlet-class</param-name>
<param-value>full.name.of.yourPortlet</param-value>
</init-param>
<load-on-startup>0</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>yourPortlet</servlet-name>
<url-pattern>/yourPortlet/*</url-pattern>
</servlet-mapping>
③、創(chuàng)建portlet.xml，增加相應(yīng)的Portlet定義信息，規(guī)范參考2.6.2。
④、創(chuàng)建liferay-portlet.xml，增加相應(yīng)的Portlet定義信息，規(guī)范參考2.6.3。
⑤、創(chuàng)建liferay-display.xml，增加相應(yīng)的Portlet類別定義信息，規(guī)范參考2.6.4。
⑥、
拷貝portlet.jar和liferay-Portlet.tld到當(dāng)前應(yīng)用。其中，portlet.jar是Portlet
API包，作用類似servlet-api.jar，位于{PORTAL_HOME}"common"lib"ext"liferay-
portlet.tld是Liferay Portal提供的Portlet標(biāo)簽庫。
⑦、選擇適當(dāng)?shù)牟渴鸱绞剑瑢⑿薷暮蟮腏ava Web應(yīng)用部署到Portlet平臺上。第四部分 附錄
本部分主要內(nèi)容
資源網(wǎng)站 Portlet范例 參考資料 后序
第五章 相關(guān)資源
作為一個開源的門戶產(chǎn)品，Liferay Portal已經(jīng)比較成熟，有比較齊全的文檔。隨著應(yīng)用的深入，開源免費的中文化文檔也在陸續(xù)出現(xiàn)。
第一節(jié) 資源網(wǎng)站
Liferay Portal 官方網(wǎng)站：http://www.liferay.com
Liferay Portal 中文網(wǎng)站：http://www.liferay.cn
Liferay Portal 論壇：http://forums.liferay.com
Tracker ： http://support.liferay.com
郵件列表：http://sourceforge.net/mailarchive/forum.php?forum=lportal-development
JavaLobby專題：http://www.javalobby.org/articles/liferay/
OSQS專題：http://cstsolaris.cst.nait.ab.ca/ist410/gerry/liferay/index.jsp
Leonardsoko1專題：http://www.leonardsokol.com/liferay/
Developer專題：http://www.developer.com/java/web/article.php/10935_3372881_1
第二節(jié) 示例
Liferay
Portal隨程序包提供了豐富的documentation，其中的Portlet Examples對Portal內(nèi)置的Hello
World、IFrame、Calendar、Message Boards、Mail五個Portlet進行了比較詳細的解說。啟動Liferay
Portal后，瀏覽這里：
http://localhost/web/guest/documentation/development/Portlet
另
外，Liferay Portal還在官方網(wǎng)站上提供了Sample Layout Template、Sample Portlet、Sample
Themes供下載。其中，Sample Portlet包括Sample JSP Portlet、Sample Struts
Portlet、Sample JSF SUN Portlet、Sample JSF MyFaces Portlet。瀏覽這里：
http://localhost/web/guest/downloads/sample_Portlet
第六章 參考資料
①、文檔
《JSR168 PORLET標(biāo)準(zhǔn)手冊漢化整理》 作者：Jini等
《Portlet應(yīng)用開發(fā)(JSR168)》 作者：Terry Lee
《(原創(chuàng)翻譯)Liferay-Portal架構(gòu)》 作者：eamoi
②、網(wǎng)站
http://www.liferay.com
http://www.liferay.cn
后序
研
究Liferay
Portal屬于半路出家。從開始到本文完成，倆月有余。作為一個開源的Portal產(chǎn)品，Liferay的確值得稱許，雖然還有不少bug。在本文截稿
的時候，Liferay Portal
V3.6.1已經(jīng)發(fā)版，新版本在拖拉Portlet、Spring遠程傳輸和布局熱部署方面有比較大的提升。本文不會就此終結(jié)，暫稱V1.0，作為前段工
作的總結(jié)。本文的用戶策略部分參考了同事Kevin的文檔，特此感謝。
PS：寫文章真的很費腦筋。
(完)