org.omnifaces.taghandler

Class Converter

java.lang.Object

javax.faces.view.facelets.TagHandler

javax.faces.view.facelets.MetaTagHandler

javax.faces.view.facelets.DelegatingMetaTagHandler

javax.faces.view.facelets.FaceletsAttachedObjectHandler

javax.faces.view.facelets.ConverterHandler

org.omnifaces.taghandler.Converter

All Implemented Interfaces:

AttachedObjectHandler, FaceletHandler, ValueHolderAttachedObjectHandler

public class Converter
extends ConverterHandler

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.

Author:

Bauke Scholtz

See Also:

DeferredTagHandlerHelper

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	Converter.DeferredConverter So that we can have a serializable converter.

Field Summary

Fields inherited from class javax.faces.view.facelets.DelegatingMetaTagHandler

delegateFactory

Fields inherited from class javax.faces.view.facelets.TagHandler

nextHandler, tag, tagId

Constructor Summary

Constructors

Constructor and Description
Converter(ConverterConfig config) The constructor.

Method Summary

Modifier and Type	Method and Description
void	apply(FaceletContext context, UIComponent parent) Create a Converter based on the binding and/or converterId attributes as per the standard JSF <f:converter> implementation and collect the render time attributes.
<T> T	create(Application application, String id) Create the concrete Converter or Validator.
TagAttribute	getTagAttribute(String name) Just return TagHandler#getAttribute() via a public method (it's by default protected and otherwise thus unavailable inside collectDeferredAttributes().
protected TagHandlerDelegate	getTagHandlerDelegate()
boolean	isDisabled(FaceletContext context)

Methods inherited from class javax.faces.view.facelets.ConverterHandler

getConverterId

Methods inherited from class javax.faces.view.facelets.FaceletsAttachedObjectHandler

applyAttachedObject, getAttachedObjectHandlerHelper, getFor

Methods inherited from class javax.faces.view.facelets.DelegatingMetaTagHandler

applyNextHandler, createMetaRuleset, getBinding, getTag, getTagId, setAttributes

Methods inherited from class javax.faces.view.facelets.TagHandler

getAttribute, getRequiredAttribute, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.faces.view.AttachedObjectHandler

applyAttachedObject, getFor

Constructor Detail

Converter

public Converter(ConverterConfig config)

The constructor.

Parameters:

config - The converter config.

Method Detail

apply

public void apply(FaceletContext context,
                  UIComponent parent)
           throws IOException

Create a Converter based on the binding and/or converterId attributes as per the standard JSF <f:converter> implementation and collect the render time attributes. Then create an anonymous Converter implementation which wraps the created Converter and delegates the methods to it after setting the render time attributes. Finally set the anonymous implementation on the parent component.

Specified by:

apply in interface FaceletHandler

Overrides:

apply in class DelegatingMetaTagHandler

Parameters:

context - The involved facelet context.

parent - The parent component to set the Converter on.

Throws:

IOException - If something fails at I/O level.

create

public <T> T create(Application application,
                    String id)

Create the concrete Converter or Validator.

Type Parameters:

T - The expected return type.

Parameters:

application - The involved faces application.

id - The converter or validator ID.

Returns:

The concrete Converter or Validator.

getTagAttribute

public TagAttribute getTagAttribute(String name)

Just return TagHandler#getAttribute() via a public method (it's by default protected and otherwise thus unavailable inside collectDeferredAttributes().

Overrides:

getTagAttribute in class DelegatingMetaTagHandler

Parameters:

name - The attribute name.

Returns:

The tag attribute associated with given attribute name.

getTagHandlerDelegate

protected TagHandlerDelegate getTagHandlerDelegate()

Overrides:

getTagHandlerDelegate in class ConverterHandler

isDisabled

public boolean isDisabled(FaceletContext context)

Overrides:

isDisabled in class DelegatingMetaTagHandler