SmartSql.TypeHandler 3.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package SmartSql.TypeHandler --version 3.0.0
NuGet\Install-Package SmartSql.TypeHandler -Version 3.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SmartSql.TypeHandler" Version="3.0.0" />
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
#r "nuget: SmartSql.TypeHandler, 3.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install SmartSql.TypeHandler as a Cake Addin
#addin nuget:?package=SmartSql.TypeHandler&version=3.0.0

// Install SmartSql.TypeHandler as a Cake Tool
#tool nuget:?package=SmartSql.TypeHandler&version=3.0.0

简介

SmartSql-Starter

0. Why

  • 拥抱 跨平台 DotNet Core,是时候了。
  • 高性能、高生产力,超轻量级的ORM。107kb

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.17134
Intel Core i7-6700K CPU 4.00GHz (Skylake), 1 CPU, 8 logical and 4 physical cores
.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 | Return | Mean | Error | StdDev | Rank | Gen 0 | Gen 1 | Gen 2 | Allocated | |--------------- |------------------------- |------------------------ |-------------- |----------:|----------:|----------:|-----:|----------:|----------:|----------:|----------:| | Native | NativeBenchmarks | Query_GetValue_DbNull | IEnumerable1 | 78.39 ms | 0.8935 ms | 0.7921 ms | 1 | 3000.0000 | 1125.0000 | 500.0000 | 15.97 MB | | SmartSql | SmartSqlBenchmarks | Query | IEnumerable1 | 78.46 ms | 0.2402 ms | 0.1875 ms | 1 | 2312.5000 | 1000.0000 | 312.5000 | 12.92 MB | | SmartSqlDapper | SmartSqlDapperBenchmarks | Query | IEnumerable1 | 78.65 ms | 1.2094 ms | 1.1312 ms | 1 | 3687.5000 | 1437.5000 | 687.5000 | 19.03 MB | | Native | NativeBenchmarks | Query_IsDBNull_GetValue | IEnumerable1 | 78.84 ms | 0.8984 ms | 0.7502 ms | 1 | 2312.5000 | 1000.0000 | 312.5000 | 12.92 MB | | Dapper | DapperBenchmarks | Query | IEnumerable1 | 79.00 ms | 1.0949 ms | 0.9706 ms | 1 | 3312.5000 | 1312.5000 | 625.0000 | 17.19 MB | | EF | EFBenchmarks | Query | IEnumerable1 | 79.44 ms | 1.6880 ms | 1.5789 ms | 1 | 6250.0000 | - | - | 26.05 MB | | SqlSugar | SqlSugarBenchmarks | Query | IEnumerable1 | 81.09 ms | 0.8718 ms | 0.7728 ms | 2 | 2187.5000 | 875.0000 | 250.0000 | 12.64 MB | | Chloe | ChloeBenchmarks | Query | IEnumerable1 | 83.86 ms | 1.2714 ms | 1.1893 ms | 3 | 2250.0000 | 937.5000 | 312.5000 | 12.62 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

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net46 is compatible.  net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on SmartSql.TypeHandler:

Package Downloads
SmartSql.TypeHandler.PostgreSql

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

SmartSql.Test.Performance

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

SmartCode.Db

SmartCode = IDataSource -> IBuildTask -> IOutput => Build Everything!!!

GitHub repositories (2)

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

Repository Stars
dotnetcore/SmartCode
SmartCode = IDataSource -> IBuildTask -> IOutput => Build Everything!!!
lindexi/lindexi_gd
博客用到的代码
Version Downloads Last updated
4.1.67 290 10/19/2023
4.1.66 265 9/21/2023
4.1.65 173 9/21/2023
4.1.64 3,025 5/13/2022
4.1.63 821 5/4/2022
4.1.62 797 4/29/2022
4.1.59 1,059 3/10/2022
4.1.58 998 3/3/2022
4.1.57 3,449 11/17/2020
4.1.56 1,506 7/14/2020
4.1.55 1,489 6/18/2020
4.1.54 856 6/12/2020
4.1.53 1,296 4/8/2020
4.1.52 928 3/27/2020
4.1.51 1,059 3/21/2020
4.1.50 1,723 3/9/2020
4.1.48 834 3/5/2020
4.1.46 977 12/18/2019
4.1.45 834 12/18/2019
4.1.44 3,539 12/5/2019
4.1.43 880 11/20/2019
4.1.42 1,231 11/18/2019
4.1.41 833 11/12/2019
4.1.40 795 11/12/2019
4.1.39 867 11/6/2019
4.1.38 892 10/29/2019
4.1.37 827 10/29/2019
4.1.36 836 10/29/2019
4.1.35 793 10/29/2019
4.1.34 836 10/28/2019
4.1.33 839 10/28/2019
4.1.32 5,132 9/30/2019
4.1.31 824 9/29/2019
4.1.30 826 9/27/2019
4.1.29 816 9/26/2019
4.1.28 924 9/2/2019
4.1.27 816 8/30/2019
4.1.26 849 8/30/2019
4.1.25 858 8/30/2019
4.1.24 867 8/28/2019
4.1.23 4,920 8/20/2019
4.1.22 826 8/19/2019
4.1.21 854 8/13/2019
4.1.20 854 8/13/2019
4.1.19 870 8/13/2019
4.1.18 8,675 8/5/2019
4.1.17 1,001 8/1/2019
4.1.16 881 8/1/2019
4.1.15 908 7/30/2019
4.1.14 888 7/30/2019
4.1.12 886 7/30/2019
4.1.11 926 7/30/2019
4.1.10 878 7/30/2019
4.1.9 877 7/29/2019
4.1.8 919 7/29/2019
4.1.7 909 7/29/2019
4.1.6 847 7/29/2019
4.1.5 893 7/27/2019
4.1.3 888 7/26/2019
4.1.2 903 7/25/2019
4.1.1 815 7/25/2019
4.1.0 887 7/24/2019
4.0.88 871 7/24/2019
4.0.86 1,574 7/22/2019
4.0.85 889 7/22/2019
4.0.84 857 7/22/2019
4.0.81 934 7/19/2019
4.0.80 860 7/19/2019
4.0.78 877 7/19/2019
4.0.76 918 7/17/2019
4.0.75 2,971 7/10/2019
4.0.73 930 7/10/2019
4.0.72 900 7/5/2019
4.0.71 978 6/25/2019
4.0.70 905 6/25/2019
4.0.69 940 6/25/2019
4.0.68 874 6/20/2019
4.0.66 945 6/18/2019
4.0.65 910 6/17/2019
4.0.63 947 6/12/2019
4.0.62 940 6/12/2019
4.0.60 931 6/11/2019
4.0.59 912 6/11/2019
4.0.58 1,015 6/3/2019
4.0.56 945 5/31/2019
4.0.55 942 5/30/2019
4.0.53 892 5/30/2019
4.0.52 921 5/30/2019
4.0.51 907 5/30/2019
4.0.50 912 5/29/2019
4.0.49 978 5/29/2019
4.0.48 924 5/24/2019
4.0.46 2,046 5/15/2019
4.0.45 961 5/10/2019
4.0.44 965 5/7/2019
4.0.43 921 5/7/2019
4.0.42 1,113 4/28/2019
4.0.41 920 4/28/2019
4.0.40 960 4/26/2019
4.0.38 950 4/26/2019
4.0.36 948 4/25/2019
4.0.35 933 4/25/2019
4.0.34 959 4/23/2019
4.0.33 929 4/19/2019
4.0.32 968 4/19/2019
4.0.30 949 4/19/2019
4.0.29 975 4/18/2019
4.0.28 941 4/18/2019
4.0.26 949 4/18/2019
4.0.25 958 4/17/2019
4.0.21 951 4/17/2019
4.0.20 907 4/16/2019
4.0.19 920 4/15/2019
4.0.18 927 4/15/2019
4.0.16 966 4/11/2019
4.0.15 961 4/11/2019
4.0.14 939 4/9/2019
4.0.13 932 4/9/2019
4.0.12 993 4/4/2019
4.0.11 964 4/4/2019
4.0.2 660 4/1/2019
4.0.0 834 4/1/2019
4.0.0-rc996 477 3/29/2019
4.0.0-rc993 547 3/28/2019
4.0.0-rc96 503 3/26/2019
4.0.0-rc95 541 3/25/2019
4.0.0-rc93 538 3/25/2019
4.0.0-rc92 503 3/25/2019
4.0.0-rc6 503 3/21/2019
4.0.0-rc3 410 3/19/2019
4.0.0-rc1 524 3/17/2019
4.0.0-beta5 415 3/16/2019
4.0.0-beta2 520 3/8/2019
4.0.0-beta1 510 3/7/2019
3.7.15 1,947 10/24/2018
3.7.15-rc 521 10/23/2018
3.0.1 1,356 6/26/2018
3.0.0 1,055 6/2/2018
3.0.0-rc6 805 5/28/2018
3.0.0-rc5 806 5/27/2018