除了 Web 应用程序部署描述符(web.xml)之外,portlet 还必须提供 portlet 部署描述符(portlet.xml),它对 WebSphere® Portal 定义 portlet 的功能。此信息包括特定于特殊 portlet 或 portlet 应用程序的配置参数以及所有 portlet 提供的一般信息(例如,portlet 支持的标记类型)。WebSphere Portal 使用此信息来为 portlet 提供服务。例如,如果 portlet 在 portlet 部署描述符中注册对帮助和编辑方式的支持,WebSphere Portal 将提供若干图标,用户可使用这些图标调用 portlet 的帮助和编辑页面。
每次创建新的 portlet 项目时,都将自动在项目的 WebContent 文件夹的 WEB-INF 中创建 portlet 部署描述符文件。它将显示为项目文件夹中的 Portlet 部署描述符节点。
可以使用 portlet 部署描述符编辑器来编辑 portlet 部署描述符(portlet.xml)。在 portlet 应用程序项目中双击 Portlet 部署描述符节点以打开 portlet 部署描述符编辑器。
通过使用此编辑器,可以创建、编辑或除去 portlet、具体 portlet 或具体 portlet 应用程序。
该编辑器与其它 XML 编辑器相似,也支持 XML 源代码视图。通过选择源代码选项卡就可以看到 XML 源代码视图。建议不要通过直接编辑源代码来编辑 portlet 部署描述符。
可以将“大纲”视图用作导航工具。当在“大纲”视图中选择一个对象时,portlet 部署描述符编辑器将切换至相应的页并将突出显示选择的对象。该对象也将打开并显示“源代码”页,在该页中将突出显示部署描述符中的代表 XML 标记。当在“源代码”页中工作时,可以使用 XML 标记进行浏览。
可以在“属性”视图中修改特定属性的属性值。要使用“属性”视图编辑另一个标记,可以在“大纲”视图中选择期望的节点,或在 portlet 部署描述符编辑器的“源代码”视图中选择属性。“属性”视图中的属性列包含属性列表,而值列包含这些属性的可编辑值。将显示选择的标记中已包括的属性及这些属性的值。当选择属性的值列时,将为您提供编辑选项。
使用复原缺省值菜单或它的工具栏按钮来将所有值更改回它的缺省设置。