6.2 KiB

Raw Blame History

K 快速上手

注意

请确保你的 Visual Studio 2019 版本 >= 16.4。

下载

Github（国际）下载 https://github.com/anjoy8/New_College

Gitee（国内）下载 https://gitee.com/laozhangIsPhi/New_College

编译与运行

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

CodeFirst 与 DbFirst

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

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

1、打开 New_College 项目下的 appsettings.json 文件；
2、修改 DBS 字节内容，配置对应的连接字符串，注意DBType对应不同的数据库类型；
3、把你想要运行的数据库 Enabled 为 true 即可，其他都要设置 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、在 New_College 层下的 program.cs 文件中，将 8081端口，修改为自己想要的端口号；
2、或者在 launchSettings.json 中设置；

如何项目重命名

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

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

1、在 New_College.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 模板来生成，在 New_College.FrameWork 层，使用方法: 9757999.html ；

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

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

3、总体操作过程，可以参考我的视频：av77612407 ；

发布与部署

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

如何更新项目模板

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

6.2 KiB Raw Blame History Unescape Escape