Way.EntityDB是一个基于EF Core的数据层框架,它取消了EF Core的Migration机制,因为Migration并不是通用的,比如说sql server生成的migration,如果换成sqlite,运行时会报错的,也就是数据库不能更换。
Way.EntityDB内置建模工具,通过图形化建表,生成Model对象代码,并且它会把表结构的修改过程,全部记录下来,涵盖在Model代码里面,所以,在新的代码运行时,数据库也会自动更新到最新结构。
举个例子,当你把一个字段的名字从column1,更改为column2,EF Core生成的migration,就是把column1删除,并添加一个column2,这样,column1的现有数据就会丢失。而EntityDB则不一样,它只会把column1改名为column2,
因为它记录的是表结构修改的过程,而不是匹对Model类的前后变化。
Way.EntityDB源码位置:
https://github.com/simpleway2016/EntityDB
启动服务器端
Way.EntityDB是允许多人同时使用,所以,分为服务器和客户端。
下载源码,编译后,在Debug/netcoreapp2.0文件夹里面,创建一个批处理文件run6062.bat,内容如下:
dotnet Way.EJServer.dll 6062
6062是本机任意一个没有使用的端口号,表示以6062为端口,创建一个服务器工作空间
运行run6062.bat,启动服务器端
运行客户端
编译并运行EJClient.exe
server url:https://localhost:6062
user name:sa
password:1
登录进去,由于没有工程项目,所以界面空白,点击【project】菜单,创建一个项目
右键点击【Database】,新建一个数据库
再新建一个数据模块UserInfo
双击UserInfo,在数据模块里面,空白处点击右键,新建数据表
这样,一张数据表就创建完成
编程使用数据表
新建一个.net core 控制台项目
给这个项目安装nuget包:Way.EntityDB
然后,回到EJClient,在TestDB处点击右键,点击【生成数据库模型代码】
保存到刚才创建的项目里面
这样,Model类就准备好了,开始写代码
using System; using System.Linq; namespace ConsoleApp1 { class Program { static void Main(string[] args) { var db = new MyDB.DB.TestDB("data source='F:\mytestdb.dat'", Way.EntityDB.DatabaseType.Sqlite); //插入数据 var user = new MyDB.UserInfo() { UserName = "Jack", Password = "123" }; //插入到数据库 db.Update(user); //从数据库查询数据 var userlist = (from m in db.UserInfo select m).ToArray(); //修改数据 var jack = db.UserInfo.FirstOrDefault(m => m.UserName == "Jack"); jack.Password = "567"; db.Update(jack); //删除数据 db.Delete(jack);
//批量删除
db.Delete(db.UserInfo.Where( m => m.id > 0 ));
} } }
从代码可以看到,虽然也是EF Core,但由于禁用了ef的数据缓存机制,所以不能使用SaveChanges去同步数据库,可以使用DBContext.Insert DBContext.Update DBContext.Delete等方法同步数据库
DBContext.Update方法,会先判断对象的主键,如果主键是Null,那么会调用Insert方法,往数据库新增一条数据,如果主键不为Null,那么就是Update数据库里面的数据
禁用缓存机制,可以避免程序员在编程的时候混乱(有时候想把数据取出来,看看现在的数据状态,但谁知道取的是缓存里面的对象)
禁用缓存机制,对于大数据量的查询,也可以节约内存,提供效率,因为不再使用的对象,不会保存在内存里面
所以整体性能,应该和使用ADO.Net差不多
编写触发器
Way.EntityDB支持类似触发器的功能。添加一个ActionCapture类
using System; using System.Collections.Generic; using System.Diagnostics; using System.Text; using Way.EntityDB; using System.Linq; namespace ConsoleApp1 { class UserInfoTrigger : Way.EntityDB.ActionCapture<MyDB.UserInfo> { public override void AfterInsert(object database, DatabaseModifyEventArg e) { MyDB.UserInfo user = (MyDB.UserInfo)e.DataItem; Debug.WriteLine($"inserted {user.UserName}"); base.AfterInsert(database, e); } public override void BeforeDelete(object database, DatabaseModifyEventArg e) { var db = database as MyDB.DB.TestDB; //由于删除的对象,可能只有主键有值,所以,需要获取删除对象的具体信息,需要到数据库把该对象取出来 var pkid = ((MyDB.UserInfo)e.DataItem).id; var deletingUser = db.UserInfo.FirstOrDefault( m=>m.id == pkid); Debug.WriteLine($"准备删除 {deletingUser.UserName}"); base.BeforeDelete(database, e); } } }
class UserInfoTrigger : Way.EntityDB.ActionCapture<MyDB.UserInfo> 表示这个类捕获的是UserInfo表的事件
这时候,这个类还不能起作用,必须在程序启动时,把它实例化,注册到DBContext里面
static Program() { Way.EntityDB.DBContext.RegisterActionCapture(new UserInfoTrigger()); }
在ActionCapture类里面,只要override各个方法,就可以实现各种事件的捕获。
级联删除
EJClient可以设置表之间的级联删除关系,并且,被级联删除的数据,同样可以被你编写的触发器捕捉到。
现在,我们新建一张数据表FamilyInfo
双击UserInfo,打开属性框,切换到【级联删除】项,添加一个级联删除关系
导航属性(一对一)
虽然UserInfo和FamilyInfo,在数据库中并没有建立关系,但是,从系统设计上来说,他们是有关系的,所以,在UserInfo里面,如果可以直接访问FamilyInfo,会比较方便,所以,
可以给他们添加导航属性,首先,我们假设他们是一对一的关系。
打开UserInfo属性窗口,切换到【导航属性】,并添加一个名称为Family的属性
然后,打开FamilyInfo属性窗口,添加一个User属性
这里要注意,UserInfo里面的Family属性,不需要选择ForeignKey,而FamilyInfo的User属性,必须选择ForeignKey
接着用EJClient生成Model代码
然后,代码,我们可以这样写了
using System; using System.Diagnostics; using System.Linq; using Microsoft.EntityFrameworkCore; namespace ConsoleApp1 { class Program { static Program() { Way.EntityDB.DBContext.RegisterActionCapture(new UserInfoTrigger()); } static void Main(string[] args) { var db = new MyDB.DB.TestDB("data source='F:\mytestdb.dat'", Way.EntityDB.DatabaseType.Sqlite); //插入数据 var user = new MyDB.UserInfo() { UserName = "Jack", Password = "123" }; //插入到数据库 db.Update(user); //插入家庭信息 var family = new MyDB.FamilyInfo() { UserId = user.id, MotherName = "李晴", FatherName = "刘星" }; db.Update(family); //从数据库查询(m => m.Family 表示包含家庭信息) var jack = db.UserInfo.Include(m => m.Family).FirstOrDefault(m => m.UserName == "Jack"); var montherName = jack.Family.MotherName; Debug.WriteLine($"mother is {montherName}"); //删除数据 db.Delete(jack); } } }
var montherName = jack.Family.MotherName;直接可以取到母亲姓名,不需要到数据库再取一遍
导航属性(一对多)
如果UserInfo和FamilyInfo是一对多的关系,那么,打开userinfo对话框,把导航属性改为这样:
这时候,就必须选择ForeignKey了
用工具再次生成Model代码
这次的代码,就是这样写了:
using System; using System.Diagnostics; using System.Linq; using Microsoft.EntityFrameworkCore; namespace ConsoleApp1 { class Program { static Program() { Way.EntityDB.DBContext.RegisterActionCapture(new UserInfoTrigger()); } static void Main(string[] args) { var db = new MyDB.DB.TestDB("data source='F:\mytestdb.dat'", Way.EntityDB.DatabaseType.Sqlite); //插入数据 var user = new MyDB.UserInfo() { UserName = "Jack", Password = "123" }; //插入到数据库 db.Update(user); //插入家庭信息 var family1 = new MyDB.FamilyInfo() { UserId = user.id, MotherName = "李晴", FatherName = "刘星" }; db.Update(family1); var family2 = new MyDB.FamilyInfo() { UserId = user.id, MotherName = "第二妈妈", FatherName = "第二爸爸" }; db.Update(family2); //从数据库查询(m => m.Families 表示包含家庭信息) var jack = db.UserInfo.Include(m => m.Families).FirstOrDefault(m => m.UserName == "Jack"); foreach (var family in jack.Families) { Debug.WriteLine($"mother is {family.MotherName}"); } //删除数据 db.Delete(jack); } } }
变更数据库类型
如果在开发过程中,你要变更数据库类型,只需要更改连接字符串和类型即可
var db = new MyDB.DB.TestDB("server=192.168.136.137;uid=sa;pwd=Sql12345678;Database=TestDB", Way.EntityDB.DatabaseType.SqlServer);
这样,就转而使用SqlServer数据库