麻宫雅典娜和三小孩:搭建开发环境(初学liferay必看)

来源:百度文库 编辑:九乡新闻网 时间:2024/05/01 01:29:37
搭建开发环境(初学liferay必看)

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

  • 所需文件

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

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

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

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

Liferay Portal Source 4.3.2

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


  • 安装工具

JDK 5
当你定位安装路径时,修改默认安装路径为:Xml代码
  1. C:\Java\jdk1.5.0_13\   
C:\Java\jdk1.5.0_13\ 

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

同样修改JRE安装路径:Xml代码
  1. C:\Java\jre1.5.0_13\  
C:\Java\jre1.5.0_13\

  • 设置JAVA_HOME.

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

  • 设置path变量

修改PATH路径。系统变量PATH路径的开头增加下面内容:
Xml代码
  1. %JAVA_HOME%\bin;   
%JAVA_HOME%\bin; 

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

同样步骤设置Ant 1.7和Jikes 1.22路径:
Xml代码
  1. ANT_HOME:C:\Java\apache-ant-1.7.0  
ANT_HOME:C:\Java\apache-ant-1.7.0

Xml代码
  1. 增加PATH路径:%ANT_HOME%\bin;   
增加PATH路径:%ANT_HOME%\bin; 


Xml代码
  1. JIKES_HOME:C:\Java\jikes-1.22  
JIKES_HOME:C:\Java\jikes-1.22

Xml代码
  1. 增加PATH路径:%JIKES_HOME%\bin;   
增加PATH路径:%JIKES_HOME%\bin; 


检查Windows确认Java虚拟机版本:


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

解压源文件到:D:\portal-4.3.2\portal

  • 建立ext工程(扩展环境)

开发者为了把自己开发的客户化代码和Liferay 源代码分离开。Liferay 推荐开发者在EXT 环境下开发,因为Liferay 修复bugs升级最新版本,这样方便了和新版本的Liferay 同步。 本质上,EXT 环境是建立在Liferay 源代码之上的一层结构。在EXT环境中,源代码封装在JAR 文件中。当你在EXT环境中执行build 时,你会创建更多的JAR 文件。

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

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

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

${username}是计算机当前用户名,比如administrator,apple等等.在计算机开始菜单运行cmd出来的
Xml代码
  1. c:\document and setting\username>  
c:\document and setting\username>

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

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

打开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.javaeye.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,文件内容两行:

引用lp.ext.dir=D:/portal-4.3.2/ext
app.server.type=tomcat


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

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

引用
##
## Server Directory
##

    app.server.parent.dir=D:/portal-4.3.2/ext/servers/tomcat


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

引用   #
    # 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}


  • 配置ext工程tomcat服务器设置

1.为了防止Java虚拟机内存溢出,在Eclipse中配置JDK可用内存:

[img]http://fantasyyong840205.javaeye.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数据库的配置示例,只需要把注释去掉即可。

Xml代码
  1.   
  2.   


    • 建立ext工程数据库

    (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系统了。