org.milyn.validation
Class Validator

java.lang.Object
  org.milyn.validation.Validator

All Implemented Interfaces:

org.milyn.delivery.ContentHandler, org.milyn.delivery.dom.DOMVisitAfter, org.milyn.delivery.dom.DOMVisitor, org.milyn.delivery.sax.SAXVisitAfter, org.milyn.delivery.sax.SAXVisitBefore, org.milyn.delivery.sax.SAXVisitor, org.milyn.delivery.Visitor

public final class Validator
extends Object
implements org.milyn.delivery.sax.SAXVisitBefore, org.milyn.delivery.sax.SAXVisitAfter, org.milyn.delivery.dom.DOMVisitAfter

A Validator uses a predefined Rule that performs the actual validator for a Validator. This way a Validator does not know about the technology used for the validation and users can mix and max different rules as appropriate to the use case they have. For example, one problem might be solve nicely with a regular expression but another might be easier to sovle using a MVEL expression. Example configuration:

<rules:ruleBases>
    <rules:ruleBase name="addressing" src="usa_address.properties" provider="org.milyn.smooks.validation.RegexProvider" />
 </rules:ruleBases>

 <validation:field on="order/header/email" rule="addressing.email" onFail="WARN" />

 

Options:

• on The fragement that the validation will be performed upon.
• rule Is the name of a previously defined in a rules element. The rule itself is identified by ruleProviderName.ruleName. So taking the above example addressing is the ruleProviderName and email is the rule name. In this case email identifies a regular expression but if you were to change the provider that might change and a differnet technology could be used to validate an email address.
• onFail The onFail attribute in the validation configuration specified what action should be taken when a rule matches. This is all about reporting back valdiation failures.

Author:

Daniel Bevenius

Constructor Summary

Validator()
No-args constructor required by Smooks.

Validator(String compositRuleName, OnFail onFail)
Public constructor.

Method Summary

String	getCompositRuleName()
OnFail	getOnFail()
void	initialize() Initialize the visitor instance.
Validator	setAppContext(org.milyn.container.ApplicationContext appContext)
void	setCompositRuleName(String compositRuleName)
void	setOnFail(OnFail onFail)
String	toString()
void	visitAfter(Element element, org.milyn.container.ExecutionContext executionContext)
void	visitAfter(org.milyn.delivery.sax.SAXElement element, org.milyn.container.ExecutionContext executionContext)
void	visitBefore(org.milyn.delivery.sax.SAXElement element, org.milyn.container.ExecutionContext executionContext)

Methods inherited from class java.lang.Object

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

Constructor Detail

Validator

public Validator()

No-args constructor required by Smooks.

Validator

public Validator(String compositRuleName,
                 OnFail onFail)

Public constructor.

Parameters:

compositRuleName - The name of the rule that will be used by this validator.

onFail - The failure level.

Method Detail

initialize

@Initialize
public void initialize()

Initialize the visitor instance.

visitBefore

public void visitBefore(org.milyn.delivery.sax.SAXElement element,
                        org.milyn.container.ExecutionContext executionContext)
                 throws org.milyn.SmooksException

Specified by:

visitBefore in interface org.milyn.delivery.sax.SAXVisitBefore

Throws:

org.milyn.SmooksException

visitAfter

public void visitAfter(org.milyn.delivery.sax.SAXElement element,
                       org.milyn.container.ExecutionContext executionContext)
                throws org.milyn.SmooksException

Specified by:

visitAfter in interface org.milyn.delivery.sax.SAXVisitAfter

Throws:

org.milyn.SmooksException

visitAfter

public void visitAfter(Element element,
                       org.milyn.container.ExecutionContext executionContext)
                throws org.milyn.SmooksException

Specified by:

visitAfter in interface org.milyn.delivery.dom.DOMVisitAfter

Throws:

org.milyn.SmooksException

toString

public String toString()

Overrides:

toString in class Object

setCompositRuleName

@ConfigParam(name="name")
public void setCompositRuleName(String compositRuleName)

getCompositRuleName

public String getCompositRuleName()

setOnFail

@ConfigParam(defaultVal="ERROR")
public void setOnFail(OnFail onFail)

getOnFail

public OnFail getOnFail()

setAppContext

public Validator setAppContext(org.milyn.container.ApplicationContext appContext)