Web开发：ORM框架之Freesql的入门和技巧使用小结

devtools/2024/11/15 0:41:03/

目录

零、官网链接

一、字段映射表

二、基础查询

sql%E7%8B%AC%E7%89%B9%E5%B0%81%E8%A3%85%EF%BC%9Abetween%E5%85%B3%E9%94%AE%E5%AD%97-toc" style="margin-left:40px;">1.freesql独特封装：between关键字查日期

 2.分页（每页 20 条数据，查询第 1 页）

sql%EF%BC%88%E5%AD%90%E6%9F%A5%E8%AF%A2%EF%BC%8C%E4%B8%8D%E5%BB%BA%E8%AE%AE%EF%BC%89-toc" style="margin-left:40px;">3.Withsql（子查询，不建议）

3.简单查询、映射查询

4.参数查询、自定义查询

5.左外连接（框架+导航属性）

6.简单分表查询

三、基础增删改

1.SQL增删改（ADO.NET）

 2.框架增删改（普通）

3.框架保存逻辑

四、基础特性

五、基础demo

1.Model

2.Main

六、事务

七、常见问题

sql%E5%AE%9E%E4%BD%93%E5%AD%97%E6%AE%B5%EF%BC%88%E4%B8%8E%E6%95%B0%E6%8D%AE%E5%BA%93%E7%9B%B8%E6%AF%94%EF%BC%89%E8%BF%87%E5%A4%9A%E5%92%8C%E8%BF%87%E5%B0%91%E5%88%86%E5%88%AB%E4%BC%9A%E6%80%8E%E4%B9%88%E6%A0%B7%EF%BC%9F-toc" style="margin-left:40px;">1.freesql实体字段（与数据库相比）过多和过少分别会怎么样？

零、官网链接

https://freesql.net/guide/

一、字段映射表

访问官网

二、基础查询

sql%E7%8B%AC%E7%89%B9%E5%B0%81%E8%A3%85%EF%BC%9Abetween%E5%85%B3%E9%94%AE%E5%AD%97">1.freesql独特封装：between关键字查日期

var list = list.Where(a => a.Time.Between(time1, time2));

 2.分页（每页 20 条数据，查询第 1 页）

var list = fsql.Select<Topic>().Where(a => a.Id > 10).Count(out var total) //总记录数量.Page(1, 20).ToList();

sql%EF%BC%88%E5%AD%90%E6%9F%A5%E8%AF%A2%EF%BC%8C%E4%B8%8D%E5%BB%BA%E8%AE%AE%EF%BC%89">3.Withsql（子查询，不建议）

class Topic
{[Column(IsIdentity = true)]public int Id { get; set; }public string Title { get; set; }public int Clicks { get; set; }public DateTime CreateTime { get; set; }public int CategoryId { get; set; }
}fsql.Select<Topic>().WithSql("select * from Topic where clicks > @val", new { val = 10 }).Page(1, 10).ToList()
//SELECT a.`Id`, a.`Clicks`, a.`CategoryId`, a.`Title`, a.`CreateTime` 
//FROM (select * from Topic where clicks > @val) a

3.简单查询、映射查询

【技巧】打印sql、纠正映射

List<Student2022> list1 = freesql.Select<Student2022>().ToList(); //1.简单查询//var sql1 = freesql.Select<Student2022>().ToSql();//【技巧】获取查询SQLList<StuAndParent> list5 = freesql.Select<Student2022>().ToList<StuAndParent>();//2.查询后自动映射
//freesql.Select<Student2022>().ToList(x => new StuAndParent { xxx = x.id }) //【技巧】纠正映射

4.参数查询、自定义查询

//等于=、批量in、模糊like查询
freesql.Ado.QuerySingle<T>("select * from t1 where id = @id", new { id = 1 });//同时支持字典查询
freesql.Ado.Query<T>("select * from t1 where name like @name", new { name = "%" + searchText + "%" });//同时支持字典查询
var ids = new int[] { 1, 2, 3 };
List<T> list = freesql.Ado.Query<T>("select * from t1 where id in @ids", new { ids = ids });//仅支持 Array 和 IList 类型List<StuAndParent> list2 = freesql.Ado.Query<StuAndParent>("SELECT * FROM Student_2022 A LEFT JOIN Parent B ON A.id=B.pid");//3.自定义SQL查询

5.左外连接（框架+导航属性）

List<StuAndParent> list2 = freesql.Ado.Query<StuAndParent>("SELECT * FROM Student_2022 A LEFT JOIN Parent B ON A.id=B.pid");//3.自定义SQL查询List<StuAndParent> list3 = freesql.Select<Student2022, Parent>()//4.左外连接（框架，列出具体字段）.LeftJoin(w => w.t1.id == w.t2.pid).ToList(w => new StuAndParent{id= w.t1.id,name = w.t1.name,pid = w.t2.pid,pname = w.t2.pname});List<StuAndParent> list3_1 = freesql.Select<Student2022, Parent>()//5.左外连接（框架,映射结果）.LeftJoin(w => w.t1.id == w.t2.pid).ToList(x=>new StuAndParent());List<StuAndParent> list4 = freesql.Select<Student2022>()  //6.左外连接(导航属性).LeftJoin<Parent>((student, parent) => student.id == parent.pid)//直接设置关联条件.ToList(x=>new StuAndParent());//转化为StuAndParent实体
    [Table(Name = "Student_2022")]public class Student2022{[Column(IsPrimary = true)]public int id { get; set; }public string name { get; set; }public int? ParentId { get; set; }  // 【导航关联字段】（数据库不需要设置外键，但数据库必须要有这个字段）[Navigate(nameof(ParentId))]  // 设置导航属性，指定【导航关联字段】public Parent Parent { get; set; }  // 关联的 Parent 实体}public class Parent{[Column(IsPrimary = true)]public int pid { get; set; }public string pname { get; set; }[Navigate(nameof(Student2022.ParentId))]  // 设置导航属性，指定【导航关联字段】public Student2022 Student { get; set; }  // 关联的 Student2022 实体}public class StuAndParent{public int id { get; set; }public string name { get; set; }public int pid { get; set; }public string pname { get; set; }}

6.简单分表查询

//7.简单分表查询
var list6 = freesql.Select<Teacher>().ToList();
    //假如是按月分表：[Table(Name = "log_{yyyyMM}", AsTable = "createtime=2022-1-1(1 month)")]注意：①需包含log_202201这张表 ②递增规律是一个月一次，确保他们存在。 ③确保有字段createtime。[Table(Name = "Teacher_{yyyy}", AsTable = "time=2023-1-1(1 year)")]public class Teacher{[Column(IsPrimary = true)]public int id { get; set; }public DateTime time { get; set; }}

三、基础增删改

1.SQL增删改（ADO.NET）

//8.sql增删改
bool b = freesql.Ado.ExecuteNonQuery(@"DELETE FROM Student_2022 WHERE id = 6")>0;

 2.框架增删改（普通）

//9.框架增删改
freesql.Insert(entity).ExecuteAffrows();freesql.Update<T>(entity);
freesql.Update<T>().Set(a => a.Title, "新标题").Set(a => a.Time, DateTime.Now).Where(a => a.Id == 1)//过滤条件.ExecuteAffrows();//更新实体 并且忽略两个列不更新
fsql.Update<Topic>().SetSource(items).IgnoreColumns(a => new { a.Clicks, a.CreateTime }).ExecuteAffrows();freesql.Delete<T>(entity).ExecuteAffrows();
freesql.Delete<T>().Where(s => s.Id == 1).ExecuteAffrows();

3.框架保存逻辑

【判断依据】主键存在=>改，主键不存在=>增

//10.保存实体（增加或修改）
var entity = new Student2022 { name = "晓晓", id = 6 };
bool b2 = freesql.InsertOrUpdate<Student2022>().SetSource(entity) .ExecuteAffrows()>0;

四、基础特性

【取常用的特性介绍】

表名：[Table(Name = "Student")]
主键：[Column(IsPrimary = true)]
自增：[Column(IsIdentity = true)]
精度：[Column(Precision = 10, Scale = 2)]  //最大长度是10  小数点后2位
           [Column(StringLength = 128)]
忽略字段映射： [Column(IsIgnore = true)]

（补充说明）

  • 表名设置才能成功映射
  • 主键设置若为Guid类型，插入数据时无需手动赋值，不指定主键特性默认id/ID/Id/iD是主键
  • 自增设置了一个字段，默认其为主键

五、基础demo

1.Model

using FreeSql.DataAnnotations;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;namespace FreesqlDemo
{public class Model{}[Table(Name = "Student_2022")]public class Student2022{[Column(IsPrimary = true)]public int id { get; set; }public string name { get; set; }public int? ParentId { get; set; }  // 【导航关联字段】（数据库不需要设置外键，但数据库必须要有这个字段）[Navigate(nameof(ParentId))]  // 设置导航属性，指定【导航关联字段】public Parent Parent { get; set; }  // 关联的 Parent 实体}public class Parent{[Column(IsPrimary = true)]public int pid { get; set; }public string pname { get; set; }[Navigate(nameof(Student2022.ParentId))]  // 设置导航属性，指定【导航关联字段】public Student2022 Student { get; set; }  // 关联的 Student2022 实体}public class StuAndParent{public int id { get; set; }public string name { get; set; }public int pid { get; set; }public string pname { get; set; }}//假如是按月分表：[Table(Name = "log_{yyyyMM}", AsTable = "createtime=2022-1-1(1 month)")]注意：①需包含log_202201这张表 ②递增规律是一个月一次，确保他们存在。 ③确保有字段createtime。[Table(Name = "Teacher_{yyyy}", AsTable = "time=2023-1-1(1 year)")]public class Teacher{[Column(IsPrimary = true)]public int id { get; set; }public DateTime time { get; set; }}
}

2.Main

using FreeSql;
using System.Diagnostics;
using System.Net.WebSockets;
using System.Reflection.Metadata;
using static FreeSql.Internal.GlobalFilter;namespace FreesqlDemo
{public class Program{// 修正后的静态字段声明private static IFreeSql freesql = new FreeSqlBuilder().UseMonitorCommand(cmd => Trace.WriteLine($"Sql：{cmd.CommandText}")).UseConnectionString(DataType.SqlServer, @"server = DESKTOP-FTH2P3S; Database = Test; Trusted_Connection = SSPI;").Build();static void Main(string[] args){List<Student2022> list1 = freesql.Select<Student2022>().ToList(); //1.简单查询var sql1 = freesql.Select<Student2022>().ToSql();//【技巧】获取查询SQLList<StuAndParent> list5 = freesql.Select<Student2022>().ToList<StuAndParent>();//2.查询后自动映射//freesql.Select<Student2022>().ToList(a => new StuAndParent { xxx = a.ext }) //【技巧】纠正映射//等于=、批量in、模糊like查询//freesql.Ado.QuerySingle<T>("select * from t1 where id = @id", new { id = 1 });//同时支持字典查询//freesql.Ado.Query<T>("select * from t1 where name like @name", new { name = "%" + searchText + "%" });//同时支持字典查询//var ids = new int[] { 1, 2, 3 };//List<T> list = freesql.Ado.Query<T>("select * from t1 where id in @ids", new { ids = ids });//仅支持 Array 和 IList 类型List<StuAndParent> list2 = freesql.Ado.Query<StuAndParent>("SELECT * FROM Student_2022 A LEFT JOIN Parent B ON A.id=B.pid");//3.自定义SQL查询List<StuAndParent> list3 = freesql.Select<Student2022, Parent>()//4.左外连接（框架，列出具体字段）.LeftJoin(w => w.t1.id == w.t2.pid).ToList(w => new StuAndParent{id= w.t1.id,name = w.t1.name,pid = w.t2.pid,pname = w.t2.pname});List<StuAndParent> list3_1 = freesql.Select<Student2022, Parent>()//5.左外连接（框架）.LeftJoin(w => w.t1.id == w.t2.pid).ToList(x=>new StuAndParent());List<StuAndParent> list4 = freesql.Select<Student2022>()  //6.左外连接(导航属性).LeftJoin<Parent>((student, parent) => student.id == parent.pid)//直接设置关联条件.ToList(x=>new StuAndParent());//转化为StuAndParent实体//7.简单分表查询var list6 = freesql.Select<Teacher>().ToList();//8.sql增删改bool b = freesql.Ado.ExecuteNonQuery(@"DELETE FROM Student_2022 WHERE id = 6")>0;//9.框架增删改//freesql.Insert(entity).ExecuteAffrows();//freesql.Update<T>(entity);//freesql.Update<T>()//    .Set(a => a.Title, "新标题")//    .Set(a => a.Time, DateTime.Now)//    .Where(a => a.Id == 1)//过滤条件//    .ExecuteAffrows();//freesql.Delete<T>(entity).ExecuteAffrows();//freesql.Delete<T>()//    .Where(s => s.Id == 1)//    .ExecuteAffrows();//10.保存实体（增加或修改）var entity = new Student2022 { name = "晓晓", id = 6 };bool b2 = freesql.InsertOrUpdate<Student2022>().SetSource(entity) .ExecuteAffrows()>0;}}
}

六、事务

using FreeSql;
using System.Diagnostics;namespace FreesqlDemo
{public class Program{// 修正后的静态字段声明private static IFreeSql freesql = new FreeSqlBuilder().UseMonitorCommand(cmd => Trace.WriteLine($"Sql：{cmd.CommandText}")).UseConnectionString(DataType.SqlServer, @"server = DESKTOP-FTH2P3S; Database = Test; Trusted_Connection = SSPI;").Build();static void Main(string[] args){using (var uow = freesql.CreateUnitOfWork())//需要安装FreeSql.DbContext第三方Nuget包{try{//开启事务uow.GetOrBeginTransaction();var student = new Student2022 { id = 11, name = "皙白" }; // 创建一个新的学生记录uow.Orm.Insert(student).ExecuteAffrows();//插入后，由于事务未提交，【查删改】该表数据会卡顿（等事务提交或回滚后再执行），但是【增】该表没问题//throw new Exception("测试事务回滚");// 提交事务uow.Commit();//可以查到插入的数据}catch (Exception ex){// 出现异常时回滚事务uow.Rollback();//回滚，不进行刚刚的插入操作Console.WriteLine($"操作失败：{ex.Message}");}}}}
}

 【总结】插入操作一般不会阻塞其他事务对现有数据的访问，而读取、删除和更新操作则可能受到未提交事务的影响被阻塞，直至事务完成。

【拓展】事务隔离级别

  • 读未提交（Read Uncommitted）：存在事务未完成时，可增删改查。
  • 读已提交（Read Committed）：存在事务未完成时，可增，读删改需要事务完成后执行。
  • 可重复读（Repeatable Read）：存在事务未完成时，增删改查需要事务完成后执行。
  • 串行化（Serializable）：存在事务未完成时，增删改查需要事务完成后执行，且事务需要排队按序进行。

事务隔离级别查询（SQLsever）：

sql">SELECT session_id,transaction_isolation_level
FROM sys.dm_exec_sessions
WHERE session_id = @@SPID;

数字代表含义：

0: READ UNCOMMITTED
1: READ COMMITTED
2: REPEATABLE READ
3: SERIALIZABLE

七、常见问题

sql%E5%AE%9E%E4%BD%93%E5%AD%97%E6%AE%B5%EF%BC%88%E4%B8%8E%E6%95%B0%E6%8D%AE%E5%BA%93%E7%9B%B8%E6%AF%94%EF%BC%89%E8%BF%87%E5%A4%9A%E5%92%8C%E8%BF%87%E5%B0%91%E5%88%86%E5%88%AB%E4%BC%9A%E6%80%8E%E4%B9%88%E6%A0%B7%EF%BC%9F">1.freesql实体字段（与数据库相比）过多和过少分别会怎么样？

①过多会报错，过少结果自然也少了没映射的字段。

（不是基本数据类型不用担心，比如说Student表：id name，实体：id name Teacher，映射不到Teacher不会报错，假如实体是：id name age，映射不到(int)age 则会报错）
②报错的解决方案：字段头上加特性

[Column(IsIgnore = true)]


http://www.ppmy.cn/devtools/100418.html

相关文章

Java笔试面试题之多线程偏门考点总结

Java笔试面试题之多线程偏门考点总结

以下一些偏门的Java多线程面试题考点&#xff1a; 特定API的深入使用&#xff1a; Semaphore 的具体应用场景和实现原理。文档中提到了Semaphore是什么&#xff0c;但没有深入探讨其在实际开发中的使用案例和细节。CyclicBarrier 和 CountDownLatch 的具体实现原理和使用场景差…
阅读更多...
爆改YOLOv8 |YOLOv8融合SEAM注意力机制

爆改YOLOv8 |YOLOv8融合SEAM注意力机制

1&#xff0c;本文介绍 SEAM&#xff08;Spatially Enhanced Attention Module&#xff09;是一个注意力网络模块&#xff0c;旨在解决面部遮挡导致的响应损失问题。通过使用深度可分离卷积和残差连接的组合&#xff0c;SEAM模块增强未遮挡面部的响应。深度可分离卷积在每个通…
阅读更多...
【C++】初识C++模板与STL

【C++】初识C++模板与STL

C语法相关知识点可以通过点击以下链接进行学习一起加油&#xff01;命名空间缺省参数与函数重载C相关特性类和对象-上篇类和对象-中篇类和对象-下篇日期类C/C内存管理 本章将简单分享C模板与STL相关知识&#xff0c;与之相关更多知识将留到下次更详细地来分享给大家 &#x1f3…
阅读更多...
CSS的简单介绍

CSS的简单介绍

1.什么是CSS CSS(层叠样式表)&#xff0c;用于控制页面的样式&#xff0c;简单地来说&#xff0c;CSS就是用来美化页面的一种语言。 2.基本语法规范 CSS的基本语法规范&#xff1a;CSS选择器{1或多条声明} 其中CSS选择器决定找谁(针对哪个元素进行修改)&#xff0c;声明决定…
阅读更多...
Debian Linux上安装Jumpserver

Debian Linux上安装Jumpserver

1.安装 Debian并配置 登录www.debian.io,下载网络版安装&#xff0c;安装很快&#xff0c;但完成后修改IP就遇到问题vi /etc/network/interfaces auto eth0 #设置开机自动连接网络 iface lo inet loopback allow-hotplug eth0 iface eth0 inet static #static表示使用固定I…
阅读更多...
HTML 全解析：从基础到实战

HTML 全解析：从基础到实战

一、简介 HTML&#xff08;HyperText Markup Language&#xff09;即超文本标记语言&#xff0c;是用于创建网页的标准标记语言。它通过各种标签来定义网页的结构和内容&#xff0c;使得浏览器能够正确地显示网页。HTML 文档由 HTML 元素组成&#xff0c;这些元素通过标签来表…
阅读更多...
选择一家正规的应急指挥中心控制台厂家有多关键

选择一家正规的应急指挥中心控制台厂家有多关键

在当今社会&#xff0c;随着自然灾害、突发事件及安全挑战的日益复杂多变&#xff0c;应急管理体系的构建显得尤为重要。而应急指挥中心作为应对各类紧急情况的神经中枢&#xff0c;其高效运作离不开先进、可靠的控制台设备支持。在此背景下&#xff0c;选择一家正规的应急指挥…
阅读更多...
湖南贝特新能源科技：巧用草料二维码，实现设备管理数字化

湖南贝特新能源科技：巧用草料二维码，实现设备管理数字化

在当今快速发展的制造业环境中&#xff0c;设备管理效率直接影响着企业的生产力与竞争力&#xff0c;我司也面临着设备管理流程中的诸多挑战。 如今购物买菜都是扫码支付的时代&#xff0c;我司也与时俱进&#xff0c; 导入了二维码系统进行公司质量、设备、安全、项目、改善等…
阅读更多...
最新文章

Copyright @ 2022~2023