【亲测免费】 FreeSql 快速入门及最佳实践指南

1. 项目介绍

FreeSql 是一个轻量级且强大的 .NET ORM 工具，支持 .NET Core 和 .NET Framework。它提供了丰富的 API 设计，可以方便地进行数据库的读写操作，同时也支持数据迁移、分表分库、全局过滤器等功能。FreeSql 支持多种数据库引擎，包括 MySQL、SQL Server、PostgreSQL、Oracle、SQLite、Firebird 及国内的一些主流数据库。该项目采用 MIT 许可证，源码公开，允许自由使用和修改。

2. 项目快速启动

首先确保已经安装了对应的数据库驱动程序。以下是一个简单的使用示例，演示如何连接数据库并执行查询：

安装依赖包

在你的 .csproj 文件中添加以下 NuGet 包依赖：

<PackageReference Include="FreeSql.Provider.MySql" Version="latest" />

连接数据库

using FreeSql;

var fsql = new MySqlProvider<MySqlParameter>()
    .Connect("Server=localhost;Database=test;Uid=root;Pwd=123456;");

查询数据

var users = fsql.Ado.SqlQuery<User>("select * from user where id = @id", new { id = 1 }).ToList();

插入数据

fsql.Ado.ExecuteCommand(
    "insert into user (name, age) values (@name, @age)", 
    new { name = "张三", age = 20 });

3. 应用案例和最佳实践

代码第一式：使用 CodeFirst 进行数据模型定义

public class User {
    [Column(IsIdentity = true)]
    public int Id { get; set; }
    public string Name { get; set; }
    public int Age { get; set; }
}

var db = new FreeSqlBuilder()
    .UseAutoSyncStructure(true)
    .UseConnectionString(DataType.MySql, "Server=localhost;Database=test;Uid=root;Pwd=123456;")
    .Build();

db.CodeFirst.SyncStructure(typeof(User)); //同步结构到数据库

最佳实践：使用 Repository 模式

为了更好地组织业务逻辑，推荐使用 Repository 模式来封装数据库操作：

public interface IUserRepository {
    IEnumerable<User> GetAll();
    User GetById(int id);
    void Save(User user);
}

public class UserRepository : IUserRepository {
    private readonly IFreeSql _freeSql;
    
    public UserRepository(IFreeSql freeSql) {
        _freeSql = freeSql;
    }

    public IEnumerable<User> GetAll() => _freeSql.Select<User>().ToList();
    public User GetById(int id) => _freeSql.Select<User>().Where(u => u.Id == id).First();
    public void Save(User user) => _freeSql.Update(user).ExecuteAffrows();
}

数据库分片最佳实践

通过 GlobalFilter 实现读写分离或者数据分库分表：

//读写分离示例
fsql.GlobalFilter.Enable(a => a.WriteDb == "master");
//数据分库分表示例
fsql.GlobalFilter.EnableSharding(a => a.Id % 2); //偶数 ID 到库 1，奇数 ID 到库 2

4. 典型生态项目

• FreeSql.AdminBlazor: 基于 Blazor 的管理后台框架，集成 FreeSql。
• FreeRedis: 强大的 Redis 客户端工具。
• FreeScheduler: 简单易用的任务调度框架。
• FreeIM: 跨平台即时通讯系统解决方案。

这些项目展示了 FreeSql 在实际应用场景中的扩展性和兼容性，有助于构建完整的业务系统。

---

以上就是 FreeSql 的基本介绍、快速启动步骤、实践案例以及相关生态项目。深入了解和熟练掌握 FreeSql 将使您的数据库开发工作更加高效和灵活。更多详细信息请参考官方文档：

• FreeSql 文档
• 示例代码仓库

祝您使用愉快！