[NewLife.XCode]实体类详解

NewLife.XCode是一个有10多年历史的开源数据中间件,由新生命团队(2002~2019)开发完成并维护至今,以下简称XCode。

整个系列教程会大量结合示例代码和运行日志来进行深入分析,蕴含多年开发经验于其中。

开源地址:https://github.com/NewLifeX/X (求star, 620+)

 

回到目录

生成实体类

上一章《数据模型》讲到模型文件Model.xml和脚本Build.tt,(nuget安装NewLife.XCode后即可拥有)。

把Build.tt和Model.xml(可改名)放在同一个目录,在Build.tt上右键“运行自定义工具”,“显示所有文件”,即可看到生成的实体类文件。

**如果运行Build.tt出错,可能是因为找不到XCode.dll文件,可以先编译一次项目,让XCode.dll生成到项目输出目录即可

我们来试试以下模型(拷贝到Model.xml里面):

640?wx_fmt=gif

<?xml version="1.0" encoding="utf-8"?>
<Tables Version="9.9.6940.24706" NameSpace="NewLife.School.Entity" ConnName="School" BaseClass="Entity" Output="">
<Table Name="Class" TableName="xxx_class" Description="班级" DbType="SqlServer">
<Columns>
<Column Name="ID" DataType="Int32" Identity="True" PrimaryKey="True" Description="编号" />
<Column Name="Name" ColumnName="xxx_Nameyyy" DataType="String" Master="True" Description="名称" />
<Column Name="CreateUser" DataType="String" Description="创建者" />
<Column Name="CreateUserID" DataType="Int32" Description="创建者" />
<Column Name="CreateTime" DataType="DateTime" Description="创建时间" />
<Column Name="CreateIP" DataType="String" Description="创建地址" />
<Column Name="UpdateUser" DataType="String" Description="更新者" />
<Column Name="UpdateUserID" DataType="Int32" Description="更新者" />
<Column Name="UpdateTime" DataType="DateTime" Description="更新时间" />
<Column Name="UpdateIP" DataType="String" Description="更新地址" />
<Column Name="Remark" DataType="String" Length="200" Description="备注" />
</Columns>
</Table>
<Table Name="Student" Description="学生" DbType="SqlServer">
<Columns>
<Column Name="ID" DataType="Int32" Identity="True" PrimaryKey="True" Description="编号" />
<Column Name="ClassID" DataType="Int32" Description="班级" />
<Column Name="Name" DataType="String" Master="True" Description="名称" />
<Column Name="Sex" DataType="Int32" Description="性别" Type="XCode.Membership.SexKinds" />
<Column Name="Age" DataType="Int32" Description="年龄" />
<Column Name="Mobile" DataType="String" Description="手机" />
<Column Name="Address" DataType="String" Description="地址" />
<Column Name="CreateUserID" DataType="Int32" Description="创建者" />
<Column Name="CreateTime" DataType="DateTime" Description="创建时间" />
<Column Name="CreateIP" DataType="String" Description="创建地址" />
<Column Name="UpdateUserID" DataType="Int32" Description="更新者" />
<Column Name="UpdateTime" DataType="DateTime" Description="更新时间" />
<Column Name="UpdateIP" DataType="String" Description="更新地址" />
<Column Name="Remark" DataType="String" Length="200" Description="备注" />
</Columns>
<Indexes>
<Index Columns="ClassID" />
</Indexes>
</Table>
</Tables>

640?wx_fmt=gif

运行build.tt后

640?wx_fmt=png

每个模型表,生成了四个实体类文件,选中它们并包含到项目中。

其中Biz常称之为业务类,多次build.tt生成不覆盖;

另一个称之为数据类,每次build.tt生成均覆盖;

这里采用了C#的分部类(partial)技术,一个类由两个或多个类文件组成。

数据类包含表名(类名)字段名(属性)等信息,修改模型文件后,每次生成都会覆盖文件。

业务类包含其它非表结构信息,供开发者填写代码,所以只有首次生成,而再次生成时不会覆盖。

640?wx_fmt=png

数据类包括一个接口(如IStudent),以满足精简需要的场合。

数据类内部还有两个内嵌类_和__,可用于快速访问字段信息以及属性名。

 

回到目录

实体静态构造函数

XCode是充血模型,因此实体类除了各个代表着表结构信息的属性外,还会有大量用户代码在其中,并且继承泛型实体基类(如Entity<User>)。

一个常见的实体类构造函数如下:

640?wx_fmt=gif

static User()
{
// 累加字段
var df = Meta.Factory.AdditionalFields;
df.Add(__.Logins);

// 过滤器 UserModule、TimeModule、IPModule
Meta.Modules.Add<UserModule>();
Meta.Modules.Add
<TimeModule>();
Meta.Modules.Add
<IPModule>();

// 单对象缓存
var sc = Meta.SingleCache;
sc.FindSlaveKeyMethod
= k => Find(__.Name, k);
sc.GetSlaveKeyMethod
= e => e.Name;
}

640?wx_fmt=gif

这里首先介绍一个最重要的实体类内嵌类Meta,它位于Entity<TEntity>.Meta,记录着实体类的一切元数据,承载着实体类的一切高级功能!

 

Meta.Factory.AdditionalFields用于存放累加字段

一般更新语句 update user set Logins=123 where id=1,而把Logins字段设为累加字段后,将得到 update user set Logins=Logins+33 where id=1 ,特别适用于并发更新同一行记录的场合。

 

实体过滤器EntityModule,用于拦截实体类的添删改操作,内置最常用的3个过滤器UserModule/TimeModule/IPModule

上一章末尾推荐的8个常用字段还记得吗? CreateUser/CreateTime/CreateIP 等,所有CreateAbc将在Insert的时候拦截赋值,所有UpdateAbc将在Insert和Update的时候拦截赋值。

UserModule取当前登录用户,由ManageProvider驱动;

TimeModule取当前时间;

IPModule取当前访问IP,由ManageProvider.UserHost提供;

 

缓存配置

单对象缓存是一个字典缓存,默认以主键为key,实体对象为value。

单对象缓存支持第二个字典,如上,配置Name为第二字典的主键,实体对象为value。

 

实体基类

当然,实体类静态构造函数还可以用于其它用途,它将会在使用该实体类任意方法(包括成员方法和静态方法)之前执行。

有时候把一个系统模块放到一个独立子目录里面,独享一个“Abc.xml”模型文件,生成的实体类在目录里面,这个时候可以让它们继承一个相同的实体基类(如EntityBase)。

然后在实体基类EntityBase的静态构造函数中写入这个模块所共有的代码。

 

回到目录

初始化数据

有些数据表需要默认初始化一些数据,如类别表、配置表等,便于开发测试。

这个时候可以重载InitData方法,它会在实体类第一次访问数据库之前执行。

640?wx_fmt=png

这里遇到Meta的第二次用法Meta.Count,该属性表示当前实体类数据表的总行数。

当总行数在100万以内时,数字精确等于 select count(*) from table,大于100万时,将采用特有的快速方法。

Meta.Count带缓存,拥有极好的性能,可用于粗略(数值较小时精确)估算该表总行数。

 

这里通过Meta.Count来判断该表是否为空表,然后对空表插入一些默认数据。

 

回到目录

数据验证Valid

每个实体类在Insert/Update之前,都需要Valid验证数据 ,参数isNew以区分Insert。

640?wx_fmt=png

Valid常常可用于判断主要字段的有效性,无效时强烈推荐抛出参数类异常,魔方NewLife.Cube表单将可以捕获并定位。

除此之外,Valid用得更多的功能是在Insert/Update之前修改完善字段数据,例如上面对密码进行MD5散列,以及格式化RoleIDs。

这里出现新技术,IsDirty和Dirtys,这是XCode的脏数据,前者判断Password字段是否有脏数据(Password被赋予跟原来不想等的值),后者清空Password脏数据。

脏数据是生成Update语句的核心,不脏的字段不会出现在update set 之中,实现部分字段更新,后续有专门章节讲解。

 

回到目录

重载添删改

实体类的添删改操作都可以重载(Insert/Update/Delete/OnInsert/OnUpdate/OnDelete)

640?wx_fmt=png

640?wx_fmt=png

重载后可以做业务代码判断,也可以级联更新其它表,还可以记录添删改操作日志,甚至还可以做假删除(重载OnDelete然后实际执行OnUpdate)

分为两组重载,实际执行顺序是:Insert=>Valid=>EntityModule=>OnInsert

 

回到目录

扩展属性

XCode不支持多表关联Join,取而代之的是扩展属性!

扩展属性的意义,用到该属性时,再去查询相应数据,一般目标表带有缓存,并且扩展属性Extends也有缓存

640?wx_fmt=png

一般扩展属性复杂对象加上XmlIgnore和ScriptIgnore特性,规避Xml序列化和Json序列化。

常常还会加上 AbcName  这样的字符串型属性,头上的Map特性将在魔方NewLife.Cube展现数据时发挥极大作用。

__.ClassID表示映射到该字段,在所有显示ClassID的地方用当前属性ClassName替代;

后面的类名和字段名,表示要关联的目标表和字段,在魔方Cube表单中将直接生成下拉选择;

 

回到目录

扩展查询

实际业务中经常会用到根据某一两个字段查询的需求,例如根据主键查询。

640?wx_fmt=png

640?wx_fmt=png

一般我们把查询返回单个对象的方法命名为 FindByAbc,而把返回多个实体的方法命名为 FindAllByAbc。

上面的代码展示了3种查询方法:

通过Meta.Count判断,当总行数小于1000时,全部走Meta.Cache实体缓存表达式搜索,其原理是整表一次性载入内存,后续有专门文章介绍;

FindByID和FindByName,当总数大于1000时,走对象缓存Meta.SingleCache,按主键ID/Name为键,缓存实体对象;

不常用的FindByMail和FindAllByClassID中,用到了真正的数据库查询 Find(__.Mail, mail) 和 FindAll(_.ClassID == classid);

默认生成的代码,都带有实体缓存和对象缓存的例子,默认情况下,FindByID只需要查一次数据并载入内存,即可实现“极速查询”,后续每10秒异步更新。

显然,如果完全不需要用到缓存,直接写数据库代码就好了。

 

回到目录

高级查询

 在业务实现中经常出现超过两个甚至更多查询条件,这个时候我们推荐Search或SearchAbc

640?wx_fmt=png

XCode的查询有一套条件表达式,以WhereExpression为代表,可以动态拼接任意复杂的where查询语句。

FindAll常用两个参数,第一个条件,第二个PageParameter实现分页查询。

 

至此,简单罗列了实体类的主要构成,具体各个构成部分都将会在后面有专题文章介绍。

 

回到目录

系列教程

NewLife.XCode教程系列[2019版]

  1. 增删改查入门。快速展现用法,代码配置连接字符串

  2. 数据模型文件。建立表格字段和索引,名字以及数据类型规范,推荐字段(时间,用户,IP)

  3. 实体类详解。数据类业务类,泛型基类,接口

  4. 功能设置。连接字符串,调试开关,SQL日志,慢日志,参数化,执行超时。代码与配置文件设置,连接字符串局部设置

  5. 反向工程。自动建立数据库数据表

  6. 数据初始化。InitData写入初始化数据

  7. 高级增删改。重载拦截,自增字段,Valid验证,实体模型(时间,用户,IP)

  8. 脏数据。如何产生,怎么利用

  9. 增量累加。高并发统计

  10. 事务处理。单表和多表,不同连接,多种写法

  11. 扩展属性。多表关联,Map映射

  12. 高级查询。复杂条件,分页,自定义扩展FieldItem,查总记录数,查汇总统计

  13. 数据层缓存。Sql缓存,更新机制

  14. 实体缓存。全表整理缓存,更新机制

  15. 对象缓存。字典缓存,适用用户等数据较多场景。

  16. 百亿级性能。字段精炼,索引完备,合理查询,充分利用缓存

  17. 实体工厂。元数据,通用处理程序

  18. 角色权限。Membership

  19. 导入导出。Xml,Json,二进制,网络或文件

  20. 分表分库。常见拆分逻辑

  21. 高级统计。聚合统计,分组统计

  22. 批量写入。批量插入,批量Upsert,异步保存

  23. 实体队列。写入级缓存,提升性能。

  24. 备份同步。备份数据,恢复数据,同步数据

  25. 数据服务。提供RPC接口服务,远程执行查询,例如SQLite网络版

  26. 大数据分析。ETL抽取,调度计算处理,结果持久化


本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/316662.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

Counting Triangles

Counting Triangles 题意&#xff1a; 给你一个完全图&#xff0c;每个边被赋值为0或1&#xff0c;问这个完全图中有多少个完美三角形&#xff1f; 完美三角形定义&#xff1a;三角形的三边都为0或1 题解&#xff1a; 正着求不好求&#xff0c;我们可以倒着想 不考虑完美&a…

程序员过关斩将--论商品促销代码的优雅性

点击上方蓝色字体&#xff0c;关注我们菜菜哥&#xff0c;YY说你帮她解决了几个问题&#xff0c;也帮我解决一个呗原来是D妹子&#xff0c;来坐我身边&#xff0c;说下情况我的项目是个电商项目&#xff0c;现在产品狗要给商品做活动正常呀我一个新手初来咋到顶不住压力了&…

Math(牛客多校第三场)

Math 题意&#xff1a; 问你有多少对(x,y),1<x<y<n,满足(x2 y2)%(xy1) 0 题解&#xff1a; 这种题。。。直接打表芜湖~ 通过打表发现&#xff1a;满足情况的为(i,i * i * i),但是也有不和谐的声音出现&#xff1a;当x8时&#xff0c;会出现两个&#xff0c;一个…

[NewLife.XCode]增删改查入门

NewLife.XCode是一个有10多年历史的开源数据中间件&#xff0c;由新生命团队(2002~2019)开发完成并维护至今&#xff0c;以下简称XCode。整个系列教程会大量结合示例代码和运行日志来进行深入分析&#xff0c;蕴含多年开发经验于其中。开源地址&#xff1a;https://github.com/…

在实际项目中使用LiteDB NoSQL数据库

LiteDB 是一个 NoSQL 数据库&#xff0c;特点是 MongoDB like 和 0 配置。100% 原汁原味的 C# 开发, Release 只有一个 DLL&#xff0c;官方有一下适用场景&#xff1a;移动App&#xff0c;桌面小应用程序&#xff0c;特有的文件格式&#xff0c;小型的 Web 应用&#xff0c;需…

初探奥尔良(Orleans)

由于工作上关系目前经常被各种并发数据问题搞得焦头烂额&#xff0c;要么要性能舍弃数据上得一致性&#xff0c;要么要一致性但是却得到了特别糟糕的响应。难道鱼和熊掌真的无法兼得吗&#xff1f;然后找到了类似奥尔良这种基于Actor模型的kuangjia首先本人因为是C#系的所以暂不…

[NewLife.XCode]功能设置

NewLife.XCode是一个有10多年历史的开源数据中间件&#xff0c;由新生命团队(2002~2019)开发完成并维护至今&#xff0c;以下简称XCode。整个系列教程会大量结合示例代码和运行日志来进行深入分析&#xff0c;蕴含多年开发经验于其中&#xff0c;代表作有百亿级大数据实时计算项…

[NewLife.XCode]数据模型文件

NewLife.XCode是一个有10多年历史的开源数据中间件&#xff0c;由新生命团队(2002~2019)开发完成并维护至今&#xff0c;以下简称XCode。整个系列教程会大量结合示例代码和运行日志来进行深入分析&#xff0c;蕴含多年开发经验于其中。开源地址&#xff1a;https://github.com/…

[NewLife.XCode]高级增删改

NewLife.XCode是一个有10多年历史的开源数据中间件&#xff0c;支持nfx/netstandard&#xff0c;由新生命团队(2002~2019)开发完成并维护至今&#xff0c;以下简称XCode。整个系列教程会大量结合示例代码和运行日志来进行深入分析&#xff0c;蕴含多年开发经验于其中&#xff0…

[NewLife.XCode]数据初始化

NewLife.XCode是一个有10多年历史的开源数据中间件&#xff0c;支持nfx/netstandard&#xff0c;由新生命团队(2002~2019)开发完成并维护至今&#xff0c;以下简称XCode。整个系列教程会大量结合示例代码和运行日志来进行深入分析&#xff0c;蕴含多年开发经验于其中&#xff0…

[NewLife.XCode]反向工程(自动建表建库大杀器)

NewLife.XCode是一个有10多年历史的开源数据中间件&#xff0c;支持nfx/netstandard&#xff0c;由新生命团队(2002~2019)开发完成并维护至今&#xff0c;以下简称XCode。整个系列教程会大量结合示例代码和运行日志来进行深入分析&#xff0c;蕴含多年开发经验于其中&#xff0…

树上启发式合并

文章内容选自OI Wiki 参考博客 内容&#xff1a; 树上启发式合并&#xff08;dsu on tree&#xff09;对于某些树上离线问题可以速度大于等于大部分算法且更易于理解和实现的算法。 他是用来解决一类树上询问问题&#xff0c;一般这种问题有两个特征&#xff1a; 只有对子树…

Wexflow:C#中的开源工作流引擎

Wexflow是一个高性能、可扩展、模块化和跨平台的工作流引擎。Wexflow在GitHub&#xff1a;https://github.com/aelassas/Wexflow。Wexflow的目标是在没有用户干预的情况下自动执行重复任务。在Wexflow的帮助下&#xff0c;构建自动化和工作流过程变得简单。Wexflow还有助于使长…

ASP.NET Core 沉思录 - Logging 的两种介入方法

ASP.NET Core 中依赖注入是一个很重要的环节。因为几乎所有的对象都是由它创建的&#xff08;相关文章请参见《ASP.NET Core 沉思录 - ServiceProvider 的二度出生》&#xff09;。因此整个日志记录的相关类型也被直接添加到了 IServiceCollection 中。今天我们将介绍各个接口/…

C# 中的Async 和 Await 的用法详解

众所周知C#提供Async和Await关键字来实现异步编程。在本文中&#xff0c;我们将共同探讨并介绍什么是Async 和 Await&#xff0c;以及如何在C#中使用Async 和 Await。同样本文的内容也大多是翻译的&#xff0c;只不过加上了自己的理解进行了相关知识点的补充&#xff0c;如果你…

Docker的部署-包括网关服务(Ocelot)+认证服务(IdentityServer4)+应用服务

本文主要介绍通过Docker来部署通过.Net Core开发的微服务架构&#xff0c;部署的微服务主要包括统一网关&#xff08;使用Ocelot开发&#xff09;、统一认证&#xff08;IdentityServer4&#xff09;、应用服务&#xff08;asp.net core web api&#xff09;&#xff1b;本文不…

ASP.NET Core 实战:使用 Docker 容器化部署 ASP.NET Core + MySQL + Nginx

一、前言在之前的文章&#xff08;ASP.NET Core 实战&#xff1a;Linux 小白的 .NET Core 部署之路&#xff09;中&#xff0c;我介绍了如何在 Linux 环境中安装 .NET Core SDK / .NET Core Runtime、Nginx、MySQL&#xff0c;以及如何将我们的 ASP.NET Core MVC 程序部署到 Li…

VS2017 无法连接到Web服务器“IIS Express”终极解决方案

今天日了gou了&#xff0c;一大早打开VS2017的时候出现无法连接到Web服务器“IIS Express”的错误&#xff0c;然后必应了一下&#xff0c;再谷歌了一下找到的解决方法也都千篇一律&#xff0c;奈何都没能解决&#xff0c;最后通过静下心来的思考&#xff0c;尝试解决了问题&am…

Docker最全教程之使用.NET Core推送钉钉消息(二十)

前言上一篇我们通过实战分享了使用Go推送钉钉消息&#xff0c;由于技痒&#xff0c;笔者现在也编写了一个.NET Core的Demo&#xff0c;作为简单的对照和说明。最后&#xff0c;由于精力有限&#xff0c;笔者希望有兴趣的朋友可以分享下使用CoreRT将.NET Core编译成机器代码这块…

Average

Average 题意&#xff1a; 矩阵W的值可以通过数组a和b得到&#xff0c;W[i][j]a[i]b[j],现在求W的一个子矩阵&#xff0c;平均值最大&#xff0c;且子矩阵必须满足宽度至少是x&#xff0c;高度至少是y&#xff0c;计算最大平均值 题解&#xff1a; 那答案就变成了分别对a和b…