基本環(huán)境配置
本節(jié)安裝配置Liferay有關(guān)開發(fā)必須的一些軟件，這些軟件在后面章節(jié)都會(huì)用到，因此本節(jié)的內(nèi)容是不可跳過(guò)的。




--------------------------------------------------------------------------------



2.1  準(zhǔn)備必須的軟件，并進(jìn)行環(huán)境參數(shù)配置
安裝如下軟件：

J2SDK 1.4.1 （雖然官方文檔推薦使用1.4.2版本，但是使用1.4.2版本的話，在LifeRay的部分功能中會(huì)出現(xiàn)中文亂碼問題；而到LifeRay 4.0為止，還沒有做到與Java 1.5的完全兼容）；（轉(zhuǎn)載者注：本人使用Liferay Portal 4.3.0版 可以與JDK1.6兼容）
Jikes 1.21 （官方文檔聲稱這個(gè)軟件不是必裝的，可以使用J2SDK中的標(biāo)準(zhǔn)編譯器代替，但是實(shí)際試驗(yàn)中，使用標(biāo)準(zhǔn)編譯器會(huì)出現(xiàn)一些奇怪的問題，而且Jikes給出的編譯錯(cuò)誤信息也更為豐富，推薦安裝使用；Jikes 1.22及以上版本是僅兼容Java 1.5的，無(wú)法與1.4版本的J2SDK一起使用，因此不要使用這些版本）；（轉(zhuǎn)載者注：必須安裝Jikes，因?yàn)樵贚iferay的配置文件中使用的編譯器就是Jikes）
Apache Ant 1.6.5 （對(duì)Ant的版本倒是沒有特殊要求，只是因?yàn)槲沂褂玫氖茿nt 1.6.5，所以我就這么注明了）； （轉(zhuǎn)載者注：在Eclipse 3.3.0版中自帶Ant 1.7.0版）


J2SDK下載后是exe格式的安裝文件，而Jikes和Ant都是zip壓縮包，直接解壓即可。這樣我安裝完三個(gè)軟件分別到如下三個(gè)目錄：

C:\j2sdk1.4.1_07
C:\jikes-1.21
C:\apache-ant-1.6.5


接著在系統(tǒng)中設(shè)定環(huán)境變量，右鍵點(diǎn)擊“我的電腦”，選擇“屬性”，再選擇“高級(jí)”－》“環(huán)境變量”，在“系統(tǒng)變量”中修改或者加入：

JAVA_HOME C:\j2sdk1.4.1_07
JIKES_HOME C:\jikes-1.21
ANT_HOME C:\apache-ant-1.6.5
如果系統(tǒng)中設(shè)置了CLASSPATH環(huán)境變量，則去除之，以防止沖突
給path環(huán)境變量加入 %ANT_HOME%\bin;%JAVA_HOME%\bin;%JIKES_HOME%\bin


之后重啟系統(tǒng)，使環(huán)境變量生效。

（轉(zhuǎn)載者注：可以不改變其他環(huán)境變量。只需要把下載到的Jikes.exe放到JDK的bin文件夾下即可。）




--------------------------------------------------------------------------------



2.2  下載LifeRay程序包
本文直接使用了發(fā)布版本的4.0的源代碼和二進(jìn)制包，當(dāng)然也可以利用Subversion接口直接訪問LifeRay在Sourceforge上的庫(kù)使用最新的源代碼版本，不過(guò)下面的試驗(yàn)只是基于發(fā)布版本的代碼包完成的，共計(jì)需要下載：

liferay-portal-src-4.0.0.zip LifeRay 4.0 正式版的源代碼包；
liferay-portal-tomcat-4.0.0.zip LifeRay 4.0 正式版的Tomcat二進(jìn)制綁定包，提供測(cè)試新Portlet的執(zhí)行環(huán)境（如果只打算編譯調(diào)試Liferay自身的代碼，而不打算開發(fā)新的獨(dú)立Portlet組件，則可以不下載這個(gè)包）；


以上文件包可以在LifeRay官方網(wǎng)站的連接或者Sourceforge上下載到。



將liferay-portal-src-4.0.0.zip解壓到D:\liferay\portal 目錄下備用。




--------------------------------------------------------------------------------



2.3  安裝和配置基本的Eclipse運(yùn)行環(huán)境
在Eclipse官方網(wǎng)站下載最新版本的Eclipse IDE環(huán)境。我將之解壓到了C:\j2sdk1.4.1_07\eclipse 目錄下，雙擊eclipse.exe文件運(yùn)行之；

File->Switch Workspace，輸入d:\liferay，點(diǎn)擊OK確認(rèn)；
File->New->Project->Java Project，輸入項(xiàng)目名稱為“portal”，保持默認(rèn)的“create new project in workspace”，選擇“Finish”結(jié)束。
如果上一步成功，那么已經(jīng)可以在左側(cè)欄看到源代碼的目錄結(jié)構(gòu)了；并且右鍵點(diǎn)擊項(xiàng)目的根目錄，選“Properties”，選“Java Build Path”的“Libraries”標(biāo)簽，應(yīng)該能夠看到所有需要的jar格式庫(kù)文件在里面了；
Window->Show View->Ant，在新出現(xiàn)的Ant標(biāo)簽欄點(diǎn)擊加號(hào)，選擇項(xiàng)目源碼根目錄上的build.xml文件；



--------------------------------------------------------------------------------



3.  基于Tomcat開發(fā)Portlet
本節(jié)通過(guò)配置一個(gè)基于Liferay的Tomcat綁定二進(jìn)制包建立一個(gè)擴(kuò)展開發(fā)Liferay的環(huán)境，這個(gè)環(huán)境特別適用于對(duì)新的Portlet組件進(jìn)行調(diào)試和開發(fā)。這個(gè)方法幾乎不會(huì)修改Liferay自身的代碼，所有的改動(dòng)都是在擴(kuò)展環(huán)境里完成，可以在Liferay升級(jí)時(shí)比較容易地實(shí)現(xiàn)擴(kuò)展了的功能的遷移。



但這個(gè)方法也有一個(gè)缺點(diǎn)，就是開發(fā)的Portlet如果不執(zhí)行deploy步驟，就不能在Liferay里啟用。因此在開發(fā)和調(diào)試Portlet的過(guò)程中，一般還是在Liferay以外的環(huán)境中開發(fā)調(diào)試好，之后移植到此擴(kuò)展開發(fā)環(huán)境中，與Liferay聯(lián)調(diào)，成功后部署應(yīng)用。具體工作中，可以與后面“改進(jìn)和調(diào)試Liferay自身代碼”一節(jié)中調(diào)試Portlet的方法稍作比較，選擇適合自己情況的方法。




--------------------------------------------------------------------------------



3.1  配置擴(kuò)展開發(fā)環(huán)境
為了方便進(jìn)行自己的修改和定制開發(fā)，同時(shí)又能與Liferay的更新保持兼容，我們使用單獨(dú)的目錄來(lái)放置自己的修改，這樣在Liferay發(fā)布新版本時(shí)，可以直接升級(jí)Liferay部署，而不會(huì)與我們的修改相沖突。具體地，我使用了d:\liferay\ext 目錄來(lái)放置所有的擴(kuò)展（包括JSP、class文件及依賴庫(kù)等）。



首先要在d:\liferay\portal 目錄下建立一個(gè)名為“release.${username}.properties”的配置文件，其中${username}就是當(dāng)前Windows登陸的用戶名，可以通過(guò)“開始菜單－》運(yùn)行－》cmd.exe”后顯示的默認(rèn)路徑看到，跟在“Documents and Settings”字樣后面的就是當(dāng)前登陸的用戶名。這樣，我的配置文件的名稱是release.administrator.properties 。文件的內(nèi)容只寫一行：

lp.ext.dir={Liferay}\ext



其中“{Liferay}”指的是Liferay源代碼存放的上級(jí)目錄，比如我寫的這一行就是：

lp.ext.dir=d:\liferay\ext



回到上一節(jié)建立好的Eclipse中的Ant視圖中，雙擊展開根節(jié)點(diǎn)Portal，應(yīng)該可以看到很多Ant任務(wù)，順序執(zhí)行 clean, start, build-ext 。屏幕下方的命令行窗口會(huì)跳躍大堆大堆的文字提示信息，如果一切正確，那么其中不應(yīng)該有紅色的錯(cuò)誤信息（絕大多數(shù)此處可能出現(xiàn)的錯(cuò)誤都是配置文件不正確所引起的）。一切正常的話，那么d:\liferay\ext 目錄下應(yīng)該生成了很多東西了。

（轉(zhuǎn)載者注：一種錯(cuò)誤有可能是Jikes缺少，其余基本上是路徑配置問題）



我們將前面準(zhǔn)備好的與Tomcat綁定的Liferay Professional版本的壓縮包解壓到d:\liferay\ext\servers\tomcat 目錄下，并且在d:\liferay\ext 目錄下建立一個(gè)名為app.server.{username}.properties的文件，在我這也就是app.server.administrator.properties ，文件內(nèi)容寫如下兩行：

lp.ext.dir={Liferay}\ext
app.server.type=tomcat



在我這也就是：

lp.ext.dir=d:\liferay\ext
app.server.type=tomcat



然后仿照前面在Eclipse里建立新的Java工程的方法，建立一個(gè)新的Java項(xiàng)目，指向d:\liferay\ext 目錄，也就是說(shuō)，在輸入Java項(xiàng)目的項(xiàng)目名稱時(shí)，輸入“ext”而不是前面輸入“portal”。




--------------------------------------------------------------------------------



3.2  添加插件支持
為了能夠在基于Tomcat的Liferay Porfessional版本的運(yùn)行環(huán)境上實(shí)現(xiàn)我們編寫的插件的調(diào)試，需要給Eclipse環(huán)境添加一個(gè)借助Tomcat服務(wù)器開展調(diào)試的插件，也就是Sysdeo這個(gè)插件，可以到 http://www./eclipse/tomcatplugin 下載，我下載的是tomcatPluginV31.zip文件（將下載的這個(gè)zip文件包解壓，拷貝到Eclipse安裝目錄的plugins目錄下，比如我這里就是拷貝到了C:\j2sdk1.4.1_07\eclipse\plugins\ 目錄下。關(guān)閉并且重啟Eclipse，如果插件安裝成功，那么在界面的左上角應(yīng)該可以看到Tomcat的圖標(biāo)（轉(zhuǎn)載者注：一只小貓，另一只小貓身上帶著一個(gè)紅叉）。



現(xiàn)在我們來(lái)配置Sysdeo插件的參數(shù)，在Eclipse里“Windows->Preferences”，選擇“Tomcat”標(biāo)簽，選擇“Version 5.x”版本，然后修改參數(shù)“Tomcat Home”為“{Liferay}\ext\servers\tomcat”，在我這里也就是“D:\liferay\ext\servers\tomcat ”；修改參數(shù)“Configuration File”為“{Liferay}\ext\servers\tomcat\conf\server.xml”，在我這里也就是“D:\liferay\ext\servers\tomcat\conf\server.xml”。



接著我們要繼續(xù)給Tomcat執(zhí)行的JVM虛擬機(jī)增加運(yùn)行參數(shù)，啟用JAAS支持以及擴(kuò)大默認(rèn)內(nèi)存占用量，也就是展開“Tomcat”標(biāo)簽，選擇“JVM Settings”，在“Append to JVM Parameters”選擇“Add”，先添加

-Djava.security.auth.login.config=d:\liferay/ext/servers/tomcat/conf/jaas.config



再添加

-Xmx512m



還要在這里修改Tomcat運(yùn)行所使用的虛擬機(jī)，要注意這里必須指定一個(gè)JDK附帶的虛擬機(jī)而不可以指向JRE附帶的虛擬機(jī)環(huán)境，否則Tomcat在運(yùn)行過(guò)程中會(huì)出現(xiàn)錯(cuò)誤。如果這里的下拉選項(xiàng)沒有出現(xiàn)與JDK中虛擬機(jī)有關(guān)的選項(xiàng)，那么我們要首先手動(dòng)建立一個(gè)，我們需要到Java標(biāo)簽下的“Installed JREs”，選擇“Add”，“JRE home directory”選擇“C:\j2sdk1.4.1_07”，給這個(gè)JRE環(huán)境起個(gè)名字，比如“J2SDK1.4.1_07”，之后點(diǎn)Ok保存設(shè)置，再重新開啟“Window->Preferences”對(duì)話框，到Tomcat的“JVM Settings”項(xiàng)選擇剛才建立的“J2SDK1.4.1_07”這個(gè)JRE就可以了。



這樣，只要再配置好Liferay的數(shù)據(jù)庫(kù)連接參數(shù)，就可以通過(guò)點(diǎn)擊Eclipse里面的Tomcat圖標(biāo)啟動(dòng)Tomcat服務(wù)器了。 （轉(zhuǎn)載者注：可以通過(guò)瀏覽器測(cè)試。地址http://localhost:8080）




--------------------------------------------------------------------------------



3.3  配置數(shù)據(jù)庫(kù)和執(zhí)行Liferay
這里選擇了使用MySql數(shù)據(jù)庫(kù)，到MySql官方網(wǎng)站下載

MySql在Windows下的可執(zhí)行包mysql-5.0.21-win32.zip、

MySql的JDBC驅(qū)動(dòng)程序mysql-connector-java-3.1.12.zip、

MySql管理工具mysql-administrator-1.1.9-win.msi、

MySql數(shù)據(jù)查詢工具mysql-query-browser-1.1.20-win.msi、

MySql數(shù)據(jù)建模工具mysql-workbench-1.0.6-beta-win32.msi。



除JDBC驅(qū)動(dòng)外，其他幾個(gè)包都可以雙擊執(zhí)行安裝向?qū)瓿伞０惭b完畢后，使用MySql數(shù)據(jù)查詢工具Query Browser連接數(shù)據(jù)庫(kù)，選擇“File->Open Script”載入D:\liferay\ext\sql\create 目錄下的create-mysql.sql 文件，點(diǎn)擊“Execute”按鈕執(zhí)行。刷新會(huì)發(fā)現(xiàn)得到了新的數(shù)據(jù)庫(kù)實(shí)例lportal。



使用MySql管理工具administrator，以root用戶連接數(shù)據(jù)庫(kù)，點(diǎn)“User Administration”，在左下方用戶賬號(hào)列表一欄點(diǎn)擊右鍵，建立新用戶liferay，輸入密碼sql606，點(diǎn)擊“Schema Privileges”標(biāo)簽，點(diǎn)擊lportal數(shù)據(jù)庫(kù)，把除了grant權(quán)限外的所有權(quán)限都給liferay這個(gè)用戶，點(diǎn)擊“Apply changes”按鈕保存這個(gè)新賬戶。這樣完成了數(shù)據(jù)導(dǎo)入以及建立MySql數(shù)據(jù)庫(kù)用戶的過(guò)程。



編輯D:\liferay\ext\servers\tomcat\conf\Catalina\localhost 目錄下的ROOT.xml文件，將其中的

<Resource
name="jdbc/LiferayPool"
auth="Container"
type="javax.sql.DataSource"
driverClassName="org.hsqldb.jdbcDriver"
url="jdbc:hsqldb:test"
username="sa"
password=""
maxActive="20"
/>

替換為

<Resource
name="jdbc/LiferayPool"
auth="Container"
type="javax.sql.DataSource"
driverClassName="com.mysql.jdbc.Driver"
url="jdbc:mysql://localhost/lportal?useUnicode=true&characterEncoding=UTF-8"
username="liferay"
password="sql606"
maxActive="100"
maxIdle="30"
maxWait="10000"
/>

請(qǐng)注意，這里如果按照官方文檔的說(shuō)法設(shè)置會(huì)出現(xiàn)錯(cuò)誤，官方文檔將數(shù)據(jù)庫(kù)url中的“&”錯(cuò)誤地寫成了“&”，會(huì)造成Tomcat啟動(dòng)失敗。



再解壓MySql的JDBC驅(qū)動(dòng)程序mysql-connector-java-3.1.12.zip 中的mysql-connector-java-3.1.12-bin.jar 文件，復(fù)制到D:\liferay\ext\servers\tomcat\common\lib 目錄下，使得Liferay能夠找到MySql的JDBC驅(qū)動(dòng)。



這樣數(shù)據(jù)庫(kù)有關(guān)的內(nèi)容已經(jīng)全部配置完成，可以點(diǎn)擊Eclipse里面的Tomcat圖標(biāo)啟動(dòng)Liferay了，如果沒有出現(xiàn)錯(cuò)誤，那么已經(jīng)可以用瀏覽器訪問http://localhost:8080 訪問到Liferay Professional版本的Tomcat服務(wù)。



這里要注意，Sysdeo插件與Liferay的Tomcat綁定二進(jìn)制包默認(rèn)指定的Hypersonic數(shù)據(jù)庫(kù)驅(qū)動(dòng)有沖突，所以我們?cè)诒竟?jié)使用了MySql數(shù)據(jù)庫(kù)。如果一定要使用Hypersonic數(shù)據(jù)庫(kù)的話，就不能通過(guò)Sysdeo插件啟動(dòng)Tomcat，而需要直接執(zhí)行D:\liferay\ext\servers\tomcat\bin 目錄下的startup.bat來(lái)啟動(dòng)。




--------------------------------------------------------------------------------



3.4  完成一個(gè)最簡(jiǎn)單的JSP的Portlet
我們通過(guò)完成一個(gè)最簡(jiǎn)單的類似Hello World那樣的JSP Portlet來(lái)展示Portlet的基本組成部分，更復(fù)雜的功能或者基于Structs等框架的Portlet請(qǐng)參見后續(xù)文檔。



在D:\liferay\ext\ext-web\docroot\html\portlet\ext 目錄建立一個(gè)新的文件夾myjspportlet 。接著打開D:\liferay\ext\ext-web\docroot\WEB-INF 文件夾下的portlet-ext.xml 文件進(jìn)行編輯，加入對(duì)這個(gè)即將建立的新Portlet的描述，如下：

<portlet>
<portlet-name>EXT_2</portlet-name>
<display-name>My JSPPortlet</display-name>
<portlet-class>com.liferay.portlet.JSPPortlet</portlet-class>
<init-param>
<name>view-jsp</name>
<value>/portlet/ext/myjspportlet/view.jsp</value>
</init-param>
<expiration-cache>300</expiration-cache>
<supports>
<mime-type>text/html</mime-type>
</supports>
<portlet-info>
<title>My JSP Portlet</title>
</portlet-info>
<security-role-ref>
<role-name>Power User</role-name>
</security-role-ref>
<security-role-ref>
<role-name>User</role-name>
</security-role-ref>
</portlet>

其中各項(xiàng)的含義為：

portlet-name 描述此Portlet的規(guī)定名稱，這個(gè)名稱必須是唯一不重復(fù)的。
display-name 記錄此Portlet在Portal中的顯示名稱，在將Portlet加入到Portal中時(shí)如果看到了這個(gè)名字，那么就可以找到現(xiàn)在編寫的這個(gè)Portlet組件，此名稱不必是唯一的。
portlet-class 描述與此Portlet對(duì)應(yīng)的Java類的完整路徑。
init-param 通過(guò)name/value對(duì)的形式指定此Portlet初始化時(shí)的參數(shù)。
expiration-cache 定義Portlet輸出緩存的超時(shí)時(shí)間，以秒為單位，超出這里指定的時(shí)間后就認(rèn)為Portlet的輸出已經(jīng)超時(shí)了，如果這里是-1則說(shuō)明輸出永遠(yuǎn)不超時(shí)。
supports 包括所支持的MIME格式，同時(shí)定義對(duì)一種特定的MIME格式，此Portlet所支持的模式，所有的Portlet都必須支持View模式。
portlet-info 定義Portlet有關(guān)的信息。
security-role-ref 包含Web應(yīng)用與系統(tǒng)角色之間的映射，在Liferay中，這里表示什么樣的角色有權(quán)限訪問此Portlet。（一般來(lái)講，Power User有權(quán)個(gè)人化Portal，而User無(wú)權(quán)進(jìn)行個(gè)人化）




現(xiàn)在我們已經(jīng)完成了對(duì)Portlet的描述，現(xiàn)在我們建立此Portlet的JSP頁(yè)面，到剛才創(chuàng)建的myjspportlet目錄下，建立一個(gè)名為init.jsp的文件，加入如下兩行：

<%@ include file="/html/common/init.jsp" %>
<portlet:defineObjects />


這兩行導(dǎo)入了每個(gè)Portlet都要包含的公共class文件以及公共變量，如果需要導(dǎo)入此Portlet專用的類或者進(jìn)行此Portlet專用的變量的初始化，那么可以仿照common/init.jsp 文件中的寫法寫在myjspportlet目錄下的init.jsp文件中。



再添加一個(gè)名為view.jsp的文件，此文件將包含Portlet要輸出的內(nèi)容，再文件中寫入“Hello [your name here]!”。Portal能夠找到并且執(zhí)行這個(gè)JSP文件是因?yàn)槲覀冊(cè)趐ortlet-ext.xml文件中的init-param標(biāo)簽指定了view-jsp參數(shù)的值是/ext/myjspportlet/view.jsp ，這個(gè)JSP文件就被作為默認(rèn)的JSP頁(yè)面被顯示了。



最后，我們需要在D:\liferay\ext\ext-ejb\classes\content 目錄下的Language-ext.properties 文件中加入下面這行，才能在Portal中加入我們創(chuàng)建的這個(gè)Portlet：

javax.portlet.title.EXT_2=My JSP Portlet



因?yàn)槲覀円呀?jīng)創(chuàng)建了擴(kuò)展開發(fā)環(huán)境，因此我們可以通過(guò)Ant腳本來(lái)向Portal添加我們新創(chuàng)建的這個(gè)Portlet。在Eclipse的Ant視圖中，導(dǎo)入D:\liferay\ext 目錄下的build.xml文件，之后執(zhí)行deploy [default]這個(gè)Ant任務(wù)，就可以完成新Portlet的發(fā)布。當(dāng)這個(gè)任務(wù)執(zhí)行完畢，啟動(dòng)Tomcat，登陸系統(tǒng)，就可以在“添加內(nèi)容”功能中找到我們新創(chuàng)建的Portlet了。




--------------------------------------------------------------------------------



4.  改進(jìn)和調(diào)試Liferay自身代碼
本節(jié)將建立一個(gè)編譯、調(diào)試Liferay自身代碼的環(huán)境。如果希望參與Liferay社區(qū)對(duì)Liferay Portal的改進(jìn)開發(fā)、提交補(bǔ)丁等，則需要按照本節(jié)的說(shuō)明配置開發(fā)環(huán)境。



此外，本節(jié)也能建立一種開發(fā)和調(diào)試Portlet組件的環(huán)境，依賴于Orion服務(wù)器的熱部署特性，能夠?qū)崿F(xiàn)對(duì)Portlet組件的實(shí)時(shí)調(diào)試。但是，由于本節(jié)的調(diào)試環(huán)境是一個(gè)完整的J2EE環(huán)境，因此也是比基于Tomcat的方法更為沉重龐大的選擇，也說(shuō)不上簡(jiǎn)潔高效。具體做Portlet開發(fā)時(shí)還要根據(jù)自己工作的具體狀況和對(duì)J2EE的熟悉程度選擇一種Portlet開發(fā)環(huán)境。




--------------------------------------------------------------------------------



4.1  安裝Orion服務(wù)器
Liferay官方在開發(fā)時(shí)使用的就是Orion服務(wù)器，因此雖然可以使用其他的J2EE Server配置開發(fā)環(huán)境，我們還是選擇了Orion。而且Orion服務(wù)器對(duì)開發(fā)者和非商業(yè)應(yīng)用提供一個(gè)免費(fèi)使用的授權(quán)，同時(shí)文檔支持和應(yīng)用程序的熱部署功能也不錯(cuò)，還是值得推薦的。



首先到Orion的官方網(wǎng)站http://www. 下載Orion服務(wù)器的二進(jìn)制文件，我選擇的是2.0.6版本，那會(huì)是一個(gè)zip壓縮包。將這個(gè)壓縮包中的內(nèi)容解壓到C:\j2sdk1.4.1_07\orion 目錄下。這時(shí)進(jìn)入這個(gè)目錄，使用“java -jar orion.jar”指令應(yīng)該能夠在http://localhost 上運(yùn)行起來(lái)了。




--------------------------------------------------------------------------------



4.2  在Eclipse中配置Orion
在Eclipse中通過(guò)“Run->Debug..”菜單進(jìn)入Debug環(huán)境設(shè)置對(duì)話框。在“Java Application”下面有個(gè)“orion”標(biāo)簽，我們需要修改這個(gè)標(biāo)簽下面的參數(shù)。



“Main”標(biāo)簽下的“Project”項(xiàng)需要改為“Portal”，原來(lái)寫的是“ext”，其他的選項(xiàng)保持默認(rèn)的即可，也即“Main class”一項(xiàng)仍保持為“com.evermind.server.ApplicationServer”。



“Arguments”標(biāo)簽下，開始Eclipse會(huì)報(bào)錯(cuò)，說(shuō)“${ORION_HOME}”變量沒有定義，我們點(diǎn)擊“Program arguments”欄目下的“Variables”按鈕，在新彈出的對(duì)話框中點(diǎn)擊“Edit Variables...”按鈕，點(diǎn)擊“New”，“Name”項(xiàng)輸入“ORION_HOME”，“Value”項(xiàng)輸入“C:\j2sdk1.4.1_07\orion”，點(diǎn)擊3次Ok關(guān)閉對(duì)話框。這樣“Program arguments”欄仍保持為“-config ${ORION_HOME}/config/server.xml -userThreads”；“VM arguments”還保持為“-Xbootclasspath/a:${workspace_loc}\portal\lib\xercesImpl.jar;${workspace_loc}\portal\lib\xml-apis.jar -Xmx512m -Dfile.encoding=UTF-8 -Duser.timezone=GMT”。



在“Classpath”標(biāo)簽下，將“User Entries”下帶環(huán)境變量的orion.jar引用路徑刪除，然后點(diǎn)擊“Add External JARs”按鈕，重新添加本機(jī)上的orion.jar庫(kù)文件。



在“JRE”標(biāo)簽，選擇“Alternate JRE”，改為“j2sdk1.4.1_07”，如果這里使用純JRE的運(yùn)行環(huán)境而不是JDK附帶的運(yùn)行環(huán)境，很可能會(huì)造成Orion運(yùn)行中的一些編譯類的錯(cuò)誤。




--------------------------------------------------------------------------------



4.3  修改Orion配置參數(shù)
編輯C:\j2sdk1.4.1_07\orion\config\server.xml 文件，在行

<web-site path="./default-web-site.xml" />
下面添加行

<web-site path="./web-sites/portal.liferay.com-web.xml" />
。





并且加入行

<compiler executable="jikes" classpath="C:\j2sdk1.4.1_07/jre/lib/rt.jar" />
來(lái)啟用jikes編譯器。其中C:\j2sdk1.4.1_07/jre/lib/rt.jar 指向JDK附帶的JRE運(yùn)行環(huán)境庫(kù)。如果不啟用jikes，則會(huì)使用sun的JDK附帶的編譯器，可能與Liferay代碼造成沖突，因此建議啟用jikes。





建立新目錄C:\j2sdk1.4.1_07\orion\config\web-sites ，在其中建立文件portal.liferay.com-web.xml ，文件內(nèi)容如下：

<?xml version="1.0" ?>
<!DOCTYPE web-site PUBLIC "Orion Web-site" "http://www./dtds/web-site.dtd">

<web-site host="[ALL]" port="8080">
<default-web-app application="default" name="portal.liferay.com-web" load-on-startup="true" />
<!-- <web-app application="default" name="test-web" root="/test" load-on-startup="false" /> -->
<web-app application="default" name="portal-web" root="/portal" load-on-startup="true" />
<web-app application="default" name="tunnel-web" root="/tunnel" load-on-startup="true" />
<!-- <web-app application="default" name="axis-web" root="/axis" load-on-startup="false" /> -->
<access-log path="../../log/default-web-access.log" />
</web-site>
我沒有找到test-web和axis-web包，因此我沒有啟用這兩項(xiàng)。





編輯C:\j2sdk1.4.1_07\orion\config\application.xml文件，添加如下行：

[Get Code]
<!-- START -->

<ejb-module id="counter-ejb" path="../applications/counter-ejb.jar" remote="false" />
<ejb-module id="documentlibrary-ejb" path="../applications/documentlibrary-ejb.jar" remote="false" />
<ejb-module id="lock-ejb" path="../applications/lock-ejb.jar" remote="false" />
<ejb-module id="mail-ejb" path="../applications/mail-ejb.jar" remote="false" />

<ejb-module id="portal-ejb" path="file:D:/liferay/portal/portal-ejb/classes" remote="false" />

<web-module id="portal-web" path="file:D:/liferay/portal/portal-web/docroot" />

<web-module id="portal.liferay.com-web" path="file:D:/liferay/portal/web-sites/liferay.com-web/docroot" />
<web-module id="tunnel-web" path="../applications/tunnel-web.war" />

<!-- -->

<mail-session location="mail/MailSession" smtp-host="smtp.server.com">
<description>description</description>
<property name="mail.from" value="mail.sender@server.com" />
<property name="mail.transport.protocol" value="smtp" />
<property name="mail.smtp.from" value="mail.sender@server.com" />
</mail-session>

<user-manager class="com.evermind.sql.DataSourceUserManager">
<property name="dataSource" value="jdbc/LiferayPool" />
<property name="table" value="User_" />
<property name="usernameField" value="userId" />
<property name="passwordField" value="password_" />
<property name="defaultGroups" value="users" />
<property name="staleness" value="0" />
</user-manager>

<!-- END -->


官方文檔說(shuō)如果使用了“80%9d\j2sdk1.4.1_07\orion\applications\bf%99a0e7%9a%84ae%9abd%8d96e58fbc%8c88%99a6%81bf%9daf%819cgreen%C:' rel='nofollow'>file:”這樣的定位方式，則要保證在C: 目錄中沒有portal-ejb.jar文件，通常這個(gè)文件產(chǎn)生于Ant腳本的Deploy過(guò)程。不過(guò)我不清楚官方文檔為什么提出這一點(diǎn)，也沒發(fā)現(xiàn)有什么影響?？赡苋绻嬖谶@個(gè)jar文件，則源碼目錄下的classes文件都會(huì)被覆蓋，這樣如果只是修改并編譯了源碼目錄下的classes文件，很可能由于jar文件的覆蓋而沒法生效，給調(diào)試帶來(lái)麻煩。



接著配置MySql數(shù)據(jù)源，參考3.3節(jié) 配置數(shù)據(jù)庫(kù)和執(zhí)行Liferay的做法，在數(shù)據(jù)庫(kù)中建立與Liferay對(duì)應(yīng)的數(shù)據(jù)庫(kù)lportal，將MySql的Java版本驅(qū)動(dòng)的jar文件復(fù)制到C:\j2sdk1.4.1_07\orion\lib 目錄下。再編輯C:\j2sdk1.4.1_07\orion\config\data-sources.xml ，使之內(nèi)容如下：

<?xml version="1.0"?>
<!DOCTYPE data-sources PUBLIC "Orion data-sources" "http://www./dtds/data-sources.dtd">

<data-sources>
<!--
An example/default DataSource that uses an ordinary
JDBC-driver (in this case hsql) to create the connections.
This tag creates all the needed kinds
of data-sources, transactional, pooled and EJB-aware sources.
The source generally used in application code is the "EJB"
one - it provides transactional safety and connection pooling.
-->
<data-source
class="com.evermind.sql.DriverManagerDataSource"
name="Liferay"
location="jdbc/LiferayCore"
pooled-location="jdbc/LiferayPool"
xa-location="jdbc/xa/LiferayXA"
ejb-location="jdbc/LiferayEJB"
connection-driver="com.mysql.jdbc.Driver"
url="jdbc:mysql://localhost/lportal"
username="liferay"
password="sql606"
inactivity-timeout="30"
schema="database-schemas/"
/>
</data-sources>



--------------------------------------------------------------------------------



4.4  修改Liferay的配置文件
Liferay使用一個(gè)名為portal.properties 的文件來(lái)配置一些重要的參數(shù)，但我們一般不要直接修改這個(gè)文件，而是另外寫一個(gè)配置文件來(lái)覆蓋里面的設(shè)置即可，這樣可以比較容易地使我們的修改與Liferay的官方設(shè)置相兼容。在D:\liferay\portal\util-java\classes 目錄下建立一個(gè)名為portal-ext.properties的文件（官方文檔寫這個(gè)文件的存放位置寫錯(cuò)了）。填寫這個(gè)文件的內(nèi)容為：

portal.ctx=/portal





--------------------------------------------------------------------------------



4.5  向Orion上部署Liferay系統(tǒng)
在D:\liferay\portal\ 目錄建立一個(gè)app.server.{username}.properties 文件，在我的機(jī)器上就是app.server.Administrator.properties 文件（{username}的含義參考“3.1節(jié) 配置擴(kuò)展開發(fā)環(huán)境”，文件內(nèi)容為

app.server={orion}
在我這寫的就是

app.server=C:/j2sdk1.4.1_07/orion




到Eclipse的Ant視圖順序執(zhí)行portal項(xiàng)目中的start和deploy任務(wù)。記得刪除portal-ejb.jar文件。



在Eclipse中用Debug界面啟動(dòng)Orion，這時(shí)應(yīng)該可以在http://localhost:8080 看到啟動(dòng)的Liferay了。（如果Ant腳本運(yùn)行的時(shí)候說(shuō)什么javac類找不到，那么調(diào)整Eclipse菜單中的：Windows->Preferences窗口中的Ant配置，把JDK的lib目錄下的tools.jar文件顯式引用進(jìn)去，就一切正常了（不可以是JRE的lib目錄下的tools.jar文件，那不一樣）。）




--------------------------------------------------------------------------------



4.6  另一種調(diào)試Portlet組件的方法
在Liferay的portal源碼工作環(huán)境下，還有一種開發(fā)調(diào)試Portlet組件的方法。我們用D:\liferay\portal\portlets\sample-jsp-portlet.war 這個(gè)Liferay自帶的Portlet作為例子。



我們將D:\liferay\portal\portlets\sample-jsp-portlet.war 目錄復(fù)制成為D:\liferay\sample-jsp-portlet 目錄，之后修改C:\j2sdk1.4.1_07\orion\config\application.xml文件，添加如下行



<web-module id="sample-jsp-portlet" path="file:D:/liferay/sample-jsp-portlet" />


再修改C:\j2sdk1.4.1_07\orion\config\web-sites\portal.liferay.com-web.xml 文件，在其中添加如下行



<web-app application="default" name="sample-jsp-portlet" root="/sample-jsp-portlet" load-on-startup="true" />


之后重啟Orion，登陸Liferay后就可以在“Add Content”界面的Test類別中找到這個(gè)sample-jsp-portlet。