第五章 .net core该怎么玩
项目目标部署环境:CentOS 7+
项目技术点:.netcore2.0 + Autofac +webAPI + NHibernate5.1 + mysql5.6 + nginx
开源地址:https://github.com/wmowm/nh.core
很多小伙伴,初识.net core都不知道如何下手,从哪里开始学习,这让我想起群里经常有小伙伴问,mvc怎么学习?
我觉得,第一步应该找到一个切入点,这里先说mvc,我们分三种情况来分析
1.萌新
我个人觉得,xxx从入门到精通,是不适合去学习的,特别是萌新,这样走马观花的看一遍,根本就起不到任何作用
最好的方法就是用mvc做一些简单的demo,登录,注册,crud.... 这就是切入点
2.从webform转入mvc
直接看mvc的路由,分部页,借助网上的一些资料即可,边做边查,mvc就非常简单了
3.从别的语言转入asp.net
熟悉asp.net的一些特性即可,mvc的设计模式是共通的
回归正题那.net core怎么玩?
还是找切入点,这里我就拿2年asp.net开发经验为原型
切入点就是造轮子,先找我们最熟悉的地方,一步步开始搭建.net core项目
我们这次的轮子是通过web api 实现CRUD,这里我的IDE是vs2017,SDK是.net core 21.4, let's go~~~
第一步,创建一个web api,这里贴出我在使用中遇到的坑
1.RestFul Action共存
在get情况下,相同路由的Action无法共存,运行报错会匹配到多个Action
在post情况下,相同路由的Action可以共存,会存在优先级,但是只会执行一个正则匹配到的Action
2.RestFul 相同路由的Action如何并存,并访问指定的Action
[Route("list"),HttpPost]
路由如下 api/{controller}/list
3.RestFul 如何设置多参数,
[Route("list"),HttpPost("{a}/{b}/{c}")]
路由如下 api/{controller}/list/1/2/3
4.Post提交多参数,[FromBody] 跨域问题
去注册中间件,让webapi支持跨域
5.Post提交多参数,[FromBody] ajax提交类型错误
必须设置:contentType: 'application/json; charset=urf-8'
参数必须格式化成json字符串: data: JSON.stringify(data)
6.关于[FromBody]标识的参数不能设置基础类型,如string...
错误说法,可以设置成string类型
7.为什么Post提交参数必须要标识[FromBody]
[FromBody]表示该参数值应该从请求的Body中获取，而不是从URL中获取,URL有长度限制
在不超过长度限制的情况下,可以随意
第二步,实现web api CRUD
[HttpGet] public async Task<JsonResult> Get(int id) { return await Task.Run<JsonResult>(() => { Common.Json json = new Common.Json(); var model = _UsersService.Get(id); json.data = model; return Json(json); }); }
通过id获取实体对象,这里非常好理解,我们直接去看这个返回的json对象
/// <summary> /// 返回的Json模型 /// </summary> public class Json { private int _status = 0; /// <summary> /// 状态 -1失败,0成功 /// </summary> public int status { get { return _status; } set { _status = value; } } public string pitchId { get; set; }//要定位的页面元素id public string msg { get; set; }//消息 public string returnUrl { get; set; }//跳转的页面 public object data { get; set; }//数据 public int total { get; set; }//总条数 }
这里还加一个属性,显示响应状态,例如token验证不通过,服务端错误500,资源未找到404.....
[Route("getlist"),HttpPost] public async Task<JsonResult> GetList([FromBody]Dictionary<string, dynamic> dic) { return await Task.Run<JsonResult>(() => { Json json = new Common.Json(); //自定义参数模板 List<SearchTemplate> st = new List<SearchTemplate>(); //自定义排序模板 List<SortOrder> order = new List<SortOrder>(); //对参数的操作 foreach (var item in dic.Keys) { //根据用户名模糊查询 if (item == "user_name") { st.Add(new SearchTemplate() { key = "user_name", value = dic[item], searchType = EnumBase.SearchType.Like }); } //根据用户名模糊查询 if (item == "mobile") { st.Add(new SearchTemplate() { key = "mobile", value = dic[item], searchType = EnumBase.SearchType.Like }); } //排序 if (item == "order") { var str = JsonConvert.SerializeObject(dic[item]); order = JsonConvert.DeserializeObject<List<SortOrder>>(str); } //分页 if (item == "paging") { var str = JsonConvert.SerializeObject(dic[item]); int [] paging = JsonConvert.DeserializeObject<int[]>(str); st.Add(new SearchTemplate() { key = "", value = paging, searchType = Common.EnumBase.SearchType.Paging }); } //后面可以根据业务拓展查询条件 } var list = _UsersService.GetList(st, order); var list_count = _UsersService.GetCount(st); json.data = list; json.total = list_count; return Json(json); }); }
前端提交方法
function getlist() { var param = { //"user_name": "admin", "order": [{ "searchType": 1, "value": "id" }], "paging": [1, 10] }; $.ajax({ type: "post", url: path + "/api/user/getlist", data: JSON.stringify(param), async: false, contentType: 'application/json; charset=urf-8', beforeSend: function (xhr) { xhr.setRequestHeader("token", $("#token").html()); }, success: function (data, status) { if (data.status != 0) { alert(data.msg); } else { vm.list = data.data; } } }); }
param 是一个json对象,它由三个部分组成 查询参数:key/value ,排序数组 ,分页数组
后台解析这些参数,我这里用的是动态解析,这样就不用每个model创建一个dto,在NHibernate里我使用的是查询器模式,我只需要把解析的参数填充到查询器即可
这里我自定义了两个模板一个用来传参分页,一个用来排序
[Serializable] public class SearchTemplate { /// <summary> /// 要查询的属性(对应Model里的属性) /// </summary> public string key { get; set; } /// <summary> /// 要查询的属性的值(对应Model里的属性得值) /// </summary> public object value { get; set; } /// <summary> /// 查询类型(>,=,In.....) /// </summary> public Common.EnumBase.SearchType searchType { get; set; } } [Serializable] public class SortOrder { /// <summary> /// 排序方式(Asc,Desc) /// </summary> public Common.EnumBase.OrderType searchType { get; set; } /// <summary> /// 要排序的属性(对应Model里的属性) /// </summary> public string value { get; set; }
查询条件是最容易变更的地方,要考虑到后期拓展,用这种方式是非常好的解决方案,这也体现了NHibernate的强大,除了查询器模式,还是有HQL,Linq,Lamdba....
后面是添加,修改,删除,都非常的简单
[HttpPost] public async Task<JsonResult> Add(Users user) { return await Task.Run<JsonResult>(() => { Json json = new Common.Json(); if (string.IsNullOrEmpty(user.user_name)) { json.msg = "用户名不能为空!"; json.status = -1; return Json(json); } var id = _UsersService.Save(user); json.data = id; json.msg = "添加成功!"; return Json(json); }); }
[HttpPut] public async Task<JsonResult> Edit(Users user) { return await Task.Run<JsonResult>(() => { Json json = new Common.Json(); _UsersService.Update(user); json.msg = "修改成功!"; return Json(json); }); }
[HttpDelete] public async Task<JsonResult> Delete(string ids) { return await Task.Run<JsonResult>(() => { //自定义返回json对象 Json json = new Json(); foreach (var id in ids.Split(new char[] { ',' })) { var m_nt = _UsersService.Get(Convert.ToInt32(id)); m_nt.is_del = 1; _UsersService.Update(m_nt); } json.msg = "成功删除" + ids.Split(new char[] { ',' }).Length + "条记录!"; return Json(json); }); }
这样我们就实现了简单的CRUD,这里存在两个问题
1.json里的时间格式
2.跨域
下章我们将讲解.net core里无处不在的依赖注入
