Qual é o uso de faces-config.xml no JSF 2?

89

Após o grande suporte do JSF 2 para anotações, estou me perguntando o que eu usaria faces-config.xmlpara. Qual é a sua importância agora?

Ou seja, quais são as configurações que só podem ser feitas por faces-config.xmlmeio de anotações e não por anotações?

No momento, tudo o que estou usando é para declarar o resolvedor EL do Spring.

<?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>
Mahmoud Saleh
fonte
1
Por que precisamos especificar o ELResolver integrado? Eu pensei que a filosofia de design é a convenção sobre a configuração ...
masterxilo
Eu também não tenho <el-resolver>no meu faces-config.xmle está funcionando perfeitamente.
Roland

Respostas:

142

Ainda deve ser usado para muitas coisas que não podem ser anotadas. Por exemplo, mensagens de validação JSF personalizadas:

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

Um pacote i18n global (para que você não precise declarar <f:loadBundle>em todas as visualizações):

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

Localidades i18n explicitamente suportadas (para que as não declaradas sejam ignoradas mesmo que haja um pacote de mensagens ou de recursos para elas):

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

Manipuladores de visualização personalizados :

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

Ouvintes de fase (ainda não há anotação para isso):

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

Beans gerenciados que não podem ser anotados (o abaixo fornece informações atuais Datesobre #{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>

Fábricas personalizados, como fábrica de manipulador de exceção personalizada (ele também permite que as fábricas para FacesContext, ExternalContext, LifeCyclee muitos mais para que você possa fornecer sua implementação personalizada):

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

Para citar apenas os comumente usados. Se você tiver o faces-config.xmlpreenchimento automático de tags em seu IDE, poderá descobrir todos eles. Apenas os beans gerenciados, validadores, conversores, componentes, renderizadores e casos de navegação ponto a ponto não são mais necessários, graças às novas anotações e navegação implícita.

BalusC
fonte
7
@Matt: Tive um projeto em que um java.util.HashMapas #{components}é armazenado no escopo da solicitação para ter uma visão geral declarativa melhor de todas as ligações de componentes. Por exemplo, binding="#{components.foo}"para que possa ser referido como o #{components.foo}que é mais autodocumentado e menos arriscado (devido a conflitos de nomes em potencial) do que binding="#{foo}"e #{foo}.
BalusC
2
Eu também estava procurando algumas anotações para especificar el-resolver. Agora eu acho que não há como especificar essas propriedades do aplicativo por meio de anotação .. certo .. ??
Rup Majumder
@RupMajumder Onde você deseja colocar essa anotação, quero dizer, em que classe? Esta propriedade está espalhada por todo o aplicativo.
iozee de
1
FWIW, ao usar o Apache Deltaspike, a anotação JsfPhaseListener pode ser usada para usar ouvintes de fase sem a necessidade de configurá-los em faces-config.xml.
jpangamarca