在JSF 2中,faces-config.xml的用途是什么?


89

在JSF 2对注释的大力支持之后,我想知道我将把faces-config.xmlfor用于什么。现在它的重要性是什么?

换句话说,只能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>

1
为什么我们需要指定内置的ELResolver?我认为设计理念是惯例而非配置...
masterxilo

我也没有<el-resolver>在我的faces-config.xml,它是可以正常使用。
罗兰

Answers:


142

它仍然可以用于许多无法注释的东西。例如自定义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>

自定义视图处理程序

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

阶段侦听器(尚无此注释):

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

不能注释的托管bean(下面的一个提供了Dateon的当前信息#{now}):

<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,以便您可以提供自定义实现):ExternalContextLifeCycle

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

仅列出常用的。如果您faces-config.xml的IDE中具有标签自动补全功能,则可以全部找到它们。由于有了新的注释和隐式导航,因此不再需要托管的Bean,验证器,转换器,组件,渲染器和点对点导航用例。


7
@Matt:我有一个项目,其中java.util.HashMapas #{components}被存储在请求范围内,以更好地说明所有组件绑定。例如,binding="#{components.foo}"以便它可以被引用为#{components.foo}这是更自我记录和小于风险(由于潜在的名称冲突)binding="#{foo}"#{foo}
BalusC

2
我也在寻找一些用于指定el-resolver的注释。现在我认为没有办法通过注解来指定这些应用程序属性。
Rup Majumder 2013年

@RupMajumder您想在哪里放置这样的注释,我的意思是在什么课上?此属性分布在整个应用程序上。
iozee 2014年

1
FWIW,当使用Apache Deltaspike时,JsfPhaseListener批注可用于使用阶段侦听器,而无需在faces-config.xml中进行配置。
jpangamarca
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.