搭建Liferay开发环境

[b][size=medium]搭建开发环境（初学liferay必看）[/size][/b]

本文内容是用来说明Liferay Portal 是什么，并且帮助Java开发者在Windows 操作系统上搭建，运行，并尽快转换为生产力。本文是高水平的并且不打算来回答比较深入的问题。然而，本文将会详细说明如何部署指定文件完成必要的安装任务。

[list]
[*][b][size=small]所需文件[/size][/b]
[/list]
下载下面列出的所有文件为安装部署做准备。这些文件都是搭建Liferay开发环境必需的。其中一些工具，你可以选择其他的替代。例如你可以选择IntelliJ IDE来代替Eclipse，但是为了简单起见，建议你安装下面的工具

[b]JDK 5 [/b]
Download the JDK here:
[url]http://java.sun.com/javase/downloads/index_jdk5.jsp[/url]

[b]Ant 1.7 [/b]
Download Ant 1.7 here:
[url]http://apache.eu.lucid.dk/ant/binaries/apache-ant-1.7.0-bin.zip [/url]

[b]Jikes 1.22 [/b]
Download Jikes 1.22 here:
[url]http://downloads.sourceforge.net/jikes/jikes-1.22-1.windows.zip?modtime=1096862035&big_mirror=0 [/url]

[b]Liferay Portal Source 4.3.2[/b]

[b]Eclipse 3.3 [/b]
Download Eclipse 3.3 here:
[url]http://www.eclipse.org/downloads/ [/url]


[list]
[*][b][size=small]安装工具[/size][/b]
[/list]
[b]JDK 5[/b]
当你定位安装路径时，修改默认安装路径为：

C:\Java\jdk1.5.0_13\ 

[img]http://fantasyyong840205.iteye.com/upload/picture/pic/8002/701a1179-f707-3045-b2c7-4434fcae04cc.jpg [/img]

同样修改JRE安装路径:

C:\Java\jre1.5.0_13\

[list]
[*][b]设置JAVA_HOME. [/b]
[/list]
设置[b]系统变量[/b]JAVA_HOME to "C:\Java\jdk1.5.0_13\"
[img]http://fantasyyong840205.iteye.com/upload/picture/pic/8004/dcb856f1-50d6-31ad-b2c9-f120a4b9a488.png [/img]

[list]
[*][b]设置path变量[/b]
[/list]
修改PATH路径。系统变量PATH路径的开头增加下面内容：

%JAVA_HOME%\bin; 

[img]http://fantasyyong840205.iteye.com/upload/picture/pic/8006/c79e2637-2d41-37b6-a3d8-46f7bf9f4ca8.png [/img]

同样步骤设置Ant 1.7和Jikes 1.22路径：

ANT_HOME：C:\Java\apache-ant-1.7.0

增加PATH路径：%ANT_HOME%\bin; 

JIKES_HOME：C:\Java\jikes-1.22

增加PATH路径：%JIKES_HOME%\bin; 

检查Windows确认Java虚拟机版本：
[img]http://fantasyyong840205.iteye.com/upload/picture/pic/8008/60ba425d-ac21-3219-8cf6-c628477fa6ca.png[/img]

同样，通过ant -version和jikes -version命令可以查看ant 和 jikes 版本。

[b]解压源文件到：D:\portal-4.3.2\portal[/b]

[list]
[*][b][size=small]建立ext工程（扩展环境） [/size][/b]
[/list]
开发者为了把自己开发的客户化代码和Liferay 源代码分离开。Liferay 推荐开发者在EXT 环境下开发，因为Liferay 修复bugs升级最新版本，这样方便了和新版本的Liferay 同步。 本质上，EXT 环境是建立在Liferay 源代码之上的一层结构。在EXT环境中，源代码封装在JAR 文件中。当你在EXT环境中执行build 时，你会创建更多的JAR 文件。

为了方便进行自己的修改和定制开发，同时又能与Liferay的更新保持兼容，我们使用单独的目录来放置自己的修改，这样在Liferay发布新版本时，可以直接升级Liferay部署，而不会与我们的修改相冲突。这里使用D:\portal-4.3.2\ext目录来放置所有的扩展（包括JSP、class文件及依赖库等）。

[b]下面我们用之前解压的Liferay源文件来创建EXT 环境。[/b]

在myeclipse下，切换到resource视图模式，展开portal工程目录，我们可看到一个release.properties文件，实际上我们要建一个它的扩展配置文件，文件名为

release.${username}.properties

${username}是计算机当前用户名，比如administrator,apple等等.在计算机开始菜单运行cmd出来的

c:\document and setting\username>

[img]http://fantasyyong840205.iteye.com/upload/picture/pic/8014/3e08a044-5292-3826-846a-298f4f00d8af.png [/img]

为什么非得计算机当前用户名，因为portal用了ant作deploy，里面有个xml配置文件使用了系统环境变量。按照官方文档要求配置：
我文件名是release.fanyong.properties，文件内容只一行：
[quote]lp.ext.dir=D:/portal-4.3.2/ext[/quote]
即扩展工程放置路径。

打开myeclipse里面ant视图（window--> show view --> ant) , 在ant视图中，点击添加，选择D:/portal-4.3.2/portal目录下build.xml顺序执行clean ,start ,build-ext 任务（Eclipse的ant视图中双击任务名称即执行该任务），执行ant任务时，控制台打印ant日志信息，提示Ext环境正在部署。 部署成功的话，在D:/portal-4.3.2/ext目录下产生一系列的文件和目录。

有时候在执行过程中会失败，报错。主要是portal工程本身没有compile完整。将portal重新build（project--build automatily）选择上，注意，让build完成后，再执行clean ,start ,build-ext完成标志是myeclipse 右下角进度条完成100%。

Eclipse中创建Java工程"ext" 选择"Create project from existing source" 选项，选择D:\portal-4.3.2\ext目录。
[img]http://fantasyyong840205.iteye.com/upload/picture/pic/8020/47e5bfe2-ffd3-3243-8cbe-93e75f0fc881.png [/img]

将 liferay-portal-tomcat-6.0-4.3.2.zip解压到 D:\portal-4.3.2/ext/servers/tomcat下,在D:/portal-4.3.2/ext目录下我们可以看到app.server.properties文件，同样我们也要建立一个扩展配置文件app.server.${username}.properties，文件内容两行：

[quote][b]lp.ext.dir=D:/portal-4.3.2/ext
app.server.type=tomcat[/b][/quote]

如果不想建立扩展配置文件，需要修改app.server.properties内容，这里采用直接修改app.server.properties内容的方式：

1.修改Tomcat所放置的文件夹

[quote][b]
##
## Server Directory
##

app.server.parent.dir=D:/portal-4.3.2/ext/servers/tomcat[/b][/quote]

2.去掉其中的注释就可以在Tomcat 6.0.x系列服务器中发布

[quote] [b] #
# Uncommment the following lines to deploy the portal in Tomcat 6.0.x
# instead of Tomcat 5.5.x.
#
#app.server.tomcat.version=6.0
#app.server.tomcat.dir=${app.server.parent.dir}/tomcat-6.0.13
#app.server.tomcat.classes.global.dir=${app.server.tomcat.dir}/lib
#app.server.tomcat.lib.endorsed.dir=${app.server.tomcat.dir}/lib/ext
#app.server.tomcat.lib.global.dir=${app.server.tomcat.dir}/lib/ext
#app.server.tomcat.lib.support.dir=${app.server.tomcat.dir}/lib/ext
#app.server.tomcat.support.dir=${app.server.tomcat.dir}/lib/ext
#app.server.tomcat.zip.name=liferay-portal-tomcat-6.0-${downloads.version.file.name}.zip

#
# Uncommment the following lines to deploy the portal to use the global
# class loader.
#
#app.server.tomcat.classes.portal.dir=${app.server.tomcat.classes.global.dir}
#app.server.tomcat.lib.portal.dir=${app.server.tomcat.lib.global.dir}[/b][/quote]

[list]
[*][b][size=small]配置ext工程tomcat服务器设置 [/size][/b]
[/list]
1.为了防止Java虚拟机内存溢出，在Eclipse中配置JDK可用内存：

[img]http://fantasyyong840205.iteye.com/upload/picture/pic/8036/3baf7618-2acc-3b3b-a951-c1c5618327ed.png [/img]

2.ROOT.xml中默认配置使用hsql数据库，修改为使用Mysql数据库
将D:\portal-4.3.2\ext\servers\tomcat\tomcat-6.0\conf\Catalina\localhost目录下的ROOT.xml文件中已经给出了Mysql数据库的配置示例，只需要把注释去掉即可。

	<!-- MySQL -->

	<!--<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=""
		password=""
		maxActive="20"
	/>-->

[list]
[*][size=small][b]建立ext工程数据库[/b][/size]
[/list]
(1) 启动mysql数据库服务。

(2) 执行E:\cmproject\ext\sql\create下的create-mysql.sql（执行脚本创建lportal数据库和portal需要的数据库表）

(4) 将mysql-connector-java-5.0.5-bin.jar拷贝到 D:\portal-4.3.2\ext\servers\tomcat\tomcat-6.0\lib下，使mysql的jdbc启动程序正常可用。

以上所有步骤顺利完成后，启动myeclipse 里面tomcat服务，启动正常的话，在浏览器里输入http://localhost:8080可以看到portal系统了。