Wpf 使用 Prism 实战开发Day11-编程知识

仓储（Repository）/工作单元（Unit Of Work）模式

仓储（rep）:仓储接口定义了对实体类访问数据库及操作的方法。它统一管理数据访问的逻辑，并与业务逻辑层进行解耦。简单的理解就是对访问数据库的一层接口封装。
工作单元（uow）:用来保证我们处理业务逻辑的，稳定性，完整性。防止在业务操作过程中，涉及对数据库多张表进行了增删改查（CURD）的时候，部分成功，部分失败。类似数据库中开的事务。

一.实现基础的仓储接口

1.新建一个 Repository (仓储) 文件夹，用来存放我们定义各个实体类对数据库操作的仓储。也就是对各个实体（表）进行增删改查的定义及实现，以及更高级的操作，例，分页，工作单元，事务，等等。

1. 创建待办事项仓储接口类 IToDoRepository 并且定义了（ToDo）实体对数据库CURD 的方法

    public interface IToDoRepository{Task<bool> Add(ToDo toDo);bool Delete(ToDo toDo);bool Update(ToDo toDo);Task<ToDo> GetToDo();}

2. 创建待办事项仓储的实现类 ToDoRepository。该类继承自 IToDoRepository 仓储接口类，并且需要实现父类所有定义的方法。

public class ToDoRepository : IToDoRepository
{private readonly MyToDoContext doContext;public ToDoRepository(MyToDoContext doContext){this.doContext = doContext;}/// <summary>/// 增加/// </summary>/// <param name="toDo"></param>/// <returns></returns>public async Task<bool> Add(ToDo toDo){await doContext.ToDo.AddAsync(toDo);return await doContext.SaveChangesAsync()>0;}/// <summary>/// 删除/// </summary>/// <param name="toDo"></param>/// <returns></returns>public  bool Delete(ToDo toDo){doContext.ToDo.Remove(toDo);    return  doContext.SaveChanges()>0;}/// <summary>///  更新/// </summary>/// <param name="toDo"></param>/// <returns></returns>public bool Update(ToDo toDo){doContext.ToDo.Update(new ToDo{Id = toDo.Id,Title=toDo.Title,Content=toDo.Content,});return  doContext.SaveChanges()>0;}/// <summary>/// 查询/// </summary>/// <returns></returns>public async Task<ToDo> GetToDo(){var toDo=await doContext.ToDo.FirstOrDefaultAsync();return toDo;}
}

以上就是定义和实现的某个实体类仓储的基础写法。并且接口命名规范要用大写字母 I开头，实现类就去掉 I 字母。例如：定义仓储接口类： IToDoRepository, 仓储接口实现类：ToDoRepository
执行完操作后，要保存到数据库，需要调用 SaveChangesAsync。异步方法需要加Async,同步方法则去掉Async.其他的方法使用异步或同步也是同样的道理。

二.如何使用仓储

1. 在 Program.cs 中，进行注入

builder.Services.AddScoped<IToDoRepository,ToDoRepository>();

2. 在控制器构造函数中实例化定义的仓储接口，并且通过 toDoRepository 实例去调用到定义的方法。

namespace MyToDo.Api.Controllers
{[ApiController][Route("[controller]/[action]")]public class WeatherForecastController : ControllerBase{private readonly IToDoRepository toDoRepository;public WeatherForecastController(IToDoRepository toDoRepository){this.toDoRepository = toDoRepository;}[HttpGet(Name = "GetToDo")]public async Task<ToDo> Get(){var  retsult= await toDoRepository.GetToDo();return retsult;}[HttpPost(Name = "Add")]public async Task<bool> AddAsync(ToDo toDo){var retsult = await toDoRepository.Add(toDo);return retsult;}[HttpDelete(Name = "Delete")]public bool Deletes(ToDo toDo){var retsult =  toDoRepository.Delete(toDo);return retsult;}[HttpPost(Name = "Update")]public bool UpdateAsync(ToDo toDo){var retsult = toDoRepository.Update(toDo);return retsult;}}
}

测试接口的时候，点击Try in out,再执行 Execute.如果没有问题，就能看到查询返回的数据了。
注意：控制器里面的添加的路由，已经改成完整的路由了。由控制器/方法组合而成的唯一路由。例如： [Route("[controller]/[action]")]
以上实现了 ToDo 实体对数据库基础的增删改查，虽然实际应用中还远远达不到使用需求，这个只是为了能去理解仓储模式的建立和使用。所有仓储底层操作数据库都大同小异。如果有别人写好的仓储，各性能各方面都相当ok，或者有其他的更主流的 orm框架，我们拿来用即可。避免重复造轮子，除非能造出更好的轮子了。

三.工作单元（Unit Of Work）

自个实现的仓储太简单，在实际应用中，如果涉及多张表操作，暂时无法保证数据的一致性。可能还需要花很多时间去修改代码达到使用需求。所以在 github 中已经有更好的实现方案 UnitOfWork，也包含了仓储接口的定义，直接拿来用即可。
使用 uow 好处，多个仓储之间可以共享上下文（DbContext）以及保证操作数据一致性和完整性。

1. 下载 Unit Of Work 源码

2.在MyToDo.Api 项目中，创建一个 UnitOfWork 文件夹，并且把以下代码复制过来

3. 创建一个类库项目去存放，共用的代码

4.选择类库项目，点下一步，并且项目名称定义成：MyToDo.Shared

5.把共用的代码，复制到 MyToDo.Shared 里面去

6.在MyToDo.Api 项目中，右键=》添加=》项目引用

7.勾选 MyToDo.Shared。表示在 MyToDo.Api引用该项目，点击确定。

8.最后，还需要在MyToDo.Api 项目的NuGet 中下载安装这个包

Microsoft.EntityFrameworkCore.AutoHistory

复制过来的代码，命名空间要更改。如果有其他报错，例如：报某个方法访问性不一至，找到那个方法。把访问修饰符 internal 改成public 就可以了。

UnitOfWork 文件夹的源码以及 MyToDo.Shared 等2个公共文件夹里面的源码，自行去github下载了

目前，整个完整的项目结构，如下：

四.如何使用工作单元（Unit Of Work）

1. 先添加不同仓储的实现，例如，待办事项仓储（ToDoRepository）

    public class ToDoRepository : Repository<ToDo>, IRepository<ToDo>{public ToDoRepository(MyToDoContext dbContext) : base(dbContext){}}

这个就是使用别人提供的 Unit Of Work中已写好的仓储接口，然后自己自定义仓储去继承并实现它的一个标准写法。这样就能调用到别人集成好的方法。集成到自己的业务逻辑中去。

2.在Program.cs 中进行依赖注入

builder.Services.AddDbContext<MyToDoContext>(option =>
{//获取数据库连接var connectionString = builder.Configuration.GetConnectionString("ToDoConnection");//使用sqliteoption.UseSqlite(connectionString);
}).AddUnitOfWork<MyToDoContext>() //注入工作单元
.AddCustomRepository<ToDo,ToDoRepository>() //注入仓储
.AddCustomRepository<Memo, MemoRepository>()
.AddCustomRepository<User, UserRepository>();

3.使用方式

namespace MyToDo.Api.Controllers
{[ApiController][Route("[controller]/[action]")]public class WeatherForecastController : ControllerBase{private readonly IUnitOfWork unitOfWork;public WeatherForecastController(IUnitOfWork unitOfWork){this.unitOfWork = unitOfWork;}[HttpGet(Name = "GetToDo")]public async Task<List<ToDo>> Get(){var  service= unitOfWork.GetRepository<ToDo>();//获取仓储服务return (List<ToDo>)await service.GetAllAsync();}}
}