SmartSql.TypeHandler 3.0.0-rc6

SmartSql = MyBatis + Cache(Memory | Redis) + ZooKeeper + R/W Splitting + ......

This is a prerelease version of SmartSql.TypeHandler.
There is a newer version of this package available.
See the version list below for details.
Install-Package SmartSql.TypeHandler -Version 3.0.0-rc6
dotnet add package SmartSql.TypeHandler --version 3.0.0-rc6
<PackageReference Include="SmartSql.TypeHandler" Version="3.0.0-rc6" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add SmartSql.TypeHandler --version 3.0.0-rc6
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

简介

0. Why

  • 拥抱 跨平台 DotNet Core,是时候了。
  • 把你的双手从数据访问层解放出来,少加点班吧。

1. So SmartSql

  • TargetFrameworks: .NETFramework 4.6 & .NETStandard 2.0
  • SmartSql = MyBatis + Cache(Memory | Redis) + ZooKeeper + R/W Splitting + ......

2. 主要特性 (√ 为已完成,未打 √ 为计划特性)

  • 1 ORM
    • 1.1 Sync
    • 1.2 Async
  • 2 XmlConfig & XmlStatement -> Sql
    • 2.1 SmartSqlMapConfig & SmartSqlMap √ (是的,你猜对了,和MyBatis一样,通过XML配置分离SQL。)
    • 2.2 Config Hot Update ->ConfigWatcher & Reload (配置文件热更新:当你需要修改Sql的时候,直接修改SqlMap配置文件,保存即可。)
  • 3 读写分离 √
    • 3.1 读写分离 √
    • 3.2 多读库 权重筛选 √ (配置多读库,根据读库权重选举读库)
  • 4 日志 √
    • 4.1 基于 Microsoft.Extensions.Logging.Abstractions (当你需要跟踪调试的时候一切都是那么一目了然)
  • 5 Dynamic Repository
    • 5.1 SmartSql.DyRepository √
  • 6 查询缓存 √
    • 6.1 SmartSql.Cache.Memory √
      • 6.1.1 Fifo √
      • 6.1.2 Lru √
    • 6.2 SmartSql.Cache.Redis √
    • 6.3 缓存事务一致性
  • 7 分布式配置插件
    • 7.1 IConfigLoader √ (配置文件加载器)
    • 7.2 LocalFileConfigLoader √ √ (本地文件配置加载器)
      • 7.2.1 Load SmartSqlMapSource Xml √
      • 7.3.1 Load SmartSqlMapSource Directory √
    • 7.3 SmartSql.ZooKeeperConfig √ (ZooKeeper 分布式配置文件加载器)

3. 性能


BenchmarkDotNet=v0.10.14, OS=Windows 10.0.16299.431 (1709/FallCreatorsUpdate/Redstone3)
Intel Core i7-4710MQ CPU 2.50GHz (Haswell), 1 CPU, 8 logical and 4 physical cores
Frequency=2435768 Hz, Resolution=410.5481 ns, Timer=TSC
.NET Core SDK=2.1.201
  [Host]     : .NET Core 2.0.7 (CoreCLR 4.6.26328.01, CoreFX 4.6.26403.03), 64bit RyuJIT
  DefaultJob : .NET Core 2.0.7 (CoreCLR 4.6.26328.01, CoreFX 4.6.26403.03), 64bit RyuJIT

| ORM | Type | Method | Mean | Error | StdDev | Rank | Gen 0 | Gen 1 | Gen 2 | Allocated |
|--------------- |------------------------- |------------------------ |---------:|----------:|----------:|-----:|-----------:|----------:|----------:|----------:|
| SmartSql | SmartSqlBenchmarks | Query | 101.6 ms | 0.2226 ms | 0.1738 ms | 1 | 2437.5000 | 1062.5000 | 375.0000 | 13.37 MB |
| Native | NativeBenchmarks | Query_IsDBNull_GetValue | 101.7 ms | 0.4101 ms | 0.3635 ms | 1 | 2437.5000 | 1062.5000 | 375.0000 | 13.37 MB |
| Dapper | DapperBenchmarks | Query | 104.4 ms | 1.3195 ms | 1.2342 ms | 2 | 3375.0000 | 1375.0000 | 625.0000 | 17.64 MB |
| SmartSqlDapper | SmartSqlDapperBenchmarks | Query | 105.7 ms | 1.1697 ms | 1.0941 ms | 3 | 3750.0000 | 1437.5000 | 625.0000 | 19.47 MB |
| Native | NativeBenchmarks | Query_GetValue_DbNull | 107.4 ms | 1.0710 ms | 1.0018 ms | 4 | 3062.5000 | 1187.5000 | 500.0000 | 16.42 MB |
| SqlSugar | SqlSugarBenchmarks | Query | 108.9 ms | 0.4048 ms | 0.3787 ms | 5 | 2375.0000 | 1000.0000 | 312.5000 | 13.09 MB |
| EF | EFBenchmarks | SqlQuery | 110.9 ms | 0.6922 ms | 0.6475 ms | 6 | 11062.5000 | - | - | 34.13 MB |
| Chloe | ChloeBenchmarks | Query | 14.5 ms | 2.2600 ms | 5.3711 ms | 7 | 2375.0000 | 1000.0000 | 312.5000 | 13.07 MB |
| EF | EFBenchmarks | Query_NoTracking | 126.4 ms | 1.3197 ms | 1.2344 ms | 8 | 5937.5000 | 2250.0000 | 1062.5000 | 30.16 MB |
| EF | EFBenchmarks | SqlQuery_NoTracking | 148.6 ms | 0.8290 ms | 0.7755 ms | 9 | 7437.5000 | 2937.5000 | 1250.0000 | 37.79 MB |


4. 安装 (NuGet)

Install-Package SmartSql

5. 常规代码

查询

            ISmartSqlMapper SqlMapper = MapperContainer.Instance.GetSqlMapper();
            SqlMapper.Query<T_Test>(new RequestContext
            {
                Scope = "T_Test",
                SqlId = "GetList",
                Request = new { Ids = new long[] { 1, 2, 3, 4 } }
            });

事务

            try
            {
                ISmartSqlMapper SqlMapper = MapperContainer.Instance.GetSqlMapper();
                SqlMapper.BeginTransaction();
                //BizCode
                SqlMapper.CommitTransaction();
            }
            catch (Exception ex)
            {
                SqlMapper.RollbackTransaction();
                throw ex;
            }

6. 最佳实践

6.1 安装 SmartSql.DIExtension

Install-Package SmartSql.DIExtension

6.2 注入依赖

 services.AddSmartSql();
 services.AddRepositoryFactory();
 services.AddRepositoryFromAssembly((options) =>
 {
    options.AssemblyString = "SmartSql.Starter.Repository";
 });

6.3 定义仓储接口

    /// <summary>
    /// 属性可选: [SqlMap(Scope = "User")] ,不设置 则默认 Scope 模板:I{Scope}Repository
    /// 可传入自定义模板
    /// RepositoryBuilder builder=new RepositoryBuilder("I{Scope}DAL");
    /// </summary>
    public interface IUserRepository
    {
        /// <summary>
        /// 属性可选 [Statement(Execute = ExecuteBehavior.Auto,Id = "Query")]
        /// 默认 Execute:Auto ,自动判断 执行类型
        /// 默认 Id : 方法名
        /// </summary>
        /// <param name="reqParams"></param>
        /// <returns></returns>
        IEnumerable<User> Query(object reqParams);
        long GetRecord(object reqParams);
        User Get(object reqParams);
        long Insert(User entity);
        int Update(User entity);
        int Delete(User enttiy);
    }

6.4 尽情享用

    public class UserService
    {
        private readonly ISmartSqlMapper _smartSqlMapper;
        private readonly IUserRepository _userRepository;

        public UserService(
             ISmartSqlMapper smartSqlMapper
            , IUserRepository userRepository)
        {
            _smartSqlMapper = smartSqlMapper;
            _userRepository = userRepository;
        }

        public long Add(AddRequest request)
        {
            int existsNum = _userRepository.Exists(new { request.UserName });
            if (existsNum > 0)
            {
                throw new ArgumentException($"{nameof(request.UserName)} has already existed!");
            }
            return _userRepository.Add(new Entitiy.User
            {
                UserName = request.UserName,
                Password = request.Password,
                Status = Entitiy.UserStatus.Ok,
                CreationTime = DateTime.Now,
            });
        }

        public void UseTransaction()
        {
            try
            {
                _smartSqlMapper.BeginTransaction();
                //Biz();
                _smartSqlMapper.CommitTransaction();
            }
            catch (Exception ex)
            {
                _smartSqlMapper.RollbackTransaction();
                throw ex;
            }
        }
    }

7. 文档地址

8. 技术交流

点击链接加入QQ群【SmartSql 官方交流群】:604762592

简介

0. Why

  • 拥抱 跨平台 DotNet Core,是时候了。
  • 把你的双手从数据访问层解放出来,少加点班吧。

1. So SmartSql

  • TargetFrameworks: .NETFramework 4.6 & .NETStandard 2.0
  • SmartSql = MyBatis + Cache(Memory | Redis) + ZooKeeper + R/W Splitting + ......

2. 主要特性 (√ 为已完成,未打 √ 为计划特性)

  • 1 ORM
    • 1.1 Sync
    • 1.2 Async
  • 2 XmlConfig & XmlStatement -> Sql
    • 2.1 SmartSqlMapConfig & SmartSqlMap √ (是的,你猜对了,和MyBatis一样,通过XML配置分离SQL。)
    • 2.2 Config Hot Update ->ConfigWatcher & Reload (配置文件热更新:当你需要修改Sql的时候,直接修改SqlMap配置文件,保存即可。)
  • 3 读写分离 √
    • 3.1 读写分离 √
    • 3.2 多读库 权重筛选 √ (配置多读库,根据读库权重选举读库)
  • 4 日志 √
    • 4.1 基于 Microsoft.Extensions.Logging.Abstractions (当你需要跟踪调试的时候一切都是那么一目了然)
  • 5 Dynamic Repository
    • 5.1 SmartSql.DyRepository √
  • 6 查询缓存 √
    • 6.1 SmartSql.Cache.Memory √
      • 6.1.1 Fifo √
      • 6.1.2 Lru √
    • 6.2 SmartSql.Cache.Redis √
    • 6.3 缓存事务一致性
  • 7 分布式配置插件
    • 7.1 IConfigLoader √ (配置文件加载器)
    • 7.2 LocalFileConfigLoader √ √ (本地文件配置加载器)
      • 7.2.1 Load SmartSqlMapSource Xml √
      • 7.3.1 Load SmartSqlMapSource Directory √
    • 7.3 SmartSql.ZooKeeperConfig √ (ZooKeeper 分布式配置文件加载器)

3. 性能


BenchmarkDotNet=v0.10.14, OS=Windows 10.0.16299.431 (1709/FallCreatorsUpdate/Redstone3)
Intel Core i7-4710MQ CPU 2.50GHz (Haswell), 1 CPU, 8 logical and 4 physical cores
Frequency=2435768 Hz, Resolution=410.5481 ns, Timer=TSC
.NET Core SDK=2.1.201
  [Host]     : .NET Core 2.0.7 (CoreCLR 4.6.26328.01, CoreFX 4.6.26403.03), 64bit RyuJIT
  DefaultJob : .NET Core 2.0.7 (CoreCLR 4.6.26328.01, CoreFX 4.6.26403.03), 64bit RyuJIT

| ORM | Type | Method | Mean | Error | StdDev | Rank | Gen 0 | Gen 1 | Gen 2 | Allocated |
|--------------- |------------------------- |------------------------ |---------:|----------:|----------:|-----:|-----------:|----------:|----------:|----------:|
| SmartSql | SmartSqlBenchmarks | Query | 101.6 ms | 0.2226 ms | 0.1738 ms | 1 | 2437.5000 | 1062.5000 | 375.0000 | 13.37 MB |
| Native | NativeBenchmarks | Query_IsDBNull_GetValue | 101.7 ms | 0.4101 ms | 0.3635 ms | 1 | 2437.5000 | 1062.5000 | 375.0000 | 13.37 MB |
| Dapper | DapperBenchmarks | Query | 104.4 ms | 1.3195 ms | 1.2342 ms | 2 | 3375.0000 | 1375.0000 | 625.0000 | 17.64 MB |
| SmartSqlDapper | SmartSqlDapperBenchmarks | Query | 105.7 ms | 1.1697 ms | 1.0941 ms | 3 | 3750.0000 | 1437.5000 | 625.0000 | 19.47 MB |
| Native | NativeBenchmarks | Query_GetValue_DbNull | 107.4 ms | 1.0710 ms | 1.0018 ms | 4 | 3062.5000 | 1187.5000 | 500.0000 | 16.42 MB |
| SqlSugar | SqlSugarBenchmarks | Query | 108.9 ms | 0.4048 ms | 0.3787 ms | 5 | 2375.0000 | 1000.0000 | 312.5000 | 13.09 MB |
| EF | EFBenchmarks | SqlQuery | 110.9 ms | 0.6922 ms | 0.6475 ms | 6 | 11062.5000 | - | - | 34.13 MB |
| Chloe | ChloeBenchmarks | Query | 14.5 ms | 2.2600 ms | 5.3711 ms | 7 | 2375.0000 | 1000.0000 | 312.5000 | 13.07 MB |
| EF | EFBenchmarks | Query_NoTracking | 126.4 ms | 1.3197 ms | 1.2344 ms | 8 | 5937.5000 | 2250.0000 | 1062.5000 | 30.16 MB |
| EF | EFBenchmarks | SqlQuery_NoTracking | 148.6 ms | 0.8290 ms | 0.7755 ms | 9 | 7437.5000 | 2937.5000 | 1250.0000 | 37.79 MB |


4. 安装 (NuGet)

Install-Package SmartSql

5. 常规代码

查询

            ISmartSqlMapper SqlMapper = MapperContainer.Instance.GetSqlMapper();
            SqlMapper.Query<T_Test>(new RequestContext
            {
                Scope = "T_Test",
                SqlId = "GetList",
                Request = new { Ids = new long[] { 1, 2, 3, 4 } }
            });

事务

            try
            {
                ISmartSqlMapper SqlMapper = MapperContainer.Instance.GetSqlMapper();
                SqlMapper.BeginTransaction();
                //BizCode
                SqlMapper.CommitTransaction();
            }
            catch (Exception ex)
            {
                SqlMapper.RollbackTransaction();
                throw ex;
            }

6. 最佳实践

6.1 安装 SmartSql.DIExtension

Install-Package SmartSql.DIExtension

6.2 注入依赖

 services.AddSmartSql();
 services.AddRepositoryFactory();
 services.AddRepositoryFromAssembly((options) =>
 {
    options.AssemblyString = "SmartSql.Starter.Repository";
 });

6.3 定义仓储接口

    /// <summary>
    /// 属性可选: [SqlMap(Scope = "User")] ,不设置 则默认 Scope 模板:I{Scope}Repository
    /// 可传入自定义模板
    /// RepositoryBuilder builder=new RepositoryBuilder("I{Scope}DAL");
    /// </summary>
    public interface IUserRepository
    {
        /// <summary>
        /// 属性可选 [Statement(Execute = ExecuteBehavior.Auto,Id = "Query")]
        /// 默认 Execute:Auto ,自动判断 执行类型
        /// 默认 Id : 方法名
        /// </summary>
        /// <param name="reqParams"></param>
        /// <returns></returns>
        IEnumerable<User> Query(object reqParams);
        long GetRecord(object reqParams);
        User Get(object reqParams);
        long Insert(User entity);
        int Update(User entity);
        int Delete(User enttiy);
    }

6.4 尽情享用

    public class UserService
    {
        private readonly ISmartSqlMapper _smartSqlMapper;
        private readonly IUserRepository _userRepository;

        public UserService(
             ISmartSqlMapper smartSqlMapper
            , IUserRepository userRepository)
        {
            _smartSqlMapper = smartSqlMapper;
            _userRepository = userRepository;
        }

        public long Add(AddRequest request)
        {
            int existsNum = _userRepository.Exists(new { request.UserName });
            if (existsNum > 0)
            {
                throw new ArgumentException($"{nameof(request.UserName)} has already existed!");
            }
            return _userRepository.Add(new Entitiy.User
            {
                UserName = request.UserName,
                Password = request.Password,
                Status = Entitiy.UserStatus.Ok,
                CreationTime = DateTime.Now,
            });
        }

        public void UseTransaction()
        {
            try
            {
                _smartSqlMapper.BeginTransaction();
                //Biz();
                _smartSqlMapper.CommitTransaction();
            }
            catch (Exception ex)
            {
                _smartSqlMapper.RollbackTransaction();
                throw ex;
            }
        }
    }

7. 文档地址

8. 技术交流

点击链接加入QQ群【SmartSql 官方交流群】:604762592

Showing the top 1 GitHub repositories that depend on SmartSql.TypeHandler:

Repository Stars
dotnetcore/SmartCode
SmartCode = IDataSource -> IBuildTask -> IOutput => Build Everything!!!

Read more about the GitHub Usage information on our documentation.

Version History

Version Downloads Last updated
4.1.53 119 4/8/2020
4.1.52 133 3/27/2020
4.1.51 182 3/21/2020
4.1.50 164 3/9/2020
4.1.48 92 3/5/2020
4.1.46 177 12/18/2019
4.1.45 67 12/18/2019
4.1.44 140 12/5/2019
4.1.43 115 11/20/2019
4.1.42 221 11/18/2019
4.1.41 109 11/12/2019
4.1.40 66 11/12/2019
4.1.39 88 11/6/2019
4.1.38 114 10/29/2019
4.1.37 73 10/29/2019
4.1.36 79 10/29/2019
4.1.35 68 10/29/2019
4.1.34 85 10/28/2019
4.1.33 73 10/28/2019
4.1.32 714 9/30/2019
4.1.31 79 9/29/2019
4.1.30 93 9/27/2019
4.1.29 92 9/26/2019
4.1.28 140 9/2/2019
4.1.27 88 8/30/2019
4.1.26 84 8/30/2019
4.1.25 87 8/30/2019
4.1.24 104 8/28/2019
4.1.23 240 8/20/2019
4.1.22 101 8/19/2019
4.1.21 121 8/13/2019
4.1.20 100 8/13/2019
4.1.19 102 8/13/2019
4.1.18 232 8/5/2019
4.1.17 154 8/1/2019
4.1.16 116 8/1/2019
4.1.15 122 7/30/2019
4.1.14 106 7/30/2019
4.1.12 122 7/30/2019
4.1.11 116 7/30/2019
4.1.10 117 7/30/2019
4.1.9 142 7/29/2019
4.1.8 125 7/29/2019
4.1.7 109 7/29/2019
4.1.6 131 7/29/2019
4.1.5 118 7/27/2019
4.1.3 121 7/26/2019
4.1.2 121 7/25/2019
4.1.1 107 7/25/2019
4.1.0 119 7/24/2019
4.0.88 106 7/24/2019
4.0.86 143 7/22/2019
4.0.85 111 7/22/2019
4.0.84 110 7/22/2019
4.0.81 160 7/19/2019
4.0.80 120 7/19/2019
4.0.78 115 7/19/2019
4.0.76 139 7/17/2019
4.0.75 168 7/10/2019
4.0.73 138 7/10/2019
4.0.72 149 7/5/2019
4.0.71 211 6/25/2019
4.0.70 136 6/25/2019
4.0.69 155 6/25/2019
4.0.68 141 6/20/2019
4.0.66 150 6/18/2019
4.0.65 146 6/17/2019
4.0.63 161 6/12/2019
4.0.62 148 6/12/2019
4.0.60 153 6/11/2019
4.0.59 148 6/11/2019
4.0.58 236 6/3/2019
4.0.56 183 5/31/2019
4.0.55 167 5/30/2019
4.0.53 155 5/30/2019
4.0.52 152 5/30/2019
4.0.51 148 5/30/2019
4.0.50 145 5/29/2019
4.0.49 154 5/29/2019
4.0.48 144 5/24/2019
4.0.46 416 5/15/2019
4.0.45 164 5/10/2019
4.0.44 189 5/7/2019
4.0.43 170 5/7/2019
4.0.42 350 4/28/2019
4.0.41 167 4/28/2019
4.0.40 190 4/26/2019
4.0.38 202 4/26/2019
4.0.36 184 4/25/2019
4.0.35 177 4/25/2019
4.0.34 248 4/23/2019
4.0.33 211 4/19/2019
4.0.32 204 4/19/2019
4.0.30 165 4/19/2019
4.0.29 198 4/18/2019
4.0.28 184 4/18/2019
4.0.26 181 4/18/2019
4.0.25 186 4/17/2019
4.0.21 177 4/17/2019
4.0.20 168 4/16/2019
4.0.19 193 4/15/2019
4.0.18 181 4/15/2019
4.0.16 200 4/11/2019
4.0.15 185 4/11/2019
4.0.14 172 4/9/2019
4.0.13 174 4/9/2019
4.0.12 204 4/4/2019
4.0.11 170 4/4/2019
4.0.2 200 4/1/2019
4.0.0 171 4/1/2019
4.0.0-rc996 122 3/29/2019
4.0.0-rc993 128 3/28/2019
4.0.0-rc96 135 3/26/2019
4.0.0-rc95 137 3/25/2019
4.0.0-rc93 137 3/25/2019
4.0.0-rc92 131 3/25/2019
4.0.0-rc6 121 3/21/2019
4.0.0-rc3 134 3/19/2019
4.0.0-rc1 130 3/17/2019
4.0.0-beta5 131 3/16/2019
4.0.0-beta2 125 3/8/2019
4.0.0-beta1 133 3/7/2019
3.7.15 956 10/24/2018
3.7.15-rc 159 10/23/2018
3.0.1 624 6/26/2018
3.0.0 376 6/2/2018
3.0.0-rc6 263 5/28/2018
3.0.0-rc5 265 5/27/2018
Show less