（1）从零开始搭建基于DDD的.net core6.0后端服务-EF Core

系列文章目录

第一章 EF Core CodeFirst 环境搭建

前言

随时微服务和DDD越来越流行，自己也想尝试着搭建一个完整的后端框架，有些人可能会说重复造轮子，其实我最开始也是这样考虑直接用ABP vnext不是很好吗？ 但是从我用ABP之后的感受是，ABP还是对我这种水平比较普通的程序员来讲过框架过于重了，从现在开始我可能会从我的理解一步一步搭建DDD的服务框架。

一、EF Core CodeFirst？

EF Core 是一个 O/RM(Object Relational Mapping)对象关系映射框架。这也是要实现DDD领域驱动的基础设施。

二、使用步骤

1.创建项目

1.1 新建类库-领域层，名称可自定义如xxx.xxx.Domain
1.2 新建类库-领域层共通，名称可自定义如xxx.xxx.Domain.Shared

1.3 新建Asp.Net core Web API，名称可自定义如 xxx.xxx.EntityFrameworkCore

在EntityFrameworkCore项目中 NuGet添加如下

2.创建实体

2.1 在Domain项目中创建实体Entity

/// <summary>
    /// 基础字典
    /// </summary>
    public class BasicDictionary
    {
        [Key]
        public Guid ID { get; set; }

        /// <summary>
        /// 字典代码
        /// </summary>
        [MaxLength(40),Required]
        public string Code { get; set; }

        /// <summary>
        /// 字典名称
        /// </summary>
        [MaxLength(80), Required]
        public string Name { get; set; }

        /// <summary>
        /// 拼音码
        /// </summary>
        [MaxLength(40), Required]
        public string PinYinCode { get; set; }

        /// <summary>
        /// 字典类型
        /// </summary>
        [Required]
        public BasicDictionaryType Type { get; set; }

        /// <summary>
        /// 字典状态
        /// </summary>
        [Required]
        public BasicDictionaryStatus Status { get; set; }

        /// <summary>
        /// 排序
        /// </summary>
        [Required]
        public int Sort { get; set; }
    }

2.2 在Domain.Shared 项目中创建枚举类

/// <summary>
    /// 基础字典状态
    /// </summary>
    public enum BasicDictionaryStatus
    {
        Invalid = 0,
        Valid = 1
    }

 /// <summary>
    /// 基础字典类别
    /// </summary>
    public enum BasicDictionaryType
    {
        WarehouseType = 0,
    }

3.创建EF Core DbContext

3.1 在EntityFrameworkCore 项目中创建DbContext

public class PSIDbContext : DbContext
    {
        public DbSet<BasicDictionary> BasicDictionaries { get; set; }

        /// <summary>
        /// 
        /// </summary>
        /// <param name="options"></param>
        public PSIDbContext(DbContextOptions<PSIDbContext> options)
            : base(options)
        {
        }

        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
            base.OnConfiguring(optionsBuilder);
        }

        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            base.OnModelCreating(modelBuilder);
        }
    }

在appsettings.json中添加数据库连接字符串

"connectionStrings": {
    "default": "Data Source=xxx;Initial Catalog=temp;User Id =xxx;Password=xxx"
  },

在Program中添加EF配置

#region ef

var configurationBuilder = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json");
var config = configurationBuilder.Build();

builder.Services.AddDbContext<PSIDbContext>(options => options.UseSqlServer(config["connectionStrings:default"]));

#endregion

3.2 在程序包管理控制台执行命令进行迁移及更新。

打开VS 工具→NuGet包管理器→程序包管理控制台。
首先输入Add-Migration innit执行，接着输入Update-Database执行。

4.创建Controller 测试查询数据

4.1 创建controller

[ApiController]
    [Route("[controller]")]
    public class BasicDictionaryController : ControllerBase
    {
        private PSIDbContext _context;

        public BasicDictionaryController(PSIDbContext context)
        {
            _context = context;
        }

        [HttpGet]
        public IEnumerable<BasicDictionary> Get()
        {
            using (_context)
            {
                //使用ef添加一条数据
                BasicDictionary basicDictionary = new BasicDictionary();
                basicDictionary.ID = Guid.NewGuid();
                basicDictionary.Code = "1";
                basicDictionary.Name = "2";
                basicDictionary.Sort = 0;
                basicDictionary.Type = Domain.Shared.BasicDictionaryType.WarehouseType;
                basicDictionary.PinYinCode = "*";
                basicDictionary.Status = Domain.Shared.BasicDictionaryStatus.Valid;

                _context.BasicDictionaries.Add(basicDictionary);
                _context.SaveChanges();

                var items = _context.BasicDictionaries.Where(b => true).ToList();

                return items;
            }
        }
    }

在浏览器输入地址 http://localhost:xxx/BasicDictionary 测试即可。

总结

最终项目目录结构如下

以上就是今天要讲的内容，本文仅仅简单介绍了EF core code first的搭建，随着章节的深入会不断完善各个部分功能，谢谢大家。