MyFaces Extensions Validator r3 News

JSF in der Praxis
24.03.2010 DI (FH) Gerhard Petracek / MyFaces-Extensions-Validator 1

MyFaces Extensions-Validator
What’s new in version 3


Agenda - 1
• Bean-Validation Integration Module
(JSR 303 for JSF 1.x & 2.x + special Features)
• Improved Support for
3rd Party Component Libraries
• Typesafe Constraint Parameters
• Constraint Severity
• Pluggable Storages
• Meta-Data Filters
• Validation Interception

Agenda - 2
• SkipValidationEvaluator
• Optional Invocation Order
• Integration of RAD-Add-on
• Additional Static Syntax for
@JoinValidation
• Empty-/Null-Value Markers
• Other Improvements
• New Add-ons


Bean-Validation Integration
• JSR 303 for JSF 1.x and JSF 2.x
• Integration Module as alternative/addition
to the Property-Validation Module
• Compatible with all BV conform
implementations
• Module provides additional features
• Advantage: It’s the (new) standard
• Disadvantage: Not all features of ExtVal
will be available (due to spec. restrictions)

ExtVal vs. JSF 2 BV-Integration
• With ExtVal
• @NotNull validation enabled by default
(deactivation via std. JSF config)
• Typesafe group validation
• No Validation Markup in the Page
• The ExtValBeanValidationContext allows
custom implementations e.g. tags, configs,…
• Component initialization
(e.g. @NotNull client-side required)
• Severity aware validation


ExtVal vs. JSF 2 BV-Integration
• Model based validation
• Sorted violation messages
• Out-of-the-box dependency injection support
for constraint-validators


ExtVal Annotations for BV
• @BeanValidation
for Group-Validation
• @ModelValidation
class level validation of an explicit or
implicit target


@BeanValidation
• Normally used in Page-Beans
• Available attributes
• viewIds (default: * for all pages)
• useGroups (default: Default.class)
• restrictGroups (default: -)
• conditions (default: #{true})
• modelValidation (default: -)
• List
(equivalent to multi-constraint syntax of JSR 303)


@BeanValidation - Examples
• Simple group validation
@BeanValidation(useGroups=Admin.class)
• Group validation for a specific view
@BeanValidation(viewIds="/login.xhtml",
useGroups=Admin.class)
• If group validation is defined for the whole
bean, it might be required to exclude
groups for special properties and/or views
@BeanValidation(restrictGroups=Admin.class)
• Conditional group validation
@BeanValidation(useGroups = Admin.class,
conditions="#{user.role.privileged}")

@ModelValidation
• To trigger bean-validation after
„Update model values" phase
• Also uses information of @BeanValidation
• Difference:
@ModelValidation isn‘t accumulated
• Available attributes
• isActive (default: false)
• displayInline (default: false)
• validationTargets (default: current base object)
• message (default: -)

3rd Party Component Libraries
• Improved support for
• Trinidad
• ICEfaces
• RichFaces
• New sandbox project e.g. for external
component support modules to improve
compatibility with 3rd party component
libraries
(http://code.google.com/p/sandbox890)


Typesafe Constraint Parameters
• Similar to the payload-attribute of BV
(Payload is the subset of Constraint
Parameters of ExtVal)
• Allows typesafe and reusable parameters
• Simple example - alternative for:
@MyConstraint(payload = "warn")
With Bean-Validation:
@MyConstraint(payload = Warn.class)
• Processed by Add-ons or Component
Libraries

Constraint Severity
• Constraints with Severity Info and Warn
don‘t "stop" the JSF-Lifecycle
• ExtVal 1.x.3 provides out-of-the-box
• ViolationSeverity.Info.class
• ViolationSeverity.Warn.class
• ViolationSeverity.Error.class (= default)
• ViolationSeverity.Fatal.class


Optional: Pluggable Parameters
• ExtVal allows to map custom classes to the
default implementations (esp. to avoid
dependencies of BV Constraints to ExtVal)
• Mapping via
• Global-ExtVal-Parameter
• Static config
• Examples are available in the ExtVal Wiki


Pluggable Storages
• Generic mechanism which provides scoped
storages with custom APIs
• Allows to create multiple storages of the
same type with different names
• Allows to create different storage types
• StorageManager (per storage type)
• Responsible for scoping
• Allows to create and reset (custom) storages
via an API (independent of the storage type)
• Allows to provide custom (tweaked) storage
implementations easily

Meta-Data Filters
• Filters meta-data before it gets added to the
meta-data storage
• Only for static meta-data manipulation
• Meta-data extraction interceptors are only
for dynamic meta-data manipulation


Validation Interception - 1
• Invocation:
• Global interceptors:
before and after the validation of a property
• Local interceptors:
before and after the validation of a constraint
• Allows to bypass validation of a
• Property
• Constraint


Validation Interception - Example
• Implementation
public class CustomInterceptor
implements PropertyValidationInterceptor {

public boolean beforeValidation(
FacesContext fC, UIComponent c,
Object convertedObject, Map<String, Object> p) {

//...
return true;
}

public void afterValidation(
FacesContext fC, UIComponent c,
Object convertedObject, Map<String, Object> p) {

//...
}
}


Validation Interception - Example
• Usage
• Global interceptors
ExtValContext.getContext()
.addPropertyValidationInterceptor(
new CustomInterceptor());
• Local interceptors
@Required(parameters = CustomInterceptor.class)
private String name;


SkipValidationEvaluator
• Evaluates if the validation process for the
current property should be skipped
• Allows to provide a custom evaluator


Optional Invocation Order
• Classes which implement an interface
which is annotated with
@InvocationOrderSupport
are allowed to use
@InvocationOrder
• The annotation allows to register artifacts
which get called e.g. before internal
artifacts
• Default order: 1000


Integration of RAD-Add-on
• It‘s possible to use input components
without value-bindings.
• Use-Case:
During prototyping sometimes developers
have to create dummy pages without
functionality.


Static Syntax for @JoinValidation
• In addition to the existing notations it‘s
possible to refer a target property via
the fully qualified class name
+ the property name
• Example:
@JoinValidation("at.irian.demo.domain.Person:password")


Empty-/Null-Value Markers
• Marker for validation strategies instead of
actively ignoring empty/null values
• Via Annotations
• @EmptyValueAwareValidationStrategy
• @NullValueAwareValidationStrategy


Other Improvements
• Structural improvements
• Performance improvements
• (JSF-) ProjectStage support


New Add-ons - 1
• Add-ons compatible with Property- and
Bean-Validation module
• Transactional model validation (light)
• Continue with warnings
• Add-ons compatible with Property-
Validation module
• Advanced meta-data
• Java based config
(Syntax inspired by Google Guice)


New Add-ons - 2
• Bean-Validation module
• Spring managed constraint validation
(us dependency injection in custom constraint
validator implementations)


Links
• http://svn.apache.org/repos/asf/myfaces/extensi
ons/validator
• http://issues.apache.org/jira/browse/EXTVAL
• http://wiki.apache.org/myfaces/Extensions/Valid
ator/Versions/Versions/UpgradeGuide
• http://os890.blogspot.com
• http://code.google.com/p/os890/source/browse/tr
unk/java/web/jsf/extval
• http://people.apache.org/~gpetracek/myfaces/ex
tval


MyFaces Extensions Validator r3 News

More Related Content

What's hot (20)

Viewers also liked (14)

Similar to MyFaces Extensions Validator r3 News (15)

Recently uploaded (20)

MyFaces Extensions Validator r3 News