liferay开发之一：简单JSP Portlet开发

Liferay开发之一：简单的JSP Portlet开发
Liferay的环境配置好以后，我们可以在ext环境中进行一些二次开发，首先我们通过一个简单的JSP Portlet HelloWorld来初步了解下portlet开发流程。
第一步：建立我们自己的portlet展示页面文件夹，我们首先需要关注的文件夹是：
…/ext-web/docroot/html/portlet/ext,在这个文件夹下我们可以建立自己的portlet，比如我们建立一个JSPPorletDemo文件夹，完成后的目录结构如下：



第二步：创建JSP文件。
打开ext环境中自带的一个portlet:reports,可以看到其中的目录结构：



我们将其中的init.jsp和view.jsp复制一份到我们自己的目录JSPPortletDemo，打开这两个JSP文件，删除一些多余代码，完成后如下图所示：
view.jsp



init.jsp



第三步：增加view.jsp的内容，其实就是HTML的代码（写到这里你从文件名已经猜到了，这个JSP将是我们的portlet的展示页面）



第四步：页面写好以后，我们需要配置一些portlet
的属性。
编写JSP Portlet
打开…/ext-web/docroot/WEB-INF目录，可以看到很多配置文件：



这些配置文件我们在后面的学习中会逐步的用到，今天我们先来了解其中三个配置文件：



1.配置portlet
portlet-ext.xml,这个配置文件用来配置portlet的属性,ext环境中已经有一个范例，我们可以在此基础上进行修改：
<?xml version="1.0"?>
<portlet-app>
<portlet>
<portlet-name>EXT_1</portlet-name>
//portlet的名字
<display-name>Reports</display-name>//页面显示的名字
<portlet-class>com.ext.portlet.reports.ReportsPortlet</portlet-class>//对应的类（此处为portlet Struts,JSP的类在下面）
<init-param>//初始化参数，用来指定视图页面
<name>view-action</name>
<value>/ext/reports/view_reports</value>
</init-param>
<expiration-cache>0</expiration-cache>//过期缓存，0应该是不会过期，具体查阅下文档，暂时用不到
//下面的全部默认，后面再讲解
<supports>
<mime-type>text/html</mime-type>
</supports>
<resource-bundle>com.liferay.portlet.StrutsResourceBundle</resource-bundle>
<portlet-preferences>
<preference>
<name>test</name>
<value>123</value>
</preference>
</portlet-preferences>
<security-role-ref>
<role-name>power-user</role-name>
</security-role-ref>
<security-role-ref>
<role-name>user</role-name>
</security-role-ref>
</portlet>
</portlet-app>
将已有的portlet配置拷贝一份（<portlet>和</portlet>之间的内容），修改如下：
<portlet>
<portlet-name>EXT_2</portlet-name>
<display-name>Hello JSP Portlet</display-name>
<portlet-class>com.liferay.portlet.JSPPortlet</portlet-class>
<init-param>
<name>view-jsp</name>
<value>/ext/JSPPortletDemo/view.jsp</value>
</init-param>
<expiration-cache>0</expiration-cache>
<supports>
<mime-type>text/html</mime-type>
</supports>
<resource-bundle>com.liferay.portlet.StrutsResourceBundle</resource-bundle>
<portlet-preferences>
<preference>
<name>test</name>
<value>123</value>
</preference>
</portlet-preferences>
<security-role-ref>
<role-name>power-user</role-name>
</security-role-ref>
<security-role-ref>
<role-name>user</role-name>
</security-role-ref>
</portlet>
主要修改了portlet-name，display-name，portlet-class，init-param这三个参数中的内容，有WEB开发经验的应该很好理解。
2.配置Portlet实例属性（这一步可以省略）
在liferay-portlet-ext.xml中添加
<portlet>
<portlet-name>EXT_2</portlet-name>
<instanceable>0</instanceable>
</portlet>
因为我们写的是JSP Portlet,所以不需要配置
<struts-path>ext/reports</struts-path>
3.定义Portlet名称
为了能够在portal 中方便查找添加你的portlet, 你需要在…/ext-impl/classes/content
Language-ext.properties中定义名称,通过添加下面这一行:
javax.portlet.title.EXT_2=Hello
JSP Portlet
其中的key值（即javax.portlet.title.EXT_2），是“javax.portlet.title”+“portlet名字”（即在portlet-ext.xml中添加的portlet的<portlet-name>的值）
4.归类Portlet
定向到…/ext-web/docroot/WEB-INF/liferay-display.xml。按照你的需要, 添加Portlet归类信息，把你所创建的portlet放入相应的位置。
<category
name="category.sample">
…
<portlet id="EXT_1" />
<portlet id="EXT_2" />
</category>

以上信息主要是为了在添加应用窗口中显示定义的portlet。如果做了Step3，那么最终在添加应用窗口中显示是第三步所定义的名字。在本例中将显示“My
JSP Portlet”。添加应用窗口如下图所示，因使用liferay版本不同页面效果会不太一样。
如果略过这一步，添加应用窗口会显示在undefined类别中。
部署项目（deploy ext项目）,build.xml—Run As…--Ant Build
5.测试
登录后（用户名test@liferay.com,密码：test）,点击右上角的Welcome Joe Bloggs!,点击Add Content

然后会弹出可添加的Portlet列表，按照分类显示：



如果你没有将自己写的portlet归类，那么Liferay会将其放在Undefined分类中：





点击ADD即可将自己的Portlet添加到页面上。显示效果如图：



后记：
在初学时还是有很多莫名其妙的问题，不过都是一些小问题，比如页面样式在保存密码后会变化，比如写的JSP Portlet没有关闭按钮等。这些问题暂时忽略，下一章我们开始学习Struts
Portlet的开发一个简单的图书管理系统。
感觉我用来入门的版本4.3.4还是有一些BUG，大概会在两篇笔记之后开始liferay6.0.5的学习。

PS，下次写文图片会减少，截图上传花费的时间太久了