JavaServer Faces 工具(Beta 版)- 发行说明


1.0 受支持的软件和规范
2.0 局限性
   2.1 Faces 组件拖放在具有多个内容区域的页面模板中不能正常工作
   2.2 不能将文件上载组件放在从包含表单的页面模板生成的页上
   2.3 在 Page Designer 中复制和粘贴 Faces 组件
   2.4 添加 Faces 项目资源时的问题
   2.5 当快速编辑视图打开时,将 JSF 组件标识与 Java 源文件同步时产生问题
3.0 已知问题
   3.1 使用页面模板中的 JSF 控件时出错

1.0 受支持的软件和规范

围绕 JavaServer Faces 技术的工具(如“选用板”视图中的 Faces 组件)被认为是 Beta 级别功能。涉及此功能的文档也在 Beta 级别受支持。
因为 JavaServer Faces 功能部件处于 Beta 状态,所以不应将它们用于生产应用程序。IBM 不能确保使用这些 JavaServer Faces 功能部件的 JavaServer Page 文件的向前迁移或兼容性,也不能确保对这些文件的支持。

2.0 局限性

2.1 Faces 组件拖放在具有多个内容区域的页面模板中不能正常工作

当用户创建包含多个内容区域的页面模板(基于 Faces 页)时,该用户必须确保这些内容区域前后都有 Faces form 标记。可以使用两种方法中的一种来实现此任务。第一种也是最直接的方法是从选用板将命令按钮拖放到页上的每个内容区域上,并在放下所有按钮之后立即删除它们。这将强制 form 标记重新成为父标记,直到它将所有内容区域都包括在内为止。另一种方法是取消隐藏“Faces 组件”选用板抽屉中的表单组件,并将它拖放到模板上,然后将内容区域拖放到表单组件上。

2.2 不能将文件上载组件放在从包含表单的页面模板生成的页上

当从选用板将“文件上载”组件拖放到从已包含 faces form 标记的页面模板生成的页上时,用户可能注意到问题。放下操作需要能够编辑表单的属性才能完成放下。有两种可能的变通方法:
a) 更改页面模板中的 form 标记,以便它具有 enctype 属性。将该属性设置为 "multipart/form-data",如:<h:form formName="form1" id="form1" enctype="multipart/form-data"></h:form>
b) 将 form 标记放置在模板的可编辑区域中。可以通过将内容区域放到页面上,然后取消隐藏选用板表单项并将它放在内容区域上来实现此目的。

2.3 在 Page Designer 中复制和粘贴 Faces 组件

当前,Page Designer 的剪切、复制和粘贴功能将只会产生 JSP 标记的准确副本并将它插入到当前光标位置处。使用 Faces 组件时这并非总有用,因为新标记通常被粘贴到现有控件内,即使这不是有效位置也是如此。对现在基本剪切和粘贴(Ctrl-x/Ctrl-c/Ctrl-v 或菜单操作)不能正确处理的标记嵌套和唯一标识有一些约束。为了避免在处理“设计”窗格中的控件时发生错误,使用鼠标来选择并拖动控件以移动它的位置。在拖动期间按下 Ctrl 键也可用来复制 Faces 控件并在放下位置处生成具有唯一标识的新标记。

2.4 添加 Faces 项目资源时的问题

当从选用板上将 Faces 组件拖动到 Web 项目中的一般 JSP 页上时,可能会提示您添加新的项目资源。不要对此提示响应“是”,而是应取消放下操作并手工添加 Faces 组件(在项目的“属性”配置中)的项目功能部件。在添加项目功能部件之后,重复放下选用板操作。

2.5 快速编辑视图打开时,将 JSF 组件标识与 Java 源文件同步时产生问题

当“快速编辑”视图打开并且在 Page Designer 中选择了 Faces 组件并使用“属性”视图来重命名组件的标识时,它将不会完全更新对 JSP 的相应 Java 源文件中该标识的所有引用。它将重命名在 Java 源文件中的任何位置出现的全部该标识,除了出现在“快速编辑”视图当前正编辑的方法中的标识之外。变通方法是在通过属性视图重命名 Faces 组件之前,关闭“快速编辑”视图。备用的变通方法是手工重命名在该方法中引用的组件标识。

3.0 已知问题

3.1 使用页面模板中的 JSF 控件时出错

当使用页面模板时,可能存在这样的情况:删除或移动 Faces 标记将导致标记位置不正确。要使页在运行时能够工作,“use_faces”标记必须包围页上的任何其它 Faces 标记。如果发现“use_faces”标记未包围任何其它 Faces 标记,则可以通过剪切“use_faces”并将它粘贴到包围所有其它 Faces 标记的适当位置来解决此问题。

返回到主自述文件