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

簡介

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	IEnumerable`1	78.39 ms	0.8935 ms	0.7921 ms	1	3000.0000	1125.0000	500.0000	15.97 MB
SmartSql	SmartSqlBenchmarks	Query	IEnumerable`1	78.46 ms	0.2402 ms	0.1875 ms	1	2312.5000	1000.0000	312.5000	12.92 MB
SmartSqlDapper	SmartSqlDapperBenchmarks	Query	IEnumerable`1	78.65 ms	1.2094 ms	1.1312 ms	1	3687.5000	1437.5000	687.5000	19.03 MB
Native	NativeBenchmarks	Query_IsDBNull_GetValue	IEnumerable`1	78.84 ms	0.8984 ms	0.7502 ms	1	2312.5000	1000.0000	312.5000	12.92 MB
Dapper	DapperBenchmarks	Query	IEnumerable`1	79.00 ms	1.0949 ms	0.9706 ms	1	3312.5000	1312.5000	625.0000	17.19 MB
EF	EFBenchmarks	Query	IEnumerable`1	79.44 ms	1.6880 ms	1.5789 ms	1	6250.0000	-	-	26.05 MB
SqlSugar	SqlSugarBenchmarks	Query	IEnumerable`1	81.09 ms	0.8718 ms	0.7728 ms	2	2187.5000	875.0000	250.0000	12.64 MB
Chloe	ChloeBenchmarks	Query	IEnumerable`1	83.86 ms	1.2714 ms	1.1893 ms	3	2250.0000	937.5000	312.5000	12.62 MB
EF	EFBenchmarks	SqlQuery	IEnumerable`1	89.11 ms	0.7562 ms	0.6314 ms	4	8187.5000	125.0000	-	33.68 MB
EF	EFBenchmarks	Query_NoTracking	IEnumerable`1	93.13 ms	0.8458 ms	0.7912 ms	5	5875.0000	2250.0000	1062.5000	29.71 MB
EF	EFBenchmarks	SqlQuery_NoTracking	IEnumerable`1	106.89 ms	1.0998 ms	1.0288 ms	6	7437.5000	2875.0000	1312.5000	37.34 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}Repository");
    /// </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);
        int GetRecord(object reqParams);
        User GetById([Param("Id")]long id);
        long Insert(User entity);
        int Update(User entity);
        int Delete(User enttiy);
        [Statement(Sql = "Select Top(@taken) T.* From T_User T With(NoLock);")]
        Task<IEnumerable<User>> QueryBySqlAsync(int taken);
        bool IsExist(object reqParams);
    }
複製代碼

6.4 盡情享用

public class UserService
    {
        private readonly ITransaction _transaction;
        private readonly IUserRepository _userRepository;

        public UserService( ITransaction transaction , IUserRepository userRepository) {
            _transaction = transaction;
            _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.Insert(new Entitiy.User
            {
                UserName = request.UserName,
                Password = request.Password,
                Status = Entitiy.UserStatus.Ok,
                CreationTime = DateTime.Now,
            });
        }

        public void UseTransaction() {
            try
            {
                _transaction.BeginTransaction();
                //Biz();
                _transaction.CommitTransaction();
            }
            catch (Exception ex)
            {
                _transaction.RollbackTransaction();
                throw ex;
            }
        }
    }
複製代碼

7. 文檔地址

• 在線閱讀地址
• PDF
• Mobi
• ePub

8. 技術交流

點擊連接加入QQ羣【SmartSql 官方交流羣】：604762592