欢迎来到《FreeSql.Repository 仓储模式》系列文档,本系列文档专注介绍 【仓储+工作单元】 的使用方式。完整文档请前往 wiki 中心:https://github.com/dotnetcore/FreeSql/wiki

FreeSql.Repository 作为 FreeSql.dll 的扩展,实现了通用仓储层功能,开箱即可,可甜可咸。

安装

环境1、.NET Core 或 .NET 5.0+

dotnet add package FreeSql.Repository

环境2、.NET Framework

Install-Package FreeSql.DbContext

定义

使用 FreeSql.Repository 仍然需要提前创建 IFreeSql:

static IFreeSql fsql = new FreeSql.FreeSqlBuilder()
    .UseConnectionString(FreeSql.DataType.Sqlite, connectionString)
    .UseAutoSyncStructure(true) //自动迁移实体的结构到数据库
    .Build(); //请务必定义成 Singleton 单例模式public class Song
{
    [Column(IsIdentity = true)]    public int Id { get; set; }    public string Title { get; set; }
}

使用方法

方法1、IFreeSql 的扩展方法,在编码中的任何地方都可以这样使用;

var curd = fsql.GetRepository<Song>();
crud.Insert(new Song()); //插入
curd.Update(new Song { Id = 10, Title = "爱你一万年" });//...

注意:同一个 Repository 实例对象在多线程中使用不安全

repo.Insert 插入数据,适配各数据库优化执行 ExecuteAffrows/ExecuteIdentity/ExecuteInserted
如果实体类有自增,插入后的值将回填给实体对象

方法2、继承实现;

public class SongRepository : BaseRepository<Song, int>
{    public SongRepository(IFreeSql fsql) : base(fsql, null, null) {}    //在这里增加 CURD 以外的方法
}

方法3、依赖注入;

public void ConfigureServices(IServiceCollection services)
{
    services.AddSingleton<IFreeSql>(fsql);
    services.AddFreeRepository(null, this.GetType().Assembly);
}//在控制器使用public SongController(IBaseRepository<Song> repo1, SongRepository repo2)
{
}