org.nuxeo.ecm.platform.forms.layout.facelets

Class FaceletHandlerHelper

java.lang.Object

org.nuxeo.ecm.platform.forms.layout.facelets.FaceletHandlerHelper

public final class FaceletHandlerHelper
extends Object

Helpers for layout/widget handlers.

Helps generating custom tag handlers and custom tag attributes.

Author:

Anahide Tchertchian

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEV_CONTAINER_ID_SUFFIX
static String	DEV_MODE_DISABLED_VARIABLE
static String	DEV_REGION_ID_SUFFIX
static String	DIR_AUTO
static String	DIR_PROPERTY
static String	LAYOUT_ID_PREFIX
static String	MESSAGE_ID_SUFFIX
static String	WIDGET_ID_PREFIX

Constructor Summary

Constructors

Constructor and Description
FaceletHandlerHelper(javax.faces.view.facelets.TagConfig tagConfig)

Method Summary

Modifier and Type	Method and Description
static javax.faces.view.facelets.TagAttributes	addTagAttribute(javax.faces.view.facelets.TagAttributes orig, javax.faces.view.facelets.TagAttribute newAttr)
javax.faces.view.facelets.TagAttributes	copyTagAttributes(javax.faces.view.facelets.FaceletContext context, String id, String... names) Copies tag attributes with given names from the tag config, using given id as base for the id attribute.
javax.faces.view.facelets.TagAttribute	createAttribute(String name, String value) Creates an attribute with given name and value.
javax.faces.view.facelets.TagAttribute	createIdAttribute(javax.faces.view.facelets.FaceletContext context, String base) Creates a unique id and returns corresponding attribute, using given string id as base.
static String	generateDevContainerId(javax.faces.view.facelets.FaceletContext context, String widgetName)
static String	generateDevRegionId(javax.faces.view.facelets.FaceletContext context, String widgetName)
static String	generateLayoutId(javax.faces.view.facelets.FaceletContext context, String layoutName)
static String	generateMessageId(javax.faces.view.facelets.FaceletContext context, String widgetName)
String	generateUniqueId(javax.faces.view.facelets.FaceletContext context) Returns a id unique within the facelet context.
static String	generateUniqueId(javax.faces.view.facelets.FaceletContext context, String base) Returns a id unique within the facelet context using given id as base.
static String	generateUniqueId(javax.faces.context.FacesContext faces, String base) Returns a id unique within the faces context using given id as base.
protected static String	generateValidIdString(String base)
static String	generateWidgetId(javax.faces.view.facelets.FaceletContext context, String widgetName)
javax.faces.view.facelets.FaceletHandler	getAliasFaceletHandler(String tagConfigId, Map<String,javax.el.ValueExpression> variables, List<String> blockedPatterns, javax.faces.view.facelets.FaceletHandler nextHandler)
javax.faces.view.facelets.TagHandler	getAliasTagHandler(String tagConfigId, Map<String,javax.el.ValueExpression> variables, List<String> blockedPatterns, javax.faces.view.facelets.TagHandler nextHandler)
protected javax.faces.view.facelets.TagHandler	getBareAliasTagHandler(String tagConfigId, Map<String,javax.el.ValueExpression> variables, List<String> blockedPatterns, javax.faces.view.facelets.FaceletHandler nextHandler)
javax.faces.view.facelets.ConverterHandler	getConvertHandler(String tagConfigId, javax.faces.view.facelets.TagAttributes attributes, javax.faces.view.facelets.FaceletHandler nextHandler, String converterId) Returns a convert handler for this configuration.
javax.faces.view.facelets.FaceletHandler	getDisableDevModeTagHandler(String tagConfigId, javax.faces.view.facelets.FaceletHandler nextHandler)
javax.faces.view.facelets.ComponentHandler	getErrorComponentHandler(String tagConfigId, String errorMessage) Component handler that displays an error on interface
javax.faces.view.facelets.ComponentHandler	getHtmlComponentHandler(String tagConfigId, javax.faces.view.facelets.TagAttributes attributes, javax.faces.view.facelets.FaceletHandler nextHandler, String componentType, String rendererType) Returns an html component handler for this configuration.
javax.faces.view.facelets.ComponentHandler	getMessageComponentHandler(String tagConfigId, String id, String forId, String styleClass) Returns a message component handler with given attributes.
Map<String,Serializable>	getSelectOptionProperties(WidgetSelectOption selectOption)
static javax.faces.view.facelets.TagAttributes	getTagAttributes(List<javax.faces.view.facelets.TagAttribute> attributes)
List<javax.faces.view.facelets.TagAttribute>	getTagAttributes(Map<String,Serializable> properties, List<String> excludedProperties, boolean useReferenceProperties, String widgetType, String widgetTypeCategory, String widgetMode)
javax.faces.view.facelets.TagAttributes	getTagAttributes(String id, Widget widget) Creates tag attributes using given widget properties and field definitions.
static javax.faces.view.facelets.TagAttributes	getTagAttributes(javax.faces.view.facelets.TagAttribute... attributes)
javax.faces.view.facelets.TagAttributes	getTagAttributes(Widget widget)
javax.faces.view.facelets.TagAttributes	getTagAttributes(Widget widget, List<String> excludedProperties, boolean bindFirstFieldDefinition)
javax.faces.view.facelets.TagAttributes	getTagAttributes(Widget widget, List<String> excludedProperties, boolean bindFirstFieldDefinition, boolean defaultToValue) Return tag attributes for this widget, including value mapping from field definitions and properties
javax.faces.view.facelets.TagAttributes	getTagAttributes(WidgetSelectOption selectOption)
javax.faces.view.facelets.TagAttributes	getTagAttributes(WidgetSelectOption selectOption, Map<String,Serializable> additionalProps)
javax.faces.view.facelets.ValidatorHandler	getValidateHandler(String tagConfigId, javax.faces.view.facelets.TagAttributes attributes, javax.faces.view.facelets.FaceletHandler nextHandler, String validatorId) Returns a validate handler for this configuration.
static boolean	isAliasOptimEnabled()
static boolean	isDevModeEnabled(javax.faces.view.facelets.FaceletContext ctx)
protected static NuxeoLayoutManagerBean	lookupBean(javax.faces.context.FacesContext ctx)
protected static NuxeoLayoutIdManagerBean	lookupIdBean(javax.faces.context.FacesContext ctx)
boolean	shouldCreateReferenceAttribute(String key, Serializable value) Returns true if a reference tag attribute should be created for given property value.
protected static String	stripUniqueIdBase(String base) Strips given base of any ending counter that would conflict with potential already generated unique ids

Methods inherited from class java.lang.Object

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

Field Detail

LAYOUT_ID_PREFIX

public static final String LAYOUT_ID_PREFIX

See Also:

Constant Field Values

WIDGET_ID_PREFIX

public static final String WIDGET_ID_PREFIX

See Also:

Constant Field Values

MESSAGE_ID_SUFFIX

public static final String MESSAGE_ID_SUFFIX

See Also:

Constant Field Values

DEV_CONTAINER_ID_SUFFIX

public static final String DEV_CONTAINER_ID_SUFFIX

Since:

6.0

See Also:

Constant Field Values

DEV_REGION_ID_SUFFIX

public static final String DEV_REGION_ID_SUFFIX

Since:

6.0

See Also:

Constant Field Values

DEV_MODE_DISABLED_VARIABLE

public static String DEV_MODE_DISABLED_VARIABLE

Since:

6.0

DIR_PROPERTY

public static final String DIR_PROPERTY

Since:

5.7

See Also:

Constant Field Values

DIR_AUTO

public static final String DIR_AUTO

Since:

5.7

See Also:

Constant Field Values

Constructor Detail

FaceletHandlerHelper

public FaceletHandlerHelper(javax.faces.view.facelets.TagConfig tagConfig)

Method Detail

generateUniqueId

public String generateUniqueId(javax.faces.view.facelets.FaceletContext context)

Returns a id unique within the facelet context.

generateUniqueId

public static String generateUniqueId(javax.faces.view.facelets.FaceletContext context,
                                      String base)

Returns a id unique within the facelet context using given id as base.

generateUniqueId

public static String generateUniqueId(javax.faces.context.FacesContext faces,
                                      String base)

Returns a id unique within the faces context using given id as base.

Since:

8.1

lookupIdBean

protected static NuxeoLayoutIdManagerBean lookupIdBean(javax.faces.context.FacesContext ctx)

stripUniqueIdBase

protected static String stripUniqueIdBase(String base)

Strips given base of any ending counter that would conflict with potential already generated unique ids

Since:

5.7

generateValidIdString

protected static String generateValidIdString(String base)

Throws:

IllegalArgumentException - if the given string is null or empty.

generateWidgetId

public static String generateWidgetId(javax.faces.view.facelets.FaceletContext context,
                                      String widgetName)

generateLayoutId

public static String generateLayoutId(javax.faces.view.facelets.FaceletContext context,
                                      String layoutName)

generateMessageId

public static String generateMessageId(javax.faces.view.facelets.FaceletContext context,
                                       String widgetName)

generateDevRegionId

public static String generateDevRegionId(javax.faces.view.facelets.FaceletContext context,
                                         String widgetName)

Since:

6.0

generateDevContainerId

public static String generateDevContainerId(javax.faces.view.facelets.FaceletContext context,
                                            String widgetName)

Since:

6.0

createIdAttribute

public javax.faces.view.facelets.TagAttribute createIdAttribute(javax.faces.view.facelets.FaceletContext context,
                                                                String base)

Creates a unique id and returns corresponding attribute, using given string id as base.

createAttribute

public javax.faces.view.facelets.TagAttribute createAttribute(String name,
                                                              String value)

Creates an attribute with given name and value.

The attribute namespace is assumed to be empty.

shouldCreateReferenceAttribute

public boolean shouldCreateReferenceAttribute(String key,
                                              Serializable value)

Returns true if a reference tag attribute should be created for given property value.

Reference tag attributes are using a non-literal EL expression so that this property value is not kept (cached) in the component on ajax refresh.

Of course property values already representing an expression cannot be mapped as is because they would need to be resolved twice.

Converters and validators cannot be referenced either because components expect corresponding value expressions to resolve to a Converter or Validator instance (instead of the converter of validator id).

getTagAttributes

public static javax.faces.view.facelets.TagAttributes getTagAttributes(javax.faces.view.facelets.TagAttribute... attributes)

getTagAttributes

public static javax.faces.view.facelets.TagAttributes getTagAttributes(List<javax.faces.view.facelets.TagAttribute> attributes)

addTagAttribute

public static javax.faces.view.facelets.TagAttributes addTagAttribute(javax.faces.view.facelets.TagAttributes orig,
                                                                      javax.faces.view.facelets.TagAttribute newAttr)

copyTagAttributes

public javax.faces.view.facelets.TagAttributes copyTagAttributes(javax.faces.view.facelets.FaceletContext context,
                                                                 String id,
                                                                 String... names)

Copies tag attributes with given names from the tag config, using given id as base for the id attribute.

getTagAttributes

public javax.faces.view.facelets.TagAttributes getTagAttributes(String id,
                                                                Widget widget)

Creates tag attributes using given widget properties and field definitions.

Assumes the "value" attribute has to be computed from the first field definition, using the "value" expression (see widget type tag handler exposed values).

getTagAttributes

public javax.faces.view.facelets.TagAttributes getTagAttributes(Widget widget)

getTagAttributes

public javax.faces.view.facelets.TagAttributes getTagAttributes(Widget widget,
                                                                List<String> excludedProperties,
                                                                boolean bindFirstFieldDefinition)

Since:

5.5

getTagAttributes

public javax.faces.view.facelets.TagAttributes getTagAttributes(Widget widget,
                                                                List<String> excludedProperties,
                                                                boolean bindFirstFieldDefinition,
                                                                boolean defaultToValue)

Return tag attributes for this widget, including value mapping from field definitions and properties

Parameters:

widget - the widget to generate tag attributes for

excludedProperties - the properties to exclude from tag attributes

bindFirstFieldDefinition - if true, the first field definition will be bound to the tag attribute named "value"

defaultToValue - if true, and there are no field definitions, tag attribute named "value" will be mapped to the current widget value name (e.g the layout value in most cases, or the parent widget value if widget is a sub widget)

Since:

5.6

getTagAttributes

public List<javax.faces.view.facelets.TagAttribute> getTagAttributes(Map<String,Serializable> properties,
                                                                     List<String> excludedProperties,
                                                                     boolean useReferenceProperties,
                                                                     String widgetType,
                                                                     String widgetTypeCategory,
                                                                     String widgetMode)

Since:

5.5, signature changed on 5.6 to include parameters widgetType and widgetMode.

getTagAttributes

public javax.faces.view.facelets.TagAttributes getTagAttributes(WidgetSelectOption selectOption,
                                                                Map<String,Serializable> additionalProps)

Since:

6.0

getTagAttributes

public javax.faces.view.facelets.TagAttributes getTagAttributes(WidgetSelectOption selectOption)

getSelectOptionProperties

public Map<String,Serializable> getSelectOptionProperties(WidgetSelectOption selectOption)

getHtmlComponentHandler

public javax.faces.view.facelets.ComponentHandler getHtmlComponentHandler(String tagConfigId,
                                                                          javax.faces.view.facelets.TagAttributes attributes,
                                                                          javax.faces.view.facelets.FaceletHandler nextHandler,
                                                                          String componentType,
                                                                          String rendererType)

Returns an html component handler for this configuration.

Next handler cannot be null, use LeafFaceletHandler if no next handler is needed.

getErrorComponentHandler

public javax.faces.view.facelets.ComponentHandler getErrorComponentHandler(String tagConfigId,
                                                                           String errorMessage)

Component handler that displays an error on interface

getConvertHandler

public javax.faces.view.facelets.ConverterHandler getConvertHandler(String tagConfigId,
                                                                    javax.faces.view.facelets.TagAttributes attributes,
                                                                    javax.faces.view.facelets.FaceletHandler nextHandler,
                                                                    String converterId)

Returns a convert handler for this configuration.

Next handler cannot be null, use LeafFaceletHandler if no next handler is needed.

getValidateHandler

public javax.faces.view.facelets.ValidatorHandler getValidateHandler(String tagConfigId,
                                                                     javax.faces.view.facelets.TagAttributes attributes,
                                                                     javax.faces.view.facelets.FaceletHandler nextHandler,
                                                                     String validatorId)

Returns a validate handler for this configuration.

Next handler cannot be null, use LeafFaceletHandler if no next handler is needed.

getMessageComponentHandler

public javax.faces.view.facelets.ComponentHandler getMessageComponentHandler(String tagConfigId,
                                                                             String id,
                                                                             String forId,
                                                                             String styleClass)

Returns a message component handler with given attributes.

Uses component type "javax.faces.HtmlMessage" and renderer type "javax.faces.Message".

getAliasFaceletHandler

public javax.faces.view.facelets.FaceletHandler getAliasFaceletHandler(String tagConfigId,
                                                                       Map<String,javax.el.ValueExpression> variables,
                                                                       List<String> blockedPatterns,
                                                                       javax.faces.view.facelets.FaceletHandler nextHandler)

Since:

5.6

getAliasTagHandler

public javax.faces.view.facelets.TagHandler getAliasTagHandler(String tagConfigId,
                                                               Map<String,javax.el.ValueExpression> variables,
                                                               List<String> blockedPatterns,
                                                               javax.faces.view.facelets.TagHandler nextHandler)

Since:

8.1

getBareAliasTagHandler

protected javax.faces.view.facelets.TagHandler getBareAliasTagHandler(String tagConfigId,
                                                                      Map<String,javax.el.ValueExpression> variables,
                                                                      List<String> blockedPatterns,
                                                                      javax.faces.view.facelets.FaceletHandler nextHandler)

isDevModeEnabled

public static boolean isDevModeEnabled(javax.faces.view.facelets.FaceletContext ctx)

Since:

6.0

lookupBean

protected static NuxeoLayoutManagerBean lookupBean(javax.faces.context.FacesContext ctx)

getDisableDevModeTagHandler

public javax.faces.view.facelets.FaceletHandler getDisableDevModeTagHandler(String tagConfigId,
                                                                            javax.faces.view.facelets.FaceletHandler nextHandler)

Since:

6.0

isAliasOptimEnabled

public static boolean isAliasOptimEnabled()

Since:

8.2