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

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

 

一、 准备工作

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

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

      liferay-portal-tomcat-5.5-jdk5-4.4.1.zip

      liferay-portal-src-4.4.1.zip

      liferay-portal-sql-4.4.1.zip

     eclipse 插件 tomcatPluginV31.zip

     apache-ant-1.7.0-bin.zip

2 、安装 JDK ，环境变量等等。具体的安装及配置过程这里省略。

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

4 、如果对 liferay 安装过程有疑问，可参考本系列的第一篇文章。

二、 搭建开发环境

1、 创建工程目录 e:/code/liferay，将 liferay-portal-src-4.4.1.zip 解压到此目录中，并修改为portal,

     也就是e:/code/liferay/portal 中的内容是解压包的内容。

2、启动eclipse，File->Switch Workspace，输入 e:/code/liferay 确定。

3、File->New->Project->Java Project，输入项目名称为“portal”，保持默认的
“create new project in workspace”，选择“Finish”结束。

4、如果上一步成功，那么已经可以在左侧栏看到源代码的目录结构了；并且
右键点击项目的根目录，选“Properties”，选“Java Build Path”的
“Libraries”标签，应该能够看到所有需要的jar格式库文件在里面了。

5、Window->Show View->Ant，在新出现的Ant标签栏点击加号，选择项目源
码根目录上的build.xml文件。注意，如果ant的版本不是1.7.0，那么需要在 window->prefrences中的Ant 下的Runtime 修改“Ant Home ”  到对应的apache-ant-1.7.0-bin.zip 解压目录。

 上述步骤完成之后，基础的portal开发环境就有了。  

6、配置扩展开发环境

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

7、首先要在e:/code/liferay /portal 目录下建立一个名为“release.${username}.properties”
的配置文件，其中${username}就是当前Windows登陆的用户名，可以通过“开
始菜单－》运行－》cmd.exe”后显示的默认路径看到，跟在“Documents and
Settings”字样后面的就是当前登陆的用户名。这样，我的配置文件的名称是
release.zhenggp.properties 。文件的内容只写一行：

                   lp.ext.dir={Liferay}/ext  ， 其中“{Liferay}”指的是Liferay源代码存放的上级目录，在我的环境里面就是：lp.ext.dir=E:/code/liferay/ext

8、回到上一节建立好的Eclipse中的Ant视图中，双击展开根节点Portal，应该可以
看到很多Ant任务，顺序执行 clean, start, build-ext 。屏幕下方的命令行窗口会跳
跃大堆大堆的文字提示信息，如果一切正确，那么其中不应该有红色的错误信
息（绝大多数此处可能出现的错误都是配置文件不正确所引起的）。一切正常
的话，那么e:/code/liferay /ext 目录下应该生成了很多东西了。

9、我们将前面准备好的与Tomcat绑定的Liferay Professional版本的压缩包解压到
e:/code/liferay /ext/servers/tomcat 目录下，并且在e:/code/liferay /ext 目录下建立一个名为
app.server.{username}.properties的文件，在我这也就是
app.server.zhenggp.properties ，文件内容写如下两行：

                lp.ext.dir=E:/code/liferay/ext

               app.server.type=tomcat

         同时需要把tomcat中的那些同时copy进来，并且修改这行

              app.server.tomcat.dir=${app.server.parent.dir}/tomcat （默认的是tomcat5.5.25,修改为tomcat)

10、仿照前面在Eclipse里建立新的Java工程的方法，建立一个新的Java项目，指
向E:/code/liferay/ext 目录，也就是说，在输入Java项目的项目名称时，输入“ext”而
不是前面输入“portal”.

11、配置tomcat 插件。，在Eclipse里“Windows->Preferences”，选
择“Tomcat”标签，选择“Version 5.x”版本，然后修改参数“Tomcat Home”
为“{Liferay}/ext/servers/tomcat”，修改参数“Configuration File”为“{Liferay}
/ext/servers/tomcat/conf/server.xml”。接着我们要继续给Tomcat执行的JVM虚拟机增加运行参数，启用JAAS支持以及扩大默认内存占用量，也就是展开“Tomcat”标签，选择“JVM Settings”，在
“Append to JVM Parameters”选择“Add”，先添加

            -Djava.security.auth.login.config=E:/code/liferay/ext/servers/tomcat/conf/jaas.config

        再添加 -Xmx512m

12、还要在这里修改Tomcat运行所使用的虚拟机，要注意这里必须指定一个JDK附
带的虚拟机而不可以指向JRE附带的虚拟机环境，否则Tomcat在运行过程中会出
现错误。如果这里的下拉选项没有出现与JDK中虚拟机有关的选项，那么我们
要首先手动建立一个，我们需要到Java标签下的“Installed JREs”，选择
“Add”，“JRE home directory”选择“D:/jdk1.5，给这个JRE环境起
个名字，比如“JDK1.5”，之后点Ok保存设置，再重新开启“Window-
>Preferences”对话框，到Tomcat的“JVM Settings”项选择刚才建立的
“JDK1.5”这个JRE就可以了。

13、配置数据库（MySQL）

           解压缩liferay-portal-sql-4.4.1.zip 文件后，执行目录 liferay-portal-sql-4.4.1/create 下的 create-mysql.sql文件即可建立 liferay 应用在 MySQL  上的数据库，数据库名为 lportal 。

       同时copy MySQL的驱动mysql-connector-java-3.1.14-bin.jar到目录  E:/code/liferay/ext/servers/tomcat/common/lib/ext 。

14 、修改E:/code/liferay/ext/servers/tomcat/conf/Catalina/localhost目录下的 ROOT.xml 文件，指定连接 SQLServer 的驱动类名称、数据库 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="admin"   maxActive="20"  />

15、其他小改进：修改console中的中文乱码

  在 E:/code/liferay/ext/servers/tomcat/conf中的logging.properties 中添加一行：

        java.util.logging.ConsoleHandler.encoding = GBK

四、启动服务器

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

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

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