分享自己的超轻量级高性能ORM数据访问框架Deft

Deft 简介

Deft是一个超轻量级高性能O/R mapping数据访问框架,简单易用,几分钟即可上手。

Deft包含如下但不限于此的特点:

1、按照Transact-SQL的语法语义风格来设计,只要调用者熟悉基本的Transact-SQL语法即可瞬间无忧开码,大大降低了学习Deft的成本,甚至零成本。
2、性能十分不错(个人觉得易用性很重要,只要性能不拖后腿就好了),通过缓存+Emit反射IDataReader,极速获取List<T>。
3、强大的查询功能,支持使用Lambda表达式任意组装where条件,支持各种各样的运算符和括号优先级,支持给查询字段取别名。
4、支持SQLServer、MySQL、Oracle、SQLite等多数据库类型,同时也支持一个业务系统里面存在多个数据库。
5、支持事务、分页查询、排序等。
6、支持like,in等sql操作符,支持avg,count,max,min,sum等sql函数。
7、颜值高,整套语法接口设计的十分巧妙,支持Lambda 表达式,链式编程,任意组装sql,极度美观。
8、支持手写sql, List<T> Select<T>(string sql)。
9、各种映射能力,包括任意查询的结果映射,支持dynamic。
10、实体类非常简单,手写即可,不需要借助工具,也没有特性标记或者继承BaseEntity等杂七杂八的东西。
11、参数化赋值,防止sql注入。
12、开放DbHelper,满足特定使用场景(比如考勤报表),可以直接执行成百上千行的复杂sql。
13、对象化操作,编译时检查。使用Lambda 表达式做写入操作时,只会对表达式指定的字段做写入操作。
14、调用代码极其简单,干净清爽,可读性强,方便维护。
15、对外抛出OnDbExecute事件,调用方可自行处理日志埋点、sql监控等。
16、开发效率快,基本无配置,无工具支持也可以开发。
17、超轻量、体积小。
18、......等您来发现

不需要xxx入门系列,不需要xxx开发文档,不需要xxx使用教程,不需要繁琐的配置,不需要晦涩难懂的使用方式,不需要xxx。。。一切从简。
因为Deft的设计使用初衷就是一个初学者花30秒钟配置数据库连接信息,然后花3分钟扫一眼和Transact-SQL极度相似的链式语法就可以做到对数据库的访问。

编译后的Release版本只有59KB

 

为什么叫Deft?
 

Deft 核心类介绍

Deft共计有4个核心类
Jugg      用于对外提供ORM核心方法的静态类
JuggContext      用于对外提供ORM核心方法的实例类
JuggDbHelper    用于数据库访问的帮助类
JuggConfig    用于设置一些配置项的静态类

Jugg一词来源于游戏中的剑圣,是一个敏捷且攻击属性都很强的战斗英雄

 

Deft 3分钟即可上手使用

实体类

public class UserInfo
{
    public Int32 Id { get; set; }

    public String Name { get; set; }

    public Byte? Age { get; set; }

    public Byte? Sex { get; set; }

    public String Email { get; set; }

    public String Address { get; set; }

    public String Remark { get; set; }

    public Object Test { get; set; } //无意义字段
}

 

.config文件中配置数据库连接信息

硬编码也可以配置数据库连接信息,遵守约定大于配置

JuggConfig.DefaultDbConCfg = new ConnectionStringSettings { ProviderName = "System.Data.SqlClient", ConnectionString = "server=.;database=Northwind;integrated security=SSPI" };

 

强大灵活且易用的语法 

//简单查询
var list = Jugg.Select<UserInfo>().Query();

//查询指定的几个字段
list = Jugg.Select<UserInfo>(x => x.Name).Query();
list = Jugg.Select<UserInfo>(x => new { x.Id, x.Name, x.Email }).Query();

//查询的时候,给字段取别名
list = Jugg.Select<UserInfo>(x => new { UserId = x.Id, UserName = x.Name, x.Email }).Query();

//查询的时候取表别名,订单拆表,查询2016年8月份的订单
list = Jugg.Select<Order>().
            From("Order_201608").
            Where(x => x.Id != null).
            OrderBy(x => x.Id).
            GetPage(8, 50).
            Query();

//带简单where条件
int idParameter = 23;
list = Jugg.Select<UserInfo>().Where(x => x.Id != idParameter).Query();

//强大的查询功能,任意组装where条件
int[] aryId = { 1, 2, 3 };
list = Jugg.Select<UserInfo>().
            Where(x =>
                    x.Id != null &&                          // where Id is not null
                    (x.Age > 18 || x.Email == null) &&       // and ( Age>18 or Email is null )
                    x.Id.ToString().Contains("8") &&         // and Id like '%8%'
                    aryId.Contains(x.Id) &&                  // and Id in (1,2,3)
                    x.Name.StartsWith("") &&               // and Name like '张%'
                    x.Remark.EndsWith("test") &&             // and Remark like '%test'
                    x.Email.Contains("@qq.com") ||           // and Email like '%@qq.com%'
                    x.Address != null                        // or  Address is not null
                    ).
            Query();

//排序
list = Jugg.Select<UserInfo>().Where(x => x.Id > 0).OrderBy(x => x.Id).Query();
list = Jugg.Select<UserInfo>().
            Where(x => x.Id > 0).
            OrderByDesc(x => x.Id).
            Query();

//分页查询
list = Jugg.Select<UserInfo>().
            Where(x => x.Id != null && (x.Age > 18 || x.Email == null)).
            GetPage().            //查询第1页,每页记录数读取JuggConfig.PageRecordCount配置的值
            Query();
list = Jugg.Select<UserInfo>().
            GetPage(5, 80).       //查询第5页,每页80条记录
            Query();

//查询某一个范围的记录
list = Jugg.Select<UserInfo>().
            GetRange(337, 100).       //查询第337~437条记录
            Query();


//手写sql查询,支持dynamic映射
List<dynamic> listDynamic = Jugg.Select("select * from UserInfo where Id>99;");
list = Jugg.Select<UserInfo>("select * from UserInfo where Id>99;");

listDynamic = Jugg.GetPage("select * from UserInfo where Id>99;");
list = Jugg.GetPage<UserInfo>("select * from UserInfo where Id>99;");

listDynamic = Jugg.GetRange("select * from UserInfo where Id>99;");
list = Jugg.GetRange<UserInfo>("select * from UserInfo where Id>99;");


//单条记录查询
var u = Jugg.Find<UserInfo>(x => x.Id == 0);
u = Jugg.Single<UserInfo>(x => x.Id == 239);

//根据条件判断记录是否存在
bool b = Jugg.Exists<UserInfo>(x => x.Id == 105);

//Max 函数返回一列中的最大值。null 值不包括在计算中。
int uid = Jugg.Max<UserInfo>(x => x.Id).Query<int>();

//Min 函数返回一列中的最小值。null 值不包括在计算中。
uid = Jugg.Min<UserInfo>(x => x.Id).Where(x => x.Id > 1000).Query<int>();

//Avg 函数返回数值列的平均值。null 值不包括在计算中。
int age = Jugg.Avg<UserInfo>(x => x.Age).Query<int>();

//Sum 函数返回数值列的总数(总额)。
age = Jugg.Sum<UserInfo>(x => x.Age).Query<int>();

//Count(*) 函数返回表中的记录数。
int count = Jugg.Count<UserInfo>().Query<int>();

//Count(column_name) 函数返回指定列的值的数目(null 不计入)。
count = Jugg.Count<UserInfo>(x => x.Name).Query<int>();


//增删改            
int id = Jugg.Insert(new UserInfo { Name = "张三" });//根据传入的对象来新增
id = Jugg.Insert<UserInfo>(x => new { x.Name, x.Age }, "李四", 18);//根据Lambda 表达式,只新增指定的字段


int affectedRowsNum = Jugg.Delete(new UserInfo { Id = 668 });//根据传入对象的Id删除
affectedRowsNum = Jugg.Delete<UserInfo>().Where(x => x.Id == 23 && x.Name != null).Execute();//根据where条件删除
affectedRowsNum = Jugg.Delete<UserInfo>().Execute();//全表删除


affectedRowsNum = Jugg.Update(new UserInfo { Id = 569, Name = "张三update" });//根据传入的对象来更新

affectedRowsNum = Jugg.Update<UserInfo>(x => new { x.Name }, "张三").
                        Where(x => x.Id == 23).Execute();//根据Lambda 表达式,只更新指定的字段


//通过JuggContext上下文来执行事务
using (JuggContext context = new JuggContext())
{
    try
    {
        context.BeginTransaction();

        id = context.Insert<UserInfo>(a => new { a.Name, a.Email, a.Age }, "张三", "123456@qq.com", 22);

        int r1 = context.Update<UserInfo>(x => new { x.Name }, "张三98261571").
                            Where(x => x.Id == id).
                            Execute();

        int r2 = context.Delete<UserInfo>().
                            Where(a => a.Id == id).
                            Execute();

        bool r3 = context.Exists<UserInfo>(x => x.Id == id);

        if (id > 0 && r1 == 1 && r2 == 1 && !r3)
        {
            context.Commit();
        }
        else
        {
            context.Rollback();
        }
    }
    catch
    {
        context.Rollback();
    }
}

 

其他可选的配置参数

JuggConfig.Debug = true;//开启调试,默认是未开启

//添加类型无效值,用于过滤不必要的字段
JuggConfig.PropertyTypeInvalidValue.Add(typeof(byte), default(byte));
JuggConfig.PropertyTypeInvalidValue.Add(typeof(int), default(int));//public int Age { get; set; },如果属性值为0,则会被Deft自动忽略

JuggConfig.DefaultPrimaryKeyColumnName = "Id";//设置主键名称,默认是 Id

JuggConfig.DeftDbConStrKeyName = "DeftDbCon";//配置.config文件中connectionStrings的key,Deft会自动去加载,默认是DeftDbCon

//硬编码配置数据库连接对象
JuggConfig.DefaultDbConCfg = new ConnectionStringSettings { ProviderName = "System.Data.SqlClient", ConnectionString = "server=.;database=Northwind;integrated security=SSPI" };

JuggConfig.PageRecordCount = 50;//设置分页的每页记录数,默认是50

JuggDbHelper.OnDbExecute += OnDbExecute;//数据库执行事件,必须先通过设置JuggConfig.Debug开启调试模式才会起效果,默认是订阅的

static void OnDbExecute(DbConnection con, string sql, DbParameterCollection dbParameters)
{
    //TODO sql日志埋点
    string dbParamsStr = null;
    foreach (DbParameter item in dbParameters)
    {
        dbParamsStr += string.Format("{0}:{1}  ", item.ParameterName, item.Value);
    }
    Console.WriteLine(string.Format("{0}{1}{2}{1}", sql, Environment.NewLine, dbParamsStr));
}

  

性能测试



Deft还有很多不足之处,希望大家多给些意见和需求,cnblogs社区的热度是我强劲的动力。

多表语法的设计和解析早就已经完成了,另外多表mapping还在优化中,暂时没有开放。
关于多表语法设计请前往我的另一篇技术博文:http://www.cnblogs.com/StrangeCity/p/4795117.html

谢谢大家的支持,打算自己用,不再放出来了。是否开源纯属个人意愿,无关个体对错,望谅解!

 

posted @ 2016-07-26 07:28  陌城&心灵捕手  阅读(7983)  评论(107编辑  收藏  举报