Module org.omnifaces

Package org.omnifaces.taghandler

Class SkipValidators

java.lang.Object

jakarta.faces.view.facelets.TagHandler

org.omnifaces.taghandler.SkipValidators

All Implemented Interfaces:

FaceletHandler

public class SkipValidators
extends TagHandler

The <o:skipValidators> taghandler allows the developer to entirely skip validation when executing an UICommand or ClientBehaviorHolder action. This taghandler must be placed inside an UICommand or ClientBehaviorHolder component (client behavior holder components are those components supporting <f:ajax>).

Usage

For example, when adding a new row to the data table, you'd like to not immediately validate all empty rows.

 <h:form>
     <h:dataTable value="#{bean.items}" var="item">
         <h:column>
             <h:inputText value="#{item.value}" required="true" />
         </h:column>
     </h:dataTable>
     <h:commandButton value="add new row" action="#{bean.add}">
         <o:skipValidators />
     </h:commandButton>
     <h:commandButton value="save all data" action="#{bean.save}" />
     <h:messages />
 </h:form>
 

Note that converters will still run and that model values will still be updated. This behavior is by design.

Since:

2.3

Author:

Michele Mariotti, Bauke Scholtz

Field Summary

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

nextHandler, tag, tagId

Constructor Summary

Constructors

Constructor	Description
SkipValidators(TagConfig config)	The tag constructor.

Method Summary

Modifier and Type	Method	Description
void	apply(FaceletContext context, UIComponent parent)	If the parent component is an instance of UICommand or ClientBehaviorHolder, and is new, and we're in the restore view phase of a postback, then delegate to processSkipValidators(UIComponent).
protected void	processSkipValidators(UIComponent parent)	Check if the given component has been invoked during the current request and if so, then register the skip validators event listener which removes the validators during PreValidateEvent and restores them during PostValidateEvent.

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

getAttribute, getRequiredAttribute, toString

Methods inherited from class java.lang.Object

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

Constructor Details

SkipValidators

public SkipValidators(TagConfig config)

The tag constructor.

Parameters:

config - The tag config.

Method Details

apply

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

If the parent component is an instance of UICommand or ClientBehaviorHolder, and is new, and we're in the restore view phase of a postback, then delegate to processSkipValidators(UIComponent).

Throws:

IllegalStateException - When the parent component is not an instance of UICommand or ClientBehaviorHolder.

IOException

processSkipValidators

protected void processSkipValidators(UIComponent parent)

Check if the given component has been invoked during the current request and if so, then register the skip validators event listener which removes the validators during PreValidateEvent and restores them during PostValidateEvent.

Parameters:

parent - The parent component of this tag.