https://github.com/2881099/freesql.dbcontext

FreeSql 扩展包，实现真正的 ORM，Repository DbContext UnitOfWork 实现。
https://github.com/2881099/freesql.dbcontext

codefirst dbcontext entity orm

Last synced: 7 months ago
JSON representation

FreeSql 扩展包，实现真正的 ORM，Repository DbContext UnitOfWork 实现。

• Host: GitHub
• URL: https://github.com/2881099/freesql.dbcontext
• Owner: 2881099
• License: mit
• Created: 2019-04-01T01:31:16.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2019-06-26T02:20:07.000Z (almost 7 years ago)
• Last Synced: 2025-08-01T01:07:10.941Z (9 months ago)
• Topics: codefirst, dbcontext, entity, orm
• Language: C#
• Homepage:
• Size: 154 KB
• Stars: 40
• Watchers: 2
• Forks: 13
• Open Issues: 2
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

          

# 源码于【2019年06月26日】移至 FreeSql 仓储维护。。。

这是 [FreeSql](https://github.com/2881099/FreeSql) 衍生出来的扩展包，包含 DbContext & DbSet、Repository & UnitOfWork 实现面向对象的特性（QQ群：4336577）。

> dotnet add package FreeSql.DbContext

## 更新日志

### v0.6.5

- 修复 Repository 联级保存的 bug；

- 添加工作单元开启方法；

- 适配 .net framework 4.5、netstandard 2.0；

### v0.6.1

- 拆分 FreeSql 小包引用，各数据库单独包、延时加载包；

- FreeSql.Extensions.LazyLoading

- FreeSql.Provider.MySql

- FreeSql.Provider.PostgreSQL

- FreeSql.Provider.SqlServer

- FreeSql.Provider.Sqlite

- FreeSql.Provider.Oracle

- 移除 IFreeSql.Cache，以及 ISelect.Caching 方法；

- 移除 IFreeSql.Log，包括内部原有的日志输出，改为 Trace.WriteLine；

- IAdo.Query\ 读取返回变为 List\\>；

- 定义 IFreeSql 和以前一样，移除了 UseCache、UseLogger 方法；

## DbContext & DbSet

```csharp

using (var ctx = new SongContext()) {

    var song = new Song { BigNumber = "1000000000000000000" };

    ctx.Songs.Add(song);

    song.BigNumber = (BigInteger.Parse(song.BigNumber) + 1).ToString();

    ctx.Songs.Update(song);

    var tag = new Tag {

        Name = "testaddsublist",

        Tags = new[] {

            new Tag { Name = "sub1" },

            new Tag { Name = "sub2" },

            new Tag {

                Name = "sub3",

                Tags = new[] {

                    new Tag { Name = "sub3_01" }

                }

            }

        }

    };

    ctx.Tags.Add(tag);

    ctx.SaveChanges();

}

```

## Repository & UnitOfWork

仓储与工作单元一起使用，工作单元具有事务特点。

```csharp

using (var unitOfWork = fsql.CreateUnitOfWork()) {

    var songRepository = unitOfWork.GetRepository();

    var tagRepository = unitOfWork.GetRepository();

    var song = new Song { BigNumber = "1000000000000000000" };

    songRepository.Insert(song);

    songRepository.Update(song);

    song.BigNumber = (BigInteger.Parse(song.BigNumber) + 1).ToString();

    songRepository.Update(song);

    var tag = new Tag {

        Name = "testaddsublist",

        Tags = new[] {

            new Tag { Name = "sub1" },

            new Tag { Name = "sub2" },

            new Tag {

                Name = "sub3",

                Tags = new[] {

                    new Tag { Name = "sub3_01" }

                }

            }

        }

    };

    tagRepository.Insert(tag);

    ctx.Commit();

}

```

## Repository

简单使用仓储，有状态跟踪，它不包含事务的特点。

```csharp

var songRepository = fsql.GetRepository();

var song = new Song { BigNumber = "1000000000000000000" };

songRepository.Insert(song);

```

## IFreeSql 核心定义

```csharp

var fsql = new FreeSql.FreeSqlBuilder()

    .UseConnectionString(FreeSql.DataType.Sqlite, @"Data Source=|DataDirectory|\dd2.db;Pooling=true;Max Pool Size=10")

    .UseAutoSyncStructure(true)

    .UseNoneCommandParameter(true)

    .UseMonitorCommand(cmd => Trace.WriteLine(cmd.CommandText))

    .Build();

public class Song {

    [Column(IsIdentity = true)]

    public int Id { get; set; }

    public string BigNumber { get; set; }

    [Column(IsVersion = true)] //乐观锁

    public long versionRow { get; set; }

}

public class Tag {

    [Column(IsIdentity = true)]

    public int Id { get; set; }

    public int? Parent_id { get; set; }

    public virtual Tag Parent { get; set; }

    public string Name { get; set; }

    public virtual ICollection Tags { get; set; }

}

public class SongContext : DbContext {

    public DbSet Songs { get; set; }

    public DbSet Tags { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder builder) {

        builder.UseFreeSql(fsql);

    }

}

```

# 过滤器与验证

假设我们有User(用户)、Topic(主题)两个实体，在领域类中定义了两个仓储：

```csharp

var userRepository = fsql.GetGuidRepository();

var topicRepository = fsql.GetGuidRepository();

```

在开发过程中，总是担心 topicRepository 的数据安全问题，即有可能查询或操作到其他用户的主题。因此我们在v0.0.7版本进行了改进，增加了 filter lambad 表达式参数。

```csharp

var userRepository = fsql.GetGuidRepository(a => a.Id == 1);

var topicRepository = fsql.GetGuidRepository(a => a.UserId == 1);

```

* 在查询/修改/删除时附加此条件，从而达到不会修改其他用户的数据；

* 在添加时，使用表达式验证数据的合法性，若不合法则抛出异常；

# 分表与分库

FreeSql 提供 AsTable 分表的基础方法，GuidRepository 作为分存式仓储将实现了分表与分库（不支持跨服务器分库）的封装。

```csharp

var logRepository = fsql.GetGuidRepository(null, oldname => $"{oldname}_{DateTime.Now.ToString("YYYYMM")}");

```

上面我们得到一个日志仓储按年月分表，使用它 CURD 最终会操作 Log_201903 表。

合并两个仓储，实现分表下的联表查询：

```csharp

fsql.GetGuidRepository().Select.FromRepository(logRepository)

    .LeftJoin(b => b.UserId == a.Id)

    .ToList();

```

注意事项：

* 不能使用 CodeFirst 迁移分表，开发环境时仍然可以迁移 Log 表；

* 不可在分表分库的实体类型中使用《延时加载》；

# 历史版本

### v0.5.23

- 增加 DbSet/Repository FlushState 手工清除状态管理数据；

### v0.5.21

- 修复 AddOrUpdate/InsertOrUpdate 当主键无值时，仍然查询了一次数据库；

- 增加 查询数据时 TrackToList 对导航集合的状态跟踪；

- 完善 AddOrUpdateNavigateList 联级保存，忽略标记 IsIgnore 的集合属性；

- 完成 IFreeSql.Include、IncludeMany 功能；

### v0.5.12

- 增加 工作单元开关，可在任意 Insert/Update/Delete 之前调用，以关闭工作单元使其失效；[PR #1](https://github.com/2881099/FreeSql.DbContext/pull/1)

### v0.5.9

- 增加 linq to sql 的查询语法，以及单元测试，[wiki](https://github.com/2881099/FreeSql/wiki/LinqToSql)；

- 修复 EnableAddOrUpdateNavigateList 设置对异步方法无效的 bug；

### v0.5.8

- 增加 IFreeSql.SetDbContextOptions 设置 DbContext 的功能：开启或禁用连级一对多导航集合属性保存的功能，EnableAddOrUpdateNavigateList（默认开启）；

- 增加 IUnitOfWork.IsolationLevel 设置事务级别；

### v0.5.7

- 修复 UnitOfWork.GetRepository() 事务 bug，原因：仓储的每步操作都提交了事务；

### v0.5.5

- 修复 MapEntityValue 对 IsIgnore 未处理的 bug；

### v0.5.4

- 修复 Repository 追加导航集合的保存 bug；

- 公开 IRepository.Orm 对象；

### v0.5.3

- 修复 实体跟踪的 bug，当查询到的实体自增值为 0 时重现；

- 优化 状态管理字典为 ConcurrentDictionary；

### v0.5.2

- 优化 SqlServer UnitOfWork 使用bug，在 FreeSql 内部解决的；

- 补充 测试与支持联合主键的自增；

### v0.5.1

- 补充 开放 DbContext.UnitOfWork 对象，方便扩展并保持在同一个事务执行；

- 补充 增加 DbSet\、Repository\ 使用方法，配合 AsType(实体类型)，实现弱类型操作；

- 修复 DbContext.AddOrUpdate 传入 null 时，任然会查询一次数据库的 bug；

- 优化 DbContext.AddOrUpdate 未添加实体主键的错误提醒；

- 修复 DbContext.Set\ 缓存的 bug，使用多种弱类型时发生；

- 修复 IsIgnore 过滤字段后，查询的错误；

- 修复 全局过滤器功能迁移的遗留 bug；

### v0.4.14

- 优化 Add 时未设置主键的错误提醒；

### v0.4.13

- 补充 Repository 增加 Attach 方法；

- 优化 Update/AddOrUpdate 实体的时候，若状态管理不存在，尝试查询一次数据库，以便跟踪对象；

### v0.4.12

- 修复 非自增情况下，Add 后再 Update 该实体时，错误（需要先 Attach 或查询）的 bug；

### v0.4.10

- 补充 开放 DbContext.Orm 对象；

- 修复 OnConfiguring 未配置时注入获取失败的 bug；

### v0.4.6

- 修复 DbSet AddRange/UpdateRange/RemoveRange 参数为空列表时报错，现在不用判断 data.Any() == true 再执行；

- 增加 DbContext 对 DbSet 的快速代理方法(Add/Update/Remove/Attach)；

- 增加 DbContext 通用类，命名为：FreeContext，也可以通过 IFreeSql 扩展方法 CreateDbContext 创建；

- 增加 ISelect NoTracking 扩展方法，查询数据时不追踪（从而提升查询性能）；

### v0.4.5

- 增加 DbSet Attach 方法附加实体，可用于不查询就更新或删除；

### v0.4.2

- 增加 DbSet UpdateAsync/UpdateRangeAsync 方法，当一个实体被更新两次时，会先执行前面的队列；

- 增加 GetRepository 获取联合主键的适用仓储类；

- 增加 DbSet 在 Add/Update 时对导航属性(OneToMany) 的处理（AddOrUpdate）；

### v0.4.1

- 独立 FreeSql.DbContext 项目；

- 实现 Repository + DbSet 统一的状态跟踪与工作单元；

- 增加 DbSet AddOrUpdate 方法；

- 增加 Repository InsertOrUpdate 方法；