|
liferay porta安裝指南(初稿).............................................................................................. 1 1 介紹............................................................................................................................. 2 1.1 入門................................................................................................................... 2 1.2 推薦配置............................................................................................................ 2 2 安裝............................................................................................................................. 2 2.1 配置開發(fā)環(huán)境..................................................................................................... 2 2.2 獲得liferay portal 源碼........................................................................................ 3 2.3 安裝你的IDE--Eclipse......................................................................................... 3 2.4 用liferay的源碼做開發(fā)........................................................................................ 3 2.4.1 獲得Orion容器......................................................................................... 4 2.4.2 在Eclipse中配置Orion.............................................................................. 4 2.4.3 啟動(dòng)Orion................................................................................................. 5 2.4.4 配置你的Properties.................................................................................... 6 2.4.5 配置Orion................................................................................................. 6 2.5 創(chuàng)建擴(kuò)展環(huán)境..................................................................................................... 7 2.5.1 啟動(dòng)擴(kuò)展................................................................................................... 7 2.5.2 添加插件(主要是編譯專業(yè)版).................................................................... 8 2.5.3 掛載數(shù)據(jù)庫............................................................................................... 8 2.5.4 starting Liferay............................................................................................ 8 3 關(guān)于翻譯...................................................................................................................... 8 1 介紹 牋 在這個(gè)文檔中,我的目標(biāo)是幫助大家設(shè)置你的額開發(fā)環(huán)境,使你可以自己在這個(gè)軟件上開發(fā)出portlets.這個(gè)文檔的起點(diǎn)是你必須具備一些web常識(shí)以及做Servlet,jsp的開發(fā)經(jīng)驗(yàn).你們可能會(huì)在不同的操作系統(tǒng)上運(yùn)行.我的能力有限,但是我會(huì)盡量保證這個(gè)配置可以適用于不同的系統(tǒng) 牋 雖然你的配置可能不高,但是作為開發(fā)和定制化Liferay,我們推薦下列硬件配置: 配置Liferay可以完成任何企業(yè)級(jí)的JAVA應(yīng)用任務(wù). Liferay控制使用幾個(gè)框架. 幸運(yùn)的是,大部分的框架Liferay已經(jīng)把它捆綁在了一起. 如果你想在Liferay上安裝一些其他的工具.首先你要確保你的機(jī)器上已經(jīng)正確安裝java JDK.你最好在你的機(jī)器上安裝最新穩(wěn)定的J2SE 接著設(shè)置你的環(huán)境變量:在WIndows下,打開控制面板/系統(tǒng)/高級(jí)/環(huán)境變量,新建變量:JAVA_HOME,ANT_HOME,JIKES_HOME 注意要把他們的路徑寫正確.設(shè)置JAVA的CLASSPATH以便其他的應(yīng)用能在機(jī)器上運(yùn)行.在PATH中添上%ANT_HOME%\bin;%JAVA_HOME%\bin;%JIKES_HOME%\bin 現(xiàn)在開始,從 http://www./web/guest/downloads/portal_source 下載最新穩(wěn)定的Liferay portal企業(yè)版代碼. 我把它解壓縮到這個(gè)目錄 D:\cvsroot\liferay (我使用CVS來儲(chǔ)存代碼),接下來我們將使用{Liferay}來代表這個(gè)目錄. 當(dāng)你下載了這個(gè)穩(wěn)定的Liferay,Then download the latest stable Liferay,這個(gè)指南已經(jīng)包括了基于tomcat的專業(yè)版.我將在稍后在這章介紹關(guān)于Tomcat的捆綁. 盡管你可能用記事本修改或者部署Liferay portal 一些簡單的事情,但是一個(gè)好的IDE工具可以加速提升你的工作.我向你展示 Eclipse這個(gè)工具,它可以很方便的部署和運(yùn)行Liferay portal.下載最新的Eclipse版本 http://www./downloads/index.php. 安裝 Eclipse 到 {Java}\eclipse 且運(yùn)行它.在菜單上 選擇File/ Switch Workspace…然后選擇 {Liferay}這個(gè)目錄. 在workspace中啟動(dòng)你的工程, 選擇 File /New/Project. 在對(duì)話框中選擇Java Project 然后點(diǎn)擊Next.在這個(gè)新的窗口中輸入portal作為Project Name然后點(diǎn)擊Finish. 如果你恰當(dāng)設(shè)置Workspace, 你應(yīng)該可以在導(dǎo)航中看到portal這個(gè)工程的透視圖. 在這個(gè)工程的根目錄上單擊鼠標(biāo)右鍵選擇Properties/Java Build Path 點(diǎn)擊右邊Libraries你需要的jar包都已經(jīng)加載上了.這些jar文件是通過{Liferay}\portal 下面的 .classpath 文件定義加載的. 添加Eclipse的插件是很容易的事情. 自從 Eclipse集成Ant以后,啟動(dòng)Ant是個(gè)很容易的事情在Window菜單下選擇Show View/Ant. 你就可以看到這個(gè)Ant顯示在你的透視圖中. 增加 Liferay’s 構(gòu)建文件也是這樣的簡單.簡單到你就選擇透視圖上面的Ant然后單擊Ant +這個(gè)符號(hào). 注意這樣會(huì)用Ant讀到出現(xiàn)每個(gè)目錄中自己的build.xml文件. 我們單擊選擇portal這個(gè)目錄中的build.xml文件. 你的啟動(dòng)圖形如圖 2.3. 2.4 用liferay的源碼做開發(fā) 在一下部分我們主要介紹怎么使用Orion這個(gè)容器對(duì)Liferay的源碼做開發(fā)和調(diào)試. It is important to note that working off the core source is not recommended.如果你想要擴(kuò)充Liferay portal的功能的話,它是你要增加一個(gè)擴(kuò)充的環(huán)境(在2.5節(jié)我們主要講怎么擴(kuò)展功能).Development of the core portal should only be done for bug fixes or enhancements that potentially would make it into the next build. Typical developers will not need to read this section. 首先從 http://www. , 下載Orion. 把這個(gè)文件釋放到(i.e. {Java}\orion-2.0.6)這個(gè)目錄,以下我將使用{orion}來代表上面這個(gè)路徑.運(yùn)行這個(gè)命令來測試你的服務(wù)“java –jar orion.jar”. 2.4.2 在Eclipse中配置Orion 在Eclipse中啟動(dòng)運(yùn)行Orion需要我們稍微花些時(shí)間設(shè)置一下.首先在你的透視圖下,右鍵工程名稱在出來的菜單中選擇Debug as/Debug,然后會(huì)出來一個(gè)對(duì)話框. 如果你以前在 Java Application下面已經(jīng)配置好一些,你可以新建一個(gè)或者刪除它.在前面點(diǎn)擊New這個(gè)按鈕, 并且改變下列內(nèi)容: Main Tab頁: 1. 改變name配置為 “orion” 2. 設(shè)置 Main class 為 “com.evermind.server.ApplicationServer” Arguments Tab頁: 1. Program arguments: -config {orion}/config/server.xml - userThreads (note that you need to change the directory path) 2. VM arguments: -Xmx256m - Dfile.encoding=UTF8 - Duser.timezone=GMT Classpath Tab頁: 1. under the User Entries group, remove the “portal (default classpath)” entry 2. 單擊 Add External JARs,在系統(tǒng)中找到你安裝orion的目錄中的orion.jar 添加它
配置Orion有三個(gè)關(guān)鍵的文件. 第一個(gè), {orion}\config\server.xml, let’s you specify which “web-sites” will be accessible when started up. 增加一個(gè)新的 website 并插入這些內(nèi)容: <web-site path="./web-sites/portal.- web.xml" />
你還的指定一個(gè)Orion的另一個(gè)編譯器: <compiler executable="jikes" classpath="{Java}\jre\lib\rt.jar" /> 現(xiàn)在你已經(jīng)詳細(xì)指定了這個(gè)新的website,你需要?jiǎng)?chuàng)建一個(gè)調(diào)用文件portal.-web.xml 在這個(gè)目錄中{orion}\config\web-sites\. 你可以看到類型于(Figure x.2. portal.-web.xml)的圖. 最后, 在{orion}\config\application.xml, 你需要增加兩個(gè)模塊web- module 和ejb-module.所有web-app的元素聲明在你的 portal.web.xml但是這些聲明也必須定義在你的 application.xml:見圖(Figure x.3. application.xml) 通過插入ejb-module元素給你的EJBs增加一個(gè)適當(dāng)?shù)膮⒖?SPAN lang=EN-US>. 注意你可以在Orion中通過使用"file:"前綴直接找文件. An advantage of using this prefix is that you don’t have to deploy your files to the server. 這個(gè)可以有助于你快速的調(diào)試JSPs (簡單的保存和更新你的JSP).另一個(gè)原因是它可以很好的編譯和部署source文件成為class.
最后,你必須編輯 {orion}\config\data- sources.xml 是你的應(yīng)用能訪問到你的數(shù)據(jù)庫. 如果你使用的mysql請(qǐng)確認(rèn)mysql.jar已經(jīng)部署到 {orion}\lib\目錄, 配置你data- sources.xml 文件例似下面: <data-sources> <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="root" password="" inactivity-timeout="30" schema="database-schemas/mysql.xml" /> </data-sources> Liferay的配置多數(shù)都在 portal.properties 這個(gè)文件中. 類似于你的這個(gè)文件 build.properties,你在portal- ext.properties設(shè)置它的屬性都比在portal.properties它本身根方便. 給你的portal配置一個(gè),創(chuàng)建一個(gè)新的文件在{Liferay}\portal\util-java\ 這個(gè)目錄中文件名為portal- ext.properties. 在里面添加下列設(shè)置: portal.ctx=/portal 此外,注意在這個(gè)portal- ext.properties設(shè)置這個(gè)屬性就不用考慮在portal.properties設(shè)置. 如果你想要你的Ant命令知道在什么地方部署它,你需要?jiǎng)?chuàng)建一個(gè)擴(kuò)展名類app.server.{username}.properties. 在這個(gè)文件中添加一行 app.server={orion} 這個(gè) {orion} 就是我們安裝Orion的目錄, 例如這樣 (i.e. app.server=D:/Java/orion- 2.0.5). 最后用你Eclipse的Ant 顯示, 運(yùn)行你portal目錄中的start和delpoy 標(biāo)記. 如果你使用"file"前綴,不要忘記去刪出portal-ejb.jar 以后部署! 你全部設(shè)置了! 在你的Debug透視圖中到前面單擊bug 這個(gè)圖標(biāo),這時(shí)在你的控制臺(tái)就會(huì)看到Orion開始啟動(dòng). 通過擴(kuò)展環(huán)境來開發(fā)和部署你的portlets 是你最感興趣的. 這樣可以改良你的portal但是不會(huì)讓你有任何頭痛的. 任何時(shí)間發(fā)布一個(gè)新的穩(wěn)定的Liferay portal 的版本,是你做的并且是一個(gè)震驚的,你可以把它賣掉.同樣可是說你開發(fā)一個(gè)健壯的擴(kuò)展環(huán)境. 所有新的classes,JSPs,和所有的新的改變都應(yīng)該在{Liferay}\ext里面. It is in your best interest to develop your portlets via an Extension Environment. This would allow you to upgrade your portal without any headaches. Any time a new stable version of Liferay Portal is released, all you would need to do is drop in the new jars and you’re set to go. With that said, your development should only be done within the Extension Environment as well. Meaning, all new classes, JSPs, and all changes in general, should be within {Liferay}\ext. 設(shè)置啟動(dòng)你的擴(kuò)展環(huán)境是很簡單的. 在做任何事情之前,你需要改變一個(gè)屬性文件(.properties)在 {Liferay}\portal目錄中. 注意在這個(gè).properties 默認(rèn)的文件中你從未改變這個(gè)值. 在每個(gè).properties文檔的頂部遵循它的注釋替換(改變),需要?jiǎng)?chuàng)建一個(gè)擴(kuò)展名類似于這個(gè)release.{username}.properties的文件. 你可以在開始/運(yùn)行 下打開一個(gè)命令提示這個(gè)${username}的值會(huì)出現(xiàn)在Documents and Settings 后面.在你的這個(gè)新的.properties文件中添加正確的一行({Liferay}是真實(shí)的目錄: lp.ext.dir={Liferay}/ext (Note that it’s a forward slash) 接下來, 在2.3節(jié)中描述的Ant顯示中,你能夠擴(kuò)展portal build.xml中的對(duì)象(taegets)列表. 在這些對(duì)象(taegets)中,你可以看到 clean, start, build- ext.向前雙擊那些對(duì)象(taegets)一會(huì)兒觀察它的輸出. 你將看到一大堆文本的輸出通過指示說明你的擴(kuò)張環(huán)境在運(yùn)行.請(qǐng)仔細(xì)檢查控制臺(tái)輸出的紅色錯(cuò)誤. 你可能發(fā)現(xiàn)你有一些可怕的錯(cuò)誤設(shè)置在你的屬性中. 如果所有的都很好,那么你應(yīng)該能到這里瀏覽你你擴(kuò)展目錄 {Liferay}\ext! 2.5.2 添加插件(主要是編譯專業(yè)版) 主要是添加一個(gè)Tomcat編譯環(huán)境老啟動(dòng)Liferay的專業(yè)版.大家看文檔吧,確實(shí)累了 對(duì)于這樣掛載數(shù)據(jù)庫請(qǐng)大家參考這個(gè),http://www./web/guest/documentation/development/databases 現(xiàn)在你有一個(gè)完整的開發(fā)環(huán)境,到前面單擊Tomcat這個(gè)圖標(biāo)來啟動(dòng)你的web 服務(wù).此時(shí)在你的portal已經(jīng)啟動(dòng),你可以在瀏覽器中輸入 http://localhost 來查看運(yùn)行效果! liferay.cn 蚊子 MSN:wenbin151@hotmail.com 歡迎大家關(guān)注中文Liferay .因?yàn)楸救怂接邢?/SPAN>(實(shí)際還沒有通過英語四級(jí)),一些文字描述是根據(jù)我的理解寫的.也有我同事(flora:flora@hotmail.com)的幫助.我代表中文Liferay謝謝我的partner:flora(MM).呵呵.Good luck! |
|
|
