从 portlet JSP 文件访问配置对象
将属性添加至 portlet 配置对象(如 PortletData 和 PortletPreferences);将控件添加至 portlet JSP 文件以添加、修改或删除这些属性;以及插入控件以访问属性或将属性绑定至 portlet JSP 文件中的现有控件。
IBM® portlet API 和 JSR 168 portlet API
定义封装有 portlet 对象数据的 portlet 配置对象。例如,IBM portlet
API 定义 PortletData 对象,而该对象在与具体 portlet 结合时,用于定义具体 portlet 实例。在
JSR 168 portlet API 中,PortletPreferences 对象结合 portlet 对象,一起定义 portlet
实体。有关 portlet 配置对象及其用法的更多详细信息,请参阅教程库中的检查
portlet API 之间的差别教程()。
使用
portlet JSP 文件的“页数据”视图来执行以下操作:
- 将属性添加至下面列示的任何 portlet 配置对象类型。
- 对于 IBM portlet
API 项目
- PortletApplicationSettings
- PortletSettings
- PortletData
- User
- 对于 JSR 168 portlet API 项目
- PortletPreferences
- USER_INFO
- 在 JSP 文件中插入或添加控件以显示、添加、修改或删除属性的值。
遵循下面的步骤以将属性添加至 portlet 数据对象,然后将控件添加至 JSP 文件以创建、修改、删除或显示数据:
- 通过在“项目资源管理器”视图中双击 portlet JSP 文件来打开它。
- 打开工作台左下角的“页数据”视图。左下角有几个堆叠式视图,所以您可能需要按 TAB 键来显示“页数据”视图。
- 在“页数据”视图中,展开 Portlet。
- 突出显示其中一个 portlet 配置对象。
- 单击右键并选择添加属性。
- 提供属性的值。
- 对于使用 IBM portlet API
提供的 PortletData 属性,还可以选择该属性的 Java™ 类型。对于这两个 portlet API,所有其它类型的数据对象仅允许 java.lang.String 作为 Java 类型。
注: 如果要将复杂(非字符串)Java 类型用于 PortletData 属性,则不要将变量拖到 JSP 页面上。请改为使用
<jsp:usebean> 标记,如以下示例中所示:
<jsp:useBean id="date" class="java.util.Date" scope="request">
<% date = (java.util.Date)portletRequest.getData().getAttribute("date"); %>
</jsp:useBean>
可使用数据 bean 来访问该数据(例如,
${date.year})。要将变量存储到
PortletData 对象中,该 portlet 必须处于编辑方式并且应该调用
<% portletRequest.getData().setAttribute("date", new java.util.Date()); %>
或等同项。
- 单击确定。
- 在“页数据”视图中,展开在其中创建新属性的 portlet 配置对象。这将列示新的属性对象。
- 将“页数据”视图中的属性对象拖到编辑器区域中的 JSP 文件上。“插入记录”向导打开。
- 在向导的配置数据控件页面上,选择为其创建控件中的其中一个选项:
- 显示现有记录(只读)
- 此选项提供用于显示属性值的代码。对于要显示的字段框中列示的每个属性,可通过从下拉菜单中选择“控件类型”来选择属性的显示方式。选项列示如下:
- 更新现有记录
- 此选项提供用于改变属性值的表单,该表单带有“提交”和“删除”按钮。对于要显示的字段框中列示的每个属性,可通过从下拉菜单中选择“控件类型”来选择属性的显示方式。选项列示如下:
- 输入字段
- 组合框
- 输出字段
- 输出链接(超链接中的输出字段)。
- 创建新的记录
- 此选项提供用于创建属性的表单,该表单带有“提交”按钮。
对于要显示的字段框中列示的每个属性,可通过从下拉菜单中选择“控件类型”来选择属性的显示方式。选项列示如下:
- 从要显示的字段下的列表中选择要添加至页面的属性。
- 单击选项以设置下列任何值:
- 按钮:使用按钮选项卡来选择或取消选择“提交”和“删除”按钮并为按钮提供标签。只会对更新或创建选项显示按钮选项卡,而不会对显示选项显示按钮选项卡。“删除”按钮仅对更新选项可用。
- 标签格式:使用标签格式选项卡来选择对齐方式(左对齐、右对齐或中间对齐)。还有一些选项用于
- 在每个标签后追加冒号。此选项在缺省情况下设置为“打开”。
- 将每个标签的首字母大写。此选项在缺省情况下设置为“打开”。
- 高级:使用高级选项卡来设置下列选项:
- 深度。此值指的是深入对象层次结构来检索要显示的属性的程度。例如,可能会有一个对象带有包含其它对象的数组字段,这些对象又可能包含其它数组和对象。缺省深度值为 3。
- 选择用作缺省深度以将该深度值用作缺省值。此选项在缺省情况下设置为“关闭”。
- 选择仅创建数据控件来创建底层代码,但会省略标签。此选项在缺省情况下设置为“关闭”(即,创建了标签)。
- 单击确定以保存选项。
- 单击完成以将控件添加至 JSP 文件。
如果想要将属性的其它控件添加至 JSP 文件,在“页数据”视图中右键单击该属性并选择插入新的控件。