题外话:
接上篇吧。上篇主要是介绍下LayUI的使用,太兴奋手打代码去了- -。
其实这个项目用了Unity这个IOC框架,毕竟人要有梦想。感兴趣的可以自己去了解下,后面有机会会说说对于IOC和DI的个人拙见以及Unity的使用。
进入正题。
二.WebApi
一个有梦想的咸鱼做的一个有梦想的demo项目就需要有梦想的考虑后期维护与扩展,那么就需要从建项目开始做好文件分类。
打开VS,选择ASP .NET Web应用程序(.NET Framework)创建一个新的项目命名Demo,然后选择Web Api,然后建立项目。注意看项目下有个Area的文件夹,作用呢其实就是可以区分控制器,方便管理,而且控制器名称可以重名。
毕竟是个B/S项目,后台所接收的请求都属于http请求,要处理这些请求后台,就会涉及到安全问题,也就是权限问题,毕竟要有梦想,还是可以发布上服务器的。而这个安全问题并不是只用用户登录验证就能解决的,这时候就会涉及到权限问题,参考淘宝,你可以随意浏览,但是一些额外操作则需要登录。
所以这里我是考虑FormsAuthenticationTicket身份验证配合授权属性AuthorizeAttribute。
Ticket,顾名思义,想入场看比赛是需要门票的,那么想进入自己的网站或者有数据库操作时,我们可以为用户设置门票。
进而小朋友些许问号,演唱会门票还有前排后排区别,考虑到实际应用情况,我们是否也需要对于用户进行权限区分,这样比较符合实际情况?这样是否更灵活?用户与角色都能去控制
Controller的权限是否更科学?没错,尤其是MVC项目,但是这里先不考虑这么多,我们后台只提供接口服务。这里我只是提供一个思路,因为要做一个大度的人,只要人进得来,场地自由活动好吧。(就是懒~)
所以会需要使用到授权属性AuthorizeAttribute类。
- AuthorizeAttribute
AuthorizeAttribute类是.Net Framework框架下提供写好的一个类,Authorization(授权)属于过滤器的一种。
这里可以提下当引用AuthorizeAttribute类时方法的执行过程。当给某一个 Controller 指定一个权限认证特性后,当程序需要调用这个Controller时,会先进入namespace为System.Web.Http的AuthorizeAttribute公共类,而后首先会执行AuthorizeAttribute 中的 OnAuthorization 方法,在 OnAuthorization 函数的执行过程中,如果验证失败了,系统会调用 HandleUnauthorizedRequest方法来进行处理,基于此原理,我们可以重写这两个方法,然后自定义自己的AuthorizeAttribute。而如果想提供匿名访问服务,即调用Controller时不进入AuthorizeAttribute,它提供了AllowAnonymousAttribute属性,字面意思也知道。
基于上述的执行过程,既然是虚函数,我们重写他的两个主要方法。
首先,新建文件夹Filter,文件夹下新建一个继承于AuthorizeAttribute的类,以XXAuthorizeAttribute命名,XX则就是自定义的特性名称。我这里是ApiAuthorizeAttribute。
首先重写OnAuthorization(HttpActionContext actionContext)。
/// <summary>
/// api权限特性
/// </summary>
[AttributeUsage(AttributeTargets.Class|AttributeTargets.Method)]
public class ApiAuthorizeAttribute : AuthorizeAttribute
{
public override void OnAuthorization(HttpActionContext actionContext)
{
var authorization = actionContext.Request.Headers.Authorization;
if (actionContext.ActionDescriptor.GetCustomAttributes<AllowAnonymousAttribute>(true).Count != 0
|| actionContext.ActionDescriptor.ControllerDescriptor.GetCustomAttributes<AllowAnonymousAttribute>(true).Count != 0)
{
base.OnAuthorization(actionContext);//正确的访问方法
}
else
{
if (authorization != null && authorization.Parameter != null)
{this.HandleUnauthorizedRequest(actionContext);//没有权限
}
else
{
this.HandleUnauthorizedRequest(actionContext);//没有权限
}
}
}
protected override void HandleUnauthorizedRequest(HttpActionContext actionContext)
{
base.HandleUnauthorizedRequest(actionContext);
}
}
梳理下逻辑:
首先,通过HttpActionContext 获得我们在ajax中传入的Requset.Headers.Authorization.
然后,通过判断是否有AllowAnonymousAttribute标识。
结合实际场景来理解这一步,还是上文例子。我总不可能一个演唱会主角还没进场就给保安拦着了要我出示票据???我自己唱歌难道还要自己出钱买票欸?好气哦是不是?
是的,如果你是保安你就被喷了,那一样的,如果你是这个项目的开发者,整个项目运行起来就没一个人能登录进来,连你自己都进不去,所以考虑实际开发不要反人类逻辑思考,那么就提供了AllowAnonymousAttribute。通过在控制器上加上[AllowAnonymous],相当于走绿色通道不要门票,那么这个最应该放在哪呢?
如果没有关系走不了后门,那么就老实判断有无门票。
然后如果没有,保安赶人,也就是进入HandleUnauthorizedRequest方法,这是会直接将页面重定向到登录页面。当然你要是宅心仁厚是个文化人,不想要保安如此粗鲁,自己重写代码
返回一段现在最流行的Json数据问问施主可还有其他诉求。
这里就会涉及到一个问题,WebApi的返回值是不支持的Json格式的,如果又不想更改配置,那么可以利用HttpResponseMessage返回Json。
return new HttpResponseMessage()
{
Content = new StringContent("string", Encoding.UTF8, "application/json"),
};
这一步做完,是不是觉得终于可以进行激动人心的登录仪式了?
想什么呢,什么都没有。数据库你都没有呢朋友。建库建表都还没进行呢。
- ORM
- Entity Framework
Object Relational Mapping,对象关系映射。
这个内容很多,这里使用Entity Framework,毕竟.Net一套。至于为什么,最直接的就是因为不想写SQL语句而且安全,这理由还不充分吗?不行你往你自己用SQL语句写的登录网站试试输入' or 1 = 1 --',看看会不会有惊喜?有惊喜的少年恭喜你真的很适合看我的博客,给个关注给个推荐谢谢嗷。
下个定义:EF是微软基于ADO .Net而开发的一套跨数据库的ORM框架(hhhhhh这里就不做过多赘述了,资料很多,我自己也写了一个Word文档,如果全小白自学的可以联系我发给你哈哈哈,其实后面会单独写EF的,还会浅谈下自学的Entity Framework Core,毕竟我也很菜)
在解决方案Demo下建立Data文件夹,文件夹下新建一个.Net Frameworek的类库,取名Domain,Domain类库下建立Models文件夹,此文件夹下建立实体类。
建库建表时就要考虑到项目需求问题,这点很重要很重要很重要,这也是有无项目经验的主要体现。加粗加红好了。
因为是个简单教程,那么我这个项目,目前先做个做个能给每个公司提供管理员工,管理自己公司信息报表的简单平台。后期纵向横向发展那些再说。比如加个department表之类的,然后再来个上级管理,下级管理啊啧啧啧,少年自己冲。
我们先建立简单的三张表,一张员工表,提供账号密码以及简单个人信息问题。一张账号信息表,方便记录一些账号操作行为。一张公司表,提供基础信息。
公司与员工的关系,员工与账号的关系,设置一个公司有一个管理账号,那么又有管理账号与普通账号的关系,又会有角色区别。
建表时,考虑到更新性原因,尽量不适用外键,所有依赖关系通过自己去思考,比如账号信息表是不是应该有个用户ID字段,以便于进行联表操作之类,同时对于删除问题,可以根据不同情景,去考虑使用物理删除还是逻辑删除。
这里简单提下物理删除和逻辑删除的区别:物理删除是删除数据库中的数据,不具有恢复性。而逻辑删除,不删除数据库中的数据,而是通过一些自定义的Flag去判断,可以理解为黑名单,你可以表格中设置bool 类型字段deleteSian,为true时可以使用,为false时拉黑,禁用,当需要时可以解除拉黑。
EmployeeModel类:
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace Demo.Domain.Models
{
[Table("EmployeesInfo")]
public class EmployeesInfoModel
{
[Key]
public int EmployeesID { get; set; }
public int CompanyID { get; set; }
/// <summary>
/// 员工姓名
/// </summary>
public string Name { get; set; }
/// <summary>
/// 性别
/// </summary>
public string Sex { get; set; }
/// <summary>
/// 工号
/// </summary>
public string JobNumber { get; set; }
/// <summary>
/// 员工电话
/// </summary>
public string Mobile { get; set; }
/// <summary>
/// 账号
/// </summary>
public string AccountNum { get; set; }
/// <summary>
/// 密码
/// </summary>
public string PassWords { get; set; }
/// <summary>
/// 账号身份
/// </summary>
public int AccountRole { get; set; }
/// <summary>
/// 员工职位
/// </summary>
public int EmployeeRole { get; set; }
public bool deleteSign { get; set; }
}
}
AccountInfoModel类:
using System;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace Demo.Domain.Models
{
[Table("AccountInfo")]
public class AccountInfoModel
{
[Key]
public int AccountID { get; set; }
/// <summary>
/// 账号名
/// </summary>
public string AccountName { get; set; }
public int EmployeesID { get; set; }
/// <summary>
/// 管理查询
/// </summary>
public int CompanyID { get; set; }
/// <summary>
/// 登陆次数
/// </summary>
public int LoginCount { get; set; }
/// <summary>
/// 开号时间
/// </summary>
public DateTime? CreateTime { get; set; }
public string CreateIP { get; set; }
/// <summary>
/// 最后登陆时间
/// </summary>
public DateTime? LastLoginTime { get; set; }
public string LastLoginIP { get; set; }
}
}
CompanyInfoModel类:
using System;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace Demo.Domain.Models
{
[Table("CompanyInfo")]
public class CompanyInfoModel
{
/// <summary>
/// 编号
/// </summary>
[Key]
public int CompanyID { get; set; }
/// <summary>
/// 省
/// </summary>
public string Province { get; set; }
/// <summary>
/// 市
/// </summary>
public string City { get; set; }
/// <summary>
/// 区
/// </summary>
public string Area { get; set; }
/// <summary>
/// 全称
/// </summary>
public string FullName { get; set; }
/// <summary>
/// 组织机构代码
/// </summary>
public string Organizationcode { get; set; }
public string Mobile { get; set; }
public int Power { get; set; }
public bool deleteSign { get; set; }
}
/// <summary>
/// 管理范围
/// </summary>
//public enum Power
//{
// 全部 = 0,
// 多区 = 1,
// 单区 = 2
//}
///// <summary>
///// 账号身份
///// </summary>
//public enum AccountRole
//{
// 管理登录 = 0,
// 普通登录 = 1
//}
///// <summary>
///// 员工身份
///// </summary>
//public enum EmployeeRole
//{
// 部门主管 = 0,
// 普通员工 = 1
//}
}
也可以使用枚举,这里我还是没用了。但是意思就是这么个意思哈哈哈哈。
通过EF建库建表完成之后,是不是觉得终于可以进行激动人心的登录仪式了?
对的,没错。
但是,
最近忙,饿了,回家做饭。下回分解。逃。