《liferay6.2开发指南》由会员分享，可在线阅读，更多相关《liferay6.2开发指南（19页珍藏版）》请在金锄头文库上搜索。
1、19Liferay 6.2开发完全指南目录第1章 认识Liferay11-1节 Portlets1得到支持的技术框架2第2章 Liferay平台开发工具22-1节 安装liferay IDE2测试 liferay服务器6生成新的Liferay项目6部署新liferay项目到 liferay服务器7生成插件102-2节 ANT14配置ant14第3章 开发portlet应用153-1节 生成一个Portlet项目16在IDE环境下开发163-2节 分析一个Portlet项目173-3节 编写入门级My Greeting Portlet183-4节 如何对portlet进行瘦身213-5节 Por
2、tlet国际化23使用liferay的语言关键字23第1章 认识Liferay1-1节 Portlets Portlets是用java编写的小型的web应用程序，并且可以当作一个web页面的一部分存在，任何portal应用的核心一定是它的portlets,因为它们包含了实际的功能，一个portlet容器紧紧是让一组合适的portlets组合在一起作为一个完整的页面出现。第2章 Liferay平台开发工具2-1节 安装liferay IDE在安装Liferay IDE前，你需要确保你的Eclipse版本可以运行Liferay IDE,并且你正在使用一个受支持的 Java版本。预备工作:确认你有受
3、支持的JAVA JRE 和 eclipse发布版：l Java 6.0 JRE及以上版本l Liferay IDE必须运行在下列之一的Eclipse版本之上 Eclipse Kepler Java EE(4.3.x) Eclipse Juno Java EE(4.2.x) Eclipse Indigo Java EE(3.7.x)安装liferay Plugin SDK在生成新的liferay插件项目前，需要受支持的liferay 插件sdk，或安装maven,而且liferay portal必须被安装，并且在你的liferay IDE中进行了相关设置，这里需要说明的是，Plugin SDK
4、和maven都可以单独安装的不需要Liferay IDE在这里只是用最简单的方法来使用Plugin SDK:从Liferay IDE中运行Plugin SDK.注意：你可以有多个Plugins sdks配置，你可以选择默认的Plugins SDK。接下来，需要安装liferay Portal tomcat运行时和服务器测试 liferay服务器一旦你的liferay portal服务器安装，你可以从Eclipse的servers下启动，你有不同的选择来启动和停用服务器：l 在start服务器绿色按钮上单击来启动服务器（ctr+alt+r）l 点击红色的stop服务器按钮来停用服务器(Ctrl+
5、ALT+S)l 右键单击服务器，选择启动l 右键单击服务器，选择停用。一旦你的服务器启动，你可以打开liferay portal home从Server标签上，通过右键单击你的liferay tomcat server并选择Open Liferay Portal Home.生成新的Liferay项目 Liferay Portal的插件必须在 liferay项目里生成，接下来让我们演示如何生成 Liferay项目的过程，先去 File-New-Liferay Plugin Project，在这个生成项目向导中，你将定义和配置你的项目 1 、提供项目名字，该名字被命名项目的目录，同时提供一个展示名
6、，展示名会用到liferay portal的页面上，以区别不同的plugin.我们这里的演示Demo会拥有一个 elearn007-helloworld-portlet的项目及hi elearn007的展示名。 2.2 选中Use default location 复选框。默认情况下默认位置设置成你当前的工作区。如果你向改变插件的默认保存目录，你可以不选中该复选框，并指定另外的目录位置。 2.3 选中Ant(liferay-plugin-sdk)作为你的build类型。 2.4 你在前面设置的sdk和 liferay运行时应该已经被选中，如果还没有指定liferayIDE到一个plugin s
7、dk，请按照前面部分的指导进行配置Plugin SDKs。部署新liferay项目到 liferay服务器你有一个插件项目，你需要部署它，最简单的办法是把该项目从包浏览器拖拽到你的在服务器视图里的liferay 运行时，另外你也可以使用下面的方法：1， 选中你的新插件项目，然后右键单击在servers标签页上的 liferay服务器。2， 选择添加和移除3， 选中你的插件项目，并点击Add来部署到服务器。4， 点击Finish.部署你的项目后，你可以看到给项目的部署消息，在控制台上，声明你的新portlet可以被使用的信息。当登录成功，单击 Add-More 选中Sample分类，然后点击你新
8、的插件，后点击添加，即可完成让刚发布的插件显示在web页面上。现在我们已经知道如何生成项目了，下面我们会学习如何生成一个新的插件在项目里，在开始之前，我们首先修改下项目默认生成的portlet项目(elearn007-helloworld)：1，打开docroot/web-inf/liferay-display.xml文件，删除 打开docroot/WEB-INF/liferay-display.xml 文件，并删除2，打开docroot/WEB-INF/liferay-portlet.xml文件删除段 elearn007-helloworld/icon.png/css/main.css/js
9、/main.jselearn007-helloworld-portlet3，打开docroot/WEB-INF/portlet.xml文件，移除片段4，删除docroot/view.jsp文件生成插件按照下面的步骤来生成位置列表portlet:1,右键单击你的elearn007-helloworld-portlet 项目在包浏览器，并且选择 new-Liferay Portlet.2,新建liferay portlet 对话框将显示出来，在这里可以对你的portlet类名进行设置，在这里我们定义为Elearn007LocationListingPortlet 在本例子中，包全限定名com.el
10、earn007.portletdemo,而继承类为com.liferay.util.bridges.mvc.MVCPortlet.另外你也可以选择com.liferay.portal.kernel.portlet.LiferayPortlet或者javax.portlet.GenericPortlet做为你的超类。当设置上面的属性值后，点击下一步。3，该窗口为liferay portlet 向导，你将为你的portlet设置部署描述。首先输入你的portlet的名字，这里为: elearn007-location-listing,然后输入展示名和标题；Elearn007 Location Li
11、sting。在本窗口你还可以指定portlet模型，视图模型被自动选择。这里有些选项是针对项目资源的；你可以指定JSp文件的生成路径。4、下面的窗口可以让你设置portlet的图标，主样式表，主javascript文件，在liferay展示部分，你可以制定分类，是否添加到控制台等，通常该窗口保持默认设置，直接点击下一步即可。5， 在下个窗口，继续保持默认设置，点击下一步。2-2节 ANT 配置ant之后可能遇到的报错信息:1、 在进行编译过程中，在控制台可能会输出“Please set the environment variable ANT_OPTS to the recommended v
12、alue of -Xmx1024m XX:MaxPermSize = 512m.”提示。原因就是当前JVM参数设置太小了，不够liferay编译使用，需要增加对JVM内存的分配，并建议将参数设置成以上所示。具体解决方法如下：（1）、在liferay工程里面的源代码的build.xml上右键Run asExternal Tool Configurations（2）、在Tab标签里面找到Environment，点击new，在name里面输入ANT_OPTS,在value里面输入-Xmx1024m XX:MaxPermSize=512m,然后点击apply。（3）、再次进行编译，即可正常编译。2、
13、在进行编译过程中，在控制台可能会输出“Tomcat is not installed in *(tomcat保存位置)。If you already have Tomcat installed,make sure the property$app.server.tomcat.dir points to your Tomcat installation.”解决方法如下：（1）、打开liferay的源码目录，找到app.server.properties文件。（2）、将此文件复制一份，重命名为app.server.username.properties的文件，其中username为当前系统的账号系
14、统。在运行命令cmd之后，即可看到。（3）、打开复制好的文件，找到app.server.parent.dir=$project.dir/./bundles。将后面的$project.dir/./bundles替换成tomcat的路径。注意在地址栏复制来的是正斜杠，需要改为反斜杠。（4）、在Eclipse里面的ant面板点击add buildfiles，将portal源码里面的build.xml文件添加到ant面板。（5）、点开此build文件，先点击compile，再点击deploy，即可将源码编译部署到tomcat中。第3章 开发portlet应用 在上面的章节我们向你演示了如何生成liferay plugin项目，接下来我们将讨论下面的专题：l 生成一个portlet项目l 分析portlet 项目l 编写入门级My Greeting Portletl 让你的Portlet支持国际化（portlet中的title必须进行国际化处理）3-1节 生成一个Portlet项目 Portlet的生成如果使用Plugin SDK是非常简单的，在Plugin SDK目录下有个portlets文件夹，放置你的portlet项目。首
