轻量ORM-SqlRepoEx （十二）SqlRepoEx 2.0.1 至 2.2.0 版本更新说明

一、功能变化

（一）、强化特性支持

1、部分类型拥有复杂属性；

2、有些属性不是来源于数据库

3、用户在原来的代码中使用 SqlRepoEx ，减少字段与数据库字段之间的冲突；

4、为支持新的特性及优化属性读写，增加了 SimpleWritablePropertyMatcher；

5、增加SqlRepoDbFieldAttribute特性后，如果用户程序仍然为POJO类型，不必标识SqlRepoDbFieldAttribute时，用SimpleWritablePropertyMatcher

6、如果明确要区分，就用WritablePropertyMatcher ；

 string ConnectionString = "Data Source=(Local);Initial Catalog=Northwind;User ID=test;Password=test";

          var connectionProvider = new ConnectionStringConnectionProvider(ConnectionString);

           MsSqlRepoFactory.UseConnectionProvider(connectionProvider);

   // 使用新的属性读写器

           MsSqlRepoFactory.UseWritablePropertyMatcher(new SimpleWritablePropertyMatcher());

           var repository = MsSqlRepoFactory.Create<Customers>();

 类型代码（使用明确特定  使用 WritablePropertyMatcher ）

    public class ToDo
    {
        [NonDatabaseField]
        public string Remark { get; set; }

        [SqlRepoDbField]
        public DateTime CreatedDate { get; set; }

        [SqlRepoDbField]
        public bool IsCompleted { get; set; }

        [SqlRepoDbField]
        public string Task { get; set; }

        [IdentityField]
        public int Id { get; set; }
    }

 类型代码（不指定 使用 SimpleWritablePropertyMatcher）

    public class ToDo
    {
        [NonDatabaseField]
        public string Remark { get; set; }
        public DateTime CreatedDate { get; set; }
        public bool IsCompleted { get; set; }
        public string Task { get; set; }

        [IdentityField]
        public int Id { get; set; }
    }

（二）事务支持

 1、在初始仓储时如果使用

MsSqlRepoFactory.UseStatementTransactionExecutor();

2、代码中使用使用方法 repository.GetConnectionProvider.BeginTransaction() 获取事务控制

public void DoIt2()
        {
            var repository = MySqlRepoFactory.Create<ToDo>();
            using (var tranc = repository.GetConnectionProvider.BeginTransaction())
            {
                repository.Update().Set(c => c.Task, "A31").Where(c => c.Id == 1).Go();// A1
                repository.Update().Set(c => c.Task, "B31").Where(c => c.Id == 2).Go();// B2

                tranc.Rollback();
            }
         }

 

（三）、增加生成  @ 参数 的语句支持

返回形如下列SQL语句：

var repository = MsSqlRepoFactory.Create<ToDo>();

var results = repository.Query().Where(c => c.Id == 6).Go().FirstOrDefault();

Console.WriteLine(resultinsert.ParamSql());

1、 INSERT  ToDo ( CreatedDate , IsCompleted , Task )

VALUES(@CreatedDate,@IsCompleted,@Task);

var resultinsert = repository.Update().For(results);

 Console.WriteLine(resultinsert.ParamSql());

2、 UPDATE   ToDo

SET CreatedDate  = @CreatedDate, IsCompleted  = @IsCompleted, Task  = @Task

WHERE Id  = @Id;

以解决储如Dapper等ORM工具需要参数类型字符串需求

SqlRepoEx中是可以与 Dapper 同时并存，意味着初始化SqlRepoEx后，

1、可以直接从 SqlRepoEx 中操作返回结果；

2、可以通过 SqlRepoEx 来生成SQL语句，另外Dapper 主要是基于SqlMapper ，SqlMapper中定义了基于 IDbConnection 接口的操作，你可以通过SqlRepoEx 的 IConnectionProvider 接口来获取一个 DbConnection 有两种方法

     （1）、 var connectionProvider = new AppConfigFirstConnectionProvider();

           IDbConnection dbConnection = connectionProvider.GetDbConnection;

     （2）、 var repository = MsSqlRepoFactory.Create<ToDo>();

          IDbConnection dbConnection = repository.GetConnectionProvider.GetDbConnection;

        public static void TestMySqlUpdate()
        {
            string ConnectionString = "datasource=127.0.0.1;username=test;password=test;database=sqlrepotest;charset=gb2312;SslMode = none;";
            var connectionProvider = new MySQLP.ConnectionStringConnectionProvider(ConnectionString);
            MySqlRepoFactory.UseConnectionProvider(connectionProvider);
            MySqlRepoFactory.UseStatementExecutor(new DapperStatementExecutor(connectionProvider));
            MySqlRepoFactory.UseDataReaderEntityMapper(new DapperEntityMapper());
            MySqlRepoFactory.UseWritablePropertyMatcher(new SimpleWritablePropertyMatcher());
            var repository11 = MySqlRepoFactory.Create<ToDo>();
            var results11 = repository11.Query().Where(c => c.Id == 2).Go().FirstOrDefault();

            results11.Task = "B21";

            var rest2=   repository11.Update().For(results11);

            Console.WriteLine(rest2.ParamSql());

            var rest3 = rest2.ParamSqlWithEntity();

            IDbConnection dbConnection = repository11.GetConnectionProvider.GetDbConnection;

            dbConnection.Execute(rest3.paramsql, rest3.entity);
        }

二、注意事项

1、如果返回的SQL中没有字段名返回，如  insert Doto() values()  ，这种情况，当前使用了WritablePropertyMatcher 属性读写器，而DTO类又未设置特性

 你可以

 （1）、增加相应字段特性

        [SqlRepoDbField]
        public string Task { get; set; }

        [IdentityField]
        public int Id { get; set; }

 （2）、使用 SimpleWritablePropertyMatcher属性读写器

        MsSqlRepoFactory.UseWritablePropertyMatcher(new SimpleWritablePropertyMatcher());

 

2、事务支持，事务支持需使用MsSqlRepoFactory.UseStatementTransactionExecutor();，如果是自定义的读写器，一定不在内部关闭 connection；

 

完整的演示代码见：https://gitee.com/azthinker/SqlRepoEx2.0Demo