liferay_6_開發(fā)文檔_ 別人的_我來讓大家免費下

1、這個是別人的，但是是要收財富值的，哈哈，我來給大家免費純屬個人理解，不確保全部正確，僅供新手參考。一、Liferay的安裝與使用    目前l(fā)iferay的最新版本是liferay portal 6.0.5，下載地址：；這里下載的是liferay與tomcat6綁定的版本，而且自帶jdk1.6，下載完后需要做以下幾個步驟便可輕松跑起來liferay了。1、下載完后最好找個文件夾專門用來做liferay的工作空間，因為以后好多文件下載，這樣方便管理。首先解壓liferay-portal-tomcat-6.0.5.zip，解壓后其目錄結(jié)構(gòu)如下:liferay

2、-portal-tomcat-6.0.5/liferay-portal-6.0.5/data/目錄下放是liferay自帶的例子（7coogs）、數(shù)據(jù)庫hsql的腳本及l(fā)ucene產(chǎn)生的文檔。liferay-portal-tomcat-6.0.5/liferay-portal-6.0.5/tomcat-6.0.26/這個就是tomcat的home目錄了，里面的結(jié)構(gòu)和一般的tomcat是一樣的，在webapps目錄中放的就是liferay portal 的應(yīng)用war包了，其中ROOT是最重要的，你會發(fā)現(xiàn)WEB-INF/classes中沒有class文件，因為它們被打成jar包放在WEB-INF/

3、lib下了，這樣效果也一樣。2、liferay中自帶hsql數(shù)據(jù)庫，如果你要改其他數(shù)據(jù)庫的話可以在liferay-portal-tomcat-6.0.5/liferay-portal-6.0.5/tomcat-6.0.26/webapps/ROOT/WEB-INF/classes下新建一個perties文件，內(nèi)容如下(這里用mysql當(dāng)作例子):    #    # MySQL    #    jdbc.de

4、fault.driverClassName=com.mysql.jdbc.Driver    jdbc.default.url=jdbc:mysql:/localhost/lportal?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false    jdbc.default.username=root    jdbc.default.password=1234其他數(shù)據(jù)庫配置可以參見：+P

5、ortal+Properties上面的配置僅僅只是liferay 6.0 之后的方法，與之前的版本還是有不同的，具體的各版本的數(shù)據(jù)庫配置可以參考：+Configuration3、在liferay-portal-tomcat-6.0.5/liferay-portal-6.0.5/tomcat-6.0.26/bin 目錄中執(zhí)行startup.bat，此時就已經(jīng)啟動tomcat了，一般會啟動5分鐘左右。啟動完畢后會自動在瀏覽器中打開http:/localhost:8080,這樣你就可以開始訪問liferay portal 了。4、登錄liferay Portal在打開的瀏覽器中，點擊右上角的logi

6、n，輸入帳號和密碼。在這里的輸入的帳號密碼為email:password:brunoliferay從5.2之后的版本中都帶有一個7cogs.inc公司的示例數(shù)據(jù)庫，所以這里的管理員帳號密碼如上。如果刪除示例數(shù)據(jù)庫，則賬號密碼如下：email:password:test5、刪除7cogs例子a、在tomcat/webapps下面找到目錄sevencogs-hook這個目錄，刪除掉b、在刪除與tomcat平級的data/hsql目錄c、重啟tomcat，這時的管理員帳號就變?yōu)?test6、liferay啟動的時候日志信息是亂碼怎么辦？打開liferay-portal-tomcat-6.0.5/li

7、feray-portal-6.0.5/tomcat-6.0.26/conf/ 目錄下的perties文件，加上一句java.util.logging.ConsoleHandler.encoding = gbk ，重新啟動就行了。二、搭建liferay的開發(fā)環(huán)境1、 開發(fā)方式介紹從6.0 開始提供可eclipse可視化的插件之后就更加的友好，開發(fā)一個portlet或者一個hook都只需點點鼠標(biāo)即可完成，這在官方wiki里面可以找到視頻教程。在準(zhǔn)備開發(fā)之前需要先了解“portlet規(guī)范”，然后再看liferay 6 的開發(fā)指南，之后再看下面的內(nèi)容。Liferay 6開發(fā)文檔下

8、載地址：Portlet 規(guī)范介紹文檔下載地址：2、 首先需要下載liferay的sdk（開發(fā)環(huán)境包）、liferay ide（開發(fā)環(huán)境的插件）。sdk的下載地址：liferay ide下載地址：安裝此插件的時候eclipse要用3.6版本的。在自己的工作目錄解壓sdk包liferay-plugins-sdk-6.0.5.zip、在eclipse中安裝liferay ide。解壓sdk后看到其目錄結(jié)構(gòu)如下：有ext、hook、portlet等目錄中放的是ext、hook、portlet以插件形式開發(fā)的文件。要修改一下sdk目錄下perties文件中運行環(huán)境目錄，此處使用tomc

9、at，所以修改大約76行修改為類似下的目錄地址：    app.server.dir=D:/liferay/liferay-portal-6.0.3/tomcat-6.0.26以portlet為例子，里面有build.xml、build-common-portlet.xml、create.bat、create.sh、portlet.zip這5個文件，不用說build.xml、build-common-portlet.xml是ant文件應(yīng)該都知道，create腳本就是新建一個插件工程，工程目錄結(jié)構(gòu)在portlet.zip中。但是現(xiàn)在有了liferay id

10、e后就不用執(zhí)行腳本創(chuàng)建了，而是直接用eclipse。這里有l(wèi)iferay ide 的使用方法：+IDE+1.1+New+and+Noteworthy。在使用liferay ide的過程中需要配置sdk和與綁定tomcat的目錄，這里就不做詳細(xì)介紹了，就是路徑的問題。裝完ide后的圖示：3、搭建完環(huán)境后新建一個liferay plugin project，可以new portlet、Hook（擴展環(huán)境）、ext（擴展環(huán)境）、theme（主題）、layout（布局）類型的;其中new Portlet 和Hook 的時候會得到liferay ide的幫助，即自動生成一些配置文件，而且這兩種擴展的目錄

11、結(jié)構(gòu)相同都能熱部署，所以hook和portlet可以合并起來開發(fā)，它們在相同的目錄結(jié)構(gòu)下能夠只能夠覆蓋jsp頁面，java類和配置文件也只能覆蓋部分，而且它們跟ROOT是分開的war包。 ext擴展環(huán)境更加靈活！可以修改任何東西，但是ide不提供菜單方式，對于jsp頁面可以在/docroot/WEB-INF/ext-web/docroot 目錄下可以創(chuàng)建與源碼中相同目錄結(jié)構(gòu)即可覆蓋。java類的目錄則是創(chuàng)建工程的時候已經(jīng)創(chuàng)建好的，例：ext下的/docroot/WEB-INF/ext-impl/src 目錄對應(yīng) 源碼中的/portal-impl/src目錄。如果我要修改源碼中的LoginAct

12、ion.java，那么我需要在/docroot/WEB-INF/ext-impl/src 目錄中新建com.liferay.portlet.login.action包（和源碼中包名相同）。源碼中的一些配置文件都在/portal-web/docroot/WEB-INF/下，在ext中對應(yīng)在/docroot/WEB-INF/ext-web/docroot/WEB-INF/目錄下。三、plugin項目的部署。 1、 在liferay的根sdk目錄中會發(fā)現(xiàn)perties配置文件，里面是一些關(guān)于配置web服務(wù)器的路徑。2、 將其復(fù)制一份，改名為build.$pe

13、rties,這里的username即計算機的用戶，可以在命令行中查看C:Documents and SettingsAdministrator>，我的是build.Aperties。 3、修改build.Aperties中的app.server.dir，把它修改成你tomcat的路徑。 4、eclipse中配置剛才的sdk，然后new Liferay Plugin Project，之后找到在根目錄下的build.xml,直接執(zhí)行direct-deploy即可。 此時到/tomcat/webapps 目錄下會看到被部署過去的項

14、目，部署其他類型的plugin也是如此。 5、啟動tomcat即可。四、配置文件之間的關(guān)系 在開發(fā)liferay的時候肯定一些原有的portlet是需要修改的，但是怎么能從頁面中看到的那個portlet一直找到源碼中你想要修改java類和jsp頁面呢？根據(jù)一段時間的研究發(fā)現(xiàn)這個方法，但是看起來很笨。 例如：我要修改登陸時用到的portlet和頁面，我是這樣找到的portlet和jsp頁面的。 1、在頁面中“右鍵”-“查看源文件”，“Ctrl+F”搜索一下portlet的標(biāo)題，即“sign in”。 2、找到之后會發(fā)現(xiàn)標(biāo)題上面有段代碼 <section class="portle

15、t" id="portlet_58“>，可以確定這個portlet的id是47。 3、上面的id對應(yīng)源碼中的liferay-display.xml中portlet的id、對應(yīng)portlet-custom.xml和liferay-portlet.xml中<portlet-name>標(biāo)簽的值。 4、找到portlet-custom.xml中對應(yīng)的portlet后 <init-param><name>view-action</name><value>/login/login</value></in

16、it-param>其中/login/login 即對應(yīng) struts-config.xml中<action>的path屬性值，從而可以找到其對應(yīng)的java類。 5、<forward>的path屬性值對應(yīng)tiles-defs.xml中<definition>的name屬性值，從而可以找到其對應(yīng)的jsp頁面。 ps：關(guān)于tiles與struts1的配置可以參考。五、自定義布局 （layout）1、在liferay ide 出來之前自定義布局都是在tpl（freemarker）文件中直接寫代碼，現(xiàn)在直接用可視化工具就能畫布局。先new Liferay lay

17、out Template Plug-in Project ，打開生成的tpl文件可以用工具拖拽layout。 對于它的使用沒什么難的，部署則跟上面講的一樣。要么就在ROOT/layouttpl/custom中直新建tpl模板文件，之后在ROOT/WEB-INF/liferay-layout-templates.xml中配置。2、可以查看tpl中生成的代碼與liferay自帶的模板文件做對比，找找規(guī)律其實挺簡單的。六、自定義主題（theme）liferay portal中每個頁面都可以設(shè)置不同的theme，在ROOT/html/themes/目錄中每個文件夾就代表一個theme，liferay默

18、認(rèn)的theme就是基于_styled的，不過這個theme中的樣式只是提供給portlet的，而默認(rèn)使用的主題是classic，打開_classic可以看到其目錄結(jié)構(gòu)如下。這里的_diffs目錄是自定義theme最主要的，除_diffs之外的目錄都是theme所需的資源目錄。如果你想要覆蓋當(dāng)前的theme的樣式則可以在這個目錄中創(chuàng)建與其他資源目錄相同結(jié)構(gòu)的目錄、之后創(chuàng)建相同名字的文件就會覆蓋。或者直接改資源目錄里的css文件、.vm文件也都可以。1、 自定義liferay的主題還是有兩種方法，像自定義layout一樣，一種是用liferay ide ，一種是直接在ROOT中改。2、 使用liferay ide自定義主題。首先New Liferay theme Plug-in Project，工程中會出現(xiàn)_diffs目錄，這時需要從ROOT/html/theme/classic 中拷貝css、images、js、templates 目錄到工程中與_diffs同級?，F(xiàn)在等于擁有了跟classic一模一樣的一套theme，如果想改動樣式則在diffs中改，這樣比較好維護