My JSF Books/Videos My JSF Tutorials OmniFaces/JSF PPTs
JSF 2.3 Tutorial
JSF Caching Tutorial
JSF Navigation Tutorial
JSF Scopes Tutorial
JSF Page Author Beginner's Guide
OmniFaces 2.3 Tutorial Examples
OmniFaces 2.2 Tutorial Examples
JSF Events Tutorial
OmniFaces Callbacks Usages
JSF State Tutorial
JSF and Design Patterns
JSF 2.3 New Features (2.3-m04)
Introduction to OmniFaces
25+ Reasons to use OmniFaces in JSF
OmniFaces Validators
OmniFaces Converters
JSF Design Patterns
Mastering OmniFaces
Reusable and less-verbose JSF code

My JSF Resources ...

Java EE Guardian
Member of JCG Program
Member MVB DZone
Blog curated on ZEEF
OmniFaces is an utility library for JSF, including PrimeFaces, RichFaces, ICEfaces ...

[OmniFaces Utilities] - Find the right JSF OmniFaces 2 utilities methods/functions

Search on blog

Petition by Java EE Guardians


miercuri, 9 decembrie 2015

JSF 2.3 Class-level bean validation on CDI based backing beans

JSF 2.3 will come with a new tag named, <f:validateWholeBean/>. As its name suggest, this tag enables class level validation. This tag contains two important attributes:

·         value - A ValueExpression referencing the bean to be validated.
·         validationGroups -  A comma-separated list of validation groups. A validation group is a fully-qualified class name.

This feature causes a temporary copy of the bean referenced by the value attribute.

Here is a brief example to ensure that the provided name and e-mail fields (contacts) are individually valid and also the e-mail start with that name (e.g. valid: nick,


import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;

public class ContactValidator implements ConstraintValidator<ValidContact, ContactBean> {
 public void initialize(ValidContact constraintAnnotation) {
  // NOOP
 public boolean isValid(ContactBean value, ConstraintValidatorContext context) {
  return value.getEmail().startsWith(value.getName());


import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import javax.validation.Constraint;
import javax.validation.Payload;

@Constraint(validatedBy = {ContactValidator.class})
public @interface ValidContact {

 String message() default "Invalid contacts (e-mail should start with name) !";
 Class<?>[] groups() default {};
 Class<? extends Payload>[] payload() default {};


@ValidContact(groups = validateBean.ContactGroup.class)
public class ContactBean implements Serializable, Cloneable {

 private static final long serialVersionUID = 1L;

 @Size(min = 3, max = 20, message = "Please enter a valid name (between 3-20 characters)!",
       groups = validateBean.ContactGroup.class)
 private String name;

 @Pattern(regexp = "[a-zA-Z0-9]+@[a-zA-Z0-9]+\\.[a-zA-Z0-9]+",
          message = "Please enter a valid formated e-mail !",
          groups = validateBean.ContactGroup.class)
 private String email;

 // getters and setters

protected Object clone() throws CloneNotSupportedException {
 ContactBean other = (ContactBean) super.clone();
 return other;


package validateBean;

public interface ContactGroup {
 // NOPE  


  <h:inputText value="#{}">     
   <f:validateBean validationGroups="validateBean.ContactGroup" />
  <h:inputText value="#{}">                     
   <f:validateBean validationGroups="validateBean.ContactGroup" />

  <h:commandButton value="Contact Admin" action="contact_admin"/>                       
  <f:validateWholeBean value="#{contactBean}" validationGroups="validateBean.ContactGroup" />     

Note This feature must explicitly be enabled by setting the following application parameter  (context parameter)  in web.xml: javax.faces.validator.ENABLE_VALIDATE_WHOLE_BEAN. If this parameter is not set, or is set to false, this tag must be a no-op.


Check the result of using the class-level validation in the below figure:

The complete application is available here (I've tested with Mojarra 2.3.0-m04 under Payara 4).

Special thanks to Arjan Tijms for contributing to this post.

Niciun comentariu :

Trimiteți un comentariu


Postări populare

Follow by Email

Visitors Starting 4 September 2015

Locations of Site Visitors