比较 JSR 168 Java Portlet 规范与 IBM Portlet API

图 4描述从客户端到 Portlet的请求流，并且更详细地展示了动作和呈现阶段。在这个示例中，Portlet A接收了一个动作。在该动作执行之后，页面（A、B、C）上的所有Portlet 的呈现方法都被调用。

图 4. 从客户端到 Portlet 的请求流

Portlet 模式

Portlet执行不同的任务并根据它们的当前函数来创建内容。Portlet模式指示 Portlet 何时将执行函数。Portlet模式指定 Portlet应该执行哪一类任务和应该生成什么样的内容。当调用 Portlet时，Portlet 容器提供当前对 Portlet 的请求的模式。在处理动作请求时，Portlet可以程序化地改变它们的 Portlet 模式。 JSR 168 定义了三类 Portlet 模式： 1. 必须支持的模式（语义同上）

Edit

显示一个或多个视图以让用户自定义个性化的 Portletsettings.Help Help

显示帮助视图。 View

显示 Portlet 输出。 2. 可选择的客户模式 About

显示 Portlet 的目的、来源、版本和其他信息。 Config

显示一个或多个配置视图以让管理员配置对所有用户有效的Portlet 设置。

Edit_defaults

设置可修改的首选项的缺省值，这些首选项通常可以在EDIT 屏幕中进行更改。 Preview

呈现输出而不需要后端连接或特定于用户的可用数据。 Print

显示适于打印的视图。 3. 特定于 Portal 厂商的模式

这些模式只适用于特定的厂商Portal。 窗口状态

窗口状态是分配给 Portlet 生成的 Portal 页面空间的指示器。Portlet容器提供当前的窗口状态给 Portlet，而 Portlet 通过窗口状态来决定它应该呈现多少信息。然而，在处理动作请求时，Portlet也可以程序化地改变它们的窗口状态。 JSR 168 定义了如下窗口状态： Normal

Portlet 与其他 Portlet共享空间，在产生它的输出时应该对考虑这种状态。 Maximized

与处于正常的窗口状态相比，窗口有更真实的状态来提供它的输出。 Minimized

Portlet 应该只呈现最小的输出或没有输出。

除了这些窗口状态之外，JSR 168 允许 Portal 定义自定义窗口状态。 数据模式

JSR 168为 Portlet定义了不同的机制以访问瞬态数据和持久性数据。 Portlet 可以设置和获取下列作用域内的瞬态数据： 请求 会话 请求有附加的数据，比如请求参数和属性，与Servlet类似。请求可以包含一些特性，以送到 Portlet 的客户端头字段（反之亦然）。 Portlet可以将数据存储在具有全局作用域的会话中，以让 Web应用程序中的其他组件访作用域中，这个作用域是 Portlet 私有的。 上下文 Portlet可以将数据存储在 Web 应用程序上下文中，与 Servlet类似。 Portlet 可以访问这些作用域内的持久性数据： 每Portlet可以将配置和个人数据存储在 Portlet引用中，以允许 个 Portlet Portlet 创建个性化的输出。Portlet可以定义允许用户在编辑模式下更改那些数据（例如股票报价）以及哪些数据是只能由管理员在配置模式下进行更改的配置设置（例如股票报价服务器）。 每个用户 Portlet可以读取用户概要信息来针对用户调整它的输出（例如显示用户所在城市的天气情况）。 Portlet 应用程序

所有资源、Portlet 和配置描述符一起打包成一个 Web应用程序档案文件（WAR）。有两个配置描述符：

所有不是 Portlet 的 Web 应用程序资源必须在 web.xml配置描述符中指定。

? 所有 Portlet 和 Portlet 相关的设置必须在 portlet.xmldeployment 描述符中指定。

?

比较 JSR 168 与 IBM Portlet API

这一部分大概地比较了 JSR 168 Portlet API 与 IBM Portlet API。首先讲解了一些相似的概念，接着说明了两者之间的不同之处。 相似点

下列概念在 JSR 168和 IBM Portlet API 中是非常相似的。 特征 相似点 不同点 Portlet 模式 两者都支持基本的 Portlet 这种配置模式在 JSR 168中是可选模式：Edit、Help 和 View。 的。IBM Portlet API 不支持其他可选的 JSR 168模式（About、Edit_defaults、Preview、Print）。 窗口状态 支持如下窗口状态：Maximized、Normal和 Minimized。 Solo 窗口状态只有 IBM Portlet API支持。 没有 没有 Portlet 生命生命周期是相同的：初始周期 化、处理请求、毁坏。 请求处理 请求处理分为处理用户动作的动作阶段和产生标记的呈现阶段。 两者都支持创建指向 Portlet或资源的 URL。 URL 编码 没有 包含 Servlet 和 JSP 可以包括没有 Servlet/JSP 在 Portlet中。 Portlet 会话 Portlet可以存储瞬态信息，没有 这些信息应该都在会话中的请求内。 Portlet 应用两者都通过附加的部署描portlet.xml 格式有所不同。 程序打包 述符（名为 portlet.xml ）来将 Portlet 应用程序打包成 WAR文件。 Portlet可以支持基于到期时间的缓存。 API使用不同的机制来实现这一功能。 IBM Portlet API使用轮询机制，在这种机制中， Portal 查询 Portlet以获取标记的有效时间，而在 JSR 168 中，Portlet可以将到期时间附加到创建的每个标记上。在用户之间共享缓存条目只有在IBM Portlet API 中才是可能的。 基于到期时间的缓存 不同点

JSR168 和 IBM Portlet API 在以下几个方面有所不同。 特征 IBM Portlet API JSR 168 该部署描述符紧跟在 web.xml 部署描述符之后，它定义一个应用程序及其 Portlet定义。 Portlet 使您可以通过部署描述符将抽象的应用程Portlet 应用程序及其不同的实例定义为序实体 具体的 Portlet应用程序。这允许重用抽象的 Portlet应用程序的设置，而只重写对于每个具体的 Portlet应用程序惟一的部分。 Portlet Web 部署描述符中的每个 Portlet配置实体 都有一个 Portlet 对象实例。根据 Flyweight模式，可以有许多 PortletSettings 对象来参数化相同的 Portlet对象（基于每个请求）。 PortletSettings 中的改变会应用到这个具体的 Portlet 中的所有 Portlet实例。用户也可以具体 Portlet的个人视图，它是通过使用自定义输出的 PortletData 呈现的。 PortletSettings 和 PortletData 合并成一个名为 PortletPreferences 的对象。 请求/响Portlet在呈现调用中接收到的请求/响应在 JSR 168中，有两个不同应对象 对象与动作调用接收到的相同。 的对象。 JSR 168 独有的特征

这些项只适用于 JSR 168。 特征 呈现参数 描述 呈现参数允许 Portlet存储它的导航状态。 呈现参数在随后的呈现请求中保持不变，而只是在Portlet接收到一个新的动作时才发生改变。这启用了书签功能，并且