Liferay系列文章(七)Liferay应用之开发额
来源:百度文库 编辑:神马文学网 时间:2024/03/29 23:11:14
为了使Liferay Portal很好地投入生产应用,除了进行必要的配置之外,还需要进行适度的二次开发,修改Liferay中的不适当部分,添加新的应用功能,并整合现有的应用系统集成到Liferay Portal中来。
一、建立Java开发环境
1、下载安装ant
Apache ant是一个优秀的Java编译工具,许多Java应用软件采用了ant进行编译处理。
从ant开源项目的网站http://ant.apache.org/ 下载最新的ant版本1.7.1软件包apache-ant-1.7.1-bin.tar.gz。把软件包解压缩到目录C:\Java\下,再把产生的目录名apache-ant-1.7.1重命名为ant-1.7.1,即ant的主目录是C:\Java\ant-1.7.1\。
2、下载安装Jikes
有许多Java应用系统选用Jikes软件来编译Java程序。Jikes是IBM创建的一款符合Sun Java技术规范的Java编译器。与Sun 的Java编译器相比,Jikes是开源的,编译速度更快,提供更为清晰的错误和警告提示。
注意,ant同Jikes不是一个东西。Jikes等同于Javac,而ant是个辅助编译工具,主要用来解释编译参数选项,它类似于Unix/Linux系统中的make,而且不管是使用Sun Javac还是IBM Jikes编译器,都可以使用ant工具。
从Jikes网站http://jikes.sourceforge.net/ 下载最新的Jikes版本1.22的软件包jikes-1.22-1.windows.zip。把软件包解压缩到目录C:\Java\jikes-1.22\下。
3、配置系统环境参数
参照“Liferay Portal 应用之安装”篇中的方法,把ANT_HOME=C:\Java\ant-1.7.1和JIKES_HOME=C:\Java\jikes-1.22加入到Windows系统的环境变量中,然后在Path变量的最前面添加上
%ANT_HOME%\bin;%JIKES_HOME%\bin;
即
Path=%ANT_HOME%\bin;%JIKES_HOME%\bin;%JAVA_HOME%\bin;....
4、下载安装Eclipse
Eclipse是一个优秀的软件开发平台,涵盖了软件开发的完整生命周期,包括建模,开发,部署,管理和测试。Eclipse的插入式可扩展架构,使得它能够同时支持Java,C,C++,PHP等语言工具在企业应用、嵌入式应用和实时应用多方面的项目开发。其中,Eclipse Web Tools Platform(WTP)软件包在Eclipse平台中提供了适合于开发Web服务和Java EE应用的丰富工具,再配合适当的插件,完全能够满足绝大多数Java应用开发的需要。因此,我们选择了Eclipse作为Liferay Portal应用的开发平台。
Eclipse WTP软件包的最新版本是3.0.1,要求运行在Eclipse-SDK-3.4以上版本,且需要其他一些扩展软件包如JDT,EMF,GEF等。
首先从Eclipse的网站http://www.eclipse.org/downloads/packages/ 选择下载Eclipse IDE for Java EE Developers软件包eclipse-jee-ganymede-win32.zip,解压缩到C:\Java\目录中,产生目录eclipse。
再到 http://downloads.eclipse.org/webtools/downloads/ 选择下载WTP软件包wtp-R-3.0.1-20080818032401.zip,也解压缩到C:\Java\目录下,覆盖已有的eclipse目录(仅添加了plugins和features子目录内容)。
最后,把Eclipse的安装目录名eclipse重命名为eclipse-3.0.1,即Eclipse WTP的主目录是C:\Java\eclipse-3.0.1\。进入该目录执行eclipse.exe启动eclipse平台。该平台界面是英文版的,但支持中文处理。
二、建立Liferay开发环境
1、安装Liferay源程序包
我们在“Liferay Portal 应用之安装”篇中已经下载了Liferay源程序包liferay-portal-src-5.1.0.zip。现在把它解压缩到C:\Projects\liferay-5.1.0\目录下,然后把生成的目录liferay-portal-src-5.1.0重命名为portal,即Liferay的源程序目录是C:\Projects\liferay-5.1.0\portal\。
2、建立扩展开发环境
(1)建立扩展开发目录ext
先确认自己电脑的Windows用户名。在C:\Projects\liferay-5.1.0\portal\目录中建立属性文件release.{用户名}.properties,本人的用户名是jingxiao,因此要建立的文件名是release.jingxiao.properties,文件内容只有一行:
lp.ext.dir=C:/projects/liferay-5.1.0/ext
然后进入DOS窗口,转入目录C:\Projects\liferay-5.1.0\portal\,执行命令:
ant clean start build-ext
若干分钟后命令执行完成,在C:\Projects\liferay-5.1.0\目录中建立了ext子目录,这是进行二次开发的扩展目录,包含了从源程序目录portal中建立并复制来的java类包、源程序、属性文件和配置文件等等。
(2)部署扩展开发环境
接下来要测试新建的扩展开发环境是否可用,能否正确生成运行环境。
打开扩展开发目录ext中的部署属性文件app.server.properties,找到单独使用Tomcat服务器的定义参数部分。在该属性文件中,缺省定义Tomcat服务器使用的是Tomcat 5.5版本,而我们使用的是Tomcat 6.0服务器(Liferay-5.1.0+Tomcat-6.0集成包),因此要把原来Tomcat 6.0属性定义的注释符号去除掉(有关Tomcat 5.5的定义还要保留),使得下列定义语句有效:
app.server.tomcat.version=6.0
app.server.tomcat.dir=${app.server.parent.dir}/tomcat-6.0.16
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}.zip
然后在扩展开发目录ext下,建立对应于用户名的扩展部署属性文件app.server.{用户名}.properties,即app.server.jingxiao.properties,其内容如下:
app.server.type=tomcat
app.server.tomcat.dir=C:/Projects/liferay-5.1.0/tomcat-6.0
最后,在DOS窗口中进入扩展开发目录C:\Projects\liferay-5.1.0\ext\,执行命令:
ant clean deploy
经过几分钟的处理后,当DOS窗口出现BUILD SUCCESSFULE提示时,部署成功,ext目录中的内容经过编译打包后部署到了运行环境tomcat-6.0目录下。
现在来测试重新部署的Liferay Portal是否工作正常。进入tomcat-6.0\bin\目录,执行startup.bat启动Liferay(MySQL数据库和LDAP服务器应该优先启动),用浏览器打开网址http://localhost:8080/,展现出同部署前一样的界面。以admin用户登录一切正常。
但由于使用了ant clean,将把已经部署到Tomcat的其他应用(webapps目录中)给删除了。因此,要么只用ant deploy来部署,要么事先备份好非Liferay Portal的那些应用目录,如Liferay的主题风格插件。
(3)建立eclipse开发项目
启动eclipse,指定工作项目目录为C:\Project\liferay-5.1.0\。在eclipse启动后的主窗口中,把鼠标移到右边的Workbench图标上,打开eclipse的工作台面。
先建立一个Java项目ext。在主菜单File列表中,依次点击New->Other…。在打开的New过滤窗口中,点开Java项目,选择Java Project子项目并按Next按钮进入下一步配置。在New Java Project窗口中,指定Project Name为ext;在Content栏目中,选择“Create project from existing source”,并在Directory栏目浏览选择现有项目的目录为C:\Projects\liferay-5.1.0\ext\。其他选项不予理会,直接按Finish按钮,eclipse将会在左侧的Package Ext窗口下建立ext项目。
按照上面的方法,再建立一个Java项目portal。其中Project Name为portal,也是选择从现有项目建立,且目录在C:\Projects\liferay-5.1.0\portal\。
再来开启显示ant窗口。在主菜单Window列表中,依次点击Show View->Other…。在打开的Show View过滤窗口中,点开Ant项目,选择Ant子项目并按OK按钮确定。这样将在eclipse右侧的窗口中调出ant显示标签。
然后打开ext项目,把build.xml配置文件拖拽到刚才建立的ant窗口中。如果要把ext项目部署到Tomcat服务中,仅需双击ant窗口中的deploy [default] [from …]项,等待最下面的Console窗口中出现BUILD SUCCESSFUL提示,则部署完成。
为了能够在eclipse中直接控制Tomcat服务器的启动或停止,方便开发调试,我们将给eclipse安装一个Tomcat插件。从http://www.eclipsetotal.com/ 网站下载最新版的tomcat插件包tomcatPluginV321.zip,把它解压缩到eclipse的插件目录C:\Java\eclipse-3.0.1\plugins\中。退出正在运行的eclipse再重新启动之,可以看到,在eclipse的快捷图标栏上多出了三个Tomcat的新图标:分别用来启动(Start Tomcat)、关闭(Stop Tomcat)和重启动(Restart Tomcat)Tomcat服务器。
接下来需要配置Tomcat插件的使用。在主菜单Window下,打开Preferences窗口,点击Tomcat项目进行配置:选择Tomcat版本为Version 6.x;指定Tomcat home为C:\Projects\liferay-5.1.0\tomcat-6.0。
由于在同一台电脑上运行了较多的Java应用,需要配置Java虚拟机的参数。点击Tomcat项目下的JVM Settings子项目,在Append to JVM Parameters栏,按Add按钮添加如下两行参数:
-Xms256m -Xmx1024m -XX:MaxPermSize=128m
-Dfile.encoding=UTF8 -Duser.timezone=GMT+8
上述配置完成之后,就可以在eclipse中按动Tomcat工具图标来控制Tomcat服务器的启停。
至此,Liferay在eclipse平台下的开发环境全部建立起来了。
三、Liferay应用开发
在我们建立的eclipse开发环境中进行应用开发。按照Liferay的建议,二次开发最好是在ext项目中进行。而且在ext项目中,Liferay的核心内容是经过打包后复制过来的,对Liferay的修改或应用开发要按照Liferay的建议,以“扩展”的形式来实现。这样的话,当Liferay升级更新了源码后,重新生成ext项目时也不会覆盖原来在ext中所作的变动。
1、修改中文译文
在Liferay Portal中使用者可以随时切换到不同的语种界面。与其他Java应用一样,Liferay的国际化也是通过使用对应于各种语言的资源文件实现的。国际化的资源文件名格式为Language_{语种名称}.properties。例如,简体中文的资源文件名是Language_zh_CN.properties。Liferay的基础语言是英语,在每个语种的资源文件中定义了英语词句与该语种词句的对应关系。因此,中文译文的修改比较容易。
由于Java资源文件的编码格式是ISO-8859-1,而我们使用的中文Windows操作系统的编码是GBK,因此不能直接显示和编辑资源文件内容,需要为eclipse添加一个资源文件编辑插件Jinto。进入网站http://www.guh-software.de/jinto_en.html, 选择下载适合于eclipse 3.3.X版本的插件包de.guhsoft.jinto-0.11.0.zip。下载后解压缩到eclipse目录C:\Java\eclipse-3.0.1\中。
启动eclipse,依次打开portal项目->portal-imp/src->content,找到简体中文语言资源文件Language_zh_CN.properties,把它复制到ext项目的对应目录下(ext项目->ext-imp/src->content),再重新命名为Language_zh_CN-ext.properties。我们所要修改的将是这个新文件。这是一种扩展修改方式,它保留了原来资源文件里的定义,但可以用新的定义替换旧的,也可以添加新的定义项。
打开该文件进行修改时,可以先把那些无需修改的定义项给删除掉,以减少重复的内容,方便修改。由于Jinto资源编辑器没有批量替换功能,就只能逐条修改了。修改完成要保存文件,并执行ant部署操作之后,才能够在Liferay Portal的运行系统中起作用。
2、增加网页布局模板
我们打算仿照系统已有的70/30比例的两列模板,制作一个40/60比例的两列布局模板。制作步骤如下:
(1)打开portal项目,进入portal-web->docroot目录中,把layouttpl子目录复制到ext项目的对应目录ext-web->docroot中。然后再次进入portal项目的portal-web->docroot->WEB-INF目录,把配置文件liferay-layout-templates.xml也复制到ext项目的对应目录ext-web->docroot->WEB-INF中,并把它重命名为liferay-layout-templates-ext.xml。
(2)修改配置文件liferay-layout-templates-ext.xml,去除多余的定义内容,仅保留有关2_columns_iii的定义内容。再把文件里的_iii改为_iv,修改70/30为40/60。修改好的文件内容如下:
"http://www.liferay.com/dtd/liferay-layout-templates_5_1_0.dtd">
(3) 进入ext项目的ext-web->docroot->layouttpl目录,删除文件thumbnails.zip和目录standard。进入custom目录,只保留2_columns_iii.pnp,2_columns_iii.tpl和2_columns_iii.wap.tpl三个文件,删除其余文件。再把这三个文件对应地重命名为2_columns_iv.pnp,2_columns_iv.tpl,2_columns_iv.wap.tpl。其中,2_columns_iv.wap.tpl是移动设备浏览版式,不必修改。2_columns_iv.pnp是版式模板的示例图片,可以复制出来用图形处理软件进行适当修改。2_columns_iv.tpl是电脑浏览器格式模板,需要作如下修改:把该文件中的seventy修改为forty;把该文件中的thirty修改为sixty。修改完成之后,2_columns_iv.tpl文件内容如下:
$processor.processColumn("column-1") $processor.processColumn("column-2")
上述操作完成之后,经过ant部署处理,系统管理员就可以在“布局模板”列表中挑选使用新建立的2 Columns(40/60) 模板了。
3、修改内嵌的Portlet
Liferay Portal预制了数十个Portlet,提供了较为丰富的功能。我们可以按照自己的喜好,对这些内嵌Portlet进行适当的修改。
在portal工程项目中,依次打开目录portal-web->docroot->html->portlet,可以看到所有的内嵌Portlet都在这里面。如果仅仅是修改某些Portlet,只需要把它们复制到ext项目对应位置,然后修改其中的程序。比如,我们想修改Document Library和Document Library Display这两个Portlet,打算取消原来显示WebDAV URL的行。具体步骤如下:
(1)进入portal工程项目的portal-web->docroot->html->portlet目录中,把document_library目录复制到ext项目的对应目录ext-web->docroot->html->portlet中。
(2)进入ext项目,打开复制来的document_library目录,编辑view.jsp程序。在view.jsp中查找字符串WebDAV,把有关显示WebDAV URL行的语句注释掉,即添加注释符号,如下所示:
(3)如前所述,修改完成之后需要保存并部署,所作修改才能够起作用。
可见,修改原有的Portlet并不难,关键是对Portlet规范和架构熟悉,仔细读懂Portlet程序和配置定义。
4、开发新的Portlet
下面我们将参照Liferay网站的例子,介绍如何在扩展开发环境下,建立一个简单的Struts架构的 Portlet,起名为Library。在ext项目下,已经有一个示范性的reports Portlet存在,我们可以参考它来建立Library Portlet。
(1)定义Portlet
有关Portlet的配置文件全部放置在ext项目的ext-web\docroot\WEB-INF\目录中。
一个新的portlet还需要在portlet-ext.xml和lifray-portlet-ext.xml中进行定义。在portlet-ext.xml的
在lifray-portlet-ext.xml配置文件中,同样在reports Portlet的定义之后,添加Library的定义内容:
在library-display.xml文件中把Library Portlet定义到sample(样品)分组中,即把
按照上面的定义,在Liferay中新建立了Library Portlet,且命名为Library,但在Liferay中的实际引用名称将是javax.portlet.title.Library,不够简练,因此需要把它重命名为便于识别的名称“图书馆”。
进入ext项目的ext-imp/src->content目录,打开Language-ext.properties资源文件,添加一条定义行:
javax.portlet.title.Library=图书馆
(2)定义网页的流转和显示方式
struts-config.xml用来定义网页的流转。该文件已经有了reports Portlet的定义,只需在之前添加如下几行有关library的定义:
tiles-defs.xml定义网页的显示方式。同上,该文件中已经有了reports Portlet的定义,只需在之前添加有关library的定义,内容如下:
(3)建立处理程序
在ext-web\docroot\html\portlet\ext\目录中建立library目录,在此放置网页显示处理程序。
建立Portlet初始化程序init.jsp,内容如下:
<%@ include file="/html/common/init.jsp" %>
建立Portlet显示程序view.jsp,内容如下(注意,eclipse缺省使用的字符编码是ISO-8859-1,不能保存中文字符。因此需要修改程序文件的字符编码格式:用鼠标右键点文件名调出处理列表,再点击最后一项Properties。在Properties配置窗口的右边有“Text file encoding”选项,从“Other:”栏选择UTF-8,保存配置即可。):
<%@ page language="java" contentType="text/html; charset=UTF-8"%>
<%@ include file="/html/portlet/ext/library/init.jsp" %>
向图书馆增加书:
" method="post" name="
书 名:
onClick="submitForm(document.
建立操作成功的处理程序success.jsp,内容如下:
<%@ page language="java" contentType="text/html; charset=UTF-8"%>
<%@ include file="/html/portlet/ext/library/init.jsp" %>
<%
String bookTitle = request.getParameter("book_title");
%>
增加的书名: <%= bookTitle %>
建立操作错误的处理程序error.jsp,内容如下:
<%@ page language="java" contentType="text/html; charset=UTF-8"%>
出现错误,操作失败!
然后建立增加书目的事务处理程序AddBookAction.java。参照reports Portlet,我们在ext-imp/src目录中建立Java包com.ext.portlet.library.action,并建立Java程序AddBookAction.java内容如下:
package com.ext.portlet.library.action;
import javax.portlet.ActionRequest;
import javax.portlet.ActionResponse;
import javax.portlet.PortletConfig;
import javax.portlet.RenderRequest;
import javax.portlet.RenderResponse;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionForward;
import org.apache.struts.action.ActionMapping;
import com.liferay.portal.struts.PortletAction;
public class AddBookAction extends PortletAction {
public void processAction(
ActionMapping mapping, ActionForm form, PortletConfig config,
ActionRequest req, ActionResponse res) throws Exception {
String bookTitle = req.getParameter("book_title");
if ( null == bookTitle || "".equals(bookTitle) ) {
setForward(req, "portlet.ext.library.error");
} else {
setForward(req, "portlet.ext.library.success");
}
}
public ActionForward render(ActionMapping mapping, ActionForm form,
PortletConfig config, RenderRequest req, RenderResponse res) throws Exception {
if (getForward(req) != null && !getForward(req).equals("")) {
return mapping.findForward(getForward(req));
} else {
return mapping.findForward("portlet.ext.library.view");
}
}
}
(4)部署和使用。
执行ant deploy部署ext项目到Tomcat服务器。启动Tomcat并打开Liferay Portal主页,以admin用户登录,向当前网页添加应用。可以看到,在sample(样品)分组下出现了我们刚建立的Library Portlet应用,把它拖放到网页上测试使用。
5、精简Liferay的Portlet
在Liferay Portal内置的几十个Portlet中,有许多是我们不需要的,比如有关网店购物的Portlet。通过在扩展配置文件中重新定义,我们可以把那些不需要的Portlet注销掉。
打开ext项目,进入ext-web->docroot->WEB-INF目录,编辑配置文件liferay-portlet-ext.xml。把需要注销的Portlet的定义项从注释框架中分离出来使它有效,再把
-->