项目目标部署环境: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里无处不在的依赖注入