在本系列的 第 1 部分 简要回顾了 JSR 168 Portlet，并对 JSR 286 Portlet 的新增特性做了详细的介绍， 本文将通过在 Apache Pluto 2.0 平台上开发和部署 Portlet 应用程序， 向读者介绍 JSR 286 Portlet 新特性的使用方法。本文将首先介绍 JSR 286 参考实 现 Apache Pluto 2.0 平台的构建过程，然后通过在 Apache Pluto 2.0 平台上开发和部署 JSR 286 Portlet 应用程序， 向读者介绍 JSR 286 Portlet 资源服务和新增的交互功能：事件和共享呈现参数。
关于本系列
本系列 专门针对具有 JSR 168 Portlet 开发基础，并且想了解 JSR 286 Portlet 新特性和开发流程的开发人员。在学完本系列后， 您将了解到相对于 JSR 168 Portlet，JSR 286 Portlet 究竟提供了哪些增强功能， 以及这些新增特性在实际开发中的应用。
本系列的 第 1 部分 简单回顾了 JSR 168 Portlet， 并列出了 JSR 286 Portlet 的新增内容。第 2 部分和第 3 部分将通过在 Apache Pluto 2.0 平台上开发和部署 Portlet 应用程序， 向读者介绍 JSR 286 Portlet 新特性的使用方法。
关于本文
本文将首先介绍 JSR 286 参考实现 Apache Pluto 2.0 平台的构建过程，然后通过在 Apache Pluto 2.0 平台上开发和部署 JSR 286 Portlet 应用程序， 向读者介绍 JSR 286 Portlet 资源服务和新增的交互功能：事件和共享呈现参数。
Portlet 过滤器和 Portlet 窗口方面应用程序的开发过程，将在第 3 部分进行详细介绍。
在示例应用程序的开发和部署中用到了下列产品：
Sun JDK 1.5
Apache Tomcat 6.x
Apache Pluto 2.0
Apache Maven 2.x
Eclipse Europa(Eclipse V3.3) for JavaEE Developers
阅读本文之前，您应当对 JSR 168 Portlet 有所了解，并阅读了本系列的 第 1 部分。
准备工作
Apache Pluto 2.0 是 JSR 286 的参考实现，是实现了 Portlet 2.0 API 的 Portlet 容器，充当 Portlet 的运行时环境，与 web 应 用服务器的 Servlet 容器的运行时环境支持 Servlet 的情形非常相似。Pluto 2.0 目前支持的 JSR 286 Portlet 新特性有资源服务、事 件、Portlet 过滤器、共享呈现参数、 Portlet 窗口。
在本文中，我们将使用 Apache Pluto 2.0 开发测试我们的 JSR 286 Portlet 应用程序。以下操作均在 Windows XP操作系统环境下进 行。
1. 构建 JSR 286 Portlet 运行环境 Apache Pluto 2.0
Apache Pluto 2.0 目前还处于开发阶段，我们只能通过其源代码构建出一个支持 JSR 286 Portlet 标准的 Portlet 2.0 容器。
安装 Sun JDK 1.5 并设定环境变量
该步骤一般读者都比较熟悉，不再拗述。需要注意的是，经过笔者测试，Pluto 2.0 源码工程只可以在 Sun JDK 1.5 下构建成功，笔 者使用 Sun JDK 1.6 和 IBM JDK 1.5 均构建失败。
安装 Maven 2
Pluto 源代码使用 Maven 2 进行项目管理和构建，我们必须首先安装该工具。
从 http://maven.apache.org/ 上寻找 Maven 2 的最新版本压缩包，下载并解压，设定 Maven 2 的安装路径为 ${M2_HOME}。将 ${M2_HOME}/bin 目录加到系统的 PATH 环境变量中。
安装 Tomcat 6
从 http://tomcat.apache.org/ 上寻找 Tomcat 6 的最新版本压缩包，下载并解压，设定安装路径为 ${TOMCAT_HOME}。
获取 Apache Pluto 2.0 源码
使用 SVN 客户端从官方 SVN 服务器上获得源代码：
清单 1. 使用 SVN 客户端从官方 SVN 服务器上获得源代码
svn checkout https://svn.apache.org/repos/asf/portals/pluto/trunk/ pluto2
使用 Maven 2 构建 Pluto 2.0
编辑 ${M2_HOME}/conf 目录下的 settings.xml 文件，增加 元素:
清单 2. settings.xml 文件
... org.apache.pluto ...
打开 pluto2 目录下的 pom.xml 文件，找到
清单 3. pom.xml 文件
...2.1.2...
改为
清单 4. pom.xml 文件
2.1.3
命令行模式下进入 pluto2 目录，执行以下命令：
清单 5.
D:/>cd pluto2D:/pluto2>mvn installD:/pluto2>mvn pluto:install -DinstallDir=${TOMCAT_HOME}
如果您的 Tomcat 安装路径中存在空格，则需要用双引号把路径引起来：
清单 6.
mvn pluto:install -DinstallDir="C:/Program Files/Apache Software Foundation/Tomcat 6.0"
从网上寻找 commons-logging-api-1.1.jar 文件，拷贝到 ${TOMCAT_HOME}/lib/ 目录下。
至此，pluto2.0 的相关文件就被安装到 tomcat 相应目录下。
编辑 ${TOMCAT_HOME}/conf/tomcat-users.xml 文件，添加角色 pluto，并在该角色下新增一个用户，以下为示例文件:
清单 7. tomcat-users.xml 文件
验证安装
运行 ${TOMCAT_HOME}/bin/startup.bat，启动 tomcat 服务器。浏览器访问 URL http://localhost:8080/pluto/portal，如图 1 所 示：
图 1. Pluto 登录界面
输入添加到 pluto 角色的用户名和密码，进入 Pluto 的 Portal 页面：
图 2. Pluto Portal界面
至此，JSR 286 Portlet 运行环境 Apache Pluto 2.0 搭建成功。
2. 使用 Eclipse Europa 建立开发环境
首先，需要 从 Eclipse 官方网站 http://www.eclipse.org 下载 Eclipse Europa，针对不同的开发需求，有几种包可供下载。我们进行的是 J2EE Web 开发，所以注意要下载 Eclipse IDE for Java EE Developers。
启动 Eclipse，对 Eclipse 进行配置：
执行菜单项 目 Window -> Preferences，打开 Preferences 对话框，选择 Server -> Installed Runtimes 项，如 图 3 所示：
图 3. Preferences 对话框
点击 Add 按钮，将 Tomcat 6 添加为运行时，如 图 4、图 5 所示：
图 4. 选择运行时类型
图 5. 设定 Tomcat 安装路径
单击 Finish 结束配置，单击 OK 关闭 Preferences 对话框。
在 Eclipse 的 Servers 视图中单击鼠标右键，选择 New -> Server 。如 图 6 所示:
图 6. 新建服务器
在弹出的窗口中选择目标运行服务器 Apache Tomcat 6.0 Server,运行时呈现 Apache Tomcat v6.0，如图7所示，点击 Finish。
图 7. 选择目标运行服务器
在 Servers 视图中双击刚刚新建的 Tomcat 服务器，打开服务器配置页面，如图 8 所示：
图 8. Tomcat 服务器配置页面
在 Server Locations 中选择 Use Tomcat Installation，Deploy Path选择 ${TOMCAT_HOME}/webapps，如图 9 所示。至此开发环境 设置完毕。
必须设定 Deploy Path 为 Tomcat 安装目录下的 webapps 目录，否则使用 Eclipse 启动 Tomcat 后，Pluto 不能加载进来。
图 9. Tomcat 服务器配置
创建 JSR 286 Portlet 应用
下面，我们开始创建一系列程序来演示 JSR 286 Portlet 的新特性。主要分为以下六个部分：
使用 Eclipse 创建 Portlet Web 项目
资源服务
事件
Portlet 过滤器
共享呈现参数
Portlet 窗口
1. 使用 Eclipse 创建 Portlet Web 项目
新建项目，项目类型选择 Web->Dynamic Web Project，如图 10 所示：
图 10. 新建动态 Web 项目
接下来，设置项目属性，项目名称 jsr286portlets, 目标运行时 Apache Tomcat V6.0，保留默认设置，点击 Finish，如 图 11 所示 ：
图 11. 设置项目属性
生成项目结构如图 12:
图 12. 项目结构
在 META-INF 下新建 context.xml 文件，内容如下：
清单 8. context.xml 文件
该文件为 Tomcat 的特有配置文件，根据 Pluto 的要求，该 Web 工程的上下文应该可以被其它 JavaEE 程序访问，所以 crossContext 参数设置为 true。
在 WEB-INF 下新建 portlet.xml 文件，内容如下：
清单 9. portlet.xml 文件
下面我们将在黑体部分填写 portlet 定义。
2. 资源服务
新增 Java 类 TestPortlet，实现了 javax.portlet.Portlet 和 javax.portlet.ResourceServingPortlet 接口：
清单 10. TestPortlet.java 文件
package com.ibm.samples.jsr286.portlets;import ...public class TestPortlet implements Portlet, ResourceServingPortlet { private PortletConfig portletConfig; public void init(PortletConfig portletConfig) throws PortletException { this.portletConfig = portletConfig; } public void destroy() { } public void processAction(ActionRequest actionRequest, ActionResponse actionResponse) throws PortletException, IOException { } public void render(RenderRequest renderRequest, RenderResponse renderResponse) throws PortletException, IOException { PortletRequestDispatcher portletRequestDispatcher = portletConfig .getPortletContext().getRequestDispatcher( "/WEB-INF/jsp/TestPortletView.jsp"); portletRequestDispatcher.include(renderRequest, renderResponse); } public void serveResource(ResourceRequest resourceRequest, ResourceResponse resourceResponse) throws PortletException, IOException { PortletRequestDispatcher portletRequestDispatcher = portletConfig .getPortletContext().getRequestDispatcher( "/WEB-INF/jsp/TestPortletResource.jsp"); portletRequestDispatcher.include(resourceRequest, resourceResponse); }}
在 WEB-INF 目录下新建 jsp 目录，在 jsp 目录下新建 portlet 呈现阶段所显示的 jsp 文件 TestPortletView.jsp。
清单 11. TestPortletView.jsp 文件
Test portlet page. ">Click me to request Resource URL
在 jsp 目录下新建 portlet 资源服务所请求的 jsp 文件 TestPortletResource.jsp。
清单 12. TestPortletResource.jsp 文件
Test portlet resource page.
编辑 portlet.xml 文件, 为 TestPortlet 增加一个 portlet 定义片断，该 TestPortlet 仅支持 View 模式。
清单 13. TestPortlet 定义片断
TestPortlet TestPortlet com.ibm.samples.jsr286.portlets.TestPortlet text/html VIEW
编辑 web.xml 文件，增加 Pluto 所需的 servlet 定义及映射。读者请注意，该定义为 Pluto 2.0 Portlet 容器所需，不属于 JSR 286 标准的要求。
清单 14. Pluto 所需的 servlet 定义及映射片断
TestPortlet org.apache.pluto.core.PortletServlet portlet-name TestPortlet 1 TestPortlet /PlutoInvoker/TestPortlet
在 Eclipse 的 Servers 视图中，右键单击 Tomcat 服务器，点击 Add and Remove Projects，在弹出的对话框中将 jsr286portlets 项目添加到右侧栏目中，点击 Finish 确认，如图13：
图 13. 部署项目到服务器
在 Servers 视图中启动服务器，Console 视图中输出 Tomcat 启动信息。
浏览器中输入相应 url 访问 pluto 的 portal 页面，登录，点击 Pluto Admin 导航栏，如图14：
图 14. Pluto 管理界面
使用该工具新建一个页面，如 “Test JSR 286 Portlet Page”。导航栏中马上新增一项 “Test JSR 286 Portlet Page”，点击进入该页 面可以见到目前该页面没有内容。
选择 jsr286portlets 应用程序中的 Portlet TestPortlet，选择上一步新建的页面，点击 Add Portlet 按钮，将 TestPortlet 布局 到 “Test JSR 286 Portlet Page”页面。如图 15:
图 15. 布局 Portlet 到 Portal 页面
进入”Test JSR 286 Portlet Page”页面，该页面新增了一个 Portlet TestPortlet，如图16：
图 16. TestPortlet 界面
注意到上图 portlet 的标题显示为 null, 这是由于 pluto 2.0 目前处于开发阶段，存在一些 bug，读者可不必理会。
点击超链接，进入所请求的资源页面，如图 17:
图 17. TestPortlet 资源界面
观察此页面，发现此页面只显示了 TestPortletResource.jsp 的内容，未经过 Portal 容器的修饰， 和直接请求一个 Servlet 或者 JSP 页面的效果是一样的。这就是 JSR 286 Portlet 资源服务的主要特性。对照此示例，读者可加深对 第 1 部分 相关内容的理解。
3. 事件
简单事件
新建 Java 类 TestSimpleEventSenderPortlet， 在该 Portlet 类的 processAction 方法中，发送一个简单事件，事件内容为一个字 符串。
清单 15. TestSimpleEventSenderPortlet.java 文件
package com.ibm.samples.jsr286.portlets;import ...public class TestSimpleEventSenderPortlet implements Portlet { ... public void processAction(ActionRequest actionRequest, ActionResponse actionResponse) throws PortletException, IOException { actionResponse.setEvent("simple-event", "simple-event is sent by " + portletConfig.getPortletName()); } public void render(RenderRequest renderRequest, RenderResponse renderResponse) throws PortletException, IOException { PortletRequestDispatcher portletRequestDispatcher = portletConfig .getPortletContext().getRequestDispatcher( "/WEB-INF/jsp/TestSimpleEventSenderPortletView.jsp"); portletRequestDispatcher.include(renderRequest, renderResponse); }}
在 jsp 目录下新建 jsp 文件 TestSimpleEventSenderPortletView.jsp
清单 16. TestSimpleEventSenderPortletView.jsp 文件
"> Test simple event sender portlet page.
新建 Java 类 TestSimpleEventReceiverPortlet， 在该 Portlet 实现了 javax.portlet.EventPortlet 接口，可以响应事件。
清单 17. TestSimpleEventReceiverPortlet.java 文件
package com.ibm.samples.jsr286.portlets;import ...public class TestSimpleEventReceiverPortlet implements Portlet, EventPortlet { ... public void processAction(ActionRequest actionRequest, ActionResponse actionResponse) throws PortletException, IOException { } public void render(RenderRequest renderRequest, RenderResponse renderResponse) throws PortletException, IOException { PortletRequestDispatcher portletRequestDispatcher = portletConfig .getPortletContext().getRequestDispatcher( "/WEB-INF/jsp/TestSimpleEventReceiverPortletView.jsp"); portletRequestDispatcher.include(renderRequest, renderResponse); } public void processEvent(EventRequest eventRequest, EventResponse eventResponse) throws PortletException, IOException { Event event = eventRequest.getEvent(); eventResponse.setRenderParameter("eventName", event.getName()); eventResponse.setRenderParameter("eventValue", event.getValue().toString()); }}
在 jsp 目录下新建 jsp 文件 TestSimpleEventReceiverPortletView.jsp
清单 18. TestSimpleEventReceiverPortletView.jsp 文件
Test simple event receiver portlet page. Received simple event: Event name: Event value:
在 portlet.xml 文件中新增 TestSimpleEventSenderPortlet 定义, 该 portlet 支持事件的发布，注意 supported-publishing- event 元素中定义所支持发布的事件名称为 simple-event。
清单 19. TestSimpleEventSenderPortlet 定义
TestSimpleEventSenderPortlet TestSimpleEventSenderPortlet com.ibm.samples.jsr286.portlets.TestSimpleEventSenderPortlet text/html VIEW
在 portlet.xml 文件中新增 TestSimpleEventReceiverPortlet 定义, 该 portlet 支持事件的响应处理，注意 supported- processing-event 元素中定义所支持处理的事件名称为 simple-event。
清单 20. TestSimpleEventReceiverPortlet 定义
TestSimpleEventReceiverPortlet TestSimpleEventReceiverPortlet com.ibm.samples.jsr286.portlets.TestSimpleEventReceiverPortlet text/html VIEW
您还需要在 portlet.xml 文件中添加以下声明，定义 QName 默认的命名空间和事件定义，该事件类型为 java.lang.String。
清单 21. simple-event 定义
http://cn.ibm.com/ simple-event java.lang.String
参照 TestPortlet 的定义，为 TestSimpleEventSenderPortlet 和 TestSimpleEventReceiverPortlet 在 web.xml 里添加 Pluto 所 需的 servlet 定义及映射。
将 TestSimpleEventSenderPortlet 和 TestSimpleEventReceiverPortlet 部署到”Test JSR 286 Portlet Page”页面，如图 18 和 图 19。
图 18. 简单事件发布 portlet
图 19. 简单事件响应 portlet
点击 TestSimpleEventSenderPortlet 中的按钮，TestSimpleEventReceiverPortlet 如图 20 所示：
图 20. 简单事件响应
表明 TestSimpleEventReceiverPortlet 接收到了名为 simple-event 的事件，事件值为 “simple-event is sent by TestSimpleEventSenderPortlet”。
复合事件
定义一个 复合事件 Java 类 SampleComplexEvent， 该类是可序列化的，并且存在 int, String, Date 三种类型的属性。
清单 22. SampleComplexEvent.java 文件
package com.ibm.samples.jsr286.events;import ...public class SampleComplexEvent implements Serializable { private static final long serialVersionUID = -1447091586272283310L; private int intItem; private String strItem; private Date dateItem; //setters and getters ...}
新建 Java 类 TestComplexEventSenderPortlet， 在该 Portlet 类的 processAction 方法中，发送一个复合事件，事件类型为 com.ibm.samples.jsr286.events.SampleComplexEvent。
清单 23. TestComplexEventSenderPortlet.java 文件
package com.ibm.samples.jsr286.portlets;import ...public class TestComplexEventSenderPortlet implements Portlet { ... public void processAction(ActionRequest actionRequest, ActionResponse actionResponse) throws PortletException, IOException { SampleComplexEvent event = new SampleComplexEvent(); event.setIntItem(new Random().nextInt()); event.setStrItem("complex-event is sent by " + portletConfig.getPortletName()); event.setDateItem(new Date()); actionResponse.setEvent("complex-event", event); } public void render(RenderRequest renderRequest, RenderResponse renderResponse) throws PortletException, IOException { PortletRequestDispatcher portletRequestDispatcher = portletConfig .getPortletContext().getRequestDispatcher( "/WEB-INF/jsp/TestComplexEventSenderPortletView.jsp"); portletRequestDispatcher.include(renderRequest, renderResponse); }}
在 jsp 目录下新建 jsp 文件 TestComplexEventSenderPortletView.jsp， 内容同 清单 16. TestSimpleEventSenderPortletView.jsp 文件 类似。
新建 Java 类 TestComplexEventReceiverPortlet， 在该 Portlet 实现了 javax.portlet.EventPortlet 接口，可以响应复合事件。
清单 24. TestComplexEventReceiverPortlet.java 文件
package com.ibm.samples.jsr286.portlets;import ...public class TestComplexEventReceiverPortlet implements Portlet, EventPortlet { ... public void processAction(ActionRequest actionRequest, ActionResponse actionResponse) throws PortletException, IOException { } public void render(RenderRequest renderRequest, RenderResponse renderResponse) throws PortletException, IOException { PortletRequestDispatcher portletRequestDispatcher = portletConfig .getPortletContext().getRequestDispatcher( "/WEB-INF/jsp/TestComplexEventReceiverPortletView.jsp"); portletRequestDispatcher.include(renderRequest, renderResponse); } public void processEvent(EventRequest eventRequest, EventResponse eventResponse) throws PortletException, IOException { Event event = eventRequest.getEvent(); eventResponse.setRenderParameter("eventName", event.getName()); SampleComplexEvent eventValue = (SampleComplexEvent) event.getValue(); eventResponse.setRenderParameter("intItem", Integer.toString(eventValue .getIntItem())); eventResponse.setRenderParameter("strItem", eventValue.getStrItem()); eventResponse.setRenderParameter("dateItem", eventValue.getDateItem().toString()); }}
在 jsp 目录下新建 jsp 文件 TestComplexEventReceiverPortletView.jsp
清单 25. TestComplexEventReceiverPortletView.jsp 文件
Test complex event receiver portlet page. Received complex event: Event name: Event value Integer item: String item: Date item:
请读者自行参照清单 19 和 清单 20 在 portlet.xml 文件中定义两个portlet TestComplexEventSenderPortlet 和 TestComplexEventReceiverPortlet, 使其分别支持发布和响应事件 complex-event。
在 portlet.xml 文件中添加以下声明，定义事件名称和类型，该事件类型为com.ibm.samples.jsr286.events.SampleComplexEvent， 如清单 26 所示：
清单 26.
complex-event com.ibm.samples.jsr286.events.SampleComplexEvent
参照 TestPortlet 的定义, 为 TestComplexEventSenderPortlet 和 TestComplexEventReceiverPortlet 在 web.xml 里添加 Pluto 所需的 servlet 定义及映射。
将 TestComplexEventSenderPortlet 和 TestComplexEventSenderPortlet 部署到”Test JSR 286 Portlet Page”页面，如图 21 和 图 22。
图 21. 复合事件发布 portlet
图 22. 复合事件响应 portlet
点击 TestComplexEventSenderPortlet 中的按钮，TestComplexEventReceiverPortlet 如图 23 所示：
图 23. 复合事件响应
表明 TestComplexEventReceiverPortlet 接收到了名为 complex-event 的事件，事件值如图 23 所示。
4. 共享呈现参数
更改 TestPortletView.jsp 文件，在文件末尾增加表单和输入框接收输入参数，如清单 26 所示：
清单 26. 表单和共享呈现参数值输入框
..."> Input public render parameter value:
更改 TestPortlet 的 processAction 方法，将从输入框中得到的值传送到呈现阶段的请求参数中，如清单 27 所示：
清单 27. TestPortlet 的 processAction 方法
...public void processAction(ActionRequest actionRequest, ActionResponse actionResponse) throws PortletException, IOException { String publicRenderParamValue = actionRequest.getParameter("public-render-param"); actionResponse.setRenderParameter("public-render-param", publicRenderParamValue);}...
新建 portlet 类 TestPublicRenderParameterPortlet, 如清单 28 所示：
清单 28. TestPublicRenderParameterPortlet.java 文件
package com.ibm.samples.jsr286.portlets;import ...public class TestPublicRenderParameterPortlet implements Portlet { private PortletConfig portletConfig; public void init(PortletConfig portletConfig) throws PortletException { this.portletConfig = portletConfig; } public void destroy() { } public void processAction(ActionRequest actionRequest, ActionResponse actionResponse) throws PortletException, IOException { } public void render(RenderRequest renderRequest, RenderResponse renderResponse) throws PortletException, IOException { PortletRequestDispatcher portletRequestDispatcher = portletConfig .getPortletContext() .getRequestDispatcher( "/WEB-INF/jsp/TestPublicRenderParameterPortletView.jsp"); portletRequestDispatcher.include(renderRequest, renderResponse); }}
TestPublicRenderParameterPortlet 呈现所需的 jsp 页面 TestPublicRenderParameterPortletView.jsp 如清单 29 所示：
清单 29. TestPublicRenderParameterPortletView.jsp 文件
Test public render parameter test page. Received public render parameter value: Parameter value:
编辑 portlet.xml 文件， 在 TestPortlet 定义的尾端加入 清单 30 中 的内容，使得 portlet TestPortlet 支持共享呈现参数 public-render-param。
清单 30.
... public-render-param
在 portlet.xml 中增加 TestPublicRenderParameterPortlet 的定义，并加入清单 30 中的内容。
在 portlet.xml 末尾添加 清单 31 中的内容：
清单 31.
... public-render-param
为 TestPublicRenderParameterPortlet 在 web.xml 里添加 Pluto 所需的 servlet 定义及映射。
将 TestPortlet 和 TestPublicRenderParameterPortlet 部署到 “Test JSR 286 Portlet Page” 页面，如图 24 和 图 25。
图 24. 输入共享呈现参数值
图 25. 显示共享呈现参数值的 portlet
在 TestPortlet 中输入参数值 testvalue, 提交表单，则在 TestPublicRenderParameterPortlet 呈现图 26 所示结果：
图 26. 显示共享呈现参数值
小结
本部分介绍了 JSR 286 Portlet 容器的参考实现 Apache Pluto 2.0 的构建过程，以及使用 Eclipse 和 Apache Pluto 2.0 进行 Portlet 开发的方法流程，并且通过示例代码介绍了JSR 286 Portlet 资源服务、事件交互和共享呈现参数的实际开发步骤。JSR 286 规 范目前还处于草案阶段，而且相应的 Portlet 容器还处于不稳定版本的开发阶段，在具体的实验性开发过程中需要读者对 Portelt 容器 本身的 Bug 加以注意。
一切伟大的行动和思想，都有一个微不足道的开始
