linq快速开发设计最佳实践(二) 构建model模型
第一篇文章我简要介绍了项目的设计框架和linq实现思想. 本篇文章将是最实际和具有技巧性的地方, 就是如何创建linq to sql 的模型对象. 二.前言 1.linq与linq to sql 姜敏同学提醒我要注意linq to sql和linq的不同.的确这两者就类似c#和.net. 老赵曾写文章特别强调过两者的不同.这里再简单提一下. linq是lang age-integrated q ery的缩写, 翻译后是"集成语言查询", 我将linq看做是一种查询框架, 拥有自己的特定语法. 只要对象实现了linq框架所需要的接口, 就可以使用linq语法进行查询.比如: codevar q ery = from tagcategory in dc.tagcategorywhere tagcategory.pkid == tagcategoryid select tagcategory linq to sql 是一个linq provider, 能够实现轻量级的orm, orm的作用是将数据库中的表和model模型做映射, 比如java中的hiberate(.net中也有nhiberate). linq to sql让我们可以使用linq的语言操作model对象, 完成对数据库的crud操作. 为何我们可以使用linq语言查询一个object？ 因为有linq to object. 为何我们可以使用linq语言查询对象操作数据库？ 因为我们有linq to sql. 2.linq to sql 的model对象 传统的model对象是一种信息模型, model类一般不包含任何的方法, 只包含属性.要描述一个现实世界st dent, 首先需要一个st dent的model类, 比如类名就叫做st dent, 用来保存每一个st dent特有的信息, 比如名字. 然后将其具有的行为在业务逻辑层描述, 比如在业务逻辑层创建一个st dentbl类, 为其添加一个walk方法. 现在比较流行使用业务模型设计系统, 业务模型会将信息和行为抽象成一个st dent角色.但是我还很少使用. 使用linq to sql, 我们能将传统意义上的model模型的某一个属性, 比如st dent类的name属性与数据库st dent表的name字段建立映射关系, 这就是orm: 对象object 关系relational 映射mapping 的含义. 有了orm, 当我们修改st dent的name时,将自动修改数据库中的数据. 我们再也看不到sql了, 系统中统统都是操作对象. linq to sql 提供了可视化设计工具"or 设计器"和命令行工具sqlmetal.exe 为数据库中的表自动生成model类代码. 但是默认生成的代码只能做做简单的demo例子, 在实际应用中有很多问题和需要修改的地方.下面将我创建一个model对象的的"最佳实践"拿出来和大家分享. 三. 使用工具建立model类 在架构上我将model类横向切割为一层, 纵向将每个业务线切割为一个项目.比如tag系统的模型层为: com.elong.model.tag 每个项目首先都要为每个表创建model类, 这一步我会使用or设计器的可视化设计.下面简单介绍一下步骤. 1.使用 or 设计器 在项目中添加新项是, 我们选择"linq to sql类",如下图: 我们会在项目中添加tagdatacontext.dbml文件, 展开此文件的"+"会发现其包含两个子文件: tagdatacontext.dbml.layo t以及tagdatacontext.design.cs 其中 tagdatacontext.design.cs 中保存我们的datacontext类和所有表的model类代码. tagdatacontext.dbml.layo t保存的是可视化设计的一些信息. 双击 tagdatacontext.dbml 文件会进入可视化设计阶段. 使用or设计器十分简单, 在此不做介绍.想学习的可以参考msdn或者一些前辈的系列教程,无非就是拖拖拽拽的工作.下面是一张or设计器截图: 提供下面几个技巧和经验: 1.如果想自动创建数据库中两个表的关系, 需要将这两个表同时拖出. 2.单击设计器空白处,查看属性面板, 有很多属性可以在这里修改: 最有用的上下文命名空间 和 实体命名空间. 上下文命名空间是datacontext类的命名空间, 我通常将其放置在dataaccess层中.实体命名空间是所有model类所在的命名空间, 我将其放置在model层中. 3.任何在可视化设计中的修改, 都会造成 .design.cs 文件重写, 所以现阶段不要手工对此文件做修改. 因为一旦作了修改将不能再使用or 设计器. 4.or 设计器允许我们创建一个不会重写的类来扩成自动生成的代码,创建方法是在or设计器的空白处点右键, 在弹出菜单中选择"查看代码",如图: 会在.dbml文件中添加一个.cs文件: 请一定要创建这个文件,因为以后我会将model类的方法创建在这个文件中. 四.使用sqlmetal.exe工具 上一章中已经提到过sqlmetal.exe,它是一个命令行工具, 需要从vis al st dio的命令行中使用.也会生成datacontext和model类的代码.比如: codesqlmetal conn:" *；pwd=*；initial catalog=databasename； data so rce=； connect timeo t=900； connection reset=false" code:"d:db.cs" db.cs中会有包含了是数据库所有表的datacontext以及每一张表的model类. 一旦我们对可视化设计生成的.design.cs文件作了修改, 比如添加了注释, 那么请不要再使用 or 设计器进行可视化的更改.正确的做法是手动的修改.design.cs中的代码, 对于新加表等工作量比较大的修改, 可以先使用sqlmetal.exe生成表对应的model类的初始代码, 将其copy到.design.cs中,然后再自行修改. 五.修改 tagdatacontext.design.cs 文件 在design.cs中, 我们要做下面几项修改: 1.修改model类名 修改model类名称,以及model类table特性的值,去掉其中的"用户."前缀.添加注释.下面是一个例子. 修改前: code[table(name = "dbo.t_activity")]p blic partial class t_activity 修改后: code   活动表.保存各种活动信息 [table(name = "t_activity")]p blic partial class activity 2. 添加所有属性的默认值和注释. 以activityname属性为例. 添加默认值: codeprivate string _activityname = string.empty； 添加注释: code  活动名称 [col mn(storage = "_activityname", dbtype = "nvarchar(200) not null", canben ll = false)]p blic string activityname 3.在主键列的col mn特性上添加isversion属性,值为tr e 比如: code  自增主键  [col mn(storage = "_pkid", a tosync = a tosync.oninsert, dbtype = "int not null identity", isprimarykey = tr e, isdbgenerated = tr e, isversion = tr e)]p blic int pkid 这一条相当重要.否则使用linq会遇到很多问题.当然也可以建立一个额外的timestamp列来用做isversion列,但是比较麻烦. 对于主键来说, a tosync属性应该设置为 oninsert, 实现的功能就是当我们将想要insert一个对象时, 在插入前并没有对象的主键id为n ll或默认值, 但是当调用datacontext完成insert操作后, 此对象的主键id属性会被自动被填充. 3.将使用数据库默认值的模型属性上,添加col mn(isdbgenerated=tr e) 比如: code[col mn(storage = "_createdtime", dbtype = "datetime not null", isdbgenerated=tr e)]p blic system.datetime createdtime { } createdtime是数据库中使用getdate在创建时写入的,我们希望使用数据库中的值.而不是在程序中更新.注意使用linq更新的是对象,如果使用默认的代码并且没有添加isdbgenerated, 则数据库中的getdate将失效. 4.修改datacontext类 如果我们添加了新的表, 除了修改.design.cs中的model模型类,还需要修改同样在此文件中的datacontext类.假设我们要添加一个activity表,则需要在datacontext类中增加下面代码: code partial void insertactivity(activity instance)；partial void updateactivity(activity instance)；partial void deleteactivity(activity instance)；p blic system.data.linq.table activity {get {ret rn this.gettable； } } 这三个分布方法是linq提供的机制,可以用来自定义增删改操作.activity属性则是在linq语句中需要使用的数据库表对象. 5.为反向引用添加 xmlignore 特性标签 自顶而下的方向是指从1对多中的"1"一方作为顶端, 叶子节点是元子表 或 "多对多"表. 实际代码中, 就是将所有 entityref 的字段所对应的属性上添加[xmlignore]特性, 否则提供远程服务需要序列化对象对象时, 会提示存在循环引用. 六.修改 tagdatacontext.cs 文件 在上面我们通过or 设计器创建的.cs文件中, 为每一个类添加一个detach方法,下面是一个标准的detach方法: code[datacontract]p blic partial class tagcategory {p blic void detach {this.propertychanged = n ll；this.propertychanging = n ll；this._tagcategorylang age = new entityset(new action(this.attach_tagcategorylang age), new action(this.detach_tagcategorylang age))；this._tagcategoryrefcity = new entityset(new action(this.attach_tagcategoryrefcity), new action(this.detach_tagcategoryrefcity))； this._tagitem = new entityset(new action(this.attach_tagitem), new action(this.detach_tagitem))；this._tagcategory1 = new entityset(new action(this.attach_tagcategory1), new action(this.detach_tagcategory1))；this._t_tag_tagcategory1 = defa lt(entityref)； } } 一个partial类可以将类代码分布在多个文件中,所以我们可以在.cs文件中扩充model类. 一个标准的detach方法需要做如下几个事情: 1.如果有 propertychanged 和 propertychanging 成员, 则设置为n ll 其中只要是model类实现了 inotifypropertychanging, inotifypropertychanged 这两个接口, 就会存在 propertychanged 和 propertychanging 这两个事件委托.默认生成的model类实现了这两个接口. 2.将model类所有的entityset和entityref字段设置为默认值. 这部分代码我们可以在自动生成的model类的构造函数中找到. 需要做的就是copy到此方法中. 在我的linq框架中, 每个model类都要有detach方法. 七.detach的作用 detach的主要作用是让对象脱离datacontext的跟踪, 从而实现一个方法:update, 参数是model对象模型. 一个对象detach后, 我们即可调用自己的业务逻辑或数据访问层对象, 进行更新操作. 而不是每次都必须依赖datacontext. 如果依赖datacontext, 那么业务逻辑和职责就没办法拆分. 如果已经有了一个信息完整的实体对象, 在不调用detach方法时会常常遇到无法attach的问题. 每次更新都要先select, 那显然是笨重的也是影响效率的. 也许至今还会有人此方法的正确性. 因为不了解linq底层的对象跟踪机制, 我也无法知道为何要这么做. 但是我花了好几天去寻找这个detach方法, 因为中文没有相关资料, 而英文资料也是在试探了好几个解决方案后才在事件中验证了此方法的可行性. 有了detach, 数据访问层的update方法就可以这么写了: code#region == update ==   更新对象  tagcategory对象 变更集 p blic changeset update(tagcategory item) { tagdatacontext dc = new tagdatacontext(m_connectionstring)； item.detach； dc.tagcategory.attach( item, tr e )； changeset res lt = dc.getchangeset； dc.s bmitchanges；ret rn res lt； }  更新集合  tagcategory集合 变更集 p blic changeset update(list itemlist) { tagdatacontext dc = new tagdatacontext(m_connectionstring)；foreach (tagcategory tempitem in itemlist) { tempitem.detach； } dc.tagcategory.attachall(itemlist, tr e)； changeset res lt = dc.getchangeset； dc.s bmitchanges；ret rn res lt；