FreeSql 开源项目教程

邬千旻Herman

于 2024-09-25 08:52:44 发布

阅读量806

点赞数 21

本文链接：https://blog.csdn.net/gitblog_00975/article/details/142513442

版权

FreeSql 开源项目教程

FreeSql dotnetcore/FreeSql: 这是一个用于SQL Server、MySQL、PostgreSQL等多种数据库的ORM框架。适合用于需要使用ASP.NET Core访问多种数据库的场景。特点：易于使用，支持多种数据库，具有高性能和可扩展性。项目地址: https://gitcode.com/gh_mirrors/fr/FreeSql

1. 项目介绍

FreeSql 是一个强大的对象关系映射（O/RM）组件，支持 .NET Core 2.1+、.NET Framework 4.0+、Xamarin 以及 AOT。它提供了丰富的功能，包括 CodeFirst 数据迁移、DbFirst 导入实体类、高级类型映射、表达式函数、导航属性、读写分离、分表/分库、全局过滤、乐观锁和悲观锁等。FreeSql 支持多种数据库，如 MySQL、PostgreSQL、SQL Server、Oracle、SQLite、Firebird 等，还包括国产数据库如达梦、人大金仓、神通、翰高、南大通用、虚谷等。

2. 项目快速启动

安装 FreeSql

首先，通过 NuGet 安装 FreeSql：

dotnet add package FreeSql.Provider.Sqlite

初始化 FreeSql

在项目中初始化 FreeSql 实例：

using FreeSql;

static IFreeSql fsql = new FreeSqlBuilder()
    .UseConnectionString(DataType.Sqlite, @"Data Source=document.db")
    .UseAutoSyncStructure(true) // 自动同步实体结构到数据库
    .Build(); // 确保定义为单例模式

定义实体类

定义一个简单的实体类：

class Song
{
    [Column(IsIdentity = true)]
    public int Id { get; set; }
    public string Title { get; set; }
    public string Url { get; set; }
    public DateTime CreateTime { get; set; }
    public ICollection<Tag> Tags { get; set; }
}

class Tag
{
    [Column(IsIdentity = true)]
    public int Id { get; set; }
    public string Name { get; set; }
    public int Parent_id { get; set; }
    public Tag Parent { get; set; }
    public ICollection<Song> Songs { get; set; }
    public ICollection<Tag> Tags { get; set; }
}

查询数据

使用 FreeSql 进行数据查询：

// 一对一、多对一查询
var tags = fsql.Select<Tag>()
    .Where(a => a.Parent.Parent.Name == "English")
    .ToList();

// 一对多查询
var tagsWithChildren = fsql.Select<Tag>()
    .IncludeMany(a => a.Tags, then => then.Where(sub => sub.Name == "foo"))
    .ToList();

// 多对多查询
var songs = fsql.Select<Song>()
    .IncludeMany(a => a.Tags, then => then.Where(sub => sub.Name == "foo"))
    .Where(s => s.Tags.Any(t => t.Name == "Chinese"))
    .ToList();