Eclipse+DB2下Liferay 4.2.2扩展开发环境的建立

<o:p>

Author:Helo
Email:[email protected]
最近在一直看Portal的一些东西，以后会逐渐把一些相关的东西写上来，也算一个总结吧。

一、环境：
JDK： JDK 1.4
Liferay： Liferay-portal-tomca-4.2.2.zip
Liferay Src： liferay-portal-src-4.2.2.zip
OS： Windows xp
Tomcat: Tomcat-5.5.X (bundle with liferay JKD 1.4)
Database：DB2 8.2
Jikes： Jikes-1.22
Ant： Apace-ant-1.65

       在系统环境变量里面新建JAVA_HOME、JIKES_HOME、ANT_HOME，在PATH环境变量里面添加%JAVA_HOME%\bin;%JIKES_HOME%\bin;%ANT_HOME%\bin。这里的ANT_HOME和PATH也可以不用设置,使用eclipse中自带的就好，这里就顺便设置下。另：这里使用的是JDK1.4，若要使用1.5则需使用官网提供的tomcat的JDK1.5绑定版。

二、Eclipse环境下的portal工程加载 
       Liferay的源代码实际上是一个Eclipse工程文件（该项目名称叫portal）。在Eclipse工作目录(我的目录为D:\liferay_4.2，此后记为${WORKSPACE})下建立portal目录，然后把下载下来的源代码liferay-portal-src-4.2.2.zip解压缩portal目录下。 
       选择File->New->Project->Java Project，输入项目名称为“portal”，保持默认的“create new project in workspace”，选择“Finish”结束。 
       如果上一步成功，那么已经可以在左侧栏看到源代码的目录结构了；并且右键点击项目的根目录，选“Properties”，选“Java Build Path”的“Libraries”标签，应该能够看到所有需要的jar格式库文件在里面了。 
       加载了portal项目之后的Eclipse的Package Explorer栏。
       选择Windows showViewAnt在出现的Ant视图中单击Add build files,在弹出对话框中选择portal项目中根目录下build.xml文件。

三、基于Tomcat的扩展开发环境建立
修改portal下release.properties文件：

lp.source.dir=D:/liferay_4.2/portal
lp.ext.dir=D:/liferay_4.2/ext
lp.eclipse.dir=D:/liferay_4.2/eclipse
lp.eclipse.project.name=ext

       编辑在${WORKSPACE}/portal\tools\ext_tmpl\ext-ejb\classes下的portal-ext.properties文件，修改#portal.release=enterprise为portal.release=professional。
然后在最后加入下面的语句：

hibernate.dialect=org.hibernate.dialect.DB2Dialect
custom.sql.function.isnull=CAST(? AS VARCHAR(32672)) IS NULL
custom.sql.function.isnotnull=CAST(? AS VARCHAR(32672)) IS NOT NULL

liferay使用了hibernate做持久化，而liferay 4.3以前的所有版本在对DB2的支持上都有问题，所以这里需要手动配置hibernate.dialect和null的问题，否则无法启动或启动后出现莫名其妙的问题。
       回到Eclipse中的Ant视图中，双击展开根节点Portal，双击打开根目录下的build.xml，应该可以在Outline看到很多Ant任务。 
       Outline下的ANT任务： 
       顺序执行 clean, start, build-ext 。屏幕下方的命令行窗口会跳跃相关文字提示信息，如果一切正确，那么其中不应该有红色的错误信息（绝大多数此处可能出现的错误都是配置文件不正确所引起的）。特别注意的是，如果你已经正确设置了JIKES_HOME和PATH却仍然提示“需要JIKES”，则把你的PATH设置为绝对路径如：C:\jikes\bin（我曾被这个问题郁闷了N久!^0^!）。一切正常的话，那么${WORKSPACE}\ext 目录下应该生成了很多东西了。 
       解压缩下载的liferay-portal-tomcat-4.2.2.zip（可运行的Liferay）到安装目录，以后假定此解压缩目录为${TOMCAT_HOME}。在${WORKSPACE}/ext目录下创建。
app.server.${username}.properties配置文件，在其中添加如下内容：

lp.ext.dir=${WORKSPACE}/ext
app.server.type=tomcat
app.server.tomcat.dir=${TOMCAT_HOME}

仿照建立portal项目，选择File->New->Project->Java Project，输入项目名称为“ext”，保持默认的“create new project in workspace”，选择“Finish”结束。
       如果上一步成功，那么已经可以在左侧栏看到ext项目的目录结构了；并且右键点击项目的根目录，选“Properties”，选“Java Build Path”的“Libraries”标签，应该能够看到所有需要的jar格式库文件在里面了。 
 
       安装Tomcat插件支持(这里不在详述)。

       然后，在ant中点击deploy，即可完成部署。

四、配置DB2数据库支持
       创建liferay数据库lportal：
       将${WORKSPACE}\sql下的build.xml加入ant试图，启动rebuild-db2即可（当然，你应该先装好DB2）。
       修改 ${TOMCAT_HOME}\conf\Catalina\localhost下的ROOT.xml文件：

xml 代码

<Context path="">
    <Resource
        name="jdbc/LiferayPool"
        auth="Container"
        type="javax.sql.DataSource"
        driverClassName="COM.ibm.db2.jdbc.app.DB2Driver"
        url="jdbc:db2:lportal"
        username=""
        password=""
        maxActive="100"
        maxIdle="30"
        maxWait="10000"
    />
    <Resource
        name="mail/MailSession"
        auth="Container"
        type="javax.mail.Session"
        mail.imap.host="localhost"
        mail.pop3.host="localhost"
        mail.smtp.host="localhost"
        mail.store.protocol="imap"
        mail.transport.protocol="smtp"
    />
    <Realm
        className="org.apache.catalina.realm.JAASRealm"
        appName="PortalRealm"
        userClassNames="com.liferay.portal.security.jaas.PortalPrincipal"
        roleClassNames="com.liferay.portal.security.jaas.PortalRole"
        debug="99"
        useContextClassLoader="false"
    />
Context>

       然后将db2java.jar拷贝到 ${TOMCAT_HOME}\common\lib\ext下面即可。
       至此，扩展开发环境搭建完成！

PS:
 附件是本文的word文档，插入了一些图片可供参考。

 </o:p>