JavaServer Faces 配置方案是启用了 JSF 的 Web 应用程序的部署描述符。JSF 配置文件用于注册和配置对象以及定义 Web 应用程序中使用的导航规则。Faces 配置文件一般命名为 faces-config.xml 文件,通常在 Web 项目的 WEB-INF 文件夹中。
在 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,则您需要在部署描述符中指定这些文件的路径。