C#轻量级ORM使用 Dapper+Contrib

C#轻量级ORM使用 Dapper+Contrib

  • 引入Dapper+Contrib
    • 关于Dapper
    • Dapper的扩展
    • Contrib中,关于entity的配置

引入Dapper+Contrib

关于Dapper

什么是Dapper
Dapper是一个简单的.NET对象映射器,在速度方面具有"King of Micro ORM"的头衔,几乎与使用原始的ADO.NET数据读取器一样快。ORM是一个对象关系映射器,它负责数据库和编程语言之间的映射。
Dapper是如何工作的
它可以分为三个步骤:

  • 创建一个IDbConnection接口对象;
  • 编写一个查询SQL来执行CRUD操作;
  • 将查询SQL作为Execute方法的参数传递。

Dapper通过扩展IDbConnection提供一些有用的扩展方法去查询您的数据库。Dapper.Contrib是对Dapper的进一步封装,使对象的基本增删改查等操作进一步简化。

引入NuGet包
Dapper通过NuGet安装:https://www.nuget.org/packages/Dapper
C#轻量级ORM使用 Dapper+Contrib_第1张图片

方法
Dapper会用以下几个方法扩展您的IDbConnection接口:

  • Execute
  • Query
  • QueryFirst
  • QueryFirstOrDefault
  • QuerySingle
  • QuerySingleOrDefault
  • QueryMultiple

Dapper的扩展

执行sql返回一个对象

		public static T ExecuteReaderReturnT<T>(string sql, object param = null, bool useWriteConn = false, IDbTransaction transaction = null)
        {
     
            if (transaction == null)
            {
     
                using (IDbConnection conn = GetConnection(useWriteConn))
                {
     
                    conn.Open();
                    return conn.QueryFirstOrDefault<T>(sql, param, commandTimeout: commandTimeout);
                }
            }
            else
            {
     
                var conn = transaction.Connection;
                return conn.QueryFirstOrDefault<T>(sql, param, commandTimeout: commandTimeout, transaction: transaction);
            }
        }

执行sql,返回影响行数

        public static int ExecuteSqlInt(string sql, object param = null, IDbTransaction transaction = null)
        {
     
            if (transaction == null)
            {
     
                using (IDbConnection conn = GetConnection(true))
                {
     
                    conn.Open();
                    return conn.Execute(sql, param, commandTimeout: commandTimeout, commandType: CommandType.Text);
                }
            }
            else
            {
     
                var conn = transaction.Connection;
                return conn.Execute(sql, param, transaction: transaction, commandTimeout: commandTimeout, commandType: CommandType.Text);
            }
        }

根据id获取实体

        public static T GetById<T>(int id, IDbTransaction transaction = null, bool useWriteConn = false) where T : class
        {
     
            if (transaction == null)
            {
     
                using (IDbConnection conn = GetConnection(useWriteConn))
                {
     
                    conn.Open();
                    return conn.Get<T>(id, commandTimeout: commandTimeout);
                }
            }
            else
            {
     
                var conn = transaction.Connection;
                return conn.Get<T>(id, transaction: transaction, commandTimeout: commandTimeout);
            }
        }

插入实体

        public static long ExecuteInsert<T>(T item, IDbTransaction transaction = null) where T : class
        {
     
            if (transaction == null)
            {
     
                using (IDbConnection conn = GetConnection(true))
                {
     
                    conn.Open();
                    var res = conn.Insert<T>(item, commandTimeout: commandTimeout);
                    return res;
                }
            }
            else
            {
     
                var conn = transaction.Connection;
                return conn.Insert(item, transaction: transaction, commandTimeout: commandTimeout);
            }
        }

更新实体

        public static bool ExecuteUpdate<T>(T item, IDbTransaction transaction = null) where T : class
        {
     
            if (transaction == null)
            {
     
                using (IDbConnection conn = GetConnection(true))
                {
     
                    conn.Open();
                    return conn.Update(item, commandTimeout: commandTimeout);
                }
            }
            else
            {
     
                var conn = transaction.Connection;
                return conn.Update(item, transaction: transaction, commandTimeout: commandTimeout);
            }
        }

分页查询

        public static List<T> ExecutePageList<T>(string sql, string sort, int pageIndex, int pageSize, bool useWriteConn = false, object param = null)
        {
     
            string pageSql = @"SELECT TOP {0} * FROM (SELECT ROW_NUMBER() OVER (ORDER BY {1}) _row_number_,*  FROM 
              ({2})temp )temp1 WHERE temp1._row_number_>{3} ORDER BY _row_number_";
            string execSql = string.Format(pageSql, pageSize, sort, sql, pageSize * (pageIndex - 1));
            using (IDbConnection conn = GetConnection(useWriteConn))
            {
     
                conn.Open();

                return conn.Query<T>(execSql, param, commandTimeout: commandTimeout).ToList();
            }
        }

Contrib中,关于entity的配置

    [Table("test")]
    public class Test
    {
     
        [Key]
        public int Id {
      get; set; }
        [ExplicitKey]
        public string Sn {
      get; set; }
        public string Label {
      get; set; }
        public string Style {
      get; set; }
        public int Count {
      get; set; }
        [Computed]
        public int Doublecount => Count * 2;

        [Write(false)]
        public int IgnoreCol {
      get; set; }
        public string More_info {
      get; set; }
    }

如上所示,test类中包含了Contrib的属性配置

  • Table:指定实体对应地数据库表名,忽略后实体对应地数据库表名会相应地变化
  • Key:指定此列为主键(自动增长主键),可忽略,忽略后默认查找
    ExplicitKey:指定此列为主键(不自动增长类型例如guid,ExplicitKey与Key地区别下面会详细讲)
  • Computed:计算属性,打上此标签,对象地insert,update等操作会忽略此列
  • Write:需穿一个bool值,false时insert,update等操作会忽略此列

其中,KeyExplicitKey这两项都是指定列为主键的。区别是打上Key特性的列在插入时是不能指定值的,只能是数据库自动增长列,而ExplicitKey特性可以允许在插入时指定值,比如用guid为主键类型,则主键在插入时必须已经生成好。

你可能感兴趣的:(数据与通讯,c#)