后端快速上手

本小节我们将在lin-cms的基础上开发一个简单的图书管理demo,帮助大家来熟悉和入门lin-cms。

lin-cms是一个lin团队经数打磨的模板项目，本人是c#的开发者，为lin-cms完善在.net 下的生态，是基于asp.netcore的基础上，沉淀下来的一套实践， 帮助开发者节约时间。

注意：本小节建立在你有一定的asp.net mvc，freesql，.net core的基础上。

数据层

由于我们用的.net core中优秀的开源项目FreeSql,codefirst模式，他能根据类生成表结构。所以，不需要我们手动创建表结构。

book 书

字段	类型	备注
id	bigint	主键Id
author	varchar	作者
image	varchar	图片
summary	varchar	简介
title	varchar	标题

可增加一些审计字段，如

字段	类型	备注
create_time	datetime	创建时间
create_user_id	datetime	创建者ID
update_time	datetime	修改时间
update_user_id	datetime	最后修改人Id
delete_time	datetime	删除时间
delete_user_id	datetime	删除人id
is_deleted	datetime	是否删除

审计字段可通过继承父类FullAduitEntity即可,当然，也可只有创建时间，创建人二个字段，继承ICreateAduitEntity接口，实现二个字段即可。如果不想要这些记录，只需要继承Entity类，仅有一个ID字段，支持泛型。

is_deleted字段本身没有什么稀奇的，但我们可以配合FreeSql实现逻辑删除（软删除），在LinCms.Web/Configs/DependencyInjectionExtensions.cs文件中。配置 了如下内容，如果我们筛选数据时，会全局启用 过滤器 (opens new window)。像创建时间，创建人。这些字段都不需要我们赋值，如果我们全部使用仓储IAuditBaseRepository访问数据库，这些字段会自动赋值。

fsql.GlobalFilter.Apply<IDeleteAduitEntity>("IsDeleted", a => a.IsDeleted == false);

模型层

我们建立单纯的实体类（Entities)，在路径lin-cms-dotnetcore\src\LinCms.Core\Entities,名为Book.cs的实体类

using FreeSql.DataAnnotations;

namespace LinCms.Core.Entities
{
    [Table(Name = "book")]
    public class Book : FullAduitEntity
    {
        [Column(DbType = "varchar(30)")]
        public string Author { get; set; } = string.Empty;

        [Column(DbType = "varchar(50)")]
        public string Image { get; set; } = string.Empty;

        [Column(DbType = "varchar(1000)")]
        public string Summary { get; set; } = string.Empty;

        [Column(DbType = "varchar(50)")]
        public string Title { get; set; } = string.Empty;
    }
}

更多特性标签支持情况，请查看FreeSql官方文档实体特性 (opens new window)。

由于默认FreeSql,只有访问到这个类时才会生成表，但我们可以手动扫描所有带有Table特性标签的类，同步表结构。仅建议开发时启动表结构全部同步。

LinCms.Web/Configs/DependencyInjectionExtensions.cs 中的AddContext配置项中.

//在运行时直接生成表结构
fsql.CodeFirst.SyncStructure(ReflexHelper.GetEntityTypes(typeof(IEntity))); 

业务层

有了实体类，我们创建IBookRepository<Book,long>，也可以不创建，直接使用IAuditBaseRepository<Book>在Service层写相应的业务。这里我们就不创建仓储服务了，框架中携带的仓储已经满足我们的要求。

仓储是什么呢。在这里我们可以理解DAL,也理解为仓库，他提供了对单个表的CURD操作方法，有了一个统一的规范。

作用即数据的持久化，应用服务通过仓储对数据进行操作，让开发者不用关注仓储内部的实现。

业务层Services，我们直接使用仓储访问数据库。

在LinCms.Application.Contracts项目中，在v1文件夹新建一个Books的文件夹,用于存放书的相关接口，创建IBookService的接口

using System.Threading.Tasks;
using LinCms.Application.Contracts.v1.Books.Dtos;
using LinCms.Core.Data;

namespace LinCms.Application.Contracts.v1.Books
{
    public interface IBookService
    {
        Task<BookDto> GetAsync(long id);
    }
}

新建一个Dtos文件夹，用于存放业务传输的数据对象，再创建一个BookDto，仅包含必要的字段，而非全部。该类以Dto结尾，代表数据传输对象。

using System;
using LinCms.Core.Entities;

namespace LinCms.Application.Contracts.v1.Books.Dtos
{
    public class BookDto:EntityDto
    {
        public string Author { get; set; }
        public string Image { get; set; }
        public string Summary { get; set; }
        public string Title { get; set; }
        public DateTime CreateTime { get; set; }
        public DateTime UpdateTime { get; set; }
    }
}

在BookService实现如下，在这里我们注入IAuditBaseRepository，通过 调用 _bookRepository.Select.Where(a => a.Id == id).ToOneAsync(); ,根据id得到书的实体对象。然后使用AutoMappeer,将Book类转换成BookDto类，然后返回。 至于为什么 这里我们可以注入IAuditBaseRepository，IMapper类，后面我们会讲到。

using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using AutoMapper;
using LinCms.Application.Contracts.v1.Books;
using LinCms.Application.Contracts.v1.Books.Dtos;
using LinCms.Core.Data;
using LinCms.Core.Entities;
using LinCms.Core.Exceptions;
using LinCms.Core.Extensions;
using LinCms.Core.IRepositories;

namespace LinCms.Application.v1.Books
{
    public class BookService : IBookService
    {
        private readonly IAuditBaseRepository<Book> _bookRepository;
        private readonly IMapper _mapper;
        public BookService(IAuditBaseRepository<Book> bookRepository, IMapper mapper)
        {
            _bookRepository = bookRepository;
            _mapper = mapper;
        }


        public async Task<BookDto> GetAsync(long id)
        {
            Book book = await _bookRepository.Select.Where(a => a.Id == id).ToOneAsync();
            return _mapper.Map<BookDto>(book);
        }
    }
}

因为使用AutoMapper简化二个对象的映射，我们在同一目录下，创建一个继承Profile类的配置项。在构造函数中，我们配置了调用CreateMap方法，代表，从Book->BookDto的映射关系。

using AutoMapper;
using LinCms.Application.Contracts.v1.Books.Dtos;
using LinCms.Core.Entities;

namespace LinCms.Application.v1.Books
{
    public class BookProfile:Profile
    {
        public BookProfile()
        {
            CreateMap<Book, BookDto>();
        }
    }
}

在ASP.NET Core中，我们会扫描该程序集（LinCms.Applicaiton）中所有继承了Profile类的子类，在LinCms.Web中ConfiguartionService配置如下，

services.AddAutoMapper(typeof(BookProfile).Assembly);

一个项目即一个程序集(生成一个dll)，仅配置一次。

我们完善一下控制器的代码。

using System.Threading.Tasks;
using AutoMapper;
using LinCms.Application.Contracts.v1.Books;
using LinCms.Application.Contracts.v1.Books.Dtos;
using LinCms.Core.Aop;
using LinCms.Core.Aop.Filter;
using LinCms.Core.Data;
using LinCms.Core.Entities;
using LinCms.Core.Exceptions;
using LinCms.Core.Extensions;
using LinCms.Core.IRepositories;
using LinCms.Web.Data.Authorization;
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;

namespace LinCms.Web.Controllers.v1
{
    [Route("v1/book")]
    [ApiController]
    [Authorize]
    public class BookController : ControllerBase
    {
        private readonly IBookService _bookService;
        public BookController(IBookService bookService)
        {
            _bookService = bookService;
        }

        [HttpGet("{id}")]
        public async Task<BookDto> GetAsync(int id)
        {
            return await _bookService.GetAsync(id);
        }
    }
}

在LinCms.Web/Controllers/v1文件夹，创建我们的Book控制器。 我们依旧通过构造函数注入服务IBookService,这里用到的是async await方法，与同步方法执行顺序一致，仅多二个关键字，并使用Task<返回值>来返回数据，通常我们使用Async标识异步方法。

启动项目，可通过Visual Studio点击上方的运行即可。

还可通过终端运行项目

先 cd 到目录 lin-cms-dotnetcore/src/LinCms.Web

dotnet run

打开浏览器，https://localhost:5001/swagger/index.html， ctrl+f搜索，book，找到GET /v1/book/{id}，点击try it out,输入id，点击Execute。

因为我们没登录登录，在BookController上写了特性标签 [Authorize] ，所以会返回

{
  "code": 10000,
  "message": "请先登录",
  "request": "GET /v1/book/131"
}

我们可以先去掉这个特性标签，也可以走登录浏览，把Token放到Header中的Authoriaztion中。。

这里我们先去掉这行特性标签。去掉后，需要ctrl+c，即出运行状态，如果感觉麻烦，可以使用 dotnet run watch 命令，修改后，自动重启，不需要手动重启。。

这里我们重新测试，手动给数据库加一些数据，记得is_deleted要是false，然后输入对应的id，会得到对应的值

{
  "author": "891dc185-2",
  "image": "f6d0c1e9-fcb2-446a-9093-d773e6515579",
  "summary": "8aea38f8-a6e0-4053-bd7a-ae4476432bdd",
  "title": "2d0c2e44-ee02-4d40-b4b7-eed03bb48aa4",
  "create_time": 1588485910430,
  "update_time": 1588485910430,
  "id": 139
}