LunchPail 2.1.1

LunchPail

LunchPail 是针对 ADO.NET 的 .NET Standard 兼容 Unit of Work 实现。UoW 是数据上下文的工作马，因此该项目被称为“午餐盒”，以参考蓝领运动员。

入门

1. 在您的 IoC 容器中注册上下文（以下以 .NET Core 和 SQL Server 为例）

//startup.cs
public void ConfigureServices(IServiceCollection services)
{
  //rest of code...

  //context
  services.AddTransient<IDbConnectionFactory>(options =>
  {
    var builder = new SqlConnectionStringBuilder(Configuration.GetConnectionString("DefaultConnection"));

    return new DbConnectionFactory(() =>
    {
      var conn = new SqlConnection(builder.ConnectionString);

      conn.Open();
      return conn;
    });
  });
  services.AddScoped<IDbContext, DbContext>();

  //repositories (we'll add this later)
}

2. 创建一个表示您的数据库对象的域类。

public class Product
{
  public int Id { get; set; }
  public string Name { get; set; }
}

3. 创建一个依赖 IDbContext 的仓储

public interface IProductRepository
{
  Task<Product> Read (int id);
}

public class ProductRepository : DbRepository
{
  public ProductRepository(IDbContext dbContext) : base(dbContext) { }

  public Product Read(int id)
  {
    return Connection.QuerySingleOrDefault<Product>("select * from dbo.Product where Id = @id", new { id }, transaction: Transaction);
  }
}

4. 将仓储注册到您的 IoC 容器中（以下以 .NET Core 为例）

//startup.cs
public void ConfigureServices(IServiceCollection services)
{
  //repositories
  services.AddScoped<IProductRepository, ProductRepository>();
}

5. 注册上下文和仓储后，您可以将其注入到控制器或服务层。

请注意，调用 dbContext.Commit() 必须在每次交互完成后发生，以确保正确释放连接。无论是读取还是写入，都适用此规定。

public class ProductService
{
  private readonly IDbContext dbContext;
  private readonly IProductRepository productRepository;

  public ProductService (
    IDbContext dbContext,
    IProductRepository productRepository)
  {
    this.dbContext = dbContext;
    this.productRepository = productRepository;
  }

  public Product Read(int id)
  {
    var product = productRepository.Read(id);
    dbContext.Commit(); // You MUST call commit after all interactions

    return product;
  }
}

由 Pim Brouwers 在多伦多，安大略省，倾心打造。