一个简单的EF查询框架除了运行项目外,大概需要5个类库项目,当然这个不是一定要这样做,这可以根据自己的需要设置有多少个项目。这里介绍的方法步骤只适合EF零基础的人看看就是了。
在开始之前,先建立一个运行项目,不管是MVC还是winfrom项目,只要能运行就OK,这是为了在后面能测试EF框架的地方。
一、模型项目。这个项目主要负责与数据库映射的,里面的类都是数据库表的实体。
首先在解决方案中建一个文件夹EFModel,这里将会收纳所有的与EF查询有关的项目,这样做只是为了将他们与运行项目分开而已,没有什么特别的意思。
在EFModel中建立一个类库,命名为DBModel,然后在这个类库中创建一个EF
添加之后,选择从数据库生成
在这里,服务器名可以输入数据库所在的服务器的ip,然后测试一下链接,看是否成功。在下面的链接到数据库中选择你要链接的数据库
下一步后,如果没有什么特别设置,就直接完成就可以了。然后看看生成的App.config文件,在connectionStrings节点下就是数据库的链接字符串了
由于没有选择任何的表,因此在数据库模型中就是空的,这时需要添加新的模型来映射数据库中的表,打开model.edmx,然后右键:
下面这一步最好选择是,否则在后面运行程序的时候可能会出现:基础提供程序在 Open 上失败。的错误
找到要添加的表,然后点完成
最后保存model,就能看到在model.tt下添加了一个实体类。至此,模型项目就完成了,如果以后需要添加新的实体类,也从数据库更新模型就是了。
这种模式下,必须是先在数据库中把表建好,然后才能添加实体类,如果需要对已经添加了实体类的表做结构上的修改,那么在数据库中完成修改后,需要在model.edmx中先删除原来的实体,然后重新添加一次才行。
二、增删改查公用方法的接口项目IDAO
建立一个类库项目EF.IDAO,添加两个引用
然后添加接口IBaseDao,
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
namespace EF.IDAO
{
public interface IBaseDao<T>
where T:class,
new ()//约束T类型必须可以实例化
{
//根据条件获取实体对象集合
IQueryable<T> LoadEntites(Func<T,bool> whereLambda );
//根据条件获取实体对象集合分页
IQueryable<T> LoadEntites(Func<T,bool> whereLambda, int pageIndex, int pageSize,out int totalCount);
//增加
T AddEntity(T entity);
//更新
T UpdateEntity(T entity);
//删除
bool DelEntity(T entity);
//根据条件删除
bool DelEntityByWhere(Func<T, bool> whereLambda);
}
}
此时基接口中的CRUD方法就定义完成。接下来我们需要使用T4模版生成所有的实体类接口并实现IBaseDao接口。
添加名为IDaoExt的T4模板
加入如下代码:
<#@ template debug="false" hostspecific="true" language="C#" #>
<#@ assembly name="System.Core" #>
<#@ import namespace="System.Linq" #>
<#@ import namespace="System.Text" #>
<#@ import namespace="System.Collections.Generic" #>
<#@ include file="EF.Utility.CS.ttinclude"#>
<#@ output extension=".cs" #>
<#
CodeGenerationTools code = new CodeGenerationTools(this);
MetadataLoader loader = new MetadataLoader(this);
CodeRegion region = new CodeRegion(this, 1);
MetadataTools ef = new MetadataTools(this);
string inputFile = @"..\DBModel\Model.edmx";//指定edmx实体模型所在的路径
EdmItemCollection ItemCollection = loader.CreateEdmItemCollection(inputFile);
string namespaceName = code.VsNamespaceSuggestion();
EntityFrameworkTemplateFileManager fileManager = EntityFrameworkTemplateFileManager.Create(this);
#>
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using DBModel;//引用Domain的命名空间
namespace EF.IDAO //实体类接口所在的命名空间
{
<#
foreach (EntityType entity in ItemCollection.GetItems<EntityType>().OrderBy(e => e.Name)) //遍历edmx模型中映射的实体对象
{#>
public interface I<#=entity.Name#>Dao:IBaseDao<<#=entity.Name#>> //生成实体对象接口,这里生成的接口的名称是根据模型中的实体类名来设置的,而实体的类名是在建数据库表名的时候设置的名称
{
}
<#};#>
}
其中,有注释的地方是需要根据自己的情况修改的地方(后面项目中的文本模板文件也是如此)。保存文件,然后就可以在IDaoExt.tt下生成了一个文件IDaoExt.cs,这个文件中有一个接口,这个接口就是上面添加的实体所对应的接口。它是根据模板IDaoExt.tt来生成的,因此每当添加了新的实体后,都需要重新保存一次这些tt文件。当然,也可以不用这个模板文件来生成对应的接口,那样的话就需要手动的添加了,这根据自己的爱好决定用哪种方式。
在项目中建一个局部接口IDBSession,注意,是局部接口,要用到关键字partial。
namespace EF.IDAO
{
public partial interface IDBSession
{
int SaveChange();//用于在业务逻辑层对提交进行管理
}
}
这个接口主要是提供实体类接口的访问属性,以实现对数据访问层的封装。建一个文本模板IDBSession.tt
<#@ template debug="false" hostspecific="true" language="C#" #>
<#@ assembly name="System.Core" #>
<#@ import namespace="System.Linq" #>
<#@ import namespace="System.Text" #>
<#@ import namespace="System.Collections.Generic" #>
<#@ include file="EF.Utility.CS.ttinclude"#>
<#@ output extension=".cs" #>
<#
CodeGenerationTools code = new CodeGenerationTools(this);
MetadataLoader loader = new MetadataLoader(this);
CodeRegion region = new CodeRegion(this, 1);
MetadataTools ef = new MetadataTools(this);
string inputFile = @"..\DBModel\Model.edmx";
EdmItemCollection ItemCollection = loader.CreateEdmItemCollection(inputFile);
string namespaceName = code.VsNamespaceSuggestion();
EntityFrameworkTemplateFileManager fileManager = EntityFrameworkTemplateFileManager.Create(this);
#>
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using DBModel;
using EF.IDAO;
namespace EF.IDAO
{
public partial interface IDBSession
{
<#foreach (EntityType entity in ItemCollection.GetItems<EntityType>().OrderBy(e => e.Name))
{#>
I<#=entity.Name#>Dao <#=entity.Name#>Dao { get; set; }
<#};#>
}
}
保存之后,就自动生成了IDBSession的局部接口了
再添加一个接口IDBSessionFactory,为业务逻辑层提供统一访问入口:
namespace EF.IDAO
{
public interface IDBSessionFactory
{
IDBSession GetCurrentDBSession();
}
}
该接口中定义GetCurrentDBSession()方法,其作用是通过该接口方法获取需要的实体对象。至此,这个项目基本上完成了,在这里添加了如下文件:
三、增删改查等方法的实现项目DAO
建好项目后添加如下引用:
创建ObjectContextFactory类,用来获取EF上下文。当网站访问量增大时,为避免EF产生的脏数据问题,我们使用System.Runtime.Remoting.Messaging 命名空间下的CallContext来解决线程内上下文唯一。
namespace EF.DAO
{
public class ObjectContextFactory
{
public static DbContext GetCurrentObjectContext()
{
//从CallContext数据槽中获取EF上下文
DbContext objectContext = CallContext.GetData(typeof(ObjectContextFactory).FullName) as DbContext;
if (objectContext == null)
{
//如果CallContext数据槽中没有EF上下文,则创建EF上下文,并保存到CallContext数据槽中
objectContext = new DBContent();//当数据库替换为MySql等,只要在此处EF更换上下文即可。这里的DBContent是model.context.cs中的局部类
CallContext.SetData(typeof(ObjectContextFactory).FullName, objectContext);
}
return objectContext;
}
}
}
创建BaseDao类,实现IBaseDao中定义方法,用于所有实体类继承此基类。但是,这个类和接口IBaseDao没有任何的关系,他们之间的联系体现在这个类的派生类实现了IBaseDao这个接口
namespace EF.DAO
{
public class BaseDao<T> where T : class, new()
{
DbContext objectContext = ObjectContextFactory.GetCurrentObjectContext() ;//获取EF上下文
/// <summary>
/// 加载实体集合
/// </summary>
/// <param name="whereLambda"></param>
/// <returns></returns>
public virtual IQueryable<T> LoadEntites(Func<T, bool> whereLambda)
{
return objectContext.Set<T>().Where<T>(whereLambda).AsQueryable<T>();
}
/// <summary>
/// 分页加载数据
/// </summary>
/// <param name="whereLambda">过滤条件</param>
/// <param name="pageIndex">页码</param>
/// <param name="pageSize">页大小</param>
/// <param name="totalCount">总记录数</param>
/// <returns></returns>
public virtual IQueryable<T> LoadEntites(Func<T, bool> whereLambda, int pageIndex, int pageSize, out int totalCount)
{
var tmp = objectContext.Set<T>().Where<T>(whereLambda);
totalCount = tmp.Count();
return tmp.Skip<T>(pageSize * (pageIndex - 1))//跳过行数,最终生成的sql语句是Top(n)
.Take<T>(pageSize) //返回指定数量的行
.AsQueryable<T>();
}
/// <summary>
/// 添加实体
/// </summary>
/// <param name="entity"></param>
/// <returns>返回更新后的实体</returns>
public virtual T AddEntity(T entity)
{
objectContext.Set<T>().Add(entity);
objectContext.SaveChanges();
return entity;
}
/// <summary>
/// 更新实体
/// </summary>
/// <param name="entity"></param>
/// <returns>返回更新后的实体</returns>
public virtual T UpdateEntity(T entity)
{
objectContext.Set<T>().Attach(entity);
objectContext.Entry<T>(entity).State = EntityState.Modified;//将附加的对象状态更改为修改
objectContext.SaveChanges();
return entity;
}
/// <summary>
/// 删除实体
/// </summary>
/// <param name="entity"></param>
/// <returns></returns>
public virtual bool DelEntity(T entity)
{
objectContext.Set<T>().Attach(entity);
objectContext.Entry<T>(entity).State = EntityState.Deleted;//将附加的实体状态更改为删除
if (objectContext.SaveChanges() > 0)
{
return true;//删除成功
}
else
{
return false;//删除失败
}
}
/// <summary>
/// 根据条件删除对象
/// </summary>
/// <param name="whereLambda">条件</param>
/// <returns></returns>
public virtual bool DelEntityByWhere(Func<T, bool> whereLambda)
{
var tmp = objectContext.Set<T>().Where<T>(whereLambda);//根据条件从数据库中获取对象集合
foreach (var entity in tmp)
{
objectContext.Entry<T>(entity).State = EntityState.Deleted;//标记对象为删除状态删除
}
if (objectContext.SaveChanges() > 0)
{
return true;
}
else
{
return false;
}
}
}
}
使用T4模板生成所有实体对象的实现,生成所有的实体类继承自BaseDao并实现各自的接口。创建一个模板文件DaoExt
<#@ template debug="false" hostspecific="true" language="C#" #>
<#@ assembly name="System.Core" #>
<#@ import namespace="System.Linq" #>
<#@ import namespace="System.Text" #>
<#@ import namespace="System.Collections.Generic" #>
<#@ include file="EF.Utility.CS.ttinclude"#>
<#@ output extension=".cs" #>
<#
CodeGenerationTools code = new CodeGenerationTools(this);
MetadataLoader loader = new MetadataLoader(this);
CodeRegion region = new CodeRegion(this, 1);
MetadataTools ef = new MetadataTools(this);
string inputFile = @"..\DBModel\Model.edmx";
EdmItemCollection ItemCollection = loader.CreateEdmItemCollection(inputFile);
string namespaceName = code.VsNamespaceSuggestion();
EntityFrameworkTemplateFileManager fileManager = EntityFrameworkTemplateFileManager.Create(this);
#>
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using DBModel;
using EF.IDAO;
namespace EF.DAO
{
<#
foreach (EntityType entity in ItemCollection.GetItems<EntityType>().OrderBy(e => e.Name))
{#>
public partial class <#=entity.Name#>Dao:BaseDao<<#=entity.Name#>>,I<#=entity.Name#>Dao
{
}
<#};#>
}
创建文本模板DBSessionExt,来生成DBSession实现接口IDBSession
<#@ template debug="false" hostspecific="true" language="C#" #>
<#@ assembly name="System.Core" #>
<#@ import namespace="System.Linq" #>
<#@ import namespace="System.Text" #>
<#@ import namespace="System.Collections.Generic" #>
<#@ output extension=".cs" #>
<#@ include file="EF.Utility.CS.ttinclude"#>
<#
CodeGenerationTools code = new CodeGenerationTools(this);
MetadataLoader loader = new MetadataLoader(this);
CodeRegion region = new CodeRegion(this, 1);
MetadataTools ef = new MetadataTools(this);
string inputFile = @"..\DBModel\Model.edmx";
EdmItemCollection ItemCollection = loader.CreateEdmItemCollection(inputFile);
string namespaceName = code.VsNamespaceSuggestion();
EntityFrameworkTemplateFileManager fileManager = EntityFrameworkTemplateFileManager.Create(this);
#>
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using EF.IDAO;
using System.Data.Entity;
namespace EF.DAO
{
public partial class DBSession : IDBSession
{
private DbContext _efContext;
//EF上下文 这段代码是因为要实现IDBSession接口中的SaveChange方法而写的,因为每次保存这个文本模板时,如果没有这段代码那么在生成的类中就会缺少SaveChange方法的实现,从而导致编译不过
public DbContext EfContext
{
get
{
if (_efContext == null)
{
_efContext = ObjectContextFactory.GetCurrentObjectContext();
}
return _efContext;
}
set { _efContext = value; }
}
public int SaveChange()
{
return EfContext.SaveChanges();//调用SaveChanges()方法提交操作
}
<#foreach (EntityType entity in ItemCollection.GetItems<EntityType>().OrderBy(e => e.Name))
{#>
private I<#=entity.Name#>Dao _<#=entity.Name#>Dao;
public I<#=entity.Name#>Dao <#=entity.Name#>Dao
{
get
{
if (_<#=entity.Name#>Dao == null)
{
_<#=entity.Name#>Dao = new <#=entity.Name#>Dao();
}
return _<#=entity.Name#>Dao;
}
set { _<#=entity.Name#>Dao = value; }
}
<#}#>
}
}
添加一个类DBSessionFactory,实现接口IDBSessionFactory
namespace EF.DAO
{
public class DBSessionFactory : IDBSessionFactory
{
public IDBSession GetCurrentDBSession()
{
IDBSession dbSession = CallContext.GetData(typeof(DBSessionFactory).FullName) as DBSession;
if (dbSession == null)
{
dbSession = new DBSession();
CallContext.SetData(typeof(DBSessionFactory).FullName, dbSession);
}
return dbSession;
}
}
}
至此,我们就已经完成了对数据访问层的封装,当数据库中的表或字段有更新时,我们只需要重新运行一下相应T4模版,就可以实现与数据库保存一致。一共添加了如下文件
四、业务逻辑层的封装
创建名为EF.IBLL的程序集,主要用于业务逻辑层接口定义
创建接口IBaseService,这个接口和IBaseDao一模一样的,但是这个接口是业务逻辑层的,而IBaseDao是数据访问层的。所以可以将IBaseDao直接拷过来换个名字就行了
创建名为IServiceExt的T4模版,用于自动生成所有实体对象的接口,并继承自IBaseService接口
<#@ template debug="false" hostspecific="true" language="C#" #>
<#@ assembly name="System.Core" #>
<#@ import namespace="System.Linq" #>
<#@ import namespace="System.Text" #>
<#@ import namespace="System.Collections.Generic" #>
<#@ output extension=".cs" #>
<#@ include file="EF.Utility.CS.ttinclude"#>
<#
CodeGenerationTools code = new CodeGenerationTools(this);
MetadataLoader loader = new MetadataLoader(this);
CodeRegion region = new CodeRegion(this, 1);
MetadataTools ef = new MetadataTools(this);
string inputFile = @"..\DBModel\Model.edmx";
EdmItemCollection ItemCollection = loader.CreateEdmItemCollection(inputFile);
string namespaceName = code.VsNamespaceSuggestion();
EntityFrameworkTemplateFileManager fileManager = EntityFrameworkTemplateFileManager.Create(this);
#>
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using DBModel;
namespace EF.IBLL
{
<#
foreach (EntityType entity in ItemCollection.GetItems<EntityType>().OrderBy(e => e.Name))
{#>
public interface I<#=entity.Name#>Service : IBaseService<<#=entity.Name#>>
{
}
<#};#>
}
至此,业务逻辑层定义完成
五、实现业务逻辑层,对数据访问层的调用
创建项目EF.BLL,创建名为BaseService基类。该基类中实现了对数据访问层的调用,也实现了增删改查
步骤: 1、先将IDBSessionFactory封装为属性,用于获取IDBSession
2、再将IDBSession封装为属性,用于获取EF上下文对象
3、定义IBaseDao类型的CurrentDao属性,用于属性获取具体的实体对象
4、定义抽象方法 SetCurrentDao(),用于子类设置实现,为CurrentDao属性赋具体的实体对象
namespace EF.BLL
{
public abstract class BaseService<T> where T : class, new()
{
//构造函数
public BaseService()
{
//调用SetCurrentDao()方法,要求子类必须实现
SetCurrentDao();
}
//获取EF实体工厂
IDBSessionFactory _dbSessionFactory;
IDBSession _dbSession;
public IDBSessionFactory DbSessionFactory
{
get
{
if (_dbSessionFactory == null)
{
_dbSessionFactory = new DBSessionFactory();
}
return _dbSessionFactory;
}
set { _dbSessionFactory = value; }
}
public IDBSession DbSession
{
get
{
if (_dbSession == null)
{
_dbSession = DbSessionFactory.GetCurrentDBSession();//通过数据访问层提供的工厂获取EF实体对象
}
return _dbSession;
}
set { _dbSession = value; }
}
//数据访问层基接口类型可以接收数据访问层的所有实体Dao
public IBaseDao<T> CurrentDao { get; set; }
//该方法用于子类实现,其作用是设置相应的实体Dao
public abstract void SetCurrentDao();
}
}
在实现增加和更新方法时,我们这时调用DBSessin中封装的SaveChanges()方法进行提交,主要目的是实现业务层控制提交。由于EF具有延迟加载特性,因此我们利用此特性,实现批量操作时,一次提交数据库,以提高程序性能,因此我们这时需要将BaseDao中的增加和更新方法中的SaveChange()方法注视掉。
基类BaseService剩下的代码:
//以下是CRUD实现
public virtual IQueryable<T> LoadEntites(Func<T, bool> whereLambda)
{
return this.CurrentDao.LoadEntites(whereLambda);
}
public virtual IQueryable<T> LoadEntites(Func<T, bool> whereLambda, int pageIndex, int pageSize, out int totalCount)
{
return this.CurrentDao.LoadEntites(whereLambda, pageIndex, pageSize, out totalCount);
}
public virtual T AddEntity(T entity)
{
var tmp = this.CurrentDao.AddEntity(entity);
this.DbSession.SaveChange();
return tmp;
}
public virtual T UpdateEntity(T entity)
{
var tmp = this.CurrentDao.UpdateEntity(entity);
this.DbSession.SaveChange();
return tmp;
}
public virtual bool DelEntity(T entity)
{
return this.CurrentDao.DelEntity(entity);
}
public virtual bool DelEntityByWhere(Func<T, bool> whereLambda)
{
return this.DelEntityByWhere(whereLambda);
}
至此,BaseService业务逻辑层基类就封装完成,接下来使用T4模版自动生成所有实体。
创建名为ServiceExt的T4模版
<#@ template debug="false" hostspecific="true" language="C#" #>
<#@ assembly name="System.Core" #>
<#@ import namespace="System.Linq" #>
<#@ import namespace="System.Text" #>
<#@ import namespace="System.Collections.Generic" #>
<#@ output extension=".cs" #>
<#@ include file="EF.Utility.CS.ttinclude"#>
<#
CodeGenerationTools code = new CodeGenerationTools(this);
MetadataLoader loader = new MetadataLoader(this);
CodeRegion region = new CodeRegion(this, 1);
MetadataTools ef = new MetadataTools(this);
string inputFile = @"..\DBModel\Model.edmx";
EdmItemCollection ItemCollection = loader.CreateEdmItemCollection(inputFile);
string namespaceName = code.VsNamespaceSuggestion();
EntityFrameworkTemplateFileManager fileManager = EntityFrameworkTemplateFileManager.Create(this);
#>
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using EF.IBLL;
using DBModel;
namespace EF.BLL
{
<#
foreach (EntityType entity in ItemCollection.GetItems<EntityType>().OrderBy(e => e.Name))
{#>
public partial class <#=entity.Name#>Service : BaseService<<#=entity.Name#>>, I<#=entity.Name#>Service
{
public override void SetCurrentDao()
{
this.CurrentDao = this.DbSession.<#=entity.Name#>Dao;
}
}
<#};#>
}
这时我们就对业务逻辑层封装完成。
现在需要建一个运行项目,来测试是否真的可以访问数据库了。项目建好后,添加DBModel,IBLL,BLL的引用。将DBModel中app.config里面的字符串链接复制到运行项目中的web.config中
然后在要访问数据库的方法中通过下面的代码来实现:
EF.IBLL.IN_CommodityService ics = new EF.BLL.N_CommodityService();
IList<DBModel.N_Commodity> lis = ics.LoadEntites(t => t.Id_bigint < 200).ToList();
int s = lis.Count;
也就是说,所有对数据库的访问都是通过EF.IBLL中的实体接口来实现的。
总结:整个数据访问的框架就分为业务逻辑层(EF.IBLL,EF.BLL),数据访问层(EF.IDAO,EF.DAO)和实体(DBModel)三个部分。在创建实体的时候,要注意EF版本的选择,目前来说最好是选择5.0版本的,因为EntityFramework的版本为5.0,否则可能会出现意想不到的错误。还有就是在选择数据连接的时候,对于是否在字符串中包括敏感数据,选择是就行了,这也是为了避免出现不可预知的错误。每次更新了实体的时候,都要重新保存一次所有的文本模板文件,以便能自动生成实体类和接口。
以上介绍的一些对数据库的访问的方法都是linq方式的,有时候我们需要通过sql语句来实现对数据库的访问,这种方式在另一篇随笔再详细的介绍。