导航
上一篇：Farseer.net轻量级ORM开源框架 V1.x 入门篇：数据库上下文
下一篇：Farseer.net轻量级ORM开源框架 V1.x 入门篇：表的数据操作
前言
上文讲述了数据库上下文，接下来就是数据库中的表与实体类的关联了（映射）。
先看下我DEMO中的上下文与表实体的关联：
namespace Demo.PO
{
public class Table : DbContext<Table>
{
[Set(Name = "Members_User")]
public TableSet<UserVO> User { get; set; } [Set(Name = "Members_Role")]
public TableSet<UserRoleVO> UserRole { get; set; }
}
}
TableSet表操作类：针对数据库表提供的一系列CURD的操作。被TableSet包含的就是表字段了。
VO实体类
1、表实体类：
public class UserVO : IEntity<int?>
{
/// <summary> 用户ID </summary>
[Field(IsPrimaryKey = true)]
public int? ID { get; set; }
/// <summary> 用户名 </summary>
[Field()]
public string UserName { get; set; }
/// <summary> 密码 </summary>
public string PassWord { get; set; }
/// <summary> 会员类型 </summary>
public eumGenderType? GenderType { get; set; }
/// <summary> 登陆次数 </summary>
public int? LoginCount { get; set; }
/// <summary> 登陆IP </summary>
public string LoginIP { get; set; }
/// <summary> 登陆IP </summary>
[Field(Name = "getdate()")]
public DateTime? GetDate { get; set; }
/// <summary> 创建时间 </summary>
public DateTime? CreateAt { get; set; }
}
可以看到，我们具体的实体，其实是一个POCO的实体。
没错，在V1.x中，框架的一个改变也是为了减轻实体的”负担“，也让框架更加轻量级，而不是侵入式的。
这里重点说下：[Field(Name = "getdate()")]
在后面我们会讲到Field.Name 是显示的告诉框架这个类属性绑定数据库中对应的表字段名称。
熟悉MSSQL朋友知道，getdate()并不是字段名称，则是MSSQL提供的函数。框架对此也是支持的。
举个例子，表有两个字段，A、B 都是int类型，
我们用SQL对A、B的值相加后进行排序是很容易实现的。
而通过框架，我们可以定义一个类属性，然后Field.Name = "A+B" ，这样我们在排序时，就按照普通的字段进行Desc(o=>o.变量)就可以了。
另外这里继承了IEntity，如前面文章说到的，是为了支持提供的扩展。我们看看IEntity的接口代码吧：
namespace FS.Core.Infrastructure
{
/// <summary> 通过实体类的继承后，后续Set、扩展方法提供针对主键的Where条件 </summary>
/// <typeparam name="T"></typeparam>
public interface IEntity<T>
{
/// <summary> 主键ID </summary>
T ID { get; set; }
} /// <summary> 通过实体类的继承后，后续Set、扩展方法提供针对主键的Where条件（默认为int?） </summary>
public interface IEntity : IEntity<int?> { }
}
接口只有一个属性：ID，大部份，我们的表都有一个主键。这个主键是自动标识的。
继承它后，框架提供了一Where条件自动转换的支持：
/// <summary>
/// 获取下一条记录
/// </summary>
/// <param name="ID">当前ID</param>
/// <param name="ts">TableSet</param>
/// <typeparam name="TEntity">实体类</typeparam>
public static TEntity ToNextEntity<TEntity>(this TableSet<TEntity> ts, int? ID) where TEntity : class, Core.Infrastructure.IEntity, new()
{
return ts.Where(o => o.ID > ID).Asc(o => o.ID).ToEntity();
} /// <summary>
/// 获取上一条记录
/// </summary>
/// <param name="ID">当前ID</param>
/// <param name="ts">TableSet</param>
/// <typeparam name="TEntity">实体类</typeparam>
public static TEntity ToPreviousEntity<TEntity>(this TableSet<TEntity> ts, int? ID) where TEntity : class, Core.Infrastructure.IEntity, new()
{
return ts.Where(o => o.ID < ID).Desc(o => o.ID).ToEntity();
}
/// <summary>
/// 获取下一条记录
/// </summary>
/// <param name="ID">当前ID</param>
/// <param name="ts">TableSet</param>
/// <typeparam name="TEntity">实体类</typeparam>
public static TEntity ToNextEntity<TEntity>(this ViewSet<TEntity> ts, int? ID) where TEntity : class, Core.Infrastructure.IEntity, new()
{
return ts.Where(o => o.ID > ID).Asc(o => o.ID).ToEntity();
} /// <summary>
/// 获取上一条记录
/// </summary>
/// <param name="ID">当前ID</param>
/// <param name="ts">TableSet</param>
/// <typeparam name="TEntity">实体类</typeparam>
public static TEntity ToPreviousEntity<TEntity>(this ViewSet<TEntity> ts, int? ID) where TEntity : class, Core.Infrastructure.IEntity, new()
{
return ts.Where(o => o.ID < ID).Desc(o => o.ID).ToEntity();
}
当然这里没办法贴出所有的扩展方法来，但让大家知道它的目的就是让我们经常操作的：o.ID == x 、o=> IDs.Contains(o.ID) 这些操作变的更加方便，不需要手动敲代码完成。
以上代码在Demo中。大家可以直接在源代码里面去查找
FieldAttribute特性介绍
2、我们先来介绍第一个特性：字段的映射
[FieldAttribute]特性目的是告诉框架，当前的这个类属性与数据库的表字段是如何关联在一起的。比如显式的指定表字段的名称。
我们先来看下面的表格：
| 序号 | 变量 | 注释 | 类型 | 适用范围 | 说明 |
| 1 | Name | 数据库字段名称 | string | 全部 |
指定表字段、视图字段名称、存储过程参数的名称、数据库函数 未显示指定时，默认使用当前的类属性名称作为缺省名称 |
| 2 | IsPrimaryKey | 是否为数据库主键 | bool | TableSet |
默认：false 设为：true 并且该变量赋了值是：Insert操作，在MSSQL里，会启用SET IDENTITY_INSERT设置，在Update时，会转换成条件，并去掉赋值。 比如：Table.Data.User.Update(new User{ ID=1,Name="xxx")); 会被转换成：Table.Data.User.Where(o=>o.ID == 1).Update(new User{ Name="xxx")); |
| 3 | InsertStatusType | 插入时字段状态 |
StatusType 枚举类型 |
TableSet |
默认：CanWrite 设为：ReadOnly时，在对应的插入或者更新时，该赋值会被过滤掉（忽略） 设为：ReadCondition时，在对应的插入或者更新时，该赋值会被转换成 == 条件。同时过滤掉赋值（忽略） 这个特性运用的好，对我们编写代码时，可以省去很多Where(o=>o.ID == 1)这种写法，以及安全保护。（禁止被更新，即时赋了值） |
| 4 | UpdateStatusType | 修改时字段状态 | TableSet | ||
| 5 | IsMap | 是否映射到数据库字段中 | bool | 全部 |
默认：true 设为：false 将不映射数据库 |
这是在我们类属性（字段中）申明的。
SetAttribute特性介绍
3、第2个常用特性：指定表名、视图名、存储过程名称
目前只有一个Name属性。
| 序号 | 变量 | 注释 | 类型 | 适用范围 | 说明 |
| 1 | Name | 表名称、视图名称、存储过程名称 | string | 全部 |
指定表、视图、存储过程的名称 未显示指定时，默认使用当前的类名称作为缺省名称 |
它是在上下文中的Set属性上申明的特性。可以参考上面出现的：Table类。
总结
相信通过上文的说明，大家知道如何进行数据库的映射了。
今天这篇与昨天的，都是环境搭建过程而已。
到了下一篇，就开始讲解实质性的数据库操作了。希望给大家带来惊喜！
导航
目 录：Farseer.net轻量级ORM开源框架 目录
上一篇：Farseer.net轻量级ORM开源框架 V1.x 入门篇：数据库上下文
下一篇：Farseer.net轻量级ORM开源框架 V1.x 入门篇：表的数据操作
广告时间
QQ群：116228666 (Farseer.net开源框架交流) 请注明：Farseer.Net
Farseer.Net是一款ORM框架 + 常用工具 + 扩展集合。
Farseer 寓意：先知、预言家 通常在某些场合时，提供计谋、策略。也希望该框架能给大家提供最大化的便捷。
ORM：其英文全称是：Object（对象） Relational（关系） Mapping（映射）
Farseer.Net的目标是：快速上手、快速开发、简单方便。
Table.Data.User.Where(o=>o.ID == ).ToEntity();
Table.Data.User.Where(o=>o.ID > ).ToList();
Table.Data.User.Where(o=>o.ID != ).Delete();
Table.Data.User.Where(o=>o.ID != ).AddUp(o=>o.LoginCount, );
Table.Data.User.Where(o=>o.ID == ).Update(new User{ UserName = "newName" });
Table.Data.User.Insert(new User{ UserName = "newName" });
