客户端验证的极品--jQuery.validator

最近在做一个用户注册登录的页面,资料查寻过程中发现了一个非常不错的客户端验证的极品-jQuery.validate。 
它是著名的JavaScript包jQuery的一个插件,其实它还有其它的一些插件应该都爽,有待慢慢来学习 

官方地址:http://bassistance.de/jquery-plugins/jquery-plugin-validation/ 
jQuery用户手册:http://jquery.org.cn/visual/cn/index.xml 

开发使用起来非常简单明了, 
我的代码:


   1. $(document).ready(function(){   
   
2.   
   
3/* 设置默认属性 */   
   
4. $.validator.setDefaults({   
   
5.   submitHandler: function(form) { form.submit(); }   
   
6. });   
   
7// 中文字两个字节   
   8. jQuery.validator.addMethod("byteRangeLength"function(value, element, param) {   
   
9.   var length = value.length;   
  
10.   for(var i = 0; i < value.length; i++){   
  
11.    if(value.charCodeAt(i) > 127){   
  
12.     length++;   
  
13.    }   
  
14.   }   
  
15.   return this.optional(element) || ( length >= param[0&& length <= param[1] );   
  
16. }, "请确保输入的值在3-15个字节之间(一个中文字算2个字节)");   
  
17.   
  
18/* 追加自定义验证方法 */   
  
19// 身份证号码验证   
  20. jQuery.validator.addMethod("isIdCardNo"function(value, element) {   
  
21.   return this.optional(element) || isIdCardNo(value);   
  
22. }, "请正确输入您的身份证号码");   
  
23.   
  
24// 字符验证   
  25. jQuery.validator.addMethod("userName"function(value, element) {   
  
26.   return this.optional(element) || /^[\u0391-\uFFE5\w]+$/.test(value);   
  
27. }, "用户名只能包括中文字、英文字母、数字和下划线");   
  
28.   
  
29// 手机号码验证   
  30. jQuery.validator.addMethod("isMobile"function(value, element) {   
  
31.   var length = value.length;   
  
32.   return this.optional(element) || (length == 11 && /^(((13[0-9]{1})|(15[0-9]{1}))+\d{8})$/.test(value));   
  
33. }, "请正确填写您的手机号码");   
  
34.   
  
35// 电话号码验证   
  36. jQuery.validator.addMethod("isPhone"function(value, element) {   
  
37.   var tel = /^(\d{3,4}-?)?\d{7,9}$/g;   
  
38.   return this.optional(element) || (tel.test(value));   
  
39. }, "请正确填写您的电话号码");   
  
40.   
  
41// 邮政编码验证   
  42. jQuery.validator.addMethod("isZipCode"function(value, element) {   
  
43.   var tel = /^[0-9]{6}$/;   
  
44.   return this.optional(element) || (tel.test(value));   
  
45. }, "请正确填写您的邮政编码");   
  
46. $(regFrom).validate({   
  
47/* 设置验证规则 */   
  
48.   rules: {   
  
49.    userName: {   
  
50.     required: true,   
  
51.     userName: true,   
  
52.     byteRangeLength: [3,15]   
  
53.    },   
  
54.    password: {   
  
55.     required: true,   
  
56.     minLength: 5   
  
57.    },   
  
58.    repassword: {   
  
59.     required: true,   
  
60.     minLength: 5,   
  
61.     equalTo: "#password"   
  
62.    },   
  
63.    question: {   
  
64.     required: true   
  
65.    },   
  
66.    answer: {   
  
67.     required: true   
  
68.    },   
  
69.    realName: {   
  
70.     required: true   
  
71.    },   
  
72.    cardNumber: {   
  
73.     isIdCardNo: true   
  
74.    },   
  
75.    mobilePhone: {   
  
76.     isMobile: true   
  
77.    },   
  
78.    phone: {   
  
79.     isPhone: true   
  
80.    },   
  
81.    email: {   
  
82.     required: true,   
  
83.     email: true   
  
84.    },   
  
85.    zipCode: {   
  
86.     isZipCode:true   
  
87.    }   
  
88.   },   
  
89/* 设置错误信息 */   
  
90.   messages: {   
  
91.    userName: {   
  
92.     required: "请填写用户名",   
  
93.     byteRangeLength: "用户名必须在3-15个字符之间(一个中文字算2个字符)"   
  
94.    },   
  
95.    password: {   
  
96.     required: "请填写密码",   
  
97.     minlength: jQuery.format("输入{0}.")   
  
98.    },   
  
99.    repassword: {   
 
100.     required: "请填写确认密码",   
 
101.     equalTo: "两次密码输入不相同"   
 
102.    },   
 
103.    question: {   
 
104.     required: "请填写您的密码提示问题"   
 
105.    },   
 
106.    answer: {   
 
107.     required: "请填写您的密码提示答案"   
 
108.    },   
 
109.    realName: {   
 
110.     required: "请填写您的真实姓名"   
 
111.    },   
 
112.    email: {   
 
113.     required: "请输入一个Email地址",   
 
114.     email: "请输入一个有效的Email地址"   
 
115.    }   
 
116.   },   
 
117/* 错误信息的显示位置 */   
 
118.   errorPlacement: function(error, element) {   
 
119.    error.appendTo( element.parent() );   
 
120.   },   
 
121/* 验证通过时的处理 */   
 
122.   success: function(label) {   
 
123.    // set   as text for IE   
 124.    label.html(" ").addClass("checked");   
 
125.   },   
 
126/* 获得焦点时不验证 */   
 
127.   focusInvalid: false,   
 
128.   onkeyup: false   
 
129. });   
 
130.   
 
131// 输入框获得焦点时,样式设置   
 132. $('input').focus(function(){   
 
133.   if($(this).is(":text"|| $(this).is(":password"))   
 
134.    $(this).addClass('focus');   
 
135.   if ($(this).hasClass('have_tooltip')) {   
 
136.    $(this).parent().parent().removeClass('field_normal').addClass('field_focus');   
 
137.   }   
 
138. });   
 
139.   
 
140// 输入框失去焦点时,样式设置   
 141. $('input').blur(function() {   
 
142.   $(this).removeClass('focus');   
 
143.   if ($(this).hasClass('have_tooltip')) {   
 
144.    $(this).parent().parent().removeClass('field_focus').addClass('field_normal');   
 
145.   }   
 
146. });   
 
147. });   


网上的资料有人说,它跟prototype包会有冲突,我还没有同时使用过,这点不是很清楚,但我是发现一个问题: 
对于最小/大 长度的验证方法,作者可能考虑到大家的命名习惯不同,同时做了minLength和minlength(maxLength和maxlength)方法, 应该哪一个都是可以的,但对于用户Message来说,只能够定义针对minlength(maxlength),才能调用用户自定义的Message, 
否则只是调用包的默认Message,但具体原因还没有查清楚。同时,这个插件提供了本地化的消息,但对于我这里初学者来说,怎么使用它还有待摸索!

----------------------------------------------华丽的分割线---------------------------------------------------------------

jQuery.validate中内置的验证方法

1、   required()         返回:Bool      //必填验证元素
2、   required(dependency-expression)     返回:Bool     //必填元素依赖于表达式的结果
3、   required(dependency-callback)         返回:Boolean    // 必填元素依赖于回调函数的结果
4、   remote(url)                返回:Bool        //请求远程校验。url通常是一个远程调用方法
5、   minlength(length)      返回:Bool        //设置最小长度
6、   maxlength(length)     返回:Bool        // 设置最大长度
7、   rangelength(range)  返回:Bool        //设置一个长度范围[min,max]
8、   min(value)                返回:Bool        // 设置最大值
9、   ax(value)               返回:Bool        //设置最小值
10、 email()                      返回:Bool       //验证电子邮箱格式
11、 range(range)            返回:Bool      // 设置值的范围
12、 url()               返回:Bool      //  验证URL格式
13、 date()            返回:Bool     //验证日期格式(类似30/30/2008的格式,不验证日期准确性只验证格式)
14、 dateISO()      返回:Bool     // 验证ISO类型的日期格式
15、  dateDE()       返回:Bool     //验证德式的日期格式(29.04.1994 or 1.1.2006)
17、  number()       返回:Bool     // 验证十进制数字(包括小数的)
18、  digits()          返回:Bool      // 验证整数
19、  creditcard()   返回:Bool     // 验证信用卡号
20、  accept(extension)     返回:Bool       // 验证相同后缀名的字符串
21、  equalTo(other)         返回:Bool       // 验证两个输入框的内容是否相同
22、  phoneUS()                返回:Bool       //验证美式的电话号码

validate ()的可选项

1、debug:进行调试模式(表单不提交):

语法:把调试设置为默认:

$.validator.setDefaults({
                   debug:true
               }) 
2、submitHandler:通过验证后运行的函数,里面要加上表单提交的函数,否则表单不会提交

语法:

$(".selector").validate({
                   submitHandler:function(form) {
                                         $(form).ajaxSubmit();
                                      }
                }) 


3、ignore:对某些元素不进行验证 
    语法: 
$("#myform").validate({
                  ignore:"ignore"
              })


4、rules:自定义规则,key:value的形式,key是要验证的元素,value可以是字符串或对象 

语法:

$(".selector").validate({
                  rules:{
                           name:"required",
                           email:{
                                    required:true,
                                    email:true
                                  }
                         }
             }) 


5、messages:自定义的提示信息key:value的形式key是要验证的元素,值是字符串或函数

语法:

 $(".selector").validate({
                    rules:{
                             name:"required",
                             email:{
                                      required:true,
                                      email:true
                                    }
                           },
                    messages:{
                                name:"Name不能为空",
                                email:{
                                         required:"E-mail不能为空",
                                         email:"E-mail地址不正确"
                                       }
                               }
              }) 


6、groups:对一组元素的验证,用一个错误提示,用error Placement控制把出错信息放在哪里 

语法:

$("#myform").validate({
                  groups:{
                             username:"fname lname"
                         },
                   errorPlacement:function(error,element) {
                             if (element.attr("name") == "fname" || element.attr("name") == "lname")
                                 error.insertAfter("#lastname");
                             else
                                 error.insertAfter(element);
                          },
                   debug:true
              }) 


7、Onubmit Boolean 默认:true,是否提交时验证 

语法:

$(".selector").validate({
                    onsubmit:false
                }) 


8、onfocusout Boolean 默认:true ,是否在获取焦点时验证 

语法:

$(".selector").validate({
                    onfocusout:false
               }) 


9、onkeyup Boolean 默认:true ,是否在敲击键盘时验证 

语法:

$(".selector").validate({
                   onkeyup:false
             }) 


10、onclick Boolean 默认:true,是否在鼠标点击时验证(一般验证checkbox,radiobox

语法:

$(".selector").validate({
                   onclick:false
             }) 


11、focusInvalid Boolean 默认:true,提交表单后,未通过验证的表单(第一个或提交之前获得焦点的未通过验证的表单)会获得焦点 

语法:

$(".selector").validate({
                 focusInvalid:false
            }) 


12、focusCleanup Boolean 默认:false,当未通过验证的元素获得焦点时,并移除错误提示(避免和 focusInvalid.一起使用)

语法: 

$(".selector").validate({
                   focusCleanup:true
             }) 


13、errorClass String 默认:"error",指定错误提示的css类名,可以自定义错误提示的样式 

语法:

$(".selector").validate({
                   errorClass:"invalid"
              })

14、errorElement String 默认:"label",使用什么标签标记错误 

语法:

$(".selector").validate({
                   errorElement:"em"
             }) 


15、wrapper String:使用什么标签再把上边的errorELement包起来 

语法:

$(".selector").validate({
                    wrapper:"li"
               }) 


16、errorLabelContainer Selector:把错误信息统一放在一个容器里面 

语法:

$("#myform").validate({
                 errorLabelContainer:"#messageBox",
                 wrapper:"li",
                 submitHandler:function() { alert("Submitted!") }
           }) 


17、showErrors:跟一个函数,可以显示总共有多少个未通过验证的元素 

语法:

$(".selector").validate({
             showErrors:function(errorMap,errorList) {
                                    $("#summary").html("Your form contains " + this.numberOfInvalids() + " errors,see details below.");
                                    this.defaultShowErrors();
                                }
        }) 


18、errorPlacement:跟一个函数,可以自定义错误放到哪里 

语法:

$("#myform").validate({
            errorPlacement:function(error,element) { error.appendTo(element.parent("td").next("td"));},
            debug:true

  })


19、success:要验证的元素通过验证后的动作,如果跟一个字符串,会当做一个css类,也可跟一个函数 

语法:

$("#myform").validate({
                  success:"valid",
                  submitHandler:function() { alert("Submitted!") }
             }) 


20、highlight:可以给未通过验证的元素加效果,闪烁等
21、addMethod(name,method,message)方法
参数name是添加的方法的名字
参数method是一个函数,接收三个参数(value,element,param) value是元素的值,element是元素本身 param是参数,我们可以用addMethod来添加除built-in Validation methods之外的验证方法 比如有一个字段,只能输一个字母,范围是a-f,写法如下:
$.validator.addMethod("af",function(value,element,params){
                                                        if(value.length>1){
                                                            return false;
                                                        }
                                                        if(value>=params[0] && value<=params[1]){
                                                            return true;
                                                        }

                                                    else{
                                                                return false;
                                                             }
                                                  },"必须是一个字母,且a-f"); 


用的时候,比如有个表单字段的id="username",则在rules中写
username:{
             af:["a","f"]
         }

addMethod的第一个参数,就是添加的验证方法的名子,这时是af
addMethod的第三个参数,就是自定义的错误提示,这里的提示为:"必须是一个字母,且a-f"
addMethod的第二个参数,是一个函数,这个比较重要,决定了用这个验证方法时的写法;
如果只有一个参数,直接写,如果af:"a",那么a就是这个唯一的参数,如果多个参数,用在[]里,用逗号分开;
对于动态提交表单时submitHandler是比较好用的,用户可以在submit时的onclick事件中进行验证,如:
$("input[type='submit']").click(function(){

                                     $("form1").validate({
                                                   submitHandler: function(form) {

                                                                   //这里就可以处理ajax事件

                                                                   $.ajax(function(){

                                                                                      //处理

                                                                                    });               

                                                                      }

                           }); 





jakarta.validation.UnexpectedTypeException: HV000030: No validator could be found for constraint 'jakarta.validation.constraints.NotBlank' validating type 'java.lang.Integer'. Check configuration for 'user_Id' at org.hibernate.validator.internal.engine.constraintvalidation.ConstraintTree.getExceptionForNullValidator(ConstraintTree.java:116) ~[hibernate-validator-8.0.2.Final.jar:8.0.2.Final] at org.hibernate.validator.internal.engine.constraintvalidation.ConstraintTree.getInitializedConstraintValidator(ConstraintTree.java:162) ~[hibernate-validator-8.0.2.Final.jar:8.0.2.Final] at org.hibernate.validator.internal.engine.constraintvalidation.SimpleConstraintTree.validateConstraints(SimpleConstraintTree.java:58) ~[hibernate-validator-8.0.2.Final.jar:8.0.2.Final] at org.hibernate.validator.internal.engine.constraintvalidation.ConstraintTree.validateConstraints(ConstraintTree.java:75) ~[hibernate-validator-8.0.2.Final.jar:8.0.2.Final] at org.hibernate.validator.internal.metadata.core.MetaConstraint.doValidateConstraint(MetaConstraint.java:130) ~[hibernate-validator-8.0.2.Final.jar:8.0.2.Final] at org.hibernate.validator.internal.metadata.core.MetaConstraint.validateConstraint(MetaConstraint.java:123) ~[hibernate-validator-8.0.2.Final.jar:8.0.2.Final] at org.hibernate.validator.internal.engine.ValidatorImpl.validateMetaConstraint(ValidatorImpl.java:555) ~[hibernate-validator-8.0.2.Final.jar:8.0.2.Final] at org.hibernate.validator.internal.engine.ValidatorImpl.validateConstraintsForSingleDefaultGroupElement(ValidatorImpl.java:518) ~[hibernate-validator-8.0.2.Final.jar:8.0.2.Final]怎么解决
最新发布
08-08
<think>我们正在处理一个Jakarta Validation异常:`UnexpectedTypeException: No validator found for NotBlank on Integer user_Id`。 问题分析: 1. `@NotBlank`注解通常用于字符串(String)类型,因为它会检查字符串不为null且长度大于0(即不是空字符串)。 2. 但是,这里我们将`@NotBlank`用在了Integer类型的字段`user_Id`上。 3. Jakarta Validation(Hibernate Validator是其参考实现)要求注解必须适用于被注解的元素类型。由于`@NotBlank`只支持字符串,所以当用于Integer时,就会抛出`UnexpectedTypeException`。 解决方案: 1. 对于非字符串类型的字段(如Integer、Long等),我们应该使用`@NotNull`注解来确保该字段不为null。 2. 如果还需要检查数值不为0(或者某个特定值),我们可以结合其他注解,例如`@Min`、`@Max`等。 但是,这里用户想要的效果可能是:既不能为null,也不能为0(或者空值?)。注意,Integer是对象类型,null表示未赋值,而0是一个有效的数值。所以,我们需要明确需求: - 如果要求user_Id不能为null且不能为0,那么我们可以使用`@NotNull`和`@Min(1)`(假设最小值为1)。 - 如果只是不能为null,那么使用`@NotNull`即可。 因此,修改注解: 将`@NotBlank`替换为`@NotNull`,如果需要进一步限制数值范围,则添加其他约束注解。 示例代码: 原代码可能类似: ```java public class User { @NotBlank private Integer user_Id; // ... } ``` 修改为: ```java public class User { @NotNull @Min(1) // 可选,如果要求最小值为1 private Integer user_Id; // ... } ``` 注意:`@NotBlank`是专门为字符串设计的,它包含三个检查:非null、非空字符串(长度>0)以及非空白字符(如果使用Hibernate Validator的扩展,则还会检查非空白字符串)。对于非字符串类型,这些检查没有意义。 另外,如果确实需要自定义验证逻辑,我们可以创建自定义的验证注解和验证器。 自定义验证器示例(如果需要验证Integer不为0): 1. 创建自定义注解`@NotZero`(或其他名称): ```java import javax.validation.Constraint; import javax.validation.Payload; import java.lang.annotation.Documented; import java.lang.annotation.Retention; import java.lang.annotation.Target; import static java.lang.annotation.ElementType.*; import static java.lang.annotation.RetentionPolicy.RUNTIME; @Documented @Constraint(validatedBy = NotZeroValidator.class) @Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE }) @Retention(RUNTIME) public @interface NotZero { String message() default "must not be zero"; Class<?>[] groups() default {}; Class<? extends Payload>[] payload() default {}; } ``` 2. 实现验证器: ```java import javax.validation.ConstraintValidator; import javax.validation.ConstraintValidatorContext; public class NotZeroValidator implements ConstraintValidator<NotZero, Integer> { @Override public boolean isValid(Integer value, ConstraintValidatorContext context) { // 允许为null,因为可能由@NotNull负责,如果同时需要非null,则应该配合@NotNull使用 if (value == null) { return true; } return value != 0; } } ``` 然后,在字段上使用: ```java public class User { @NotNull @NotZero private Integer user_Id; // ... } ``` 但是,对于大多数情况,使用`@NotNull`和`@Min(1)`就足够了,不需要自定义。 总结: 错误原因是将只适用于字符串的`@NotBlank`用在了Integer上。解决方案是使用`@NotNull`替代,并根据需要添加其他数值约束。 相关问题: 1. Jakarta Validation中常用的约束注解有哪些? 2. 如何自定义验证注解和验证器? 3. 在Jakarta Validation中,如何处理集合或数组元素的验证?</think>### 解决 UnexpectedTypeException: @NotBlank 在 Integer 类型上的问题 当在 Integer 类型字段上使用 `@NotBlank` 注解时,会触发 `UnexpectedTypeException`,因为 **`@NotBlank` 仅适用于字符串类型**,不能用于数值类型(如 Integer)。以下是解决方案和原理分析: --- ### 问题原因 1. **注解类型不匹配** `@NotBlank`(来自 `jakarta.validation.constraints`)设计用于验证字符串: - 检查字符串不为 `null` - 检查字符串长度 `> 0` - 检查字符串包含非空白字符 但 Integer 是数值类型,无法通过字符串规则验证[^1]。 2. **验证器查找机制** Jakarta Validation 在运行时根据字段类型查找匹配的验证器。由于没有为 Integer 定义的 `@NotBlank` 验证器,抛出异常: ```java jakarta.validation.UnexpectedTypeException: No validator found for constraint 'NotBlank' on type 'java.lang.Integer' ``` --- ### 解决方案 #### ✅ 方案 1:使用 `@NotNull` 替代(推荐) ```java public class User { @NotNull(message = "User ID cannot be null") // ✅ 正确用于对象类型 private Integer user_Id; } ``` - **`@NotNull`** 适用于所有对象类型(包括 Integer),检查值非 `null` - **数值范围检查**:若需验证数值有效性(如大于0),添加额外注解: ```java @NotNull @Positive(message = "User ID must be positive") // 确保值 > 0 private Integer user_Id; ``` #### ✅ 方案 2:自定义验证器(复杂场景) 1. 创建自定义注解 `@NotZero`: ```java import jakarta.validation.Constraint; import jakarta.validation.Payload; import java.lang.annotation.*; @Target({ElementType.FIELD}) @Retention(RetentionPolicy.RUNTIME) @Constraint(validatedBy = NotZeroValidator.class) // 关联验证器 public @interface NotZero { String message() default "Value must not be zero"; Class<?>[] groups() default {}; Class<? extends Payload>[] payload() default {}; } ``` 2. 实现验证逻辑: ```java import jakarta.validation.ConstraintValidator; import jakarta.validation.ConstraintValidatorContext; public class NotZeroValidator implements ConstraintValidator<NotZero, Integer> { @Override public boolean isValid(Integer value, ConstraintValidatorContext context) { // 允许为 null(由 @NotNull 处理),仅检查非零 return value == null || value != 0; } } ``` 3. 在字段上使用: ```java public class User { @NotNull @NotZero // 自定义注解 private Integer user_Id; } ``` --- ### 关键区别:`@NotBlank` vs `@NotNull` | 注解 | 适用类型 | 检查内容 | |--------------|-------------|-----------------------------| | `@NotBlank` | `String` | 非 null + 非空字符串 + 非空白符 | | `@NotNull` | 任意对象 | 非 null | | `@Min`/`@Max`| 数值类型 | 数值范围 | --- ### 最佳实践 1. **对象类型**(Integer/Long/Double): - 用 `@NotNull` 检查 null - 用 `@Positive`、`@Negative`、`@Min`、`@Max` 检查数值有效性 ```java @NotNull @Positive private Integer user_Id; ``` 2. **字符串类型**: ```java @NotBlank // 仅用于 String! private String username; ``` 3. **集合类型**: ```java @NotEmpty // 检查非空集合(非 null 且 size>0) private List<String> items; ``` > 💡 提示:所有 Jakarta Validation 注解需配合 `@Valid` 在 Controller 层触发验证: > ```java > public ResponseEntity<?> createUser(@Valid @RequestBody User user) { ... } > ``` --- ### 相关问题 1. 如何为枚举类型定义自定义验证器? 2. Jakarta Validation 中 `@Valid` 和 `@Validated` 有何区别? 3. 如何全局处理验证失败时的异常消息? 4. 在 Spring Boot 中如何自定义验证错误响应格式? [^1]: Jakarta Bean Validation 规范要求约束注解必须匹配目标类型,`@NotBlank` 仅支持 `CharSequence` 类型。 [^2]: 自定义验证器需实现 `ConstraintValidator` 接口并注册到约束注解。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值