SmartSql 3.3.16

简介

SmartSql-Starter

Why

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

So SmartSql

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

主要特性

• 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 分布式配置文件加载器)

安装 (NuGet)

Install-Package SmartSql

最佳实践

安装 SmartSql.DIExtension

Install-Package SmartSql.DIExtension

注入依赖

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

定义仓储接口

    /// <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);
    }

尽情享用

    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;
            }
        }
    }

文档地址

• 在线阅读地址
• PDF
• Mobi
• ePub

技术交流

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