在JSF 2中使用faces-config.xml有什么用?

时间:2011-09-28 12:13:16

标签: jsf jsf-2 faces-config

在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>

1 个答案:

答案 0 :(得分:138)

它还可用于许多无法注释的事物。例如。自定义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(以下代码在Date上显示当前#{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>

自定义工厂,例如自定义异常处理程序工厂(它还允许工厂FacesContextExternalContextLifeCycle等等,以便您可以提供自定义实现):

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

仅列出常用的名称。如果您的IDE中有faces-config.xml标记自动完成,您可以全部找到它们。由于新的注释和隐式导航,不再需要托管bean,验证器,转换器,组件,渲染器和点对点导航案例。