转载

Farseer.net轻量级开源框架 V1.x 入门篇：新版本说明

目录： Farseer.net轻量级开源框架目录

上一篇：没有了

下一篇： Farseer.net轻量级开源框架 V1.x 入门篇：数据库配置

前言

V1.x版本终于到来了。本次版本的开发从3月份开始，花了一个月的时间完成了概念版本设计、开发。到了4月份进行多次的内核的重构设计。到了5月份进行大规模的BUG修复、代码优化。

截止到今天（6月初），已知的BUG都已修复，并已在2个项目中应用了，并且运行良好。

本篇主题

1、新增队列管理：

新版本改变了V0.x时的使用方式， 以Entityframework为模型 进行参考设计。

在新版中，多了队列的概念，也就是我们在对表进行操作时，并不是单句运行的，经常是一段逻辑里面会对不同的表进行多次的操作，最后在进行SaveChange()提交到数据库。在触发SaveChange()时，通过 队列管理（QueueManger） 迭代所有 队列（Queue） 进行委托执行提交到数据库。

这里面涉及到了 延迟执行 的概念。

2、新增批量提交：

在过去版本中， User .Data. Insert ( new User { UserName = " NewName " }); 则会立即执行，

新版本中采用new Table()方式，则会延迟到SaveChange()时才 转换成Sql，生成Sql参数化，然后提交到数据库 ，这里类似EntityFramework的方式。

当然也提供了与旧版本的操作方式，这里提供不是为了兼容，而是为了有时我们确实并不需要多次操作表，可能就只是简单的一个插入新记录而已。

新版本提供的两种方式

3、新增数据库操作：

1 Table.Data.User.Insert(new UserVO() { UserName = "yy" });

1 using (var context = new Table()) 2 { 3     var info = new UserVO() { UserName = "xx" }; 4     context.User.Insert(info); 5     context.SaveChanges(); 6 }

在旧版本中只提供了第一种方式，而在新版本中，相当于多了第二种方式。

在第二种方式中，只有在context.SaveChanges();之后才会对数据库的操作生效。这是从调用的角度来说的，当然新版本中，内核处理方式完全改变了。

其次是实体类映射完全不同了，更加轻量级了。不再依赖框架提供的基类（旧版本是强制继承的），新版本 取消了实体类的基类 了。

新版实体类的映射

4、改变的实体类：

 1     [Context()]  2     public class Table : TableContext<Table>  3     {  4         [Set(Name = "Members_User")]  5         public TableSet<UserVO> User { get; set; }  6   7         [Set(Name = "Members_Role", IsCache = true)]  8         public TableSet<UserRoleVO> UserRole { get; set; }  9     } 10  11     public class UserVO : IEntity<int?> 12     { 13         /// <summary> 14         /// 用户ID 15         /// </summary> 16         [Field(IsPrimaryKey = true)] 17         public int? ID { get; set; } 18         /// <summary> 19         /// 用户名 20         /// </summary> 21         [Field()] 22         public string UserName { get; set; } 23  24         /// <summary> 25         /// 密码 26         /// </summary> 27         public string PassWord { get; set; } 28     }

看了上面的实体类映射，是不是觉得很像EntityFramework的DbContext、DbSet呢。

UserVO 继承 IEntity<int?> 并不是必须的。继承它后，框架会提供一些额外的扩展支持。（后面文章在详细述说）

在新版本中，主键int ID不是强制性的继承了 ，因此不能像旧版中可以方便的提供： User .Data. ToInfo (1) 。而为了实现这一效果，则必须要继承这个 IEntity 接口。

PO、VO的分离。在旧版本中，如果有多张表的字段结构完全一样，则在映射时必须要为每张表定义一样的实体类。这对项目而言是臃肿的代码。

在新版本中，VO脱离了框架的束缚，由Table来决定我这张表由“谁”来映射它的结构，这会给我们的实现项目中带来非常灵活的编码方式，比如多个数据库表对应同一个VO实体。

实体类的Map方式分离了

5、Map分离了：

在旧版本中，因为实体类只有一个，没有分离。所以对整个class进行了映射并缓存。

而在新版本中，从上文大家也看到了，进行了分离。变成了三种类型：Table、TableSet、实体VO。

因此对应的Map也有： ContextMap （映射 Table 的特性、 TableSet 的特性）、 FieldMap （映射实体VO的字段特性）

它们在命名空间：FS.Mapping.Context中 Farseer.net轻量级开源框架 V1.x 入门篇：新版本说明

在这里，大家有所了解就行。实际项目中用到不大，更多的是FS.Core中内部的调用。它标记了各个实体类的映射关系。

即然Map改变了，那么实体类的特性标记也变了。

DBAttribute 没有了，换成了： ContextAttribute 。
ColumnAttribute 没有了，换成了： SetAttribute 、 FieldAttribute

统一的缓存管理

6、统一了缓存的管理：

在原来的版本中，有些缓存的（比如反射的、枚举中文名称的、ORM的）是存在各自的管理中。

而在新版本中，将统一放到FS.Core. CacheManger 中。并提供了Clear()方法进行清除所有缓存。

Farseer.net轻量级开源框架 V1.x 入门篇：新版本说明

具体代码不在这里贴出来，大家可以从上图中看到缓存管理的地方。

新版本结构的分离

7、结构的分离：

以上讲的是调用方式的改变以及实体类映射的改变。为了更方便于开源推广，框架在结构上也进行了分离：

Farseer.net轻量级开源框架 V1.x 入门篇：新版本说明

Farseer.Net ：ORM映射、数据库操作。
Farseer.Net.Utils ：提供常用的工具类（但不与WinForm、WebForm、MVC有任何的关联）
Farseer.Net.Utils.Form ：提供WinForm的相关工具
Farseer.Net.Utils.Web ：提供WebForm、MVC的相关工具

在实际项目中，大家可能不会用到除ORM以外的工具类（大家有自已常用的工具类）。因此分离出来，让ORM更加专注。

因此本系列教程，只讲解Farseer.Net相关代码，其它工具类请大家自行下截后研究。（其实也没什么可研究性，就只是一些工具类方法）

两个版本的区别是巨大的，作者在新版本中是进行了完全的重写，所以本篇中不能一一描述新旧版本的区别。本篇中仅是给大家带来一个初步的印象，后面的篇幅，我们会一一讲解每个运用。

调用的例子

8、全新的编码方式：

最后，我们在贴一段综合调用的例子给大家：

 1 using (var context = new Table())  2 {  3     var info = context.User.Where(o => o.ID > 0 && o.CreateAt < DateTime.Now).Desc(o => new { o.ID, o.LoginCount }).Asc(o => o.GenderType).ToEntity();  4     info.PassWord = "77777";  5     context.User.Where(o => o.ID == 1).Update(info);  6   7     info.ID = null;  8     info.PassWord = "00000New";  9     context.User.Insert(info); 10  11  12     context.User.Where(o => o.ID == 1).Append(o => o.LoginCount, 1).AddUp(); 13     context.User.AddUp(o => o.LoginCount, 1); 14     context.UserRole.ToList(); 15     context.UserRole.Where(o => o.ID == 1).ToList(); 16     context.UserRole.Where(o => o.ID > 1).ToList(); 17     var lst = context.User.Where(o => o.ID > 0).Desc(o => new { o.ID, o.LoginCount }).Asc(o => o.GenderType).ToList(); 18  19     context.SaveChanges(); 20 }

1 new Table().User.Where(o => o.ID > 0).ToList(); 2 Table.Data.User.AddUp(o => o.LoginCount, 1); 3 Table.Data.User.Where(o => o.ID > 0).ToList(); 4 Table.Data.Set<UserVO>().Where(o => o.ID > 0).ToList();

本篇不会讲太多实质性的代码，主要是讲解下新旧版本的对比，让大家有个直观的印象。

本篇就讲解到这，后面的篇幅将开始真正带领大家认识新框架的魅力了。

导航

目录： Farseer.net轻量级开源框架目录

上一篇：没有了

下一篇： Farseer.net轻量级开源框架 V1.x 入门篇：数据库配置

广告时间

QQ群： 116228666 (Farseer.net开源框架交流) 请注明： Farseer.Net

Farseer.Net是一款ORM框架 + 常用工具 + 扩展集合。

Farseer 寓意：先知、预言家通常在某些场合时，提供计谋、策略。也希望该框架能给大家提供最大化的便捷。

ORM：其英文全称是： Object （对象） Relational （关系） Mapping （映射）

Farseer.Net的目标是：快速上手、快速开发、简单方便。

1 Table.Data.User.Where(o=>o.ID == 1).ToEntity(); 2 Table.Data.User.Where(o=>o.ID > 1).ToList(); 3 Table.Data.User.Where(o=>o.ID != 0).Delete(); 4 Table.Data.User.Where(o=>o.ID != 0).AddUp(o=>o.LoginCount, 1); 5 Table.Data.User.Where(o=>o.ID == 1).Update(new User{ UserName = "newName" }); 6 Table.Data.User.Insert(new User{ UserName = "newName" });