3步上手轻量级ORM框架SmartSql：从安装到实战

3步上手轻量级ORM框架SmartSql：从安装到实战

【免费下载链接】SmartSqlSmartSql = MyBatis in C# + .NET Core+ Cache(Memory | Redis) + R/W Splitting + PropertyChangedTrack +Dynamic Repository + InvokeSync + Diagnostics项目地址: https://gitcode.com/gh_mirrors/smar/SmartSql

SmartSql是一款融合MyBatis思想的轻量级ORM框架，专为.NET Core设计，通过XML集中管理SQL语句实现跨数据库兼容，同时集成内存/Redis缓存、读写分离等企业级特性。本文将带你从零开始部署环境、掌握核心功能，并通过实战案例体验动态仓库的高效开发模式。

零基础配置：如何搭建SmartSql开发环境？

环境准备清单

• .NET Core SDK 3.1+（推荐5.0以上版本）
• 支持SQL Server/MySQL/PostgreSQL的数据库环境
• VS2019+或VS Code（安装C#扩展）

快速部署步骤

1. 获取项目源码

打开终端执行克隆命令：

git clone https://gitcode.com/gh_mirrors/smar/SmartSql

2. 依赖管理与项目构建

在解决方案目录执行：

dotnet restore # 还原NuGet依赖 dotnet build -c Release # 编译项目

如何验证环境配置成功？可运行测试项目检查基础功能：

cd src/SmartSql.Test.Unit dotnet test

避坑指南：XML SQL配置与动态仓库实战

核心功能实现

1. XML映射文件配置

在Maps目录创建User.xml，定义基础CRUD操作：

<SmartSqlMap Scope="User"> <!-- 新增用户 --> <Statement Id="Insert"> INSERT INTO User(Id,Name,Age) VALUES(@Id,@Name,@Age) </Statement> <!-- 查询用户 --> <Statement Id="GetById"> SELECT * FROM User WHERE Id=@Id </Statement> </SmartSqlMap>

2. 动态仓库接口定义

创建IUserRepository接口实现无代码调用：

public interface IUserRepository : IRepository<User, long> { // 继承IRepository获得基础CRUD方法 [Statement(Scope = "User", SqlId = "GetByAgeRange")] IEnumerable<User> GetByAge(int minAge, int maxAge); }

常见问题排查：3大典型错误解决方案

错误现象	可能原因	解决方法
找不到SQL映射	XML文件未设置为嵌入资源	在属性窗口将Build Action设为EmbeddedResource
数据库连接失败	连接字符串格式错误	检查SmartSqlMapConfig.xml中的DataSource配置
动态代理异常	接口方法命名不规范	确保方法名符合CRUD命名约定或显式指定Statement

功能投票：你最期待的SmartSql新特性

1. 可视化SQL编辑器集成
2. 分布式事务支持
3. 自动分表分库功能

欢迎在评论区留下你的选择，帮助我们优先开发最实用的功能！

提示：完整示例代码可参考sample/SmartSql.Sample.AspNetCore项目，包含ASP.NET Core集成的完整配置。

【免费下载链接】SmartSqlSmartSql = MyBatis in C# + .NET Core+ Cache(Memory | Redis) + R/W Splitting + PropertyChangedTrack +Dynamic Repository + InvokeSync + Diagnostics项目地址: https://gitcode.com/gh_mirrors/smar/SmartSql