一步一步创建ASP.NET MVC5程序[Repository+Autofac+Automapper+SqlSugar](八)
前言
Hi, 大家好,还是星期五,还是Rector,又在图享网准时和大家见面了。 今天给大家带来系列教程《一步一步创建ASP.NET MVC5程序[Repository+Autofac+Automapper+SqlSugar]》的第八期了,不知道你有没有按照教程将前七期的都实际练习一篇呢?如果是,你在练习的时候有没有遇到什么问题呢? 反正Rector是有收到部分童鞋发来他们练习过程中的问题反馈的哦。
如果你仔细阅读并实际练习了前面七期的教程,我相信,作为刚入门或者经验尚浅的你一定会有收获的。
加油吧,骚年!!! 人生苦短,就怕努力!!!
Rector这是要成为心理导师的节奏啊,一来就给大家灌饱心灵鸡汤。。。
**本文篇幅有点长,请作好心里准备!!! 同时,也吐个槽,本文看似内容简单的一B,但也花了笔者几个小时来准备示例以及写作,写技术文章真心伤不起 珍爱生命,远离程序!!! **
还是回到我们的正题,开始我们今天的系列教程:《一步一步创建ASP.NET MVC5程序Repository+Autofac+Automapper+SqlSugar》
本文知识要点
- 用户注册/登录功能设计与实现
设计用户表
这个表呢,Rector已经为大家准备好了,MySQL表结构如下:
SET FOREIGN_KEY_CHECKS = 0; -- ---------------------------- -- Table structure for ts_user -- ---------------------------- DROP TABLE IF EXISTS `tb_user`; CREATE TABLE `tb_user` ( `Id` int(10) NOT NULL AUTO_INCREMENT, `LoginName` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT '' COMMENT '登录名', `Password` varchar(150) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT '' COMMENT '密码', `DisplayName` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '' COMMENT '显示名称', `RealName` varchar(30) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '' COMMENT '真实姓名', `EmailAddress` varchar(120) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '' COMMENT '电子邮箱', `Avatar` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '' COMMENT '用户头像', `Status` int(2) NOT NULL DEFAULT 1 COMMENT '用户的状态,0:禁用,1:正常', `Telephone` varchar(20) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '' COMMENT '手机号码', `Qq` varchar(15) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '', `WebsiteUrl` varchar(200) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '', `CreatedOn` datetime(0) NULL DEFAULT NULL COMMENT '用户创建时间', `CreatedIp` varchar(24) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '' COMMENT '创建用户时的IP地址', `LoginCount` int(8) NULL DEFAULT 0 COMMENT '登录次数累加器', `LatestLoginDate` datetime(0) NULL DEFAULT NULL COMMENT '最近一次登录时间', `LatestLoginIp` varchar(24) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '' COMMENT '最近一次登录时的IP地址', `ModifiedOn` datetime(0) NULL DEFAULT NULL COMMENT '最近修改时间', `Type` int(2) NULL DEFAULT 0 COMMENT '用户类型[-1:超级管理员,0:一般用户]', PRIMARY KEY (`Id`) USING BTREE, UNIQUE INDEX `IX_LoginName`(`LoginName`) USING BTREE, UNIQUE INDEX `IX_EmailAddress`(`EmailAddress`) USING BTREE, INDEX `IX_CreatedOn`(`CreatedOn`) USING BTREE ) ENGINE = InnoDB AUTO_INCREMENT = 0 CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Dynamic; SET FOREIGN_KEY_CHECKS = 1;
请直接复制以上MySQL脚本,然后到对应数据执行即可,当然你也可以在这个版本的源码里面找到。 这个表就不准备提前写入示例数据了,一会我们用注册功能来写入数据。
创建领域实体和视图实体
在项目 【TsBlog.Domain】中的Entities文件夹中创建 User.cs 实体类:
using SqlSugar; using System; namespace TsBlog.Domain.Entities { [SugarTable("tb_user")] public class User { [SugarColumn(IsIdentity = true, IsPrimaryKey = true)] public int Id { get; set; } public string LoginName { get; set; } public string Password { get; set; } public string RealName { get; set; } public string EmailAddress { get; set; } public string Avatar { get; set; } public int Status { get; set; } public string Telephone { get; set; } public string Qq { get; set; } public string WebsiteUrl { get; set; } public DateTime CreatedOn { get; set; } public string CreatedIp { get; set; } public int LoginCount { get; set; } public DateTime? LatestLoginDate { get; set; } public string LatestLoginIp { get; set; } public DateTime? ModifiedOn { get; set; } public int Type { get; set; } } }
再在项目【TsBlog.ViewModel】中创建 User 的文件夹,并创建以下几个视图实体类
LoginViewModel.cs
using System.ComponentModel.DataAnnotations; namespace TsBlog.ViewModel.User { /// <summary> /// 用户登录视图实体 /// </summary> public class LoginViewModel { [Required(ErrorMessage = "请输入用户")] [Display(Name = "用户名")] public string UserName { get; set; } [Required(ErrorMessage = "请输入密码")] [Display(Name = "密码")] [DataType(DataType.Password)] public string Password { get; set; } } }
RegisterViewModel.cs
using System.ComponentModel.DataAnnotations; namespace TsBlog.ViewModel.User { /// <summary> /// 用户注册视图实体 /// </summary> public class RegisterViewModel { [Required(ErrorMessage = "请输入用户名")] [Display(Name = "用户名")] public string UserName { get; set; } [Required(ErrorMessage = "请输入密码")] [Display(Name = "密码")] [DataType(DataType.Password), MaxLength(20, ErrorMessage = "密码最大长度为20个字符"), MinLength(6, ErrorMessage = "密码最小长度为6个字符")] public string Password { get; set; } [Required(ErrorMessage = "请输入确认密码")] [Display(Name = "确认密码")] [DataType(DataType.Password), Compare("Password", ErrorMessage = "两次密码不一致")] public string ConfirmPassword { get; set; } } }
UserViewModel.cs:
using System; namespace TsBlog.ViewModel.User { /// <summary> /// 与领域用户实体对应的用户视图实体 /// </summary> public class UserViewModel { public int Id { get; set; } public string LoginName { get; set; } public string Password { get; set; } public string RealName { get; set; } public string EmailAddress { get; set; } public string Avatar { get; set; } public int Status { get; set; } public string Telephone { get; set; } public string Qq { get; set; } public string WebsiteUrl { get; set; } public DateTime CreatedOn { get; set; } public string CreatedIp { get; set; } public int LoginCount { get; set; } public DateTime? LatestLoginDate { get; set; } public string LatestLoginIp { get; set; } public DateTime? ModifiedOn { get; set; } public int Type { get; set; } } }
仓储层
在项目【TsBlog.Repositories】中创建 IUserRepository.cs 以及其实现类 UserRepository.cs。
IUserRepository.cs:
using TsBlog.Domain.Entities; namespace TsBlog.Repositories { public interface IUserRepository : IRepository<User> { } }
UserRepository.cs:
using TsBlog.Domain.Entities; namespace TsBlog.Repositories { public class UserRepository : GenericRepository<User>, IUserRepository { } }
服务层
在项目【TsBlog.Services】中创建 IUserService.cs 以及其实现类 UserService.cs。
IUserService.cs:
using TsBlog.Domain.Entities; namespace TsBlog.Services { public interface IUserService : IService<User> { User FindByLoginName(string loginName); } }
UserService.cs:
using TsBlog.Domain.Entities; using TsBlog.Repositories; namespace TsBlog.Services { public class UserService : GenericService<User>, IUserService { private readonly IUserRepository _repository; public UserService(IUserRepository repository) : base(repository) { _repository = repository; } public User FindByLoginName(string loginName) { return _repository.FindByClause(x => x.LoginName == loginName); } } }
创建加密类
在解决方案文件夹【1.Libraries】中创建一个新的项目,取名为【TsBlog.Core】,在此项目中先创建一个名为 Security的文件夹,再创建一个加密类 Encryptor.cs:
using System.Security.Cryptography; using System.Text; namespace TsBlog.Core.Security { /// <summary> /// 加密静态类 /// </summary> public static class Encryptor { //MD5加密一个字符串 public static string Md5Hash(string text) { MD5 md5 = new MD5CryptoServiceProvider(); md5.ComputeHash(Encoding.ASCII.GetBytes(text)); var result = md5.Hash; var strBuilder = new StringBuilder(); foreach (var t in result) { strBuilder.Append(t.ToString("x2")); } return strBuilder.ToString(); } } }
在用户注册或者登录时,我们将使用这个MD5加密用户的密码,并将其保存到数据库中(数据库中保存明文的密码是非常危险的,特别是在重要的安全级别很高的项目中,千(不)万(信)别(你)这(试)样(一)做(下)!!!)。
创建控制器
在项目【TsBlog.Frontend】中创建控制器 AccountController.cs,并添加如下代码:
AccountController.cs
using System; using System.Web.Mvc; using TsBlog.Core.Security; using TsBlog.Domain.Entities; using TsBlog.Services; using TsBlog.ViewModel.User; namespace TsBlog.Frontend.Controllers { /// <summary> /// 用户中心控制器 /// </summary> public class AccountController : Controller { /// <summary> /// 用户服务接口 /// </summary> private readonly IUserService _userService; public AccountController(IUserService userService) { _userService = userService; } /// <summary> /// 登录页面 /// </summary> /// <returns></returns> public ActionResult Login() { return View(); } /// <summary> /// 提交登录请求 /// </summary> /// <param name="model"></param> /// <returns></returns> [HttpPost, ValidateAntiForgeryToken, AllowAnonymous] public ActionResult Login(LoginViewModel model) { //如果视图模型中的属性没有验证通过,则返回到登录页面,要求用户重新填写 if (!ModelState.IsValid) { return View(model); } //根据用户登录名查询指定用户实体 var user = _userService.FindByLoginName(model.UserName.Trim()); //如果用户不存在,则携带错误消息并返回登录页面 if (user == null) { ModelState.AddModelError("error_message", "用户不存在"); return View(model); } //如果密码不匹配,则携带错误消息并返回登录页面 if (user.Password != Encryptor.Md5Hash(model.Password.Trim())) { ModelState.AddModelError("error_message", "密码错误,请重新登录"); return View(model); } //并用户实体保存到Session中 Session["user_account"] = user; //跳转到首页 return RedirectToAction("index", "home"); } /// <summary> /// 注册页面 /// </summary> /// <returns></returns> public ActionResult Register() { return View(); } /// <summary> /// 提交注册请求 /// </summary> /// <param name="model"></param> /// <returns></returns> [HttpPost, ValidateAntiForgeryToken, AllowAnonymous] public ActionResult Register(RegisterViewModel model) { //如果视图模型中的属性没有验证通过,则返回到注册页面,要求用户重新填写 if (!ModelState.IsValid) { return View(model); } //创建一个用户实体 var user = new User { LoginName = model.UserName, Password = Encryptor.Md5Hash(model.Password.Trim()), CreatedOn = DateTime.Now //由于是示例教程,所以其他字段不作填充了 }; //将用户实体对象写入数据库中 var ret = _userService.Insert(user); if (ret <= 0) { //如果注册失败,则携带错误消息并返回注册页面 ModelState.AddModelError("error_message", "注册失败"); return View(model); } //如果注册成功,则跳转到登录页面 return RedirectToAction("login"); } } }
添加必要JS库
由于之前我们将项目中的多余的JS库全部移除掉了,所以现在我们重新安装一下我们项目中将要到的一些JS库,包括:jQuery,Bootstrap等,都使用Nuget来安装,方便统一管理和升级。
安装jQuery:
安装Bootstrap:
安装jquery.validate.bootstrap:
安装完成后的JS库文件夹:
完成注册页面
在 [Views/Account]文件夹中创建注册页面视图 register.cshtml:
@model TsBlog.ViewModel.User.RegisterViewModel @{ Layout = null; } <!DOCTYPE html> <html> <head> <meta name="viewport" content="width=device-width" /> <title>用户注册</title> <style type="text/css"> * { box-sizing: border-box; } body { box-sizing: border-box; margin: 0; padding: 0; color: #333; } .account-container { position: absolute; margin: auto; top: 0; right: 0; bottom: 0; left: 0; width: 400px; height: 480px; background-color: #fff; /*border-radius: 3px;*/ box-shadow: 0 2px 2px 0 rgba(0,0,0,0.14), 0 3px 1px -2px rgba(0,0,0,0.12), 0 1px 5px 0 rgba(0,0,0,0.2); } .account-signin-container { margin-top: 15px; } .account-signin-container h1 { font-size: 20px; border-bottom: 2px solid #f7f7f7; margin: 0 0 15px; padding-bottom: 10px; padding-left: 15px; letter-spacing: 0.1em; } .account-form { padding: 15px; } .account-form .form-group { width: 100%; margin-bottom: 15px; } .account-form .form-group label { width: 100%; display: block; } .account-form .form-group input { border: 1px solid #ccc; line-height: 32px; font-size: 16px; padding: 2px 0px; padding-left: 5px; display: block; width: 100%; margin-top: 5px; } .account-form #btn_register { border: 0; background: #3b78e7; color: #fff; font-size: 18px; font-weight: bold; padding: 8px 25px; cursor: pointer; margin-top: 15px; display: inline-block; box-shadow: 0 2px 2px 0 rgba(0,0,0,0.14), 0 3px 1px -2px rgba(0,0,0,0.12), 0 1px 5px 0 rgba(0,0,0,0.2); border-radius: 3px; min-width: 100px; text-align: center; } .account-form #btn_register:hover { background: #4885F3; } span.error { color: #f00; } .btn-login { float: right; display: block; margin-top: 25px; color: #4885f3; } @@media(max-width:500px) { .account-container { width: 100%; height: 100vh; } } </style> </head> <body> <div class="account-container"> <div class="account-modal-container"> <div class="modal"></div> <div class="load-bar-container"> <div class="load-bar"> <div class="bar"></div> <div class="bar"></div> <div class="bar"></div> </div> </div> <div class="account-signin-container"> <h1>用户注册</h1> @using (Html.BeginForm("register", "account", FormMethod.Post, new { @class = "account-form", role = "form" })) { @Html.ValidationMessage("error_message", new { @class = "error" }) @Html.AntiForgeryToken() <div class="form-group"> <label> <span>登录名:</span> @Html.TextBoxFor(m => m.UserName, new { placeholder = "请输入登录名" }) @Html.ValidationMessageFor(m => m.UserName, "", new { @class = "error" }) </label> </div> <div class="form-group"> <label> <span>密码:</span> @Html.PasswordFor(m => m.Password, new { placeholder = "请输入密码" }) @Html.ValidationMessageFor(m => m.Password, "", new { @class = "error" }) </label> </div> <div class="form-group"> <label> <span>确认密码:</span> @Html.PasswordFor(m => m.ConfirmPassword, new { placeholder = "请输入确认密码" }) @Html.ValidationMessageFor(m => m.ConfirmPassword, "", new { @class = "error" }) </label> </div> <div class="form-group"> <button id="btn_register" type="submit">注 册</button> <a class="btn-login" href="~/account/login">登录</a> </div> } </div> </div> </div> <script src="~/Scripts/jquery-3.2.1.min.js"></script> <script src="~/Scripts/jquery.validate.min.js"></script> <script src="~/Scripts/jquery.validate.unobtrusive.min.js"></script> </body> </html>
再在当前文件夹下创建 login.cshtml 视图文件用作登录页面:
@model TsBlog.ViewModel.User.LoginViewModel @{ Layout = null; } <!DOCTYPE html> <html> <head> <meta name="viewport" content="width=device-width" /> <title>用户登录</title> <style type="text/css"> * { box-sizing: border-box; } body { box-sizing: border-box; margin: 0; padding: 0; color: #333; } .account-container { position: absolute; margin: auto; top: 0; right: 0; bottom: 0; left: 0; width: 400px; height: 450px; background-color: #fff; /*border-radius: 3px;*/ box-shadow: 0 2px 2px 0 rgba(0,0,0,0.14), 0 3px 1px -2px rgba(0,0,0,0.12), 0 1px 5px 0 rgba(0,0,0,0.2); } .account-signin-container { margin-top: 15px; } .account-signin-container h1 { font-size: 20px; border-bottom: 2px solid #f7f7f7; margin: 0 0 15px; padding-bottom: 10px; padding-left: 15px; letter-spacing: 0.1em; } .account-form { padding: 15px; } .account-form .form-group { width: 100%; margin-bottom: 15px; } .account-form .form-group label { width: 100%; display: block; } .account-form .form-group input { border: 1px solid #ccc; line-height: 32px; font-size: 16px; padding: 2px 0px; padding-left: 5px; display: block; width: 100%; margin-top: 5px; } .account-form #btn_login { border: 0; background: #3b78e7; color: #fff; font-size: 18px; font-weight: bold; padding: 8px 25px; cursor: pointer; margin-top: 15px; display: inline-block; box-shadow: 0 2px 2px 0 rgba(0,0,0,0.14), 0 3px 1px -2px rgba(0,0,0,0.12), 0 1px 5px 0 rgba(0,0,0,0.2); border-radius: 3px; min-width: 100px; text-align: center; } .account-form #btn_login:hover { background: #4885F3; } span.error { color: #f00; } .btn-register { float: right; display: block; margin-top: 25px; color: #4885f3; } @@media(max-width:500px) { .account-container { width: 100%; height: 100vh; } } </style> </head> <body> <div class="account-container"> <div class="account-modal-container"> <div class="modal"></div> <div class="load-bar-container"> <div class="load-bar"> <div class="bar"></div> <div class="bar"></div> <div class="bar"></div> </div> </div> <div class="account-signin-container"> <h1>用户登录</h1> @using (Html.BeginForm("login", "account", FormMethod.Post, new { @class = "account-form", role = "form" })) { @Html.ValidationMessage("error_message", new { @class = "error" }) @Html.AntiForgeryToken() <div class="form-group"> <label> <span>登录名:</span> @Html.TextBoxFor(m => m.UserName, new { placeholder = "请输入登录名" }) @Html.ValidationMessageFor(m => m.UserName, "", new { @class = "error" }) </label> </div> <div class="form-group"> <label> <span>密码:</span> @Html.PasswordFor(m => m.Password, new { placeholder = "请输入密码" }) @Html.ValidationMessageFor(m => m.Password, "", new { @class = "error" }) </label> </div> <div class="form-group"> <button id="btn_login" type="submit">登 录</button> <a class="btn-register" href="~/account/register">注册账号</a> </div> } </div> </div> </div> <script src="~/Scripts/jquery-3.2.1.min.js"></script> <script src="~/Scripts/jquery.validate.min.js"></script> <script src="~/Scripts/jquery.validate.unobtrusive.min.js"></script> <script src="~/res/assets/notie/notie.min.js"></script> </body> </html>
这两个页面均是响应式的布局,可适应不同设备。
好了,关于注册和登录的逻辑以及页面都完成了,那么运行项目,打开注册页面:http://localhost:54739/account/register,具体的注册请自行体验:
注册成功后,系统将带你到登录页面:
具体功能也请自行体验。
以上,我们只完成了注册和登录的基本功能,接下来我们来体验一下简单的权限访问,在本期教程之前,我们的: http://localhost:54739/home/index 以及 http://localhost:54739/home/post 是可以直接访问的,现在我们给这两个页面添加访问权限,即只有登录后才能访问,修改 HomeController.cs 如下:
using System.Web.Mvc; using TsBlog.AutoMapperConfig; using TsBlog.Services; namespace TsBlog.Frontend.Controllers { public class HomeController : Controller { private readonly IPostService _postService; public HomeController(IPostService postService) { _postService = postService; } public ActionResult Index() { //如果未登录,则跳转到登录页面 if (Session["user_account"] == null) { return RedirectToAction("login", "account"); } return View(); } public ActionResult Post() { //如果未登录,则跳转到登录页面 if (Session["user_account"] == null) { return RedirectToAction("login", "account"); } var post = _postService.FindById(1).ToModel(); return View(post); } } }
重新编译项目,按F5运行,再打开地址:http://localhost:54739/home/index ,发生了什么情况? 是不是被重定向到了登录页面,要求你登录? 这就对了,输入你刚才注册的用户名和密码,登录后,系统会重新带你到:http://localhost:54739/home/index 页面。
OK,今天这期的关于用户注册和登录功能就介绍到这里,本期只实现了简单的功能,在后续的教程中将重构和封装相应的功能代码,敬请期待。。。
如果你喜欢Rector的本系列文章,请为我点个大大的赞。
看完教程如果觉得还不过瘾的,遇到问题的,想“勾对”的,欢迎加入图享网官方QQ群:483350228。有什么,你懂的。。。
谢谢你的耐心阅读,未完待续,我们下期再见……
本期源码托管,请至首发地址获取-- 《一步一步创建ASP.NET MVC5程序[Repository+Autofac+Automapper+SqlSugar](八)》
数据库脚本文件请到目录下获取:TsBlog\document\scripts\mysql\v1.8\
本文来源自 图享网 《一步一步创建ASP.NET MVC5程序[Repository+Autofac+Automapper+SqlSugar](八)》
推荐阅读
-
一步一步创建ASP.NET MVC5程序[Repository+Autofac+Automapper+SqlSugar](十一)
-
一步一步创建ASP.NET MVC5程序[Repository+Autofac+Automapper+SqlSugar](九)
-
一步一步创建ASP.NET MVC5程序[Repository+Autofac+Automapper+SqlSugar](八)
-
一步一步创建ASP.NET MVC5程序[Repository+Autofac+Automapper+SqlSugar](十一)
-
一步一步创建ASP.NET MVC5程序[Repository+Autofac+Automapper+SqlSugar](八)
-
一步一步创建ASP.NET MVC5程序[Repository+Autofac+Automapper+SqlSugar](九)