一、启语
前面我们说到,模型验证的原理(包含1、项目创建,2、模型创建,3、走通测试模型验证,4、在过滤器中处理返回json格式(非控制器内))-完全是新手理解使用的,新番理解
通常情况下,对于那些经常为别人提供数据接口的开发人员来说,对于调用方传递过来的参数都会有验证处理。例如:
if (string.IsNullOrEmpty(entity.Name)){ //当姓名为空时,.........}if (entity.Age<0 || entity.Age>100){ //当年龄小于0或大于100时,有的人可能超过一百岁,我希望我的有生之年Age>100,emm,.........} if (string.IsNullOrEmpty(entity.PhoneNum)){ //当电话号码为空时,.........}if (!string.IsNullOrEmpty(entity.PhoneNum)){ Regex regex = new Regex("^1[34578]\\d{9}$"); var result=regex.IsMatch(entity.PhoneNum); if (!result) { //当电话号码格式不合法时,......... }}//以下还有50个字段需要验证,是不是有种绝望的感觉,有木有?有木有?有人可能会跟调用者说,某个字段必须怎么怎么样,有些人就喜欢故意传错,故意刁钻,到头来,最苦逼的还是写接口的人。
有时候一个系统有十几二个接口,光验证的代码就一大堆,真的有时候不想写,都说程序猿是最聪明的一批人,自然有好的解决方法。
C# webapi 有一种叫模型验证的东西,在java里面,应该有一种注解的东西可以处理。
在ASP.NET Web API中,你可以使用命名空间的注解属性来设置模型属性的验证规则。考虑以下模型:
using System;using System.Collections.Generic;using System.Linq;using System.Web;using System.ComponentModel.DataAnnotations;namespace WebApi.Models{ public class Personnel { [Required(ErrorMessage = "Name参数不能为空")]//Required 验证这个参数不能为空 ErrorMessage:为空时自定义错误信息 public string Name { get; set; } [Required(ErrorMessage = "Age参数不能为空")] [Range(1, 100, ErrorMessage = "Age参数只能是大于1,小于100")]//Range 验证值只能在某些范围内,只适用于Int类型的字段 public int Age { get; set; } [Required(ErrorMessage = "电话号不能为空")] [RegularExpression("^[1]+[3,4,5,7,8]+\\d{9}", ErrorMessage = "PhoneNum不合法的电话号码格式")]//RegularExpression 用正则验证字段的合法性,多用于身份证、电话号码、邮箱、等等... public string PhoneNum { get; set; } }}
这样的话就可以节省大量冗余代码,那么,接下来如何去处理呢?
在接口请求之前,我们可以对客户端传过来的数据进行模型验证处理,对于webapi比较熟悉的人应该知道过滤器,不知道的可以看我前面的文章,如何使用webapi三大过滤器,过滤器是基于AOP,面向切面的编程思想。
在这里我们用的ActionFilterAttribute过滤器,只要继承这个接口并且实现其中的OnActionExecuting方法就行。具体实现如下:
方式一:
using System.Collections.Generic;using System.Linq;using System.Net;using System.Net.Http;using System.Web.Http.Controllers;using System.Web.Http.Filters;using System.Web.Http.ModelBinding;namespace WebApi.Filters{ public class ValidateModelAttribute : ActionFilterAttribute { public override void OnActionExecuting(HttpActionContext actionContext) { if (actionContext.ModelState.IsValid == false) { // Return the validation errors in the response body. // 在响应体中返回验证错误信息 var errors = new Dictionary>(); foreach (KeyValuePair keyValue in actionContext.ModelState) { errors[keyValue.Key] = keyValue.Value.Errors.Select(e => e.ErrorMessage); } actionContext.Response = actionContext.Request.CreateResponse(HttpStatusCode.BadRequest, new { code = HttpStatusCode.BadRequest,//返回客户端的状态码 success = false, error = errors//显示验证错误的信息 }); } } }}
方式二:
using System.Collections.Generic;using System.Linq;using System.Net;using System.Net.Http;using System.Web.Http.Controllers;using System.Web.Http.Filters;using System.Web.Http.ModelBinding;namespace WebApi.Filters{ public class ValidateModelAttribute : ActionFilterAttribute { public override void OnActionExecuting(HttpActionContext actionContext) { if (actionContext.ModelState.IsValid == false) { //如果验证是吧,只取第一个错误信息返回 //var item = actionContext.ModelState.Values.Take(1).SingleOrDefault(); //var errors = item.Errors.Where(b => !string.IsNullOrWhiteSpace(b.ErrorMessage)).Take(1).SingleOrDefault().ErrorMessage; //直接获取 var error=actionContext.ModelState.Values.First().Errors.First().ErrorMessage ; actionContext.Response = actionContext.Request.CreateResponse(HttpStatusCode.BadRequest, new { code = HttpStatusCode.BadRequest,//返回客户端的状态码 success = false, error = error//显示验证错误的信息 }); } } }}
注意:Model必须不能为null,正则的验证,必须满足必选项(即有值才会触发正则进行验证-一般前端键名肯定会传的,除非恶意,只请求,而不传参出现这种情况,我这边也要想办法处理 null)。
//