这里将要和大家分享的是学习总结第三篇;首先感慨一下这周跟随netcore官网学习是遇到的一些问题:
a.官网的英文版教程使用的部分nuget包和我当时安装的最新包版本不一致,所以没法按照教材上给出的列子测试实例,官网给出的一句话暂未发布最新包
b.某些资料不够详细只是一句话,加上网速慢,查阅资料不行啊
好了,感慨完后,下面是本篇将要分享的学习步奏,对于刚学或者即将要学习的朋友做个相互交流:
1.Model Validation(实体模型验证)
2.自定义验证属性
3.创建一个接口支持返回json,xml两种数据格式
下面一步一个脚印的来分享:
1.Model Validation(实体模型验证)
实体模型验证,直接通过添加注解的方式来定义需要验证的格式,要使用注解必须在实体类文件中引用System.ComponentModel.DataAnnotations该命名空间,写法如下:
红色框里面的就是用法,直接写在属性字段上方中括号('[]')括起来,小括号('()')里面是传递的参数,这里截图用到了Required:必填,StringLength(100):最小输入字符长度100,ClasssicMoive(1960):自定义验证,DataType(DataType.Date):属性为日期格式;还有很多常用的验证特性,具体可以去这个地址:https://docs.asp.net/en/latest/mvc/models/validation.html;
这里重点说这两个:
Remote(使用远程验证):通俗一点讲就是通过指定的路由去后台验证该属性的值知否有效,属于服务器验证;方法的实例用法如下(这里介绍一种用法,至于重载的方法各位可以试试):
这里需要的参数是routeName:就是路由,后面的一些属性非必填,咋们按照默认的来写一个
首先,定义一个验证是否包含有Blogs字样的路由,代码如下:
[AcceptVerbs("Get", "Post")]
public JsonResult IsContainerBlogs(string title)
{ if (!title.Contains("Blogs") || string.IsNullOrEmpty(title))
{ return Json("Title里面没有Blogs字样!");
}
return Json(true);
}
这里的特性AcceptVerbs,主要是用来限制只允许get,post请求
然后,定义个文章实体如下格式:
public class Article
{
[Required]
public int ID { get; set; } [Remote(action: "IsContainerBlogs", controller: "ArticlesFormat")]
public string Title { get; set; }
public DateTime CreateTime { get; set; }
}
并且通过自动生成对应的View和Controller(这里主要演示remote效果,具体生成view和Controller操作可以参照前面写的一篇: NET Core-学习笔记(一)),好的咋们启动dotnet run命令,访问创建文章的页面,先来看下Title属性生成的html代码:
红框的部分路径就是咋们之前在实体里面指定的Action和Controller的路由,再来看下效果:
没有Blogs会提示刚才路由定义方法返回的错误信息,
有Blogs的Title结果直接添加成功,
RegularExpression(使用正则写法验证):按照自定义的RegExp规则来验证数据的有效性;
还是用Title做例子,注释掉之前的Remote,换成RegularExpression,代码如:[RegularExpression(pattern:"d+",ErrorMessage ="不符合正则规则")],这里限制Title内容只能是数字,我们运行测试结果如下:
2.自定义验证属性
要实现自定义模型验证,需要继承:System.ComponentModel.DataAnnotations.ValidationAttribute,这里直接上代码,更详细的说明看下在代码注释里面创建一个ModelRegexExtendAttribute类继承ValidationAttribute:
public class ModelRegexExtendAttribute : ValidationAttribute
{
private string _pattern;
public ModelRegexExtendAttribute(string pattern = @"\d+", string errorMessage = "必须满足正则")
{
_pattern = pattern;
this.ErrorMessage = errorMessage;
} protected override ValidationResult IsValid(object value, ValidationContext validationContext)
{
//validationContext.DisplayName:指定某个实体类的属性
//获取指定属性的相关属性信息
var t = validationContext.ObjectType.GetProperty(validationContext.DisplayName);
//获取对应属性的值
var p = t.GetValue(validationContext.ObjectInstance, null); //做正则做匹配
if (Regex.IsMatch(p.ToString().ToUpper(), _pattern))
{ return ValidationResult.Success;
} return new ValidationResult(this.ErrorMessage);
} }
使用这个这个自定义的验证,和上面的验证是一样的:
测试的话,重新运行dotnet run,然后刷新刚才添加文字的页面,具体验证操作和上面一样
3.创建一个接口支持返回json,xml两种数据格式
首先,我们创建一个名为ArticlesFormatController的Controller(其实就是第二点说的那个Controller),然后通过注入ApplicationDbContext访问文章的列表数据(这里大家可以看下 学习笔记(一)的链接数据库),ArticlesFormatController具体实现的方法有:
public class ArticlesFormatController : Controller
{ private readonly ApplicationDbContext _context; public ArticlesFormatController(ApplicationDbContext context)
{ _context = context;
} [Route("[controller]/[action]")]
public async Task<List<Article>> GetArticles()
{ return await _context.Article.ToListAsync();
} //[Route("[controller]/[action]/{id}.{format?}")]
public async Task<Article> GetArticle(int? id)
{ if (id == null)
{ return new Article();
}
return await _context.Article.Where(b => b.ID == id).SingleOrDefaultAsync();
} public string GetArticleName(int? id)
{
if (id == null)
{ return string.Empty;
}
return _context.Article.Where(b => b.ID == id).SingleOrDefaultAsync().Result.Title;
} [AcceptVerbs("Get", "Post")]
public JsonResult IsContainerBlogs(string title)
{ if (!title.Contains("Blogs") || string.IsNullOrEmpty(title))
{ return Json("Title里面没有Blogs字样!");
}
return Json(true);
} }
此时在浏览器访问文章列表的路由:http://localhost:5000/ArticlesFormat/GetArticles得到如下图:
此时定义的Controller返回的是json数据,这个是框架默认的返回json;
接下来,在Startup.cs文件的ConfigureServices服务方法中,找到默认生成的services.AddMvc()代码,我们改造成这样:
services.AddMvc(op =>
{ op.OutputFormatters.Add(new XmlSerializerOutputFormatter());
}).AddXmlSerializerFormatters();
生成的时候会报错,直接复制我这里的代码有问题,因为找不到某个包,这里需要通过nuget添加:Microsoft.AspNetCore.Mvc.Formatters.Xml包到项目中:
ok,此时再Startup.cs中就可以直接引用一个空间:using Microsoft.AspNetCore.Mvc.Formatters然后再生成下项目,这样是否不编译错误了呢;
接着,dotnet run再次运行启动项目,浏览器直接访问http://localhost:5000/ArticlesFormat/GetArticles出来的还是json数据,有些失望的感觉,但是通常接口形式都会指定接收属性类型Accept的类型,那么我们这样试试,使用DHCgoogle插件(其实就是post,get访问工具);
先来一个json数据:
截图有点大勿喷,再来一个xml返回的数据:
最后的图有点长,希望审核人员不要在意,这里的返回json和xml格式的数据方式就完成了,大家可以试试,今天就分享到这里,谢谢。