JSF 2 中 faces-config.xml 的用途是啥？

Posted 2023-02-22

【中文标题】JSF 2 中 faces-config.xml 的用途是啥？

【英文标题】：What is the use of faces-config.xml in JSF 2?JSF 2 中 faces-config.xml 的用途是什么？

【发布时间】：2011-11-26 20:05:02

【问题描述】：

在 JSF 2 对注释的大力支持之后，我想知道我将使用 faces-config.xml 做什么。它现在的重要性是什么？

也就是说，有哪些配置只能通过faces-config.xml，不能通过注解？

现在我使用它的目的就是声明 Spring 的 EL 解析器。

<?xml version="1.0" encoding="UTF-8"?>
<faces-config
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
    http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd"
    version="2.0">

    <application>
        <el-resolver>
            org.springframework.web.jsf.el.SpringBeanFacesELResolver
        </el-resolver>
    </application> 
</faces-config>

【问题讨论】：

为什么我们需要指定内置的ELResolver？我认为设计理念是约定优于配置...

我的faces-config.xml 中也没有<el-resolver>，它运行良好。

【参考方案1】：

它仍然可以用于许多无法注释的事情。例如。自定义 JSF 验证消息：

<application>
    <message-bundle>com.example.i18n.messages</message-bundle>
</application>

一个全局 i18n 包（这样您就不需要在每个视图中声明 <f:loadBundle>）：

<application>
    <resource-bundle>
        <base-name>com.example.i18n.Text</base-name>
        <var>text</var>
    </resource-bundle>
</application>

明确支持 i18n 语言环境（因此即使有消息包或资源包，也将忽略未声明的语言环境）：

<application>
    <locale-config>
        <default-locale>en</default-locale>
        <supported-locale>nl</supported-locale>
        <supported-locale>es</supported-locale>         
        <supported-locale>de</supported-locale>         
    </locale-config>
</application>

自定义view handlers:

<application>
    <view-handler>com.example.SomeViewHandler</view-handler>
</application>

Phase listeners（仍然没有注释）：

<lifecycle>
    <phase-listener>com.example.SomePhaseListener</phase-listener>
</lifecycle>

无法注释的托管 bean（下面给出了#now 上的当前Date）：

<managed-bean>
    <description>Current date and time</description>
    <managed-bean-name>now</managed-bean-name>
    <managed-bean-class>java.util.Date</managed-bean-class>
    <managed-bean-scope>request</managed-bean-scope>
</managed-bean>

自定义工厂，例如自定义异常处理程序工厂（它还允许 FacesContext、ExternalContext、LifeCycle 等工厂，以便您提供自定义实现）：

<factory>
    <exception-handler-factory>com.example.SomeExceptionHandlerFactory</exception-handler-factory>
</factory>

只命名常用的。如果您的 IDE 中有 faces-config.xml 标签自动完成功能，您可以将它们全部找出来。由于新的注释和隐式导航，不再需要托管 bean、验证器、转换器、组件、渲染器和点对点导航案例。

【讨论】：

@Matt：我有一个项目，其中 java.util.HashMap as #components 存储在请求范围内，以便对所有组件绑定有更好的声明性概述。例如。 binding="#components.foo" 以便可以将其引用为 #components.foo，这比 binding="#foo" 和 #foo 更具自我记录性和风险（由于潜在的名称冲突）。

我还在寻找一些用于指定 el-resolver 的注释。现在我认为没有办法通过注释来指定这些应用程序属性..right..??

@RupMajumder 你想把这样的注释放在哪里，我的意思是在什么类上？该属性分布在整个应用程序中。

FWIW，使用 Apache Deltaspike 时，JsfPhaseListener 注解可用于使用相位监听器，无需在 faces-config.xml 中配置它们。