.NET 个人博客-给文章添加上标签

  • .NET 个人博客-给文章添加上标签已关闭评论
  • 114 次浏览
  • A+
所属分类:.NET技术
摘要

本篇文章实现文章标签功能首先需要新增一个标签类Tag,然后Post文章类和Tag标签类的关系是多对多的关系。也就是一个文章可以有多个标签,一个标签也可以被多个文章使用。


个人博客-给文章添加上标签

优化计划

本篇文章实现文章标签功能

思路

首先需要新增一个标签类Tag,然后Post文章类和Tag标签类的关系是多对多的关系。也就是一个文章可以有多个标签,一个标签也可以被多个文章使用。

为了实现这个多对多关系,光有Tag表和Post表还不够,还需要一个中间表去维护标签和文章之间的关联关系,就定为PostTag表吧。

代码实现

准备工作

为Post类新增导航属性

public List<Tag> Tags { get; set; } 

新增Tag类

public class Tag {     /// <summary>     /// 标签ID     /// </summary>     [Key] //主键     public int Id { get; set; }      /// <summary>     /// 标签名称     /// </summary>     public string Name { get; set; }      /// <summary>     /// 导航属性 - 文章列表     /// </summary>     public List<Post>? Posts { get; set; } } 

新增PostTag类

public class PostTag {     /// <summary>     /// 标签ID     /// </summary>     public int TagId { get; set; }      /// <summary>     /// 导航属性 - 文章     /// </summary>     public Post Post { get; set; }      /// <summary>     /// 导航属性 - 标签     /// </summary>     public Tag Tag { get; set; } } 

在DbContext数据库上下文中添加新增类

public DbSet<Tag> Tags { get; set; } public DbSet<PostTag> PostTags { get; set; } 

然后是上下文的protected override void OnModelCreating(ModelBuilder modelBuilder)方法中添加

modelBuilder.Entity<Post>()     .HasMany(e => e.Tags)     .WithMany(e => e.Posts)     .UsingEntity<PostTag>(); 

类创建完成后,需要在数据库中新增Tags表和PostTags表,使用Code First模式或者手动创建都行。

控制器

修改之前打包上传文章的控制器,新增List tags

public async Task<ApiResponse<Post>> Upload([FromForm] String Categoryname,[FromForm]String Parent, [FromForm] List<string> tags,IFormFile file,[FromServices] ICategoryService categoryService ) 

服务

在之前的打包上传服务新增标签处理

public async Task<Post> Upload(int CategoryId, List<string> tags,IFormFile file){     ....之前的代码          foreach (var tagName in tags)             {                 var tag = await _myDbContext.Tags.FirstOrDefaultAsync(t => t.Name == tagName);                 if (tag == null)                 {                     tag = new Tag { Name = tagName };                     _myDbContext.Tags.Add(tag);                 }                  var postTag = new PostTag                 {                     Post = post,                     Tag = tag                 };                  _myDbContext.PostTags.Add(postTag);             }                 await _myDbContext.SaveChangesAsync();             return post; } 

接口测试

.NET 个人博客-给文章添加上标签

可以看到tags是一个数组类型的参数

.NET 个人博客-给文章添加上标签

数据库也是添加成功了

Razor页面

上述只是简单的在上传文章的时候设置了一下标签,接下来设计一下页面显示

分页查询服务

首先是分页查询服务,可以看到是返回的一个元组,然后PaginationMetadata是分页数据,之前在做推荐博客加载的时候提过一下,之前是没有用到的,然后现在是用到了,所以需要计算一下分页的信息。顺便提一下这个类是大佬的一个Nuget包,然后是提供了ApiResponsePaged类去把元组和数据类结合在一起,在博客的评论中就用到了ApiResponsePaged类来返回数据给前端。但考虑的标签页的设计,就没用这个类,而是直接使用元组,我发现元组用着也不错。

    public async Task<(List<PostTag>, PaginationMetadata)> GetAllTagPostAsync(QueryParameters param)     {         var postTags = await _myDbContext.PostTags             .Where(p => p.TagId == param.TagId)             .Include(p => p.Post)             .ThenInclude(p => p.Categories)             .Include(p => p.Post)             .ThenInclude(p => p.Comments)             .Include(p => p.Post)             .ThenInclude(p => p.Tags)             .Skip((param.Page - 1) * param.PageSize)             .Take(param.PageSize)             .ToListAsync();              var totalCount = await _myDbContext.PostTags.CountAsync(p => p.TagId == param.TagId);         var pageCount = (int)Math.Ceiling((double)totalCount / param.PageSize);              var pagination = new PaginationMetadata()         {             PageNumber = param.Page,             PageSize = param.PageSize,             TotalItemCount = totalCount,             PageCount = pageCount,             HasPreviousPage = param.Page > 1,             HasNextPage = param.Page < pageCount,             IsFirstPage = param.Page == 1,             IsLastPage = param.Page == pageCount,             FirstItemOnPage = (param.Page - 1) * param.PageSize + 1,             LastItemOnPage = Math.Min(param.Page * param.PageSize, totalCount)         };              return (postTags, pagination);     } 

控制器

 public async Task<IActionResult> Index(int tagId = 1, int page = 1, int pageSize = 8)     {         var TagList = await _tagService.GetAllTagAsync();         if (TagList.Count == 0)             return View(new TagIndex()             {                 TagList = await _tagService.GetAllTagAsync(),                 TagId = 0,                 TagAllPosts = await _tagService.GetAllTagPostAsync(                     new QueryParameters                     {                         Page = page,                         PageSize = pageSize,                         TagId = tagId,                     })             });                  var currentTag = tagId == 1 ? TagList[0] :await _tagService.GetById(tagId);         if (currentTag == null)         {             _messages.Error($"标签 {currentTag} 不存在!");             return RedirectToAction(nameof(Index));         }          TagIndex tagIndex = new TagIndex()         {             TagList = await _tagService.GetAllTagAsync(),             TagId = currentTag.Id,             TagAllPosts = await _tagService.GetAllTagPostAsync(                 new QueryParameters                 {                     Page = page,                     PageSize = pageSize,                     TagId = currentTag.Id,                 })         };         return View(tagIndex);     } 

分页组件

@model (Personalblog.Model.ViewModels.Categories.PaginationMetadata,int)  <nav aria-label="Page navigation">     <ul class="pagination justify-content-center">         <li class="page-item @(!Model.Item1.HasPreviousPage ? "disabled" : "")">             <a class="page-link" href="#" aria-label="Previous" href="@Url.Action("Index", new { tagId = Model.Item2, page = Model.Item1.PageNumber - 1, pageSize = Model.Item1.PageSize })">                 <span aria-hidden="true">&laquo;</span>                 <span class="sr-only">Previous</span>             </a>         </li>         @for (int i = 1; i <= Model.Item1.PageCount; i++)         {             <li class="page-item @(Model.Item1.PageNumber == i ? "active" : "")">                 <a class="page-link" href="@Url.Action("Index", new { tagId = Model.Item2, page = i, pageSize = Model.Item1.PageSize })">@i</a>             </li>         }         <li class="page-item @(!Model.Item1.HasNextPage ? "disabled" : "")">             <a class="page-link" href="#" aria-label="Next" href="@Url.Action("Index", new { tagId = Model.Item2, page = Model.Item1.PageNumber + 1, pageSize = Model.Item1.PageSize })">                 <span aria-hidden="true">&raquo;</span>                 <span class="sr-only">Next</span>             </a>         </li>     </ul> </nav> 

Tag文章组件

@using Personalblog.Migrate @model List<Personalblog.Model.Entitys.PostTag>  @foreach (var p in Model) {     <div class="col-md-3 col-12 mb-2">         <div class="card" style="padding:0;">             <img class="bd-placeholder-img card-img-top" alt=""                  src="@Url.Action("GetRandomImage", "PicLib", new { seed = p.PostId, Width = 800, Height = 1000 })">             <div class="card-body">                 <h5 class="card-title">@p.Post.Title</h5>                 <p class="card-text">@p.Post.Summary.Limit(50)</p>                 <div class="mb-1 text-muted d-flex align-items-center">                     <span class="me-2">@p.Post.LastUpdateTime.ToShortDateString()</span>                     <div class="d-flex align-items-center">                         <i class="bi bi-eye bi-sm me-1"></i>                         <span style="font-size: 0.875rem;">@p.Post.ViewCount</span>                     </div>                     <span style="width: 10px;"></span> <!-- 这里设置了一个 10px 的间距 -->                     <div class="d-flex align-items-center">                         <i class="bi bi-chat-square-dots bi-sm me-1"></i>                         <span style="font-size: 0.875rem;">@p.Post.Comments.Count</span>                     </div>                 </div>             </div>             <ul class="list-group list-group-flush">                 <li class="list-group-item">                     <div class="row">                         @await Html.PartialAsync("Widgets/Tags", p.Post.Tags)                     </div>                 </li>             </ul>             <div class="card-body">                 <a                    asp-controller="Blog" asp-action="Post" asp-route-id="@p.Post.Id">                     Continue reading                 </a>             </div>         </div>     </div> } 

Tag主页面

@model Personalblog.Model.ViewModels.Tag.TagIndex @{     ViewData["Title"] = "标签页"; } @section head {     <link href="~/lib/Tag/Tag.css" rel="stylesheet"> } <div class="container px-4 py-3">     <h2 class="d-flex w-100 justify-content-between pb-2 mb-3 border-bottom">         <div>Tag</div>         <div>文章标签</div>     </h2>      <div class="row mb-4">         @await Html.PartialAsync("Widegets/TagPostCard",Model.TagAllPosts.Item1) //文章     </div>     @await Html.PartialAsync("Widegets/TagPagination",(Model.TagAllPosts.Item2,Model.TagId))//分页 </div> 

我在调用分部视图的时候,元组的好处就体现出来了,将数据和分页分开去写页面,分页视图我就传递item2也就是PaginationMetadata类,文章页面我就传递item1也就是文章数据。

效果展示

.NET 个人博客-给文章添加上标签

.NET 个人博客-给文章添加上标签

很多文章我还没来得及添加标签,问题不大,文章编辑标签的接口也是写了的~

.NET 个人博客-给文章添加上标签

参考资料

可以去看看官方文档的多对多关系的解释

结尾

页面就简单的做完了,然后后台的接口就是一些简单的crud,这里就不细讲了。主要看多对多关系和元组这2个好东西就行了~

.NET 个人博客-给文章添加上标签