SmartSql.TypeHandler
3.0.0-rc6
This is a prerelease version of SmartSql.TypeHandler.
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package SmartSql.TypeHandler --version 3.0.0-rc6
NuGet\Install-Package SmartSql.TypeHandler -Version 3.0.0-rc6
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-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.
#r "nuget: SmartSql.TypeHandler, 3.0.0-rc6"
#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-rc6&prerelease
// Install SmartSql.TypeHandler as a Cake Tool
#tool nuget:?package=SmartSql.TypeHandler&version=3.0.0-rc6&prerelease
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 缓存事务一致性
- 6.1 SmartSql.Cache.Memory √
- 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
Product | Versions 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.
-
.NETFramework 4.6
- Newtonsoft.Json (>= 11.0.2)
- SmartSql (>= 3.0.0-rc6)
-
.NETStandard 2.0
- Newtonsoft.Json (>= 11.0.2)
- SmartSql (>= 3.0.0-rc6)
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 | 303 | 10/19/2023 |
4.1.66 | 267 | 9/21/2023 |
4.1.65 | 175 | 9/21/2023 |
4.1.64 | 3,044 | 5/13/2022 |
4.1.63 | 821 | 5/4/2022 |
4.1.62 | 797 | 4/29/2022 |
4.1.59 | 1,064 | 3/10/2022 |
4.1.58 | 998 | 3/3/2022 |
4.1.57 | 3,468 | 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,297 | 4/8/2020 |
4.1.52 | 930 | 3/27/2020 |
4.1.51 | 1,061 | 3/21/2020 |
4.1.50 | 1,757 | 3/9/2020 |
4.1.48 | 836 | 3/5/2020 |
4.1.46 | 979 | 12/18/2019 |
4.1.45 | 836 | 12/18/2019 |
4.1.44 | 3,542 | 12/5/2019 |
4.1.43 | 882 | 11/20/2019 |
4.1.42 | 1,233 | 11/18/2019 |
4.1.41 | 835 | 11/12/2019 |
4.1.40 | 797 | 11/12/2019 |
4.1.39 | 869 | 11/6/2019 |
4.1.38 | 894 | 10/29/2019 |
4.1.37 | 829 | 10/29/2019 |
4.1.36 | 838 | 10/29/2019 |
4.1.35 | 795 | 10/29/2019 |
4.1.34 | 839 | 10/28/2019 |
4.1.33 | 841 | 10/28/2019 |
4.1.32 | 5,233 | 9/30/2019 |
4.1.31 | 826 | 9/29/2019 |
4.1.30 | 828 | 9/27/2019 |
4.1.29 | 818 | 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 | 868 | 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,676 | 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 | 894 | 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,972 | 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 | 911 | 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,047 | 5/15/2019 |
4.0.45 | 962 | 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 | 921 | 4/28/2019 |
4.0.40 | 961 | 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 | 969 | 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 | 967 | 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 | 994 | 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,949 | 10/24/2018 |
3.7.15-rc | 522 | 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 |