- cdi
- components
- contexts
- converters
- el
- eventlisteners
- exceptionhandlers
- facesviews
- filters
- functions
- managedbeans
- push
- resourcehandlers
- search
- servlets
- taghandlers
- utils
- validators
- viewhandlers
- - converter
- enableRestorableView
- ignoreValidationFailed
- importConstants
- importFunctions
- massAttribute
- methodParam
- skipValidators
- tagAttribute
- validator
- viewParamValidationFailed
- cdi
- components
- contexts
- converters
- el
- eventlisteners
- exceptionhandlers
- facesviews
- filters
- functions
- managedbeans
- push
- resourcehandlers
- search
- servlets
- taghandlers
- utils
- validators
- viewhandlers
- converter
- enableRestorableView
- ignoreValidationFailed
- importConstants
- importFunctions
- massAttribute
- methodParam
- skipValidators
- tagAttribute
- validator
- viewParamValidationFailed
The <o:converter>
is a taghandler that extends the standard <f:converter>
tag family with support for deferred value expressions in all attributes. In other words, the converter attributes are not evaluated anymore on a per view build time basis, but just on every access like as with UI components and bean properties. This has among others the advantage that they can be evaluated on a per-iteration basis inside an iterating component, and that they can be set on a custom converter without needing to explicitly register it in a tagfile.
Usage
When you specify for example the standard <f:convertDateTime>
by converterId="javax.faces.DateTime"
, then you'll be able to use all its attributes such as pattern
and locale
as per its documentation, but then with the possibility to supply deferred value expressions.
<o:converter converterId="javax.faces.DateTime" pattern="#{item.pattern}" locale="#{item.locale}" />
The converter ID of all standard JSF converters can be found in their javadocs. First go to the javadoc of the class of interest, then go to CONVERTER_ID
in its field summary and finally click the Constant Field Values link to see the value.
JSF 2.3 compatibility
The <o:converter>
is currently not compatible with converters which are managed via JSF 2.3's new managed=true
attribute set on the FacesConverter
annotation, at least not when using Mojarra. Internally, the converters are wrapped in another instance which doesn't have the needed setter methods specified. In order to get them to work with <o:converter>
, the managed=true
attribute needs to be removed, so that OmniFaces ConverterManager
will automatically manage them.
Demo
In the below demo, it was the intent to use <f:convertDateTime>
as follows:
<f:convertDateTime type="both" dateStyle="full" timeStyle="full" locale="#{locale}" />
But this wouldn't even run, it will throw the following exception because the #{locale}
isn't
available during view build time (for a background explanation, check
this Stack Overflow answer).
javax.faces.view.facelets.TagAttributeException: /taghandlers/converter @62,92 locale="" Attribute did not evaluate to a String or Locale: null at com.sun.faces.facelets.tag.jsf.ComponentSupport.getLocale(ComponentSupport.java:297) at com.sun.faces.facelets.tag.jsf.core.ConvertDateTimeHandler.setAttributes(ConvertDateTimeHandler.java:127) at com.sun.faces.facelets.tag.jsf.ConverterTagHandlerDelegateImpl.applyAttachedObject(ConverterTagHandlerDelegateImpl.java:130)
It works as intuitively expected with the <o:converter>
as it allows a render time evaluation of attributes.
For another related use case, checkout the
<o:validator>
showcase page.
Language | Full date time pattern |
---|---|
English | Sunday, January 17, 2021 at 3:29:07 AM Greenwich Mean Time |
Spanish | domingo, 17 de enero de 2021, 3:29:07 (hora del meridiano de Greenwich) |
French | dimanche 17 janvier 2021 à 03:29:07 heure moyenne de Greenwich |
German | Sonntag, 17. Januar 2021 um 03:29:07 Mittlere Greenwich-Zeit |
Dutch | zondag 17 januari 2021 om 03:29:07 Greenwich Mean Time |
Arabic | الأحد، ١٧ يناير ٢٠٢١ ٣:٢٩:٠٧ ص توقيت غرينتش |
Hebrew | יום ראשון, 17 בינואר 2021 בשעה 3:29:07 שעון גריניץ׳ |
Chinese | 2021年1月17日星期日 格林尼治标准时间 上午3:29:07 |
<h:dataTable value="#{converterBean.locales}" var="locale">
<h:column>
<f:facet name="header">Language</f:facet>
#{locale.displayLanguage}
</h:column>
<h:column>
<f:facet name="header">Full date time pattern</f:facet>
<h:outputText value="#{now}">
<o:converter converterId="javax.faces.DateTime" type="both" dateStyle="full" timeStyle="full" locale="#{locale}" />
</h:outputText>
</h:column>
</h:dataTable>
package org.omnifaces.showcase.taghandlers;
import java.util.ArrayList;
import java.util.List;
import java.util.Locale;
import javax.annotation.PostConstruct;
import javax.enterprise.context.RequestScoped;
import javax.inject.Named;
@Named
@RequestScoped
public class ConverterBean {
private List<Locale> locales;
@PostConstruct
public void init() {
locales = new ArrayList<>();
for (String language : new String[] { "en", "es", "fr", "de", "nl", "ar", "he", "zh" }) {
locales.add(new Locale(language));
}
}
public List<Locale> getLocales() {
return locales;
}
}