# K 快速上手

注意

请确保你的 Visual Studio 2019 版本 >= 16.8.2
并安装 .NET 5.0 SDK

# 下载

Github(国际) 下载 https://github.com/anjoy8/Blog.Core

Gitee(国内) 下载 https://gitee.com/laozhangIsPhi/Blog.Core

# 编译与运行

1、拿到项目后,双击 Blog.Core.sln 解决方案;
2、首先 F6 编译,看是否有错误;
3、然后 F5 运行,调起 8081 端口,浏览器查看效果;
4、因为系统默认的是 sqlite 数据库,如果你想换其他数据库,请看下边;
5、注意:本系统是直接自动生成数据库和数据的,不用手动创建数据库;

# CodeFirst 与 DbFirst

1、项目同时支持两个常见开发模式:CodeFirstDbFirst
2、首先 如果你是第一次下载我的项目,肯定是想要浏览效果和直接使用对应的权限相关的内容,这个时候肯定需要用到数据库表结构,那就肯定需要 CodeFirst ,只需要在appsettings.json 里配置好数据库连接字符串(下文会说到如何配置),就能正确运行;
3、浏览器查看效果,或者配合 Admin 项目查看效果后,如果感觉项目可行,并打算在此基础上二次开发,那肯定会在你刚刚创建的数据库种去创建新的表结构,这个时候就需要使用 DbFirst 模式,来生成四层项目问题:Model+Service+Repository等;
4、你可以使用T4模板,但是我更建议使用 /api/DbFirst/GetFrameFiles 接口来生成,不仅支持多种类型的数据库,还支持同时多库模式的输出;
5、如果你不想用我的表结构和实体类,在项目启动的时候,把配置文件的 SeedDBEnabled节点设置成False即可,然后配置对应的你自己的数据库连接字符串,比如是商城的,然后使用 /api/DbFirst/GetFrameFiles 接口来生成你的数据库四层类文件;

# 如何配置数据库连接字符串

1、打开 Blog.Core 项目下的 appsettings.json 文件;
2、修改 DBS 字节内容,配置对应的连接字符串,注意DBType对应不同的数据库类型;
3、把你想要运行的数据库 Enabledtrue 即可,其他都要设置 false
4、然后 MainDB 设置为下边你使用的指定 ConnId:

  "MainDB": "WMBLOG_MSSQL", //当前项目的主库,所对应的连接字符串的Enabled必须为true
  "MutiDBEnabled": false, //是否开启多库
  "DBS": [
    {
      "ConnId": "WMBLOG_SQLITE",
      "DBType": 2,// sqlite数据库
      "Enabled": true,// 设置为true,启用1
      "Connection": "WMBlog.db" //只写数据库名就行
    },
    {
      "ConnId": "WMBLOG_MSSQL",
      "DBType": 1,// sqlserver数据库
      "Enabled": true,// 设置为true,启用2
      "Connection": "Server=.;Database=WMBlogDB;User ID=sa;Password=123;",
      "ProviderName": "System.Data.SqlClient"
    },
    {
      "ConnId": "WMBLOG_MYSQL",
      "DBType": 0,// mysql
      "Enabled": false,// false 不启用
      "Connection": "Server=localhost; Port=3306;Stmt=; Database=wmblogdb; Uid=root; Pwd=456;"
    },
    {
      "ConnId": "WMBLOG_ORACLE",
      "DBType": 3,// Oracle 
      "Enabled": false,// 不启用
      "Connection": "Provider=OraOLEDB.Oracle; Data Source=WMBlogDB; User Id=sss; Password=789;"
    }
  ],

5、如果你想多库操作,需要配置

  a:MainDB 设置为主库的 ConnId;
  b:MutiDBEnabled设置为true,
  c:把下边想要连接的多个连接字符串都设置为true

# 如何配置项目端口号

1、在 Blog.Core 层下的 program.cs 文件中,将 8081端口,修改为自己想要的端口号;
2、或者在 launchSettings.json 中设置(注意,如果仅仅修改这里,publish后,端口访问无效);

# 如何项目重命名

1、双击项目根目录下的 CreateYourProject.bat 批处理文件;
2、根据提示,在Dos窗口内输入自己想要的项目名称即可;
3、在根目录会有一个 .1YourProject 文件夹,里边即你的项目;

# 新增实体模块后如何迁移到数据库

1、在 Blog.Core.Model 项目目录下的 Seed 文件夹下,找到 DBSeed 类;
2、根据提示,找到生成table的地方 myContext.CreateTableByEntity
3、添加进去你新增的实体类,当然也可以用下边的单独写法;
4、编译项目,没错后,运行,则数据库更新完毕;

# 新增实体,如何进行增删改查CURD操作

1、随便找一个含有业务逻辑的 controller 参考一下即可;
2、主要 api 是通过 Service 服务层提供业务逻辑;
3、然后服务层通过 Repository 仓储层封装持久化操作;
4、每一个表基本上对应一个仓储类,基本的操作都封装到了 BaseRepository.cs 基类仓储中;
5、添加完业务逻辑,记得要 F6 重新编译一下,因为项目间引用解耦了;
6、项目已经自动注入了,直接在控制器使用对应的服务层接口就行: IxxxxService ;

# 新增数据库表,如何反向生成四层文件

1、可以通过 T4 模板来生成,在 Blog.Core.FrameWork 层,使用方法: 9757999.html

注意:这种方案,目前默认的只能是 SqlServer ,其他类型的数据库,可以看上边文章中的代码,或者群文件里对应的代码。

1、修改DbHelper.ttinclude文件中的连接字符串,注意是SqlServer的: public static readonly string ConnectionString;
2、然后去各个层模板文件,点击Ctrl+S;
3、就会在对应的层内,看到新文件,比如:Blog.Core.Model/Model_NEW

2、也可以通过 Sqlsugar 所带的方法来实现 DbFirst,具体查看 Controller 层下的 DbFirstController.cs

3、总体操作过程,可以参考我的视频:av77612407

# 发布与部署

1、双击项目根目录下的 Blog.Core.Publish.bat批处理文件;
2、执行完成后,根目录会有一个.PublishFiles 文件夹,就是发布后的项目;

# 如何更新项目模板

1、着急的话自己打包,不着急就提 issue,等我更新;
2、我的开源项目中,有个模板项目 BlogCoreTempl 地址,下载下来;
3、下载最新的 Blog.Core 源代码;
4、将源代码拷贝到模板项目的 content 文件夹下;
5、双击 Package.bat 文件,就生成了最新的模板了;