从 EF Core / SqlSugar 转到 XCode 一些使用记录

之前做 .NET 项目主要用 EF Core 和 SqlSugar,最近项目里开始用 XCode 数据中间件。用了一段时间,把一些和之前习惯不太一样的地方、以及踩过的坑记录一下,供参考。

一、建模方式:从实体类到模型文件
EF Core和SqlSugar的习惯是先写C#实体类加特性标注,或者是先建好表再用生成类文件。现在用的XCode 采用的是模型驱动:先写 Model.xml 定义表结构,再通过代码生成器生成实体类。

生成后会得到两个文件:

  • 一个是数据类,每次生成会覆盖,只放字段和基础查询;

  • 另一个是业务类(.Biz.cs),首次生成后不再覆盖,可以写自己的业务逻辑。

新增字段只需要改 XML 重新生成,实体类和数据库结构不会出现对不上的情况。

二、查询写法:Find / FindAll 和 Field 表达式

EF Core 的 LINQ 和 SqlSugar 的链式调用都比较熟悉,XCode 的风格不太一样。它提供了 Find / FindAll 静态方法,配合一个 _ 内嵌类来构造条件:
var user = User.Find(_.Name, “张三”);

var list = User.FindAll(_.Age > 18, _.CreateTime.Desc(), 0, 20);
_ 是每个实体类都有的内嵌类,包含了每个字段的 Field 引用,通过运算符重载来构造查询条件。_.Name == name 最终会翻译成 WHERE Name='...'
更灵活的是 WhereExpression,支持 & 和 |,也能加括号,可以根据不同条件动态拼接:
var exp = new WhereExpression();
if (classId > 0) exp &= _.ClassID == classId;
if (!string.IsNullOrEmpty(key)) exp &= _.Name.Contains(key);
var students = Student.FindAll(exp, null, null, 0, 20);

三、多表查询:不支持 JOIN
XCode 不支持传统的多表关联 JOIN 查询,推荐的替代方案是扩展属性:给实体类添加 [NotMapped] 标记的属性,在 getter 里调用其他表的查询方法,配合缓存使用。
public partial class Student
{
[NotMapped]
public Class ClassInfo => Class.FindByID(ClassID);
}
四、需要注意的点

  1. XCode 不支持可空类型,所以不要让 null 和 "" 有不同的业务含义,各种类型的默认值就代表无效数据。另外尽量不要设置字段的长度、精度等属性,否则跨数据库迁移时容易出问题。
  2. 不支持外键,表间关系是通过字段名猜测的