基于LiferayPortal4.2.2二次开发环境搭建

Liferay Portal二次开发环境搭建

Liferay版本：4.2.2

一、软件平台需求：

1、jdk1.5.0_07-windows-i586-p.exe

2、apache-ant_1.7.1

3、jikes-1.22

4、Eclipse 3.2

5、MyEclipse 5.5

6、Tomcat 基于Eclipse插件 3.2.0

7、liferay-portal-src-4.2.2.zip

8、liferay-portal-tomcat-4.2.2.zip

9、liferay-portal-sql-4.2.2.zip

具体软件，参见软件包。

二、安装过程

说明：为了方便管理，将所需的软件，全部放在C:/Java目录下，具体安装情况可以因个人喜好而定。

1、安装jdk1.5.0_07，运行jdk1.5.0_07-windows-i586-p.exe文件后，对JDK进行安装。安装完JDK后，进行以下配置：

设置JAVA_HOME：

JAVA_HOME= C:/Java/jdk1.5.0_07

设置PATH路径：

%JAVA_HOME%/bin;

2、安装jikes-1.22，安装好Jikes后，安装完JDK后，进行以下配置：

设置JIKES_HOME：

JIKES_HOME=C:/Java/jikes-1.22

设置PATH路径：

%JIKES_HOME%/bin;

3、安装ANT1.7.1，对ANT1.7.1进行解压缩后，放在C:/Java目录下。

设置ANT_HOME：

ANT_HOME=C:/Java/apache-ant_1.7.1

设置PATH路径：

%ANT_HOME%/bin;

说明：设置PATH路径时需果注意顺序，由于Jikes与Ant需果JDK支持所以：

%JAVA_HOME%/bin;%JIKES_HOME%/bin;%ANT_HOME%/bin;

4、安装Eclipse3.2与MyEclipse5.5，由于MyEclipse需要Eclipse3.2支持，所以需要先安装Eclipse3.2。

5、安装MySQL5.0数据库及MySQL管理工具MySQL-Front3.2。

在保证以上软件全部都顺利安装后，才能够对Liferay Portal的二次开发环境进行搭建，这里数据库选择MySQL5.0版本，其他与其类似，请自行测试，Tomcat采用Liferay自带的Tomcat5.5版本。

6、创建Eclipse工作空间，所在位置为：C:/Java/Liferay

7、将liferay-portal-src-4.2.2.zip解压到此目录中，并修改为portal，用Eclipse导入到当前的工作空间中，请检查源代码，保证没有错误。

8、修改Eclipse集成的ANT，将ANT HOME修改为解压后C:/Java/apache-ant_1.7.1目录下。

9、配置扩展开发环境，在portal项目中，添加文件：

release.Administrator.properties，其中“Administrator”为当前系统所在的用户名

在该文件中，添加的内容，主要是用于修改系统的release.properties文件的内容，以满足用户的需要：

文件内容：

lp.ext.dir={Liferay}/ext

用于其中“{Liferay}”指的是Liferay源代码存放的上级目录，当前所在环境里为：lp.ext.dir=C:/Java/Liferay/ext，同时在C:/Java/Liferay目录下创建ext目录。

10、选中portal项目中的build.xml文件后，选择run as -> run ant菜单后，顺序勾选：clean, start, build-ext，最后点击run进行编译，前提，必须保证在编译过程中，不出现任何红色的错误信息，如果提示关于JDK的告警消息提示，可以忽略，例如：

[javac] 注意：C:/Training/Liferay/portal/portal-ejb/src/com/liferay/portal/smtp/SMTPServerUtil.java 使用了未经检查或不安全的操作。

 [javac] 注意：要了解详细信息，请使用 -Xlint:unchecked 重新编译。

此步骤容易出现一些莫名其妙的错误，在配置时要小心谨慎，在编译过程中，需要3分钟左右的时间，请耐心等待。

11、检查ext目录下，是否有新的文件生成，在上步操作成功后，会将二次开发的一些扩展程序保存到当前目录中。

12、解压liferay-portal-tomcat-4.2.2.zip文件，将解压后的目录改名为tomcat，同时覆盖C:/Java/Liferay/ext/servers/的tomcat目录，或是将解压后的全部文件及文件夹复制到C:/Java/Liferay/ext/servers/tomcat目录中也可。

13、在C:/Java/Liferay/ext/目录下创建app.server.Administrator.properties文件，用来扩展app.server.properties文件的配置，其中的“Administrator”为当前登录的用户名，可以根据实际的登录名进行设置。

添加内容如下：

lp.ext.dir=C:/Java/Liferay/ext

app.server.type=tomcat

用来指定扩展项目所在的位置及应用运行的服务器类型。

由于指定的服务器类型为tomcat，所以还需要将app.server.properties文件中基于tomcat服务器的相关配置信息添加到app.server.Administrator.properties文件中：

主要是下面这句，将后面的tomcat-5.5.17改为tomcat

app.server.tomcat.dir=${app.server.parent.dir}/tomcat-5.5.17

具体配置：

app.server.tomcat.dir=${app.server.parent.dir}/tomcat

app.server.tomcat.bin.dir=${app.server.tomcat.dir}/bin

app.server.tomcat.classes.global.dir=${app.server.tomcat.dir}/common/classes

app.server.tomcat.classes.portal.dir=${app.server.tomcat.portal.dir}/WEB-INF/classes

app.server.tomcat.deploy.dir=${app.server.tomcat.dir}/webapps

app.server.tomcat.lib.global.dir=${app.server.tomcat.dir}/common/lib/ext

app.server.tomcat.lib.portal.dir=${app.server.tomcat.portal.dir}/WEB-INF/lib

app.server.tomcat.portal.dir=${app.server.tomcat.deploy.dir}/ROOT

app.server.tomcat.log.dir=${app.server.tomcat.dir}/logs

app.server.tomcat.temp.dir=${app.server.tomcat.dir}/temp

app.server.tomcat.work.dir=${app.server.tomcat.dir}/work

app.server.tomcat.zip.name=liferay-portal-tomcat-${downloads.version.file.name}.zip

#app.server.tomcat.zip.name=liferay-portal-tomcat-jdk5-${downloads.version.file.name}.zip app.server.tomcat.zip.url=${sourceforge.mirror}/${app.server.tomcat.zip.name}

14、用Eclipse将ext项目导入到当前的工作空间中，请检查源代码，保证没有错误。

15、添加Tomcat插件，由于在ext中已经添加了基于Liferay的tomcat服务器，建议添加Tomcat插件，用来快速完成对服务器的配置：

将tomcat插件文件中的tomcat目录复制到Eclipse的安装目录下面，进入到

C:/Java/Eclipse/eclipse/links目录下，创建文件tomcat.link连接文件，其中文件主名可以不叫tomcat，但为了保持一致，建议取名tomcat，扩展名必须为link。添加如下内容：

path=C://Java//Eclipse//tomcat

这里为tomcat插件所在的位置。

也可以：path=C:/Java/Eclipse/tomcat

重新启动Eclipse，查看是Tomcat插件是否配置成功，如要在工具栏上面有三只猫，表示配置成功。

16、配置Tomcat插件：

（1）选择：Windows -> Preferences，选择“Tomcat”，选择“Version 5.x”版本。

（2）修改参数“Tomcat Home”为“C:/Java/Liferay/ext/servers/tomcat”，

（3）修改参数“Server.xml”文件的位置：

“C:/Java/Liferay/ext/ext/servers/tomcat/conf/server.xml”。

（4）修改参数“Context files”路径的位置：

“C:/Java/Liferay/ext/servers/tomcat/conf/Catalina/localhost”

以上具体以个人Tomcat所在位置而定。

（5）配置Tomcat执行的JVM虚拟机增加运行参数，启用JAAS支持以及扩大默认内存占用量，也就是展开“Tomcat”标签，选择“JVM Settings”，在“Append to JVM Parameters”选择“Add”：

先添加

-Djava.security.auth.login.config=C:/Java/Liferay/ext/servers/tomcat/conf/jaas.config

再添加

-Xmx512m

（6）配置Tomcat所需的JDK版本，选择Eclipse中配置的已安装的JDK版本。

17、由于Liferay默认带的数据库为HSQL数据库，目前在开发过程中，需要替换为具体的数据库，目前以MySQL为例：

解压liferay-portal-sql-4.2.2.zip文件后，进入create目录后，打开create-mysql.sql文件，选中文件中的SQL脚本通过工具MySQL Front将导入到MySQL数据库，相对应的数据库名为lportal。

18、在数据库导入成功后，将MySQL的驱动mysql-connector-java-3.1.12-bin.jar文件复制到C:/Java/Liferay/ext/servers/tomcat/common/lib/ext这个目录下。

19、修改C:/Java/Liferay/ext/servers/tomcat/conf/Catalina/localhost目录下的 ROOT.xml文件，指定连接到MySQL的驱动类名称、数据库URL及用户和密码，设置如下：

<Resource

name="jdbc/LiferayPool"

auth="Container"

type="javax.sql.DataSource"

driverClassName="com.mysql.jdbc.Driver"

url="jdbc:mysql://localhost/lportal?useUnicode=true&amp;characterEncoding=UTF-8"

username="root"

password="root"

maxActive="20"

 />

具体设置与MySQL数据库连接的用户名及密码相同。

20、修改控制台的中文乱码

进入到C:/Java/Liferay/ext/servers/tomcat/conf中的logging.properties 文件，在最后添加一行：

java.util.logging.ConsoleHandler.encoding=GBK

即可。

21、进入Eclipse中导入的ext项目，选中build.xml文件后，点击deploy即可部署到Tomcat服务器上，检查在部署过程中，不出现错误。

22、通过添加的Tomcat插件，启动Tomcat服务器，会在控控台报出一些错误，不用管它，可以直接通过进入到C:/Java/Liferay/ext/servers/tomcat/bin目录下，

运行startup.bat文件即可。

23、当Tomcat服务器启动后，打开浏览器，在地址栏输入http://localhost:8080即可出现liferay界面。到此，Liferay的二次开发环境已经搭建完成。

 

说明：如果朋友在开发过程中出现一些问题，别着急，慢慢来，一定会搞定的，我也是在开发过程中走了很多弯路，最后，总结出一些心得，希望与大家分享。

 

 

                                                        刘羽

                                                        2010-6-13