【Liferay Portlet指南一】——Liferay扩展环境搭建

环境设置
一、JDK 1.6.0, JDK 1.5.0 or JDK 1.4.2
    1. 点击下一步安装
    2. 设置环境变量“JAVA_HOME”指向jikes的目录
    3. 增加“%JAVA_HOME%/bin”到Path环境变量中

二、Jikes 1.22 or Jikes 1.21
    1. 解压缩安装包
    2. 设置环境变量“JIKES_HOME”指向jikes的目录
    3. 增加“%JIKES_HOME%/bin”到Path环境变量中
三、Ant 1.7.0
    1. 解压缩安装包
    2. 设置环境变量“ANT_HOME”指向ant的目录
    3. 增加“%ANT _HOME%/bin”到Path环境变量中

 

配置扩展环境
本指南所使用的liferay版本为4.2.2

Step1：解压源代码
    将liferay源代码解压到任意目录，我们称之为${PORTAL_HOME}。本指南中，将liferay源代码存放在目录${PORTAL_HOME}/src下。

Step2：修改release配置文件
    在${PORTAL_HOME}/src目录下找到文件release.properties，将其另存，命名为“release.${username}.properties”。其中${username}就是当前Windows登陆的用户名，可以通过“开始菜单－》运行－》cmd.exe”后显示的默认路径看到，跟在“Documents and Settings”字样后面的就是当前登陆的用户名。比如配置文件的名称是release.administrator.properties 。文件的内容如下:
    修改lp.source.dir属性，来指定liferay源代码所在目录

1. lp.source.dir=${PORTAL_HOME}/src

    修改lp.ext.dir属性，来指定liferay扩展环境放置目录

1. lp.ext.dir=${PORTAL_HOME}/ext

    当然可以在源文件release.properties上修改，不过不建议这样做。

Step3：生成扩展环境
    “开始菜单－》运行－》cmd.exe”，启动命令提示符窗口，进入到${PORTAL_HOME}/src目录下（因为执行ant命令所需的build.xml在此文件夹下）。执行以下ant命令，生成扩展环境。

1. $ ant start
2. $ ant build-ext

Step4：安装liferay tomcat
    将liferay tomca解压到任意目录，我们称之为${CATALINA_HOME}。本指南中，将liferay tomca存放在目录${PORTAL_HOME}/servers/tomcat下。

Step5：修改app配置文件
    在${PORTAL_HOME}/ext 目录下找到文件app.server.properties，将其另存，命名为“app.server.{username}.properties”。比如配置文件是app.server.administrator.properties。用来指向需要发布的liferay tomcat服务器。修改内容如下：
    修改app.server.parent.dir属性，来指定服务器的父目录。

1. app.server.parent.dir=D:/servers/tomcat

    修改app.server.tomcat.dir属性，来指定服务器所在目录。

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

Step6：部署扩展环境
    “开始菜单－》运行－》cmd.exe”，启动命令提示符窗口，进入到${PORTAL_HOME}/src目录下（因为执行ant命令所需的build.xml在此文件夹下）。执行以下ant命令，部署环境。

1. $ ant deploy

Step7：建立数据库
    在${PORTAL_HOME}/src/sql/create目录下找到与你使用数据相对应的.sql文件。执行该.sql脚本建立数据库。脚本默认数据名为“lportal”。

Step8：拷贝JDBC Driver
     将与你使用的数据库相应的JDBC Driver，拷贝到目录${CATALINA_HOME}/common/lib/ext下。

Step9：修改数据库配置文件
    在${CATALINA_HOME}/conf/Catalina/localhost下，找到文件ROOT.xml。修改名字为“jdbc/LiferayPool”的<Resource>元素的值，将其设置为与你所使用数据库相应的配置信息。示例代码如下：

1. <Resource
2.  name="jdbc/LiferayPool"
3.  auth="Container"
4.  type="javax.sql.DataSource"
5.  driverClassName="net.sourceforge.jtds.jdbc.Driver"
6.  url="jdbc:jtds:sqlserver://localhost:1433/lportal"
7.  username="sa"
8.  password="1234"
9.  maxActive="20"
10. />

Step10：测试
进入到目录${CATALINA_HOME}/bin下，点击“startup.bat”启动Liferay Tomcat服务器。打开浏览器，访问http://localhost:8080。点击“Sign In”,利用用户名：test@liferay.com、密码：test，进入系统。如果可以正常登录，即环境配置成功。

其他：

    liferay默认使用的jikes编译器来对Java文件进行编译。如果想使用JDK来进行编译，就需要修改配置文件。

    在ext环境的跟目录下，有个build.properties文件。将其中javac.compiler的值修改为modern。

    修改前：

1. javac.compiler=jikes

    修改后：

1. javac.compiler=modern

转帖请注明出处。

 

我将陆续发布JSPPortlet、StrutsPortlet、PreferencePortlet、SSHPortlet，开发指南。