public class ValidateUniqueColumn extends TagHandler implements ValueChangeListener
UIInput component in an UIData component
has an unique value throughout all rows, also those not visible by pagination. This validator works directly on the
data model and may therefore not work as expected if the data model does not represent all available
rows of the UIData component (e.g. when there's means of lazy loading).
The default message is
{0}: Please fill out an unique value for the entire column. Duplicate found in row {1}
Usage example:
<h:dataTable value="#{bean.items}" var="item">
<h:column>
<h:inputText value="#{item.value}">
<o:validateUniqueColumn />
</h:inputText>
</h:column>
</h:dataTable>
In an invalidating case, only the first row on which the value is actually changed (i.e. the value change event has
been fired on the input component in the particular row) will be marked invalid and a faces message will be added
on the client ID of the input component in the particular row. The default message can be changed by the
message attribute. Any "{0}" placeholder in the message will be substituted with the label of the
input component. Any "{1}" placeholder in the message will be substituted with the 1-based row index of the data
model. Note that this does not take pagination into account and that this needs if necessary to be taken care of in
the custom message yourself.
<o:validateUniqueColumn message="Duplicate value!" />
nextHandler, tag, tagId| Constructor and Description |
|---|
ValidateUniqueColumn(TagConfig config)
The tag constructor.
|
| Modifier and Type | Method and Description |
|---|---|
void |
apply(FaceletContext context,
UIComponent parent)
If the component is new, check if it's an instance of
UIInput and then register this tag as a value
change listener on it. |
String |
getMessage()
Returns the runtime evaluated value of the message attribute.
|
boolean |
isDisabled()
Returns the runtime evaluated value of the disabled attribute.
|
void |
processValueChange(ValueChangeEvent event)
When this tag is not disabled, the input value is changed, the input component is valid and the input component's
local value is not null, then check for a duplicate value by visiting all rows of the parent
UIData
component. |
getAttribute, getRequiredAttribute, toStringpublic ValidateUniqueColumn(TagConfig config)
config - The tag config.public void apply(FaceletContext context, UIComponent parent) throws IOException
UIInput and then register this tag as a value
change listener on it. If the component is not new, check if there's an UIData parent.apply in interface FaceletHandlerIOExceptionpublic void processValueChange(ValueChangeEvent event) throws AbortProcessingException
UIData
component.processValueChange in interface ValueChangeListenerAbortProcessingExceptionpublic String getMessage()
public boolean isDisabled()