《JSF标签详解》.pdf

附录 D JSF 配置 大多数 Java Web 框架一样，JSF 应用配置是通过 XML 文件处理的，该文件通常称为 与faces-config.xml 。在这个文件中，你可以配置应用所支持的场所、受管 bean 、导航规 则以及替换可插入的 JSF 类。你还可以在此文件中配置 UI 扩展（组件、呈现器、验证器以及 转换器）和其他高级特征。所有这些东西都可以在代码中设置，虽然这样做通常只在动态场合下 才有用。 顺便 如果你不喜欢编辑XML文件，可以用工具来进行。有一个免费的配置文件编辑器叫做Faces 说说 Console IDE Exadel ，它可以插入到许多流行的 之中，也可以作为单独的程序运行。 也提供 Eclipse plugin JSF Studio 了一个可以作为 的 产品，可以简化配置、导航和其他内容的编辑。 此外，大多数IDE也对配置的某些部分甚至全部方面提供了可视化编辑器。JSF Central 社 JSF 区站点维护着一个 工具的产品目录。 JSF 可以支持多个配置文件。默认情况下，它会查找文件名为 WEB-INF/faces-config.xml 的 文件，并且这里实际上也是放置大部分应用配置的地方。还可以通过 javax.faces.CONFIG_ FILESS 上下文参数指定额外的配置文件，这个参数在想要将你的配置进行分割以便易于维护时 是很有用的。例如，两个不同的团队可能工作于具有不同配置文件的不同模块。JSF 也要在 JAR 文件（或者其他任何资源路径）中搜索名为 META-INF/faces-config.xml 的配置文件；这将允许 你或者第三方能够创建组件、呈现器、验证器、转换器的库，并且它们可以被你的应用自动注册。 所有应用配置文件都必须引用 JSF 配置的文档类型定义（DTD ）： （如果你使用的是JSF 1.0 ，URI 将是“/dtd/Web-facesconfig_1_0.dtd ”）。图D-1 解释了配置文件的基本结构。 下面的小节详细解释了 DTD 的每个元素。关于总体介绍和例子以及有关通过Web.xml 进行 应用配置的信息，见第 3 章。注意，许多元素都是可选的，特别是对 UI 扩展而言。通常，可选 元素用于 IDE 集成。 附录 D JSF 配置 713 图D-1 JSF 配置文件的基本结构 D.1 公共属性 JSF 配置元素并没有很多属性。事实上，只有两个（见表 D-1 ），它们都用在多个不同的元 素中。 表D-1 通用属性 属性名称 必需? 说 明 支持元素 id 否 元素唯一的标识符。这是一个 XML 标识符（ ID 类型）， 所有元素 并且不应该与 JSF 标识符混淆 xml:lang 否 本元素内容的场所字符串。场所字符串由语言代码、国家（地 icon, 区）代码（可选）以及一个变体（可选）所组成，中间以下划 description, 线（“_ ”）或者连字符（“- ”）分隔。例如美国英语是“en_US ” display-name