高性能ORM框架XLinq功能詳細介紹


之前簡單介紹了XLinq的一些功能,有很多功能都沒有提到,現在給XLinq加了一些功能,這次把所有功能都介紹一遍。

設計目標

  1. 易用性

    在使用一個框架的時候

    應該沒幾個人會喜歡寫一大堆的配置文件吧

    也應該沒幾個人會喜歡為了完成一個小功能卻需要寫一大堆代碼

    這是XLinq開發的首要目標之一,就是盡可能提高易用性

    最小配置的情況下僅需要一句連接字符串的配置就可以使用

    默認支持的是Sql Server 2008 R2數據庫,理論上說也大部分支持了sql server系的其他數據庫

  2. 高性能

    目前針對查詢時的DataReader轉List和批量插入有針對性優化,其他的不太重要的例如批量更新這個並沒有太多優化

  3. 易於調試

    出了問題能夠以最快速度讓使用者定位到問題,其實這些是細節問題

  4. 支持LINQ

    這個其實是跟易用性掛勾的,園子里面有大神寫的ORM,聲稱"無Linq",其實我也不太想用Linq,因為解析Linq實在太難,坑太多,但又找不到另一種比Linq更讓我滿意的方案。然后我去看了他的ORM的使用方法,發現一旦復雜起來不見得會比Linq更清晰,並且實體類的設計實在是···

    Linq實現復雜的語法確實比較蛋疼,sql語句里面直接來幾個case when,linq就得寫暈過去,至少解析的時候會暈過去。

    但在我看來,既然linq語句都比較復雜了,那肯定是有很多的邏輯在里面,就像上面說的case when,那么為什么不把這些邏輯分拆成好幾個linq去執行呢?或者干脆點寫存儲過程里面。

  5. 多數據庫支持

使用方法

  1. 建立控制台應用程序,暫時只支持.net 4.5.2版本
  2. 安裝xlinq nuget包

  3. 建立數據庫XLinq及相關表

  4. 添加配置文件
    1. <connectionStrings>
    2.   <add name="test" connectionString="Data Source=(local);;initial catalog=XLinq;User Id=xinchen;Password=123456"/>
    3. </connectionStrings>
  5. 建立TestDataContext類和User實體類
    1. public class TestDataContext:DataContext
    2.     {
    3.         public TestDataContext():base("test")
    4.         {
    5.  
    6.         }
    7.     }
    8. public class User
    9.     {
    10.         public int Id { get; set; }
    11.         public string Username { get; set; }
    12.     }
  6. 開始使用
    1. TestDataContext db = new TestDataContext();
    2.            db.Set<User>().ToList();

查詢

  1. 單表查詢

    Lambda版:

    1. db.Set<User>().Where(x => x.Username == "xxxx").ToList();

    LINQ版:

    1. (from user in db.Set<User>() where user.Username == "xxxx" select user).ToList();

    LINQ版看起來明顯感覺比較麻煩,所以在簡單查詢的時候我更傾向於Lambda表達式

    上面的語句生成的代碼是一致的

    1. [Users1].[Id] [Id]
    2. ,[Users1].[Username] [Username]
    3.  FROM [Users] [Users1] WHERE ([Users1].[Username] = @param2)
  2. 多表查詢

    建立實體類的過程不再說

    兩個表連接查詢,因為用Lambda實現比較復雜,所以后面都不再用Lambda實現

    1. var query = from user in db.Set<User>()
    2.                         join userRole in db.Set<UserRole>() on user.Id equals userRole.UserId
    3.                         where user.Id == 1 && userRole.RoleId == 1
    4.                         select new
    5.                         {
    6.                             user.Id,
    7.                             userRole.RoleId,
    8.                             user.Username
    9.                         };

    生成的語句

    1. [user].[Id] [Id]
    2. ,[userRole].[RoleId] [RoleId]
    3. ,[user].[Username] [Username]
    4.  FROM
    5. [Users] [user] INNER JOIN [UserRoles] [userRole]
    6.  ON [user].[Id] = [userRole].[UserId]
    7.  
    8.  WHERE (([user].[Id] = @param1) AND ([userRole].[RoleId] = @param2))

    五個表連接查詢

    1. var query = from user in db.Set<User>()
    2.                        join userRole in db.Set<UserRole>() on user.Id equals userRole.UserId
    3.                        join rolePrivilege in db.Set<RolePrivilege>() on userRole.RoleId equals rolePrivilege.RoleId
    4.                        join priviege in db.Set<Privilege>() on rolePrivilege.PrivilegeId equals priviege.Id
    5.                        join role in db.Set<Role>() on userRole.RoleId equals role.Id
    6.                        where user.Id == 1 && userRole.RoleId == 1
    7.                        select new
    8.                        {
    9.                            user.Id,
    10.                            userRole.RoleId,
    11.                            user.Username,
    12.                            PrivilegeName = priviege.Name,
    13.                            RoleName = role.Name
    14.                        };

    生成的語句

    1. [user].[Id] [Id]
    2. ,[userRole].[RoleId] [RoleId]
    3. ,[user].[Username] [Username]
    4. ,[priviege].[Name] [PrivilegeName]
    5. ,[role].[Name] [RoleName]
    6.  FROM
    7. [Users] [user] INNER JOIN [UserRoles] [userRole]
    8.  ON [user].[Id] = [userRole].[UserId]
    9.  
    10.  INNER JOIN [RolePrivileges] [rolePrivilege]
    11.  ON [userRole].[RoleId] = [rolePrivilege].[RoleId]
    12.  
    13.  INNER JOIN [Privileges] [priviege]
    14.  ON [rolePrivilege].[PrivilegeId] = [priviege].[Id]
    15.  
    16.  INNER JOIN [Roles] [role]
    17.  ON [userRole].[RoleId] = [role].[Id]
    18.  
    19.  WHERE (([user].[Id] = @param5) AND ([userRole].[RoleId] = @param6))
  3. 左連接查詢

    因為linq本身的左連接寫法比較蛋疼,所以xlinq也沒有辦法,后面會想辦法簡化

    1. var query = from user in db.Set<User>()
    2.                         join userRole in db.Set<UserRole>() on user.Id equals userRole.UserId into urs
    3.                         from ur in urs.DefaultIfEmpty()
    4.                         where user.Id == 1 && ur.RoleId == 1
    5.                         select new
    6.                         {
    7.                             user.Id,
    8.                             ur.RoleId,
    9.                             user.Username
    10.                         };

    生成的語句

    1. [user].[Id] [Id]
    2. ,[userRole].[RoleId] [RoleId]
    3. ,[user].[Username] [Username]
    4.  FROM
    5. [Users] [user] Left JOIN [UserRoles] [userRole]
    6.  ON [user].[Id] = [userRole].[UserId]
    7.  
    8.  WHERE (([user].[Id] = @param5) AND ([userRole].[RoleId] = @param6))
  4. 延遲加載
    1. var query = db.Set<User>().Where(x => x.Username == "xxxxx").Select(x => x.Id);
    2.            foreach (var item in query)
    3.            {
    4.  
    5.            }
  5. 自連接查詢
    1. var query = from user1 in db.Set<User>()
    2.                         join user2 in db.Set<User>() on user1.Id equals user2.Id
    3.                         select user1;

    生成的語句

    1. [user1].[Id] [Id]
    2. ,[user1].[Username] [Username]
    3.  FROM
    4. [Users] [user1] INNER JOIN [Users] [user2]
    5.  ON [user1].[Id] = [user2].[Id]
  6. SQL語句查詢
    1. db.SqlQuery<User>("select * from dbo.users", new Dictionary<string, object>());
  7. 分頁查詢
    1. var page = 1;
    2.             var pageSize = 10;
    3.             var query = (from user in db.Set<User>()
    4.                          join userRole in db.Set<UserRole>() on user.Id equals userRole.UserId
    5.                          join rolePrivilege in db.Set<RolePrivilege>() on userRole.RoleId equals rolePrivilege.RoleId
    6.                          join priviege in db.Set<Privilege>() on rolePrivilege.PrivilegeId equals priviege.Id
    7.                          join role in db.Set<Role>() on userRole.RoleId equals role.Id
    8.                          where user.Id == 1 && userRole.RoleId == 1
    9.                          orderby user.Id descending
    10.                          select new
    11.                          {
    12.                              user.Id,
    13.                              userRole.RoleId,
    14.                              user.Username,
    15.                              PrivilegeName = priviege.Name,
    16.                              RoleName = role.Name
    17.                          }).Skip((page - 1) * pageSize).Take(pageSize);

    生成的語句

    1. SELECT [_indexTable].[Id],[_indexTable].[RoleId],[_indexTable].[Username],[_indexTable].[PrivilegeName],[_indexTable].[RoleName] FROM (SELECT [user].[Id] [Id]
    2. ,[userRole].[RoleId] [RoleId]
    3. ,[user].[Username] [Username]
    4. ,[priviege].[Name] [PrivilegeName]
    5. ,[role].[Name] [RoleName]
    6. ,ROW_NUMBER() OVER(ORDER BY [user].[Id]) #index
    7.  FROM [Users] [user] INNER JOIN [UserRoles] [userRole]
    8.  ON [user].[Id] = [userRole].[UserId]
    9.  
    10.  INNER JOIN [RolePrivileges] [rolePrivilege]
    11.  ON [userRole].[RoleId] = [rolePrivilege].[RoleId]
    12.  
    13.  INNER JOIN [Privileges] [priviege]
    14.  ON [rolePrivilege].[PrivilegeId] = [priviege].[Id]
    15.  
    16.  INNER JOIN [Roles] [role]
    17.  ON [userRole].[RoleId] = [role].[Id]
    18.  
    19.  WHERE (([user].[Id] = @param5) AND ([userRole].[RoleId] = @param6)) ) _indexTable where [_indexTable].[#index] BETWEEN 0 AND 10
  8. 動態查詢
    1. IQueryable<User> query = db.Set<User>();
    2.             var filters = new List<SqlFilter>();
    3.             filters.Add(SqlFilter.Create("Id", Operation.Equal, 1));
    4.             filters.Add(SqlFilter.Create("Username", Operation.Like, "aaa"));
    5.             query = query.Where(filters);

    生成的語句

    1. [Users1].[Id] [Id]
    2. ,[Users1].[Username] [Username]
    3.  FROM [Users] [Users1] WHERE (([Users1].[Id] = @param2) AND CHARINDEX(@param3,[Users1].[Username])>0)
  9. 取日期查詢

    這個功能主要針對EF中無法直接取日期的問題

    1. var query = db.Set<User>().Where(x => x.LoginTime.Date == DateTime.Now.Date);
    2. [Users1].[Id] [Id]
    3. ,[Users1].[Username] [Username]
    4. ,[Users1].[LoginTime] [LoginTime]
    5.  FROM [Users] [Users1] WHERE (CONVERT(DATE,[Users1].[LoginTime],211) = @param3)
  10. 計算天數查詢
    1. var query = db.Set<User>().Where(x => (x.LoginTime - DateTime.Now).TotalDays <= 7);

    生成的語句

    1. [Users1].[Id] [Id]
    2. ,[Users1].[Username] [Username]
    3. ,[Users1].[LoginTime] [LoginTime]
    4.  FROM [Users] [Users1] WHERE (DATEDIFF(DAY,[Users1].[LoginTime],@param2) <= @param3)

修改

  1. 先查詢后修改(注意只有十條數據以內才會支持修改)
    1. var query = db.Set<User>().FirstOrDefault();
    2.             query.Username = "xxxxxxx";
    3.             db.SaveChanges();
  2. 直接修改
    1. db.Set<User>().Where(x => x.Id == 1).Update(x => new User
    2.             {
    3.                 Username = "xxxxxxxxxxxxx"
    4.             });

    Update子句必須采用這寫法才會有效

刪除

  1. 先查詢后刪除
    1. var query = db.Set<User>().FirstOrDefault();
    2. db.Set<User>().Remove(query);
    3. db.SaveChanges();
  2. 直接刪除
    1. db.Set<User>().Where(x => x.Id == 1).Delete();

事務

  1. 普通事務
    1. using (var scope = new TransactionScope())
    2. {
    3.     db.Set<User>().Where(x => x.Id == 1).Delete();
    4.     scope.Complete();
    5. }
  2. 嵌套事務
    1. using (var scope = new TransactionScope())
    2. {
    3.     db.Set<User>().Where(x => x.Id == 1).Delete();
    4.     using (var s1 = new TransactionScope())
    5.     {
    6.         db.Set<Privilege>().Where(x => x.Id == 1).Delete();
    7.         s1.Complete();
    8.     }
    9.     scope.Complete();
    10. }

調試支持

在調試的時候可直接看到SQL語句

多數據庫支持

通過配置文件實現多數據庫支持

  1. <configSections>
  2.   <section name="xlinq" type="Xinchen.XLinq.ConfigSection,Xinchen.XLinq"/>
  3. </configSections>
  4.  
  5. <xlinq connectionStringName="test" dataBase="SQLite"></xlinq>

鏈式Api

有沒有園友注意到,我上面用的User實體並沒有進行任何特殊處理,但實際翻譯出來的語句是識別的Users表

這其實是"抄"的EF的約定大於配置的原則,默認情況下,實體名的復數就是表名,實體中的Id識別為主鍵並自動增長

如果需要自定義這些規則,則需要使用特性或鏈式API,我現在更喜歡鏈式API

  1. public class TestDataContext:DataContext
  2.    {
  3.        public TestDataContext():base("test")
  4.        {
  5.  
  6.        }
  7.  
  8.        protected override void ConfigurationModel(Xinchen.XLinq.Configuation.EntityConfigurationManager entityConfiguration)
  9.        {
  10.            entityConfiguration.Entity<User>().TableName("Users").Key(x => x.Id, Xinchen.DbUtils.DataAnnotations.DataSourceTypes.AutoIncreament);
  11.        }
  12.    }

重寫DataContext的ConfigurationModel方法即可使用鏈式API對實體相關信息進行配置,上面是指定了User實體的表名、主鍵及主鍵的數據來源為自動增長

創建表

若要創建表,則幾乎必須使用鏈式API對實體進行配置之后才能進行自動創建

另外這個功能有一定的限制,默認情況下不會啟用該功能,若啟用了也只有在數據庫中一個表都沒有的情況下才會自動創建表

這樣做是因為真正的數據庫運行環境其實很可能壓根不允許自動創建表,然后就是下面這個樣子,這樣一來這個功能其實並沒有太大用,只有在第一次初始化數據庫的時候才會用。

當然也可以始終自動創建表,這個需要稍微配置一下,當allwayAutoCreateTables為true時並且autoCreateTables為true時,將始終自動創建表

下面演示創建一個Test表

DataContext中的配置

  1. public class TestDataContext : DataContext
  2. {
  3.     public TestDataContext()
  4.         : base("test")
  5.     {
  6.  
  7.     }
  8.  
  9.     protected override void ConfigurationModel(Xinchen.XLinq.Configuation.EntityConfigurationManager entityConfiguration)
  10.     {
  11.         var testEntity = entityConfiguration.Entity<Test>().TableName("TestTables").Key(x => x.Id, Xinchen.DbUtils.DataAnnotations.DataSourceTypes.AutoIncreament);
  12.         testEntity.Property(x => x.Id).Name("TId");
  13.         testEntity.Property(x => x.Name).MaxLength(100);
  14.     }
  15. }

創建的表

自定義Provider(有這功能,但沒有測試)

性能

  1. 查詢
    1. class Program
    2. {
    3.     static int count = 1;
    4.     static int rowCount = 1000000;
    5.     static void Main(string[] args)
    6.     {
    7.         TestDataContext xlinqDb = new TestDataContext();
    8.         TestDbContext efDb = GetEF(null);
    9.         var userDB = xlinqDb.Set<User>();
    10.         var userRoleDb = xlinqDb.Set<UserRole>();
    11.         var efUserDb = efDb.Users;
    12.         var efUserRoleDb = efDb.UserRoles;
    13.         ExecuteTimer("XLinq使用Linq", () =>
    14.         {
    15.             for (int i = 0; i < count; i++)
    16.             {
    17.                 userDB.Take(rowCount).ToList();
    18.             }
    19.         });
    20.         ExecuteTimer("XLinq使用SQL", () =>
    21.         {
    22.             var sql = "select top " + rowCount + " * from dbo.users";
    23.             var dict = new Dictionary<string, object>();
    24.             for (int i = 0; i < count; i++)
    25.             {
    26.                 xlinqDb.SqlQuery<User>(sql, dict);
    27.             }
    28.         });
    29.         ExecuteTimer("XLinq多表", () =>
    30.         {
    31.             for (int i = 0; i < count; i++)
    32.             {
    33.                 (from user in userDB
    34.                  join userRole in userRoleDb on user.Id equals userRole.UserId into us
    35.                  from u in us.DefaultIfEmpty()
    36.                  select user).Take(rowCount).ToList();
    37.             }
    38.         });
    39.         efDb = GetEF(efDb);
    40.         efUserDb = efDb.Users;
    41.         efUserRoleDb = efDb.UserRoles;
    42.         ExecuteTimer("EF使用LINQ", () =>
    43.         {
    44.             for (int i = 0; i < count; i++)
    45.             {
    46.                 efUserDb.Take(rowCount).ToList();
    47.             }
    48.         });
    49.         efDb = GetEF(efDb);
    50.         efUserDb = efDb.Users;
    51.         efUserRoleDb = efDb.UserRoles;
    52.         ExecuteTimer("EF使用SQL", () =>
    53.         {
    54.             var sql = "select top " + rowCount + " * from dbo.users";
    55.             for (int i = 0; i < count; i++)
    56.             {
    57.                 efDb.Database.SqlQuery<User>(sql).ToList();
    58.             }
    59.         });
    60.         efDb = GetEF(efDb);
    61.         efUserDb = efDb.Users;
    62.         efUserRoleDb = efDb.UserRoles;
    63.         ExecuteTimer("EF多表", () =>
    64.         {
    65.             for (int i = 0; i < count; i++)
    66.             {
    67.                 (from user in efUserDb
    68.                  join userRole in efUserRoleDb on user.Id equals userRole.UserId into us
    69.                  from u in us.DefaultIfEmpty()
    70.                  select user).Take(rowCount).ToList();
    71.             }
    72.         });
    73.         SqlConnection conn = new SqlConnection();
    74.         conn.ConnectionString = System.Configuration.ConfigurationManager.ConnectionStrings[1].ConnectionString;
    75.         ExecuteTimer("Dapper", () =>
    76.         {
    77.             var sql = "select top " + rowCount + " * from dbo.users";
    78.             for (int i = 0; i < count; i++)
    79.             {
    80.                 conn.Query<User>(sql);
    81.             }
    82.         });
    83.         Console.ReadKey();
    84.     }
    85.  
    86.     static void ExecuteTimer(string name, Action action)
    87.     {
    88.         var watcher = Stopwatch.StartNew();
    89.         action();
    90.         watcher.Stop();
    91.         Console.WriteLine(string.Format("{0}查詢{1}數據{2}次", name, rowCount, count).PadRight(30) + ":" + watcher.Elapsed);
    92.     }
    93.  
    94.     static TestDbContext GetEF(TestDbContext ef)
    95.     {
    96.         if (ef != null)
    97.         {
    98.             ef.Dispose();
    99.         }
    100.         TestDbContext efDb = new TestDbContext();
    101.         efDb.Users.Where(x => false).ToList();
    102.         efDb.Configuration.AutoDetectChangesEnabled = false;
    103.         efDb.Configuration.ProxyCreationEnabled = false;
    104.         efDb.Configuration.ValidateOnSaveEnabled = false;
    105.         return efDb;
    106.     }
    107.  
    108.     public class TestDbContext : DbContext
    109.     {
    110.         public TestDbContext()
    111.             : base("name=test")
    112.         {
    113.  
    114.         }
    115.  
    116.         public System.Data.Entity.DbSet<User> Users { get; set; }
    117.         public System.Data.Entity.DbSet<UserRole> UserRoles { get; set; }
    118.     }
    119. }

     

    測試結果

     

     

    查詢一次的情況下EF慢的妥妥的,XLinq微弱優勢

    查詢N次的情況下EF這···還有人說EF慢?不過大概是因為緩存的原因,但最后一張圖看着又不太像,或許還跟GC什么的關吧,所以還有人說EF慢么··

    或者是我測試代碼有問題?

  2. 插入
    1. class Program
    2. {
    3.     static int count = 10;
    4.     static int rowCount = 1000;
    5.     static void Main(string[] args)
    6.     {
    7.         TestDataContext xlinqDb = new TestDataContext();
    8.         TestDbContext efDb = GetEF(null);
    9.         var userDB = xlinqDb.Set<User>();
    10.         var userRoleDb = xlinqDb.Set<UserRole>();
    11.         var efUserDb = efDb.Users;
    12.         var efUserRoleDb = efDb.UserRoles;
    13.         ExecuteInsertTimer("XLinq", () =>
    14.         {
    15.             for (int i = 0; i < rowCount; i++)
    16.             {
    17.                 userDB.Add(new User()
    18.                 {
    19.                     C1 = "x",
    20.                     C2 = "x",
    21.                     C3 = "x",
    22.                     C4 = "x",
    23.                     C5 = "x",
    24.                     C6 = "x",
    25.                     C7 = "x",
    26.                     C8 = "x",
    27.                     C9 = "x",
    28.                     C10 = "x",
    29.                     Username = "xxxx"
    30.                 });
    31.             }
    32.             xlinqDb.SaveChanges();
    33.         });
    34.         ExecuteInsertTimer("EF", () =>
    35.         {
    36.             for (int i = 0; i < rowCount; i++)
    37.             {
    38.                 efUserDb.Add(new User()
    39.                 {
    40.                     C1 = "x",
    41.                     C2 = "x",
    42.                     C3 = "x",
    43.                     C4 = "x",
    44.                     C5 = "x",
    45.                     C6 = "x",
    46.                     C7 = "x",
    47.                     C8 = "x",
    48.                     C9 = "x",
    49.                     C10 = "x",
    50.                     Username = "xxxx"
    51.                 });
    52.             }
    53.             efDb.SaveChanges();
    54.         });
    55.         Console.ReadKey();
    56.     }
    57.  
    58.     static void ExecuteTimer(string name, Action action)
    59.     {
    60.         var watcher = Stopwatch.StartNew();
    61.         action();
    62.         watcher.Stop();
    63.         Console.WriteLine(string.Format("{0}查詢{1}數據{2}次", name, rowCount, count).PadRight(30) + ":" + watcher.Elapsed);
    64.     }
    65.     static void ExecuteInsertTimer(string name, Action action)
    66.     {
    67.         var watcher = Stopwatch.StartNew();
    68.         action();
    69.         watcher.Stop();
    70.         Console.WriteLine(string.Format("{0}插入{1}條數據", name, rowCount).PadRight(30) + ":" + watcher.Elapsed);
    71.     }
    72.  
    73.     static TestDbContext GetEF(TestDbContext ef)
    74.     {
    75.         if (ef != null)
    76.         {
    77.             ef.Dispose();
    78.         }
    79.         TestDbContext efDb = new TestDbContext();
    80.         efDb.Users.Where(x => false).ToList();
    81.         efDb.Configuration.AutoDetectChangesEnabled = false;
    82.         efDb.Configuration.ProxyCreationEnabled = false;
    83.         efDb.Configuration.ValidateOnSaveEnabled = false;
    84.         return efDb;
    85.     }
    86.  
    87.     public class TestDbContext : DbContext
    88.     {
    89.         public TestDbContext()
    90.             : base("name=test")
    91.         {
    92.  
    93.         }
    94.  
    95.         public System.Data.Entity.DbSet<User> Users { get; set; }
    96.         public System.Data.Entity.DbSet<UserRole> UserRoles { get; set; }
    97.     }
    98. }

    測試結果

測試源碼下載

http://files.cnblogs.com/files/wzxinchen/XlinqDemo.zip


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM