What is the use of faces-config.xml in JSF 2?

JsfJsf 2Faces Config

Jsf Problem Overview


After the JSF 2 big support for annotations, I'm wondering what I would use the faces-config.xml for. What is its importance now?

In other words, what are the configurations that can only be done through faces-config.xml and not via annotations?

Right now all what I am using it for is to declare Spring's EL resolver.

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

Jsf Solutions


Solution 1 - Jsf

It's still to be used for many things which can't be annotated. E.g. custom JSF validation messages:

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

A global i18n bundle (so that you don't need to declare <f:loadBundle> in every view):

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

Explicitly supported i18n locales (so that the not-declared ones will be ignored even though there's a message bundle or resource bundle for it):

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

Custom view handlers:

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

Phase listeners (there's still no annotation for that):

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

Managed beans which can't be annotated (the below one gives current Date on #{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>

Custom factories, such as custom exception handler factory (it also allows factories for FacesContext, ExternalContext, LifeCycle and many more so that you can provide your custom implementation):

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

To name only the commonly used ones. If you have faces-config.xml tag autocompletion in your IDE, you can find them all out. Only the managed beans, validators, converters, components, renderers and point-to-point navigation cases are not needed anymore thanks to the new annotations and implicit navigation.

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionMahmoud SalehView Question on Stackoverflow
Solution 1 - JsfBalusCView Answer on Stackoverflow