FreeSql 是一个功能强大的 .NETStandard 库，用于对象关系映射程序(O/RM)，便于开发人员能够使用 .NETStandard 对象来处理数据库，不必经常编写大部分数据访问代码。支持 .NETCore 2.1+ 或 .NETFramework 4.6.1+。

Package Name	NuGet	Downloads
FreeSql
FreeSql.Repository

特性

支持 CodeFirst 迁移；
支持 DbFirst 从数据库导入实体类，支持三种模板生成器；
采用 ExpressionTree 高性能读取数据；
支持深入的类型映射，比如pgsql的数组类型，堪称匠心制作；
支持丰富的表达式函数；
支持导航属性查询，和延时加载；
支持同步/异步数据库操作方法，丰富多彩的链式查询方法；
支持读写分离、分表分库，租户设计；
支持多种数据库，MySql/SqlServer/PostgreSQL/Oracle/Sqlite；


入门	《Select》 \| 《Update》 \| 《Insert》 \| 《Delete》
新手	《表达式函数》 \| 《CodeFirst》 \| 《DbFirst》
高手	《Repository》 \| 《UnitOfWork》 \| 《过滤器》
不朽	《读写分离》 \| 《分区分表》 \| 《租户》 \| 更新日志

快速开始

var connstr = "Data Source=127.0.0.1;User ID=root;Password=root;" + 
    "Initial Catalog=cccddd;Charset=utf8;SslMode=none;Max pool size=10";

IFreeSql fsql = new FreeSql.FreeSqlBuilder()
    .UseConnectionString(FreeSql.DataType.MySql, connstr)
    .UseSlave("connectionString1", "connectionString2")
    //读写分离，使用从数据库，支持多个

    .UseMonitorCommand(
        cmd => Console.WriteLine(cmd.CommandText),
        //监听SQL命令对象，在执行前
        (cmd, traceLog) => Console.WriteLine(traceLog))
        //监听SQL命令对象，在执行后

    .UseLogger(null)
    //使用日志，不指定默认输出控制台 ILogger
    .UseCache(null)
    //使用缓存，不指定默认使用内存 IDistributedCache

    .UseAutoSyncStructure(true)
    //自动同步实体结构到数据库
    .UseSyncStructureToLower(true)
    //转小写同步结构
    .UseSyncStructureToUpper(true)
    //转大写同步结构
    .UseConfigEntityFromDbFirst(true)
    //若无配置实体类主键、自增，可从数据库导入
    .UseNoneCommandParameter(true)
    //不使用命令参数化执行，针对 Insert/Update，也可临时使用 IInsert/IUpdate.NoneParameter() 

    .UseLazyLoading(true)
    //延时加载导航属性对象，导航属性需要声明 virtual
    .Build();

实体

FreeSql 使用模型执行数据访问，模型由实体类表示数据库表或视图，用于查询和保存数据。

可从现有数据库生成实体模型，提供 IDbFirst 生成实体模型。

或者手动创建模型，基于模型创建或修改数据库，提供 ICodeFirst 同步结构的 API（甚至可以做到开发阶段自动同步）。

class Song {
    [Column(IsIdentity = true)]
    public int Id { get; set; }
    public DateTime? Create_time { get; set; }
    public bool? Is_deleted { get; set; }
    public string Title { get; set; }
    public string Url { get; set; }

    public virtual ICollection<Tag> Tags { get; set; }
}
class Song_tag {
    public int Song_id { get; set; }
    public virtual Song Song { get; set; }

    public int Tag_id { get; set; }
    public virtual Tag Tag { get; set; }
}
class Tag {
    [Column(IsIdentity = true)]
    public int Id { get; set; }
    public int? Parent_id { get; set; }
    public virtual Tag Parent { get; set; }

    public decimal? Ddd { get; set; }
    public string Name { get; set; }

    public virtual ICollection<Song> Songs { get; set; }
    public virtual ICollection<Tag> Tags { get; set; }
}

查询

//OneToOne、ManyToOne
var t0 = fsql.Select<Tag>().Where(a => a.Parent.Parent.Name == "粤语").ToSql();
//SELECT a.`Id`, a.`Parent_id`, a__Parent.`Id` as3, a__Parent.`Parent_id` as4, a__Parent.`Ddd`, a__Parent.`Name`, a.`Ddd` as7, a.`Name` as8 
//FROM `Tag` a 
//LEFT JOIN `Tag` a__Parent ON a__Parent.`Id` = a.`Parent_id` 
//LEFT JOIN `Tag` a__Parent__Parent ON a__Parent__Parent.`Id` = a__Parent.`Parent_id` 
//WHERE (a__Parent__Parent.`Name` = '粤语')

//OneToMany
var t1 = fsql.Select<Tag>().Where(a => a.Tags.AsSelect().Any(t => t.Parent.Id == 10)).ToSql();
//SELECT a.`Id`, a.`Parent_id`, a.`Ddd`, a.`Name` 
//FROM `Tag` a 
//WHERE (exists(SELECT 1 
//	FROM `Tag` t 
//	LEFT JOIN `Tag` t__Parent ON t__Parent.`Id` = t.`Parent_id` 
//	WHERE (t__Parent.`Id` = 10) AND (t.`Parent_id` = a.`Id`) 
//	limit 0,1))

//ManyToMany
var t2 = fsql.Select<Song>().Where(s => s.Tags.AsSelect().Any(t => t.Name == "国语")).ToSql();
//SELECT a.`Id`, a.`Create_time`, a.`Is_deleted`, a.`Title`, a.`Url` 
//FROM `Song` a
//WHERE(exists(SELECT 1
//	FROM `Song_tag` Mt_Ms
//	WHERE(Mt_Ms.`Song_id` = a.`Id`) AND(exists(SELECT 1
//		FROM `Tag` t
//		WHERE(t.`Name` = '国语') AND(t.`Id` = Mt_Ms.`Tag_id`)
//		limit 0, 1))
//	limit 0, 1))

更多前往wiki：《Select查询数据文档》

表达式函数

var t1 = select.Where(a => new[] { 1, 2, 3 }.Contains(a.testFieldInt)).ToSql();
//SELECT a.`Id`, a.`Clicks`, a.`TestTypeInfoGuid`, a.`Title`, a.`CreateTime` 
//FROM `Song` a 
//WHERE (a.`Id` in (1,2,3))

查找今天创建的数据

var t2 = select.Where(a => a.CreateTime.Date == DateTime.Now.Date).ToSql();

SqlServer 下随机获取记录

var t3 = select.OrderBy(a => Guid.NewGuid()).Limit(1).ToSql();
//SELECT top 1 ...
//FROM [Song] a 
//ORDER BY newid()

更多前往wiki：《Expression 表达式函数文档》

返回数据

List<Song> t1 = fsql.Select<Song>().Where(a => a.Id > 0).ToList();

//返回普通字段 + 导航对象 Type 的数据
List<Song> t2 = fsql.Select<Song>().LeftJoin(a => a.Type.Id == a.TypeId).ToList();

//返回一个字段
List<int> t3 = fsql.Select<Song>().Where(a => a.Id > 0).ToList(a => a.Id);

//返回匿名类型
List<匿名类型> t4 = fsql.Select<Song>().Where(a => a.Id > 0).ToList(a => new { a.Id, a.Title });

//返回元组
List<(int, string)> t5 = fsql.Select<Song>().Where(a => a.Id > 0).ToList<(int, string)>("id, title");

//返回SQL字段
List<匿名类> t4 = select.Where(a => a.Id > 0).Skip(100).Limit(200)
    .ToList(a => new {
        a.Id, a.Title,
        cstitle = "substr(a.title, 0, 2)", //将 substr(a.title, 0, 2) 作为查询字段
        csnow = Convert.ToDateTime("now()"), //将 now() 作为查询字段
        //奇思妙想：怎么查询开窗函数的结果
    });

执行SQL返回数据

List<Song> t6 = fsql.Ado.Query<Song>("select * from song");
List<(int, string ,string)> t7 = fsql.Ado.Query<(int, string, string)>("select id,title,url from song");
List<dynamic> t8 = fsql.Ado.Query<dynamic>("select * from song");

更多前往wiki：《Select查询数据》

性能测试

FreeSql Query & Dapper Query

Elapsed: 00:00:00.6733199; Query Entity Counts: 131072; ORM: Dapper

Elapsed: 00:00:00.4554230; Query Tuple Counts: 131072; ORM: Dapper

Elapsed: 00:00:00.6846146; Query Dynamic Counts: 131072; ORM: Dapper

Elapsed: 00:00:00.6818111; Query Entity Counts: 131072; ORM: FreeSql*

Elapsed: 00:00:00.6060042; Query Tuple Counts: 131072; ORM: FreeSql*

Elapsed: 00:00:00.4211323; Query ToList<Tuple> Counts: 131072; ORM: FreeSql*

Elapsed: 00:00:01.0236285; Query Dynamic Counts: 131072; ORM: FreeSql*

FreeSql ToList & Dapper Query

Elapsed: 00:00:00.6707125; ToList Entity Counts: 131072; ORM: FreeSql*

Elapsed: 00:00:00.6495301; Query Entity Counts: 131072; ORM: Dapper

测试方法：运行两次，以第二次性能报告，避免了首个运行慢不公平的情况。查看测试代码

FreeSql 目前使用的ExpressionTree+缓存，因为支持更为复杂的数据类型，所以比 Dapper Emit 慢少许。

贡献者名单

systemhejiyong LambertW

dystudio / freesql Goto Github PK

freesql's Introduction

特性

快速开始

实体

查询

表达式函数

返回数据

性能测试

贡献者名单

freesql's People

Contributors

Watchers

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent