顾名思义，ajax:clientValidator就是以Ajax方式在客户端对输入构件的值进行校验。我们看一段代码：

<w:form clientValidate="true">
	<w:textField id="username">
		<ajax:clientValidator message="admin是系统预留帐号，不可注册！">
			if(value == 'admin') 
				return false;
			else
   				return true;
		</ajax:clientValidator>
	</w:textField>
</w:form>

这段代码用于用户注册时判断用户输入的注册名是不是admin，如果是则提示错误。此校验在构件失去焦点时触发。效果如下：

图 17.6. ajax:clientValidator客户端校验

当然啦，校验功能最强大的正则表达式在这里也是可以使用的。下面这段代码是对固定电话号码的校验：

<w:form clientValidate="true">
	<w:textField id="tel">
		<ajax:clientValidator message="请输入有效的电话号码（限国内固定电话）！">
			var re = new RegExp("^0[1-9]\\d{1,2}-?[1-9]\\d{6,7}$"); 
			return re.test(value);
		</ajax:clientValidator>
	</w:textField>
</w:form>

其中正则表达式re的意思是说：3-4位区号，后面7-8位短号；区号和短号之间可以用-连接，也可以省略-；区号第一位必须是0，区号第二位和短号第一位必须是1-9之间的数字，不能是0。运行后效果与上图类似。

前面所有的例子都是在客户端进行的校验，那么如何在服务器端进行校验呢？

有时我们为了保证页面代码的简洁性（便于美工人员进行美工），我们需要将本章第一节中讲的OperaMasks预置的校验器校验移到LiteBean中，这时对于通过IoVC绑定的构件属性，我们可以通过在绑定属性上加上校验器注解的方式来请求校验。OperaMasks中预定义了一些常用的校验器注解：

例如，下面是一个很常见的页面代码：

<w:form>
	<layout:panelGrid columns="3">
		<h:outputLabel for="name" value="姓名：" />
		<w:textField id="name" />
		<h:message for="name" />
		<h:outputLabel for="weight" value="体重：" />
		<w:textField id="weight" />
		<h:message for="weight" />
		<h:outputLabel for="age" value="年龄：" />
		<w:textField id="age" />
		<h:message for="age" />
		<h:outputLabel for="usedName" value="曾用名：" />
		<w:textField id="usedName" />
		<h:message for="usedName" />
		<h:outputLabel for="idNum" value="身份证号：" />
		<w:textField id="idNum" />
		<h:message for="idNum" />
	</layout:panelGrid>
	<w:button label="提交" />
</w:form>

其中的layout:panelGrid只用于布局，与校验无关。h:message仅用于显示校验错误信息，与校验也无关。现在我们来进行了一些IoVC简单校验：

	@Bind
	@Required(message="姓名不能为空！")
	private String name;
	@Bind
	@ValidateDoubleRange(minimum=10.00,maximum=200.00,message="体重必须为10.00-200.00之间的小数！")
	private Double weight;
	@Bind
	@ValidateLongRange(minimum=18,maximum=60,message="年龄必须为18-60之间的整数")
	private int age;
	@Bind
	@ValidateLength(minimum=2,maximum=4,message="必须是2-4个汉字！")
	private String usedName;
	@Bind
	@ValidateRegexp(value=CommonRegexpPatterns.IDENTITY_CARD,message="必须是有效的15位或18位的身份证号码！")
	private String idNum;

运行此页面，输入非法信息，点提交按钮后效果如下图。

图 17.7. IoVC服务器端简单校验

上面这些注解同样只能进行一些简单的非空、长度、范围校验及正则式规则校验。如果我们要进行复杂一些的校验，代码较长时怎么办？

OperaMasks提供了@Validate注解，用于将LiteBean中的方法注解为指定构件的校验方法。@Validate绑定构件的方式有两种：

下面举个简单的例子来说明一下@Validate注解的用法。假如某个页面中有个输入框用于输入月份，且当月份小于10时允许前面输入0，也可以不输入。这时我们就不能用一个int型属性来保存它了，当然也就不能用上面的@ValidateLongRange来校验了。只能用一个String类型属性来保存它，那么如何校验呢？当然可以用@ValidateRegexp注解来写个正则表达式校验，我们看看用方法怎么校验。

<w:form>
    <w:textField id="month" />
    <w:button label="提交" />
</w:form>

@Bind
private String month;

@Validate(message = "月份有效格式为1-12或01-12")
public boolean validateMonth(String value) {//此处参数类型与@Bind绑定的value属性类型一致
	if (value.length() == 2 && value.startsWith("0") && value.compareTo("01") >= 0 && value.compareTo("09") <= 0)
		return true;
	if (value.length() == 2 && value.startsWith("1") && value.compareTo("10") >= 0 && value.compareTo("12") <= 0)
		return true;
	if (value.length() == 1 && value.compareTo("1") >= 0 && value.compareTo("9") <= 0)
		return true;
	return false;
}

到目前为止，我们所见到的@Validate注解的方法的方法签名都是public boolean methodName(Object value)；事实上，这个方法签名可以有很多种，除了直接返回boolean值的这种最简单形式，还允许：

校验的目的是为了保证在使用LiteBean的某个属性时，它的值是合法的。在OperaMasks请求处理生命周期中，使用这个值有3个地方：更新模型值阶段（Update Model Value Phase）、调用应用程序阶段（Invoke Application Phase）和渲染响应阶段（Render Response Phase），其中我们可以通过IoVC加入控制逻辑的时机有两个：调用应用程序整个周期及渲染响应阶段之前的BeforeRender周期。

默认的校验是发生在更新模型值阶段之前的处理验证阶段（Process Validations Phase）阶段，如果页面输入的值可以成功更新到模型中去，而只是逻辑上不合法，我们可以延后再检验它。

也就是说，如果我们会调用应用程序，且在此阶段使用LiteBean的某个属性值，我们可以在Action或ActionListener中校验。如果我们不调用应用程序，我们也可以在BeforeRender时进行校验。

再次说明一下：这种延后的校验不可处理输入数值的物理不合法（比如类型无法自动转换、数值超出范围等），只能处理类型合法范围合法而在某种场景下逻辑不合法的输入数值。

对于上一节中相同的页面代码，我们可以这样校验：

@Bind
private String month;

@Action
public void doSomething() {
	boolean flag = false;
	if (month.length() == 2 && month.startsWith("0") && month.compareTo("01") >= 0 && month.compareTo("09") <= 0)
		flag = true;
	if (month.length() == 2 && month.startsWith("1") && month.compareTo("10") >= 0 && month.compareTo("12") <= 0)
		flag = true;
	if (month.length() == 1 && month.compareTo("1") >= 0 && month.compareTo("9") <= 0)
		flag = true;
	if (flag == false){
		//输出一个错误提示到页面中某个地方
	}else{
		//值已经合法了，可以执行正常的处理逻辑
	}
}

ActionListener中与Action类似，BeforeRender中写法也与上面类似，只是与校验仅仅能影响页面的显示，而不能影响业务逻辑的执行。

上面的这些服务器端检验的方法都将代码直接写在某个页面对应的LiteBean中了，一方面不便于复用，另一方面使得LiteBean代码比较臃肿，都不便于维护。我们可以编写一个独立的检验器类，在需要使用的地方引用这个类就可以了。

在OperaMasks中定义独立的校验器类也是非常方便的，只需要在类定义时加上@DefineValidator注解，此类就会成为一个有效的校验器类，无需在配置文件中声明，也无需继承 javax.faces.validator.Validator接口（继承亦可）：

例如，需要定义一个简单的校验器，当输入值为字符串“bad”时校验失败。以下三种写法是完全等价的：

这样一个校验器类就算定义好了，对于一些能设置validator属性的构件就可直接通过上面定义的校验器类中的校验器id使用它了，例如：

<w:textField id="first" validator="badStringValidator"/>

但是，由于没有为这个校验器类定义对应的校验器构件标签，对于那些通过子构件形式来设置校验器的构件，这个校验器类无法直接在页面使用。对此，可以在LiteBean中使用另一个IoVC标签@Validator进行绑定。

@Bind
@Validator(BadStringValidator.class)
private String first;

这种方法与上面直接使用构件的validator属性效果一样，如下图。

图 17.8. 使用独立的校验器类

我们发现自己编写的独立校验器类工作正常了。但是如果我们在另一个系统中也到用到这个校验器类，但是要求当输入值为字符串“notbad”时校验失败，怎么办？改一下校验器代码？有没有更好的办法？能不能为这个校验器传入参数？

至此我们已经用了很多的注解了，而且这些注解大部分都可以使用参数，我们可不可以将我们的校验器类也做成注解？在OperaMasks中这也是可以做到的。我们可以再写一个Annotation类，指定其实现类为刚才那个BadStringValidator.class校验器类就行了。来看代码：

@Target({ElementType.FIELD, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Validator(BadStringValidator.class)
public @interface ValidateBadString {
}

好了，我们的注解做好了。那个校验器类不用做任何修改，现在我们将LiteBean中使用校验类的地方改为：

@Bind
@ValidateBadString  //这里原来是@Validator(BadStringValidator.class)
private String first;

这里@ValidateBadString的ValidateBadString就是那个Annotation类的类名。运行页面，可看到展现效果与改动前完全一致。

此时还是不能传入参数，我们再来改一下ValidateBadString.class这个Annotaion类。代码改为：

@Target({ElementType.FIELD, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Validator(BadStringValidator.class)
public @interface ValidateBadString {
    public String invalidValue() default "bad";
}

再来修改一下校验器类BadStringValidator.class，让它使用这个参数。代码如下：

@DefineValidator
public class BadStringValidator {
    private String invalidValue;
    public String getInvalidValue() {
        return invalidValue;
    }
    public void setInvalidValue(String invalidValue) {
        this.invalidValue = invalidValue;
    }
    @Validate
    public void validate(FacesContext context, UIComponent component, Object value) {
        if (value == null || this.invalidValue.equalsIgnoreCase(value.toString())) {
            ((UIInput) component).setValid(false);
            context.addMessage(component.getClientId(context),
                    new FacesMessage(FacesMessage.SEVERITY_ERROR, "非法的字符串", "非法的字符串")
            );
        }
    }
}

正如我们所期望的那样，现在我们可以为这个注解传入参数了，把应用场景中的LiteBean代码改为：

@Bind
@ValidateBadString(invalidValue="notbad")
private String first;

好了，运行页面，在textField中输入notbad并提交，可看到校验器注解已生效。这样以后在任何要限制不能输入的字符时我们就可以用这个注解了，通过invalidValue参数传入要限制的值。当然你也可以自己对上面的代码进行修改，让它一次可以传入多个限制字符。

下面且看OperaMasks 2.3版本客户端校验的一些新特性

下面我们看看在一些可能出现的场景里如何应用客户端校验