菜鸡之NetCore 使用EF操作数据库 Oracle & Sqlserver （一）

摘要：

　　该篇文章主要记录netCore EFCore 如何操作Oracle和SqlServer 数据库，采用Codefirst方式创建数据库以及表。

一， 项目建立

　　项目采用DDD领域驱动设计模式【学习中】，目录介绍

　　1. Application ：服务层，【暂时不建立服务】

　　2. Domain ：业务领域层，主要就是一些仓储定义已经业务逻辑，当前项目定义数据库实体以及仓储定义

　　3. Infrastructure ：基础设施层，提供公共功能组件，当前项目实现Oracle&Sqlserver数据库的操作以及仓储的实现

　　4.Presentation ：WebApi放在这感觉不合适，但是放在Application中也好像不合适

二. 数据库实体（表）设计

　　1. 在Demo.Core项目中新建文件夹Entities,该文件夹主要存放数据库实体相关信息，这里仅仅包含一个实体STUDENT

　　2. 在Entites文件夹下新增Student.cs类

 namespace Demo.Core.Entities
 {
     [Table("STUDENT")]  //指定数据库对应表名
     public class Student
     {
         /// <summary>
         /// 学生学号
         /// </summary>
         [Key]  //主键
         [Column("USERID")] //指定数据库对应表栏位名称
         public string UserId { get; set; }

         /// <summary>
         /// 学生姓名
         /// </summary>
         [MaxLength()]
         [Column("NAME")]
         public string Name { get; set; }
     }
 }

　　填坑记录：指定数据库表名和栏位名为大小，否则我们使用PL/SQL进行查询的时候就要加入引号，因为PL/SQL以及一些工具是不分大小写，使用起来很不方便。若强行使用驼峰命名，在数据库工具查询方法如下：

 SELECT "UserId","Name" FROM "Student";

三. 创建DbContext

　　1.项目Demo.EFCore中Nuget数据库驱动包

　　　　Oracle      =>    Oracle.EntityFrameworkCore   【目前为止是预发行版本2.19.0-beta4】

　　　　SqlServer  =>   Microsoft.EntityFrameworkCore 【目前为止稳定版本2.2.4】

　　　　可以同时都安装如果有需要。在搜索Oracle驱动的时候，要选中旁边的【包含预发行版本】

　　2.添加对项目Demo.Core的引用

　　3. 新建DemoDBContext.cs

 namespace Demo.EFCore
 {
     public class DemoDbContext : DbContext
     {
         public DemoDbContext(DbContextOptions<DemoDbContext> options)
             :base(options)
         {

         }

         //该处定义你要映射到数据库中的表
         //格式固定
         public DbSet<Student> Student { get; set; }

         protected override void OnModelCreating(ModelBuilder modelBuilder)
         {
             //判断当前数据库是Oracle 需要手动添加Schema(DBA提供的数据库账号名称)
             if(this.Database.IsOracle())
             {
                 modelBuilder.HasDefaultSchema("NETCORE");
             }
             base.OnModelCreating(modelBuilder);
         }

     }
 }

　　　　填坑记录：如果使用Oracle必须手动添加Schema

四. 配置Demo.WebApi 项目

　　1.添加对 Demo.EFCore项目引用

　　2.修改配置文件 appsetting.json ，添加连接字符串信息DbConn，如下代码

 {
   "Logging": {
     "LogLevel": {
       "Default": "Warning"
     }
   },
   "AllowedHosts": "*",
   "DbConn": {
     "OraConn": "User Id=netcore;Password=netcore2019;Data Source=10.244.247.124:1521/ORCL;",
     "SqlConn": "Server=10.244.4.236\\NEMO;Database=NETCORE;User ID=sa;Password=Sa2016;"
   }
 }

appsetting.json

　　3.修改 Startup.cs 文件中 , 修改ConfigureServices方法注册Oralce&SqlServer连接

ConfigureServices

　　根据需要使用Oracle或者SqlServer，当前模式下只能选择一个。

　　填坑记录：在使用Oracle的时候一定要先请DBA将账号建制好

五.数据库迁移

　　1. 设定Demo.WebApi作为系统启动项

　　2.打开程序包管理控制台 => 默認项目选择Demo.EFCore

　　3.控制台中输入：Add-Migration Init

　　　　此时会在Demo.EFCore中生成一个文件夹 Migrations,该文件记录了数据迁移记录

　　4.控制台输入：Update-DataBase

　　5.数据库查询表已经生成

　　如果修改了实体对象（比如新增表或者修改表栏位）后，依次执行步骤3，4即可将修改结果保存到对应的数据库。

　　扩展：

　　1. dbContext.Database.EnsureDeleted(); dbContext.Database.EnsureCreated();用这两个方法，可以简单粗暴的将数据库删除在重建，就不用手动输入命令进行迁移，这样做很显然会导致数据库中已有的数据丢失。

　　2. 我们也可以使用dbContext.Database.Migrate()代替输入“Update-DataBase”命令而在程式中自动迁移，但是没有找到替代“Add-Migration”的命令。

六.初始化数据库表值

　　通常我们在上线项目后，数据库中都会有些初始值，在CodeFirst模式下，我们通过代码在数据库生成后将值注入。

　　1.在Demo.EFCore 新建DemoInitial.cs

 public class DemoInitial
     {
         public static void Initial(DbContext dbContext)
         {
             //简单粗暴创建数据库
             //删除数据库后从新创建数据库
             //如果删除报错，就手动去数据库删除
             //dbContext.Database.EnsureDeleted();
             //dbContext.Database.EnsureCreated();

             //程式自动检测有没有新的迁移没有反应到数据，有则更新数据库
             if(dbContext.Database.GetPendingMigrations().ToList().Count()>)
             {
                 dbContext.Database.Migrate();
             }

             //根据某一个表是否有数据来判断是否需要注入初始数据
             if(!dbContext.Set<Student>().Any())
             {
                 var student = new Student()
                 {
                     UserId = "C3700408",
                     Name = "Nemo"
                 };
                 dbContext.Set<Student>().Add(student);
                 dbContext.SaveChanges();
             }

         }
     }

　　2.修改Demo.WebApi Program,因为我们要在项目启动的时候去做这些事

  public static void Main(string[] args)
         {
             var host = CreateWebHostBuilder(args).Build();
             using (var scope = host.Services.CreateScope())
             {
                 var services = scope.ServiceProvider;
                 try
                 {
                     DemoDbInitial.Initial(services.GetService<DemoDbContext>());
                 }
                 catch (Exception ex)
                 {
                     //Do something
                 }
             }
             host.Run();
         }

　　3.运行代码,检测数据库

总结：

点击获取源码