JavaServer Faces 配置方案

JavaServer Faces 配置方案是启用了 JSF 的 Web 应用程序的部署描述符。JSF 配置文件用于注册和配置对象以及定义 Web 应用程序中使用的导航规则。Faces 配置文件一般命名为 faces-config.xml 文件,通常在 Web 项目的 WEB-INF 文件夹中。

该配置文件必须符合 JavaServer Faces 应用程序配置文件的 XML 模式。该文件必须包含 XML 版本号、DOCTYPE 声明以及用于包含所有其他声明的 <faces-config> 标记。

JSF 配置文件的示例。

在 JSF 配置文件中,您可以注册在 Web 应用程序中使用的 JavaBeans™,指定导航规则,注册定制组件,注册转换器以及注册验证器。

该文件的根元素是 <faces-config> 标记。您注册的每个 JavaBean 都具有一个包含在根元素中的 <managed-Bean> 标记。<managed-bean> 元素具有三个子元素:
  • <managed-bean-name> - 此标记定义 JavaBean 的名称。
  • <managed-bean-class> - 此标记指定 JavaBean 类。
  • <managed-bean-scope> - 此标记定义 JavaBean 的作用域。
导航规则在 <navigation-rule> 元素中定义。此元素包含子元素。
  • <from-view-id> - 此标记定义规则。
  • <navigation-case> - 此标记定义使此事例执行所必须存在的条件。
  • <from-outcome> - 此标记包含应用程序操作方法的执行所返回的逻辑结果字符串。
  • <to-view-id> - 此标记包含在此导航规则匹配时应显示的下一视图的标识。

Web 应用程序可以包含多个应用程序配置资源文件。如果这些文件不在缺省目录 WEB-INF 中和/或没有命名为 faces-config.xml,则您需要在部署描述符中指定这些文件的路径。


反馈