FreeSql在ASP.NTE Core WebApi中如何使用的教程

时间 2019-11-17

标签 freesql asp.nte asp nte core webapi 如何使用教程栏目 ASP 繁體版

原文原文链接

文章概述

主要在介绍FreeSql在ASP.NTE Core WebApi中如何使用的过程，完成一个最简单的博客系统的后端接口。mysql

FreeSql 简介

国人写的一个功能强大的ORM,FreeSql 支持 MySql/SqlServer/PostgreSQL/Oracle/Sqlite，特色：轻量级、可扩展、基于 .NET Standard 跨平台。git

参考

FreeSql github github.com/2881099/Fre…github
关于.net core cli中如何使用dotnet newweb
使用 ASP.NET Core 建立 Web APIsql
Swagger/OpenAPI 生成接口文档数据库
Swagger GitHub (Swashbuckle.AspNetCore)c#
项目源码 github.com/luoyunchong…后端
项目源码稍微有所重构，命名空间会有变化，但总体类与结构无大的变化。api

项目准备

Mysql 5.6
Visual Studio 2019或201七、Visual Studio code
.NET Core 2.2+
PowerShell
懂点mvc，该教程不会教你如何使用 ASP .NET Core MVC、RESTful

建立一个webapi 的项目，起名为RESTful.FreeSql浏览器

PS dotnetcore-examples\asp.net-core-freesql> dotnet new webapi -n RESTful.FreeSql
The template "ASP.NET Core Web API" was created successfully.
PS dotnetcore-examples\asp.net-core-freesql> cd .\RESTful.FreeSql\
PS dotnetcore-examples\asp.net-core-freesql\RESTful.FreeSql> dotnet run

info: Microsoft.Hosting.Lifetime[0]
      Now listening on: https://localhost:5001
info: Microsoft.Hosting.Lifetime[0]
      Now listening on: http://localhost:5000
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
      Content root path: D:\code\github\dotnetcore-examples\asp.net-core-freesql\RESTful.FreeSql
复制代码

打开浏览器 https://localhost:5001 会出现404

请打开这个地址 https://localhost:5001/api/values ，可看到以下内容。

["value1","value2"]
复制代码

接下来咱们来集成FreeSql，咱们以最简单的命令和说明，详细内容去官网看具体内容

官网文档 freesql.net/doc

Install

要先cd到RESTful.FreeSql目录中。

PS \asp.net-core-freesql\RESTful.FreeSql> dotnet add package FreeSql
PS \asp.net-core-freesql\RESTful.FreeSql> dotnet add package FreeSql.Provider.MySql
复制代码

code first

关于CodeFirst，官方文档的介绍

代码优先，使用过EntityFramework的应该很清楚这一律念，个人理解就是：在分析数据库表关系时，不经过在数据库中设计表，而是直接在代码中声明对应的类，使用导航属性代替外键关联，经过数据表字段与C#中的类库对应，从而自动生成数据表。

db first

数据库优先：需求分析后，直接设计数据库，经过数据库中的表，直接生成代码，类。

开始

分析需求

咱们以code first 为示例，学习如何使用freesql，实现一个简单的博客。将表内容分为博客表（Blog)和评论表（Post)

Blog 表

字段名	字段类型	说明
BlogId	int	博客id
Title	varchar(50)	博客标题
Content	varchar(500)	博客内容
CreateTime	DateTime	发布时间

Post 表

字段名	字段类型	说明
PostId	int	评论id
ReplyContent	varchar(50)	标题
BlogId	int	博客id
ReplyTime	DateTime	回复时间

建一个Domain文件夹,用于存放数据库表中对应的实体类。

关于

1. Column属性介绍，你们能够看源码，解析

1). 好比：Blog表中指定了Title为varchar(50),咱们如何经过代码指定了主键，惟一值，字形。

public class Blog
    {
        [Column(IsIdentity = true, IsPrimary = true)]
        public int BlogId { get; set; }
        [Column(DbType = "varchar(50)")]
        public string Title { get; set; }
    }
复制代码

2). Column的命名空间在

using FreeSql.DataAnnotations;
复制代码

更多属性介绍

字段	备注
Name	数据库列名
OldName	指定数据库旧的列名，修改实体属性命名时，同时设置此参数为修改以前的值，CodeFirst才能够正确修改数据库字段；不然将视为【新增字段】
DbType	数据库类型，如： varchar(255)
IsPrimary	主键
IsIdentity	自增标识
IsNullable	是否可DBNull
IsIgnore	忽略此列，不迁移、不插入
IsVersion	设置行锁（乐观锁）版本号，每次更新累加版本号，若更新整个实体时会附带当前的版本号判断（修改失败时抛出异常）
DbDefautValue	数据库默认值
MapType	类型映射，好比：可将 enum 属性映射成 typeof(string)
Uniques	惟一键，在多个属性指定相同的标识，表明联合键；可以使用逗号分割多个 UniqueKey 名。

2. Table 的使用：用于在类的上面指定这个表的属性

[Table(Name = "t_blog")]
public class Blog {
  //...
}
复制代码

更多属性介绍

字段	备注
Name	数据库表名
OldName	指定数据库旧的表名，修改实体命名时，同时设置此参数为修改以前的值，CodeFirst才能够正确修改数据库表；不然将视为【建立新表】
SelectFilter	查询过滤SQL，实现相似 a.IsDeleted = 1 功能
DisableSyncStructure	禁用 CodeFirst 同步结构迁移

3. 其余的仍是看 github.com/2881099/Fre…

Blog.cs

using FreeSql.DataAnnotations;
using System;

namespace RESTful.FreeSql.Domain
{
    public class Blog
    {
        [Column(IsIdentity = true, IsPrimary = true)]
        public int BlogId { get; set; }
        [Column(DbType = "varchar(50)")]
        public string Title { get; set; }
        [Column(DbType = "varchar(500)")]
        public string Content { get; set; }
        public DateTime CreateTime { get; set; }
    }
}
复制代码

Post.cs

using FreeSql.DataAnnotations;
using System;

namespace RESTful.FreeSql.Domain
{
    public class Post
    {
        [Column(IsIdentity = true, IsPrimary = true)]
        public int PostId { get; set; }
        [Column(DbType = "varchar(50)")]
        public string ReplyContent { get; set; }
        public int BlogId { get; set; }
        public DateTime ReplyTime { get; set; }
        public Blog Blog { get; set; }
    }
}
复制代码

Startup.cs

非所有代码，这里注意点：要先在mysql中建立数据库FreeSql_Blog，不然一直提示主库xxxxx,官网未找到相关描述。

这里初始化FreeSql，并使用单例模式，注入到默认的依赖中，这样在Controller中便可直接注入。

namespace RESTful.FreeSql
{
    public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Fsql = new FreeSqlBuilder()
                        .UseConnectionString(DataType.MySql, @"Data Source=127.0.0.1;Port=3306;User ID=root;Password=123456;Initial Catalog=FreeSql_Blog;Charset=utf8;SslMode=none;Max pool size=10")
                        .UseAutoSyncStructure(true)
                        .Build();
        }

        public IFreeSql Fsql { get; }

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddSingleton<IFreeSql>(Fsql);

        }
    }
}
复制代码

BlogController

在controllers文件夹新建一个控制器BlogController

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using FreeSql;
using Microsoft.AspNetCore.Mvc;
using RESTful.FreeSql.Domain;

namespace RESTful.FreeSql.Controllers
{
    [Route("api/[controller]")]
    [ApiController]
    public class BlogController : ControllerBase
    {
        // GET api/Blog

        IFreeSql _fsql;
        public BlogController(IFreeSql fsql)
        {
            _fsql = fsql;
        }

        [HttpGet]
        public ActionResult<IEnumerable<Blog>> Get()
        {
            List<Blog> blogs = _fsql.Select<Blog>().OrderByDescending(r => r.CreateTime).ToList();

            return blogs;
        }

        // GET api/blog/5
        [HttpGet("{id}")]
        public ActionResult<Blog> Get(int id)
        {
            return _fsql.Select<Blog>(id).ToOne();
        }


        // DELETE api/blog/5
        [HttpDelete("{id}")]
        public void Delete(int id)
        {
            _fsql.Delete<Blog>(new { BlogId = id }).ExecuteAffrows();
        }
    }
}
复制代码

从新运行，打开地址 http://localhost:5001/api/blog 会发现数据库中生成了表blog，这时候表post并无生成。因此咱们判断，只有在访问到实体类才检查是否存在表结构，而后执行相应的处理。

手动向blog表中加一些数据，而后再次请求

http://localhost:5001/api/blog，可看到相应的数据。
http://localhost:5001/api/blog/1 可获得单个数据。

自动同步实体结构【开发环境必备】

此功能默认为开启状态，发布正式环境后，请修改此设置

Fsql = new FreeSqlBuilder()
          .UseConnectionString(DataType.MySql, @"链接字符串")
          .UseAutoSyncStructure(true)
          .Build();
                      
//UseAutoSyncStructure(true/false)【开发环境必备】自动同步实体结构到数据库，程序运行中检查实体表是否存在，而后建立或修改

// 也可以使用此方法指定是否自动同步结构。                  
Fsql.CodeFirst.IsAutoSyncStructure = true;
复制代码