AspNetCore - MVC实战系列目录

开篇唠嗑

这实战第三章，也就是本章的时候为了响应博友们的要求，已经把爱留图网站的代码开源到了git了，也为了NetCore的美好明天贡献自己微薄的一份力，尽管已经开源了源码，我还是会坚持写完netcore实战系列的博文，希望大家多多支持；还有就是今天为了缓解51假期综合征能进入学习正规，早上习惯性的打开博客园，让我吃惊了，看着今天编辑推荐的博文还以为博客园出现什么故障了，如此不堪的文章尽然被编辑推荐，我在想怎么了是审核人员的不负责么，要说不负责为什么我写了这么久的博文，一篇都没被编辑推荐过呢呵呵，这里还是希望博客园能对内容的审核更严谨，而不是马马虎虎，毕竟我们很多人还是支持园区的；

个人中心模块设计

对于一个暂时只有上传，点赞，阅览的雏形网站来说，个人中心没有太多能够展示的，因此我这里把用户常用操作的记录也展示出来了，和个简单的统计模块，所以就有了以下的个人中心模块：

由上图能够看到内容不多，但是从技术角度上来说也涉及到了几个知识点和注意事项；

代码知识点分享

获取客户端ip和服务端ip+port

首先我们就从用户记录日志开始讲起，对刚刚使用netcore的朋友，对怎么获取操作人的ip有点疑惑，这里我就分享下我的经验，避免您们再做各种测试或者查资料了，这里我为了代码使用方便，直接通过静态扩展方法对Controller扩展了获取ip的方法：

   public static string GetUserIp(this Controller controller)

   {

       return controller.HttpContext.Connection.RemoteIpAddress.ToString();

   }

没错客户端的ip信息存储于 HttpContext.Connection 中，上面是获取ip再来分享怎么获取网站的host和port吧，只需要使用 Request.Host 的代码：

 var appUrl = $"http://{Request.Host.Host}:{Request.Host.Port}"

验证用户是否登录

对于个人中心来说往往需要验证用户是否登录，也就是是否存在咋们说通session，同样为了方便我重写了一个父Controller，凡是需要登录验证的Controller都继承于她：

  public class BaseController : Controller

     {

         public MoUserInfo _MyUserInfo;

         public override void OnActionExecuting(ActionExecutingContext context)

         {

             _MyUserInfo = context.HttpContext.Session.Get<MoUserInfo>(context.HttpContext.Session.SessionKey()); //获取登录session

             if (_MyUserInfo == null)

             {

                 context.Result = new RedirectToActionResult(nameof(MemberController.Login), "Member", new { ReturnUrl = context.HttpContext.Request.Path });

             }

             ViewData["MyUserInfo"] = _MyUserInfo;

             base.OnActionExecuting(context);

         }

     }

上面的这种方式通常也是大家对于登录验证用的最多的方式之一了，这里暂时没有用到过滤器等其他的验证方式；

自定义分页TagHelper

对于个人中心的登陆日志和爱心积分增加记录来说，一页是展示不完的，往往需要分页来展示，为此我采用了重写TagHelper的方式，来自定义一个分页控件；首先我定义一个这样的分页属性实体：

 /// <summary>

     /// 分页option属性

     /// </summary>

     public class MoPagerOption

     {

         /// <summary>

         /// 当前页  必传

         /// </summary>

         public int CurrentPage { get; set; }

         /// <summary>

         /// 总条数  必传

         /// </summary>

         public int Total { get; set; }

         /// <summary>

         /// 分页记录数（每页条数 默认每页15条）

         /// </summary>

         public int PageSize { get; set; }

         /// <summary>

         /// 路由地址(格式如：/Controller/Action) 默认自动获取

         /// </summary>

         public string RouteUrl { get; set; }

         /// <summary>

         /// 样式 默认 bootstrap样式 1

         /// </summary>

         public int StyleNum { get; set; }

         /// <summary>

         /// 地址与分页数拼接符

         /// </summary>

         public string JoinOperateCode { get; set; }

     }

然后自定个PagerTagHelper类来继承TagHelper，并且重写她的 public override void Process(TagHelperContext context, TagHelperOutput output) 函数，为了简洁我已经在代码注意的地方加上了注释：

 /// <summary>

     /// 分页标签

     /// </summary>

     public class PagerTagHelper : TagHelper

     {

         public MoPagerOption PagerOption { get; set; }

         public override void Process(TagHelperContext context, TagHelperOutput output)

         {

             output.TagName = "div";

             //PagerOption.JoinOperateCode = string.IsNullOrWhiteSpace(PagerOption.JoinOperateCode) ? "/" : PagerOption.JoinOperateCode;

             if (PagerOption.PageSize <= ) { PagerOption.PageSize = ; }

             if (PagerOption.CurrentPage <= ) { PagerOption.CurrentPage = ; }

             if (PagerOption.Total <= ) { return; }

             //总页数

             var totalPage = PagerOption.Total / PagerOption.PageSize + (PagerOption.Total % PagerOption.PageSize >  ?  : );

             if (totalPage <= ) { return; }

             else if (totalPage <= PagerOption.CurrentPage)

             {

                 PagerOption.CurrentPage = totalPage;

             }

             //当前路由地址

             if (string.IsNullOrEmpty(PagerOption.RouteUrl))

             {

                 //PagerOption.RouteUrl = helper.ViewContext.HttpContext.Request.RawUrl;

                 if (!string.IsNullOrEmpty(PagerOption.RouteUrl))

                 {

                     var lastIndex = PagerOption.RouteUrl.LastIndexOf("/");

                     PagerOption.RouteUrl = PagerOption.RouteUrl.Substring(, lastIndex);

                 }

             }

             //构造分页样式

             var sbPage = new StringBuilder(string.Empty);

             switch (PagerOption.StyleNum)

             {

                 case :

                     {

                         break;

                     }

                 default:

                     {

                         #region 默认样式

                         PagerOption.RouteUrl = PagerOption.RouteUrl.TrimEnd('/');

                         sbPage.Append("<nav>");

                         sbPage.Append("  <ul class=\"pagination\">");

                         sbPage.AppendFormat("       <li><a href=\"{0}{2}{1}\" aria-label=\"Previous\"><span aria-hidden=\"true\">&laquo;</span></a></li>",

                                                 PagerOption.RouteUrl,

                                                 PagerOption.CurrentPage -  <=  ?  : PagerOption.CurrentPage - ,

                                                 PagerOption.JoinOperateCode);

                         for (int i = ; i <= totalPage; i++)

                         {

                             sbPage.AppendFormat("       <li {1}><a href=\"{2}{3}{0}\">{0}</a></li>",

                                 i,

                                 i == PagerOption.CurrentPage ? "class=\"active\"" : "",

                                 PagerOption.RouteUrl,

                                 PagerOption.JoinOperateCode);

                         }

                         sbPage.Append("       <li>");

                         sbPage.AppendFormat("         <a href=\"{0}{2}{1}\" aria-label=\"Next\">",

                                             PagerOption.RouteUrl,

                                             PagerOption.CurrentPage +  > totalPage ? PagerOption.CurrentPage : PagerOption.CurrentPage + ,

                                             PagerOption.JoinOperateCode);

                         sbPage.Append("               <span aria-hidden=\"true\">&raquo;</span>");

                         sbPage.Append("         </a>");

                         sbPage.Append("       </li>");

                         sbPage.Append("   </ul>");

                         sbPage.Append("</nav>");

                         #endregion

                     }

                     break;

             }

             output.Content.SetHtmlContent(sbPage.ToString());

         }

     }

到此后台封装的方法就完成了，此刻我们还需要再Views/_ViewImports.cshtml文件中增加如下内容，才能正常的只用我们自定义的标签：

 @using LovePicture.Web

 @addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers

 @addTagHelper LovePicture.Web.Extends.PagerTagHelper, LovePicture.Web  //这里是增加的内容

到此我们分页的配置就完成了，下面就开始介绍怎么来使用封装的分页标签了；先看Action中这样来写：

 public IActionResult UserLogs(string id)

         {

             if (string.IsNullOrWhiteSpace(id)) { return BadRequest(); }

             #region  构造参数

             var paramArr = id.Split('-');

             if (paramArr.Length != ) { return BadRequest(); }

             var page = Convert.ToInt32(paramArr[]);

             var codeId = Convert.ToInt32(paramArr[]);

             if (codeId != (int)EnumHelper.EmLogCode.登录 && codeId != (int)EnumHelper.EmLogCode.积分)

             {

                 return BadRequest();

             }

             page = page <=  ?  : page;

             //初始化分页类

             var pageOption = new MoPagerOption

             {

                 CurrentPage = page,

                 PageSize = ,

                 Total = ,

                 RouteUrl = $"/usercenter/userlogs/{codeId}",

                 StyleNum = ,

                 JoinOperateCode = "-"

             };

             #endregion

             var userLogs = _db.ToUserLog.

                  Where(b => b.UserId == _MyUserInfo.Id && b.CodeId == codeId).AsEnumerable();

             pageOption.Total = userLogs.Count();

             userLogs = userLogs.OrderByDescending(b => b.Id).

                  Skip((pageOption.CurrentPage - ) * pageOption.PageSize).

                  Take(pageOption.PageSize).

                  ToList();

             //通过ViewData方式分页属性数据传递到试图中

             ViewBag.PagerOption = pageOption;

             var userLog = new ToUserLog

             {

                 CodeId = codeId,

                 Des = $"{Enum.GetName(typeof(EnumHelper.EmLogCode), codeId)}记录"

             };

             ViewData["userLog"] = userLog;

             return View(userLogs);

         }

最后需要再试图中绑定模型，和使用标签pager：

 @using LovePicture.Com

 @using LovePicture.Model.Models

 @using LovePicture.Model.MoClass

 @using LovePicture.Web.Extends

 @model IEnumerable<ToUserLog>

 @{

     var userLog = ViewData["userLog"] as ToUserLog;

     ViewData["Title"] = userLog.Des;

     var userInfo = ViewData["MyUserInfo"] as MoUserInfo;

     userInfo.Status = ;

 }

 <div class="row">

     @await Html.PartialAsync("UserCenterGroup", userInfo)

     <div class="col-md-10">

         <h3><span class="glyphicon glyphicon-home" aria-hidden="true"></span> 个人中心</h3>

         <hr />

         <div class="row">

             <div class="col-md-12">

                 <table id="tabLog" class="table">

                     <thead>

                         <tr>

                             <th class="text-center" style="border:0px">@userLog.Des</th>

                         </tr>

                     </thead>

                     <tbody>

                         @foreach (var item in Model)

                         {

                             <tr>

                                 <td>

                                     @item.Des

                                 </td>

                             </tr>

                         }

                     </tbody>

                 </table>

                 <div class=" text-center">

                     <pager pager-option="ViewBag.PagerOption as MoPagerOption"></pager>

                 </div>

             </div>

         </div>

     </div>

 </div>

为什么通过ajax获取数据来绑定数据，而不用Action返回实体模型来绑定试图呢

由于什么统计数据，上传记录，登录记录，爱心记录等数据来源方式基本都是统一的来自数据库(暂未只用缓存)，所以没有什么特别需要讲的地方，反而关注分析了为什么用ajax获取后再绑定数据到页面的方式；对于ajax的方式请求来说，通常都是前端异步的代名词，一个个人中心来说需要展示很多的信息，尤其是还有统计等信息，如果通过Action-View方式直接绑定Model来加载数据，那无疑是让用户体验变差了，因为这种方式需要等待后台把数据加载完后才能展示页面给客户，经过我对爱留图个人中心如果采用这种方式展示数据的统计，需要花10s（本地）因此在没有使用缓存的基础上，我果断的使用了前端异步展示的方式（ajax）；当然对于在mvc模式中使用ajax的方式来绑定数据感觉有些异类，的确是这样，因为netcore的mvc目的就是让咋们快速构建系统的，不过有些时候还是需要更具具体的情况来选择具体的方式；来看看个人中心的统计信息对应的代码吧：

 #region 统计信息

         [HttpPost]

         public JsonResult UserStatis()

         {

             var data = new MoLoveData();

             var list = new List<dynamic>();

             //留图数（公有）

             var userContent = _db.ToContent.Where(b => b.UserId == _MyUserInfo.Id).AsEnumerable();

             var total1 = userContent.Count(b => b.Status == (int)EnumHelper.EmContentStatus.公有);

             list.Add(new

             {

                 name = "留图数（公有）",

                 total = $"{ total1}（张）"

             });

             //留图数（私有）

             var total2 = userContent.Count(b => b.Status == (int)EnumHelper.EmContentStatus.私有);

             list.Add(new

             {

                 name = "留图数（私有）",

                 total = $"{ total2}（张）"

             });

             //点赞数

             var total3 = userContent.Where(b => b.Status != (int)EnumHelper.EmContentStatus.删除).Sum(b => b.ZanNum);

             list.Add(new

             {

                 name = "点赞数",

                 total = $"{ total3}（个）"

             });

             //浏览数

             var total4 = userContent.Where(b => b.Status != (int)EnumHelper.EmContentStatus.删除).Sum(b => b.ReadNum);

             list.Add(new

             {

                 name = "浏览数",

                 total = $"{ total4}（次）"

             });

             //爱心积分

             var total5 = _MyUserInfo.LevelNum;

             list.Add(new

             {

                 name = "爱心积分",

                 total = $"{ total5}（分）"

             });

             data.Data = list;

             data.IsOk = true;

             return Json(data);

         }

         #endregion

通过 return Json(data); 方法json对象给请求方；然后前端需要通过ajax来请求：

 getUserStatis: function (tabId) {

             if (tabId.length <= ) { return; }

             $.post("/usercenter/UserStatis", { x:  }, function (data) {

                 if (data) {

                     if (!data.isOk) { $("#" + tabId + " tbody").html('<tr><td colspan="2">获取失败，稍后重试</td></tr>'); return; }

                     var trArr = [];

                     $.each(data.data, function (i, item) {

                         //console.log(item);

                         trArr.push('<tr><td>' + item.name + '</td><td>' + item.total + '</td></tr>');

                     });

                     if (trArr.length > ) {

                         $("#" + tabId + " tbody").html(trArr.join(''));

                     } else {

                         $("#" + tabId + " tbody").html('<tr><td>暂无</td></tr>');

                     }

                 }

             });

         }

为了更好的用户体验，我在ajax还没有请求加载数据前，默认在数据展示区域增加一个加载的图片背景：

  <div class="row">

             <div class="col-md-6">

                 <div class="panel panel-default">

                     <div class="panel-heading">统计信息</div>

                     <div class="panel-body">

                         <table id="tabStatis" class="table text-center">

                             <thead>

                                 <tr>

                                     <th class="text-center" style="border:0px">统计名称</th>

                                     <th class="text-center" style="border:0px">数值</th>

                                 </tr>

                             </thead>

                             <tbody>

                                 <tr>

                                     <td colspan="">

                                         <div class="loading"></div>

                                     </td>

                                 </tr>

                             </tbody>

                         </table>

                     </div>

                 </div>

             </div>

对应的loading类样式：

 .loading {

     width: %;

     height: 32px;

     background: url('../images/load.gif') no-repeat center top;

 }

最后上传一个效果图吧，表示表示：

巴特西

AspNetCore-MVC实战系列（三）之个人中心