Liferay Portal学习笔记（四）：搭建开发环境

当我们再对 liferay 源代码进行研究或者对某个类进行修改的时候很不方便，所以我们需要搭建一个开发环境，这样在修改 liferay 源代码的时候就更加方便。下面我们会一步步搭建 liferay 的开发环境。

<o:p> </o:p>

一、 准备工作

1 、下载下列文件，下载步骤这里省略：

      jdk-1_5_0_06-windows-i586-p.exe

      liferay-portal-tomcat-jdk5-<st1:chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">4.0.0</st1:chsdate>.zip

      liferay-portal-src-<st1:chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">4.0.0</st1:chsdate>.zip

      liferay-portal-sql-<st1:chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">4.0.0</st1:chsdate>.zip

2 、安装 JDK ，具体的安装及配置过程这里省略。

3 、我们假定 Eclipse 及 Tomcat 插件都已安装，若还没有安装，请参考相关文档准备好开发工具，这里省略该步骤。

4 、如果对 liferay 安装过程有疑问，可参考作者的另一篇文章。

      Liferay Portal学习笔记（一）：安装

二、 搭建开发环境

1、  在 Eclipse 中新建项目 liferayPortal ，并设置源文件夹为 src ，输入文件夹名为 liferay/WEB-INF/classes 。

2、  将 liferay-portal-tomcat-jdk5-<st1:chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">4.0.0</st1:chsdate>.zip 解压缩后并拷贝到项目 liferayPortal 根目录下，然后改名为 tomcat 。

3、  将 liferayPortal/tomcat 目录下的 liferay 目录剪切到项目 liferayPortal 根目录下覆盖原目录。

4、  将 liferay-portal-src-<st1:chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">4.0.0</st1:chsdate>.zip 解压缩，然后将 liferay-4.0.0-src/portal-ejb/src 目录下的 com 文件夹拷贝到项目 liferayPortal/src 目录下。

5、  将 liferay-<st1:chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">4.0.0</st1:chsdate>-src/util-jsf/src/com/liferay 目录下的 util 文件夹拷贝到项目 liferayPortal/src/com/liferay/ 目录下。

6、  拷贝 liferay-<st1:chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">4.0.0</st1:chsdate>-src/portal-ejb/classes 目录下除 com 文件夹外其他全部的文件夹及文件到项目 liferayPortal/src 目录下。

7、  拷贝 liferay-<st1:chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">4.0.0</st1:chsdate>-src/portal-ejb/classes/com/liferay/portal 下的 definitions 文件夹到项目 liferayPortal/src/com/liferay/portal 目录下。

8、  修改 liferayPortal/tomcat/conf/Catalina/localhost 目录下的 ROOT.xml 文件中的 docBase 路径，指向 liferayPortal/liferay 目录。

9、  将 liferay-<st1:chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">4.0.0</st1:chsdate>-src/lib 目录下的所有 jar 包全部添加到项目 liferayPortal 中。

10、 将 liferayPortal/liferay/WEB-INF/lib 下的 compression-filter.jar 、 counter-ejb.jar 、 documentlibrary-ejb.jar 、 ext-ejb.jar 、 lock-ejb.jar 、 mail-ejb.jar 、 secure-  filter.jar 、 strip-filter.jar 、 util-java.jar 、 util-taglib.jar 、 util-wsrp.jar 共 11 个包加到项目中。

11、 将 liferayPortal/tomcat/common/lib/ext 目录下的 portal-shared.jar 包加到项目中。

12、 在 liferayPortal/src 目录下新建文件 portal-ext.properties ，内容为：

portal.release=professional

13、 在“首选项－ >Java — > 已安装的 JRE ”里选择之前安装的 jre<st1:chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">1.5.0</st1:chsdate>_06 。
 

14、 在“首选项－ >Tomcat ”项中指定 tomcat 的版本为 Version 5.x ，并且指定“ Tomcat home ”路径为项目 liferayPortal/tomcat 目录。

15、 在“首选项－ >Tomcat － >JVM Settings ”项，设定 JRE 的版本为“ jre<st1:chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">1.5.0</st1:chsdate>_<st1:chmetcnv unitname="”" sourcevalue="6" hasspace="False" negative="False" numbertype="1" tcsc="0" w:st="on">06”</st1:chmetcnv>，并且添加如下几个JVM Parameters ：

         -Xms<st1:chmetcnv unitname="m" sourcevalue="128" hasspace="False" negative="False" numbertype="1" tcsc="0" w:st="on">128m</st1:chmetcnv>

         -Xmx<st1:chmetcnv unitname="m" sourcevalue="512" hasspace="False" negative="False" numbertype="1" tcsc="0" w:st="on">512m</st1:chmetcnv>

         -Dfile.encoding=UTF8

         -Duser.timezone=GMT+08

         -Djava.security.auth.login.config=D:\devtool\eclipse\workspace\liferayPortal\tomcat\conf\jaas.config

    这里最后一个参数一定要指明 jaas.config 文件的路径
     
三、创建数据库

1 、本例中我们已 SQL Server 数据库为例，介绍怎样连接数据库。

2 、解压缩 liferay-portal-sql-<st1:chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">4.0.0</st1:chsdate>.zip 文件后，导入目录 liferay-portal-sql-4.0.0/create 下的 create-sql-server.sql 文件即可建立 liferay 应用在 SQL Server 上的数据库，数据库名为 lportal 。

（导入 sql 文件命令参见 C:\Program Files\Microsoft SQL Server\80\Tools\Binn\osql.exe ）

3 、修改 liferayPortal/tomcat/conf/Catalina/localhost 目录下的 ROOT.xml 文件，指定连接 SQLServer 的驱动类名称、数据库 URL 及用户和密码，修改结果如下：

<resource></resource>        name="jdbc/LiferayPool"        auth="Container"        type="javax.sql.DataSource"        driverClassName="net.sourceforge.jtds.jdbc.Driver"        url="jdbc:jtds:sqlserver://localhost:1433;DatabaseName=lportal"        username="sa"     password="sa"     maxActive="100" />

4 、拷贝 liferay-<st1:chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">4.0.0</st1:chsdate>-src/lib 目录下的 jtds.jar 包到 liferayPortal/tomcat/common/lib/ext 目录下。

四、启动服务器

在 Eclipse 中启动 Tomcat ，当出现如下画面时，表示 Tomcat 启动成功。

 在浏览器中访问：http://localhost:8080即可出现liferay界面。

到此，我们的开发环境已经搭建完成。