对门户和portlet程序的事件和公共赋值参数的工具支持
Java portlet 规格 2.0 中引入的新特性,基于 JSR 286,支持 portlets 之间的协作。事件和公共赋值变量是 portlets 相互之间可以交流的两个机理。在对一些关键概念做简短介绍之后,本文向您介绍如何使用 IBM Rational Application Developer V7.5 中的 Portal Toolkit,来创建一个 JSR 286 基本 portlet 的范例。在这个过程中,它解释了 Portal Toolkit 是怎样加速整个过程以升级这些功能的。
关键概念
本文首先介绍一下关键概念,然后使用范例 portlet 程序来展示一下这些概念。
事件
JavaSpecification Request(JSR)286 规格的 2 版本,使 portlets 发送和接受事件成为可能。事件能使 portlets 相互之间进行交流。IBM Rational Application Developer V7.5 提供了一系列的工具,以定义事件,激活 portlets,并使用事件在它们之间传递数据。一个 portlet 可以处理交流的双方:
向其他 portlets 发送事件
从其他 portlets 那里接受和处理事件
事件的属性
每一个事件必须有一个名字,可能还要有其他属性:
Name:事件独一无二的名字。该事件名必须是一个完整的 QName,跟在 XML 规格中定义的名字一样,它由一个名字区(例如,http://www.ibm.com)和本地区(例如,sampleEvent)组成。您可以为多个事件使用相同的名字区,只需将其宣布为默认的名字区,然后为每一个事件只指定本地区。
Description:(可选项)对事件所做的描述。
Value type:(可选项)随事件一起传递的值的 Jazz 类名。
Alias:(可选项)事件名字区特定的名字。
按照如下步骤,创建一个 portlet 程序,该程序集成了事件和公共赋值变量,以便在 portlets 之间进行交流:
创建一个 JSR 286 portlet 项目和 portlets。
在 portlet 部署描述器(PDD)中创建一个事件定义。
添加事件作为 portlet 支持的发布或者处理的事件。
编辑 portlet 类中的过程行为或者事件代码,以发布或者处理事件。
添加公共赋值变量。
向服务器发布 portlet 项目。
将 portlets 集中到一起。
通过使用 Rational Application Developer V7.5 提供的工具,可以极大地简化这些任务。
公共赋值变量
JSR 286 规格提供了支持 portlet 之间协作的另外一个机理:公共赋值变量(查看资源以找到更多关于它的信息)。这些参数为在 portlet 之间共享请求参数提供了一种途径。
公共赋值变量的属性
每一个变量必须要有一个名字,或者可能还要有其他的属性:
Name:(必需的)参数独一无二的名字,要么是一个字符串要么是名字空间特定的名字。选择默认的名字空间或者指定一个不同的。您所输入的作为事件名的本地字符串会添加到名字空间。
Identifier:(必需的) portlet 代码中使用的字符串以引用赋值变量。
Description:(可选的)对赋值变量的描述。
Alias:(可选的)对参数的名字空间区域内的名字。