.NET 分布式架构开发实战之四 构建从理想和实现之间的桥梁(前篇)

  前言:

  上一篇文章讲述了一些实现DAL的理论,本篇主要是DAL实现的的初步的尝试。

  本篇的主要议题如下:

  1) 设计DAL的基本操作

  2) 对基本的操作的进一步的思考

  3) 查询对象的一些思考

  1. 设计DAL的基本操作

  Richard认为:在设计一个架构或者Framework的时候,有几点很重要:

  a. 总体把握的能力。

  b. 抽象的能力。

  c. 分析的能力

  首先,从总体上来看,Richard认为DAL中最基本,而且最容易想到的方法就是CRUD(Create, Read, Update, Delete)四个操作。

  于是Richard在草纸写出了基本操作的名称:

  AddSingleDataEntity;

  AddDataEntityList;

  UpdateSingleDataEntity;

  UpdateDataEntityList;

  DeleteSingleDataEntity;

  DeleteDataEntityList;

  GetSingleDataEntiry;

  GetDataEntityList;

  上面列出的方法名字很长,其实Richard在思考这些方法的名称的时候也参考了.NET设计规范中的一些建议:方法名称要具有“自解释性,因为架构的设计最后还是给开发人员用的,所以方法的定义要一眼就看出它是干什么的,而且规范的命名也可以大大的减少维护的成本。(可能这些名字的命名有点对规范的“生搬硬套,但是之后会慢慢的重构的)

  从总体出发,已经定义出了基本的操作,那么现在就开始一步步的分析,如何实现这些方法。

  Richard开始思考第一个方法的实现,其实Richard心里也清楚:其实到底哪个方法作为第一个来考虑也许很重要,但是在一切都不清楚之前起码要拿一个来入手,而且随着思考的深入,很多的问题都会慢慢的浮现,到时候一切就会明晰起来。

  对于AddSingleDataEntity这个方法,首先就要考虑这个方法到底要把什么添加到数据库中,也就是说要考虑这个方法的参数,而且这个参数要足够的“兼容,因为之前Richard就是想设计出一个“以不变应万变的DAL。在考虑这个参数问题之前,首先Richard很清楚:在.NET数据访问技术中,Linq,Entity Framework等ORM技术已经广泛的应用,所以在设计DAL的时候要充分的考虑到现有的一些技术(尽量避免重新造轮子)。

  而且在数据是如何被存入到数据库中的以及数据是如何从数据库中取出的,这个工作是完全可以交给这些ORM的,最后的结果就是:在DAL中只是操作这些ORM的那些映射实体。基于这个想法, Richard就确定了:AddSingleDataEntity参数是一个数据实体。(本系列文章约定:数据实体,即DataEntity,就是ORM对一个数据库表进行映射后产生的实体和数据库中的表一一对应,如在数据库中有一张Employee表,Linq to Sql将会把它映射成为Employee的一个类,这个类就称为数据实体)。因为这些方法最终是操作数据实体的,所以包含这些方法的接口名字就定义为IDataContext。

  因为不同的表产生不同的数据实体,但是Richard还想使得AddSingleDataEntity这个方法可以接受任何的数据实体,所以此时很有必要对数据实体进行抽象。所以Richard想到了定义一个接口:IDataEntity,打算让所有通过ORM生成的数据实体都继承这个接口。而且Richard还想到:

  1. 如果BLL直接引用DAL使用的,那么IDataEntity可能会在BLL中出现的。

  2. 如果BLL通过repository去DAL中获取数据,那么到时候BLL可能都不会直接引用DAL,但是BLL最终还是得使用数据做事情,所以IDataEntity还是会在BLL中出现,所以,IDataEntity接口最好定义在一个公共的地方。

  Richard决定新建一个Common的类库,加入IDataEntity接口的定义,现在这个接口里面什么都没有,只是一个标记而已,表明继承这个接口的类就是数据实体类。

  AddSingleDataEntity(IDataEntity dataEntity);

  还有一点就是尽量的使用类型安全的方法,于是Richard把方法改成了范型方法:

  AddSingleDataEntityT(T dataEntity) where T:IDataEntity,class,new();

  至于T 的那些约束:T:IDataEntity,class,new(),是考虑到了Linq和EF中对数据实体的一些要求。

  一般的Add方法都是返回添加是否成功,true或者false,方法再次改造:

  bool AddSingleDataEntityT(T dataEntity) where T:IDataEntity,class,new();

  然后Richard就写出了上面列出的一些方法的定义:

  bool AddSingleDataEntityT(T dataEntity) where T : class,IDataEntity, new();

  bool AddDataEntityListT(ListT dataEntityList) where T : class,IDataEntity, new();

  bool DeleteDataEntityListT(ListT dataEntityList) where T : class,IDataEntity, new();

  bool DeleteSingleDataEntityT(T dataEntity) where T : class,IDataEntity, new();

  bool UpdateSingleDataEntityT(T dataEntity) where T : class,IDataEntity, new();

  bool UpdateDataEntityListT(ListT dataEntityList) where T : class,IDataEntity, new();

  至于GetDataEntityList,按照之前的查询对象的想法,传入一个IQuery的接口:

  ListT GetDataEntityListT(IQuery query)where T : class,IDataEntity, new();

  2. 对基本的操作的进一步的思考

  确实,上面那些基本操作是没有什么问题的,现在Richard又考虑到了另外的一些问题,还是以AddSingleDataEntity方法为例:

  a. 有些时候,不仅仅要知道插入数据是否成功,而且还想返回新加入数据在数据库中的主键信息来做其他的用途。怎么办?再来查询一次?

  b. 如果插入失败了,仅仅只是返回一个false吗?可能其他的调用模块想知道到底是发生了什么异常而导致的插入失败,而且其他的模块对于发生的异常有自己的处理方法,所以AddSingleDataEntity要提供足够的信息。

  基于上面的思考,所以这个基本的操作方法不能只是简单的返回一些简单的值就完了。也就是说,这些方法要返回一个数据包:里面包含很多信息,以便其他的调用模块来使用这些信息,感觉有点像是C#事件中的eventArgs.

  所以Richard在Common的那个类库中加入一个对象,定义如下:

  代码

public class DataResultT where T : IDataEntity

{

public ListT EntityList { get; set; }

public bool IsSuccess { get; set; }

public Exception Exception { get; set; }

public object CustomData { get; set; }

}

  这个类最后将会作为方法的返回结果。

  Richard发觉,上面的方法确实是很有自解释性,但是很多的开发人员对这些CRUD操作的名字都很熟悉了,而且最后开发的出来的架构的使用者还是开发人员,应该符合他们的习惯,所以Richard改变了方法的名字,改变后的版本如下:

  代码

public interface IDataContext

{

IListT QueryT(IQuery queryCondition) where T : class,IDataEntity, new();

IListT QueryT(IQuery queryCondition, int pageIndex, int pageCount) where T : class,IDataEntity, new();

// CRUD services (well, mostly CUD)

T AddT(T item) where T : class,IDataEntity, new();

IListT AddT(ListT itemList) where T : class,IDataEntity, new();

bool DeleteT(ListT itemList) where T : class,IDataEntity, new();

bool DeleteT(T item) where T : class,IDataEntity, new();

T UpdateT(T item) where T : class,IDataEntity, new();

ListT UpdateT(ListT itemList) where T : class,IDataEntity, new();

}

  3. 查询对象的一些思考

  在上面的基本的操作中,在Query方法中传入的是查询对象,因为查询对象是基于解释器的,可以在解释完查询对象之后就缓存起来。以后再次查询的时候,如果两个查询的对象一样(例如在构造查询对象时候,可以为其定义一个唯一的标示),那么就不用再去对查询对象进行解释。如果根据这个查询对象的查出的数据都是只读的,那就更好了,就可以把查询对象和对应的结果一起缓存起来。

  相关文章:.NET分布式架构开发实战之一 故事起源

.NET 分布式架构开发实战之二 草稿设计

.NET 分布式架构开发实战之三 数据访问深入一点的思考

时间: 2024-10-25 23:09:19

.NET 分布式架构开发实战之四 构建从理想和实现之间的桥梁(前篇)的相关文章

[原创].NET 分布式架构开发实战之四 构建从理想和实现之间的桥梁(前篇)

原文:[原创].NET 分布式架构开发实战之四 构建从理想和实现之间的桥梁(前篇) .NET 分布式架构开发实战之四 构建从理想和实现之间的桥梁(前篇) 前言:上一篇文章讲述了一些实现DAL的理论,本篇主要是DAL实现的的初步的尝试.   本篇的主要议题如下: 1. 设计DAL的基本操作 2. 对基本的操作的进一步的思考 3. 查询对象的一些思考   系列文章链接:  [原创].NET 分布式架构开发实战之一 故事起源 [原创].NET 分布式架构开发实战之二 草稿设计 [原创].NET 分布式

.NET分布式架构开发实战之四 构建从理想和实现之间的桥梁(前篇)

本篇的主要议题如下: 1.设计DAL的基本操作 2.对基本的操作的进一步的思考 3.查询对象的一些思考 1.设计DAL的基本操作 Richard认为:在设计一个架构或者Framework的时候,有几点很重要: a.总体把握的能力. b.抽象的能力. c.分析的能力 首先,从总体上来看,Richard认为DAL中最基本,而且最容易想到的方法就是CRUD(Create, Read, Update, Delete)四个操作. 于是Richard在草纸写出了基本操作的名称: AddSingleDataE

.NET 分布式架构开发实战之四 构建从理“.NET研究”想和实现之间的桥梁(前篇)

前言: 上一篇文章讲述了一些实现DAL的理论,本篇主要是DAL实现的的初步的尝试. 本篇的主要议题如下: 1) 设计DAL的基本操作 2) 对基本的操作的进一步的思考 3) 查询对象的一些思考 1. 设计DAL的基本操作 Richard认为:在设计一个架构或者Framework的时候,有几点很重要: a. 总体把握的能力. b. 抽象的能力. c. 分析的能力 首先,从总体上来看,Richard认为DAL中最基本,而且最容易想到的方法就是CRUD(Create, Read, Update, De

[原创].NET 分布式架构开发实战之一 故事起源

原文:[原创].NET 分布式架构开发实战之一 故事起源 .NET 分布式架构开发实战之一 故事起源   前言:本系列文章主要讲述一个实实在在的项目开发的过程,主要包含:提出问题,解决问题,架构设计和各个逻辑层的实现以及新问题的出现和代码的重构.本系列文章以故事的形式展开,而且文章列举的很多项目的名称,大家也不用太关心,很多都是虚拟的.   系列文章链接:  [原创].NET 分布式架构开发实战之一 故事起源 [原创].NET 分布式架构开发实战之二 草稿设计 [原创].NET 分布式架构开发实

[原创].NET 分布式架构开发实战之二 草稿设计

原文:[原创].NET 分布式架构开发实战之二 草稿设计 .NET 分布式架构开发实战之二 草稿设计   前言:本篇之所以称为草稿设计,是因为设计的都是在纸上完成的.反映了一个思考的过程. 本篇的议题如下:   1. 第一个数据层草图的提出 2. 对数据访问层的思考 3. 第二个数据层草图的提出   系列文章链接:  [原创].NET 分布式架构开发实战之一 故事起源 [原创].NET 分布式架构开发实战之二 草稿设计 [原创].NET 分布式架构开发实战之三 数据访问深入一点的思考 [原创].

[原创].NET 分布式架构开发实战之三 数据访问深入一点的思考

原文:[原创].NET 分布式架构开发实战之三 数据访问深入一点的思考 .NET 分布式架构开发实战之三 数据访问深入一点的思考   前言:首先,感谢园子里的朋友对文章的支持,感谢大家,希望本系列的文章能够真正的对大家起到一点帮助的作用.再次感谢大家.   大家也许想问,什么时候出代码,代码一定会出的,我不想一上来就开始抛出一大堆的代码,然后讲解,架构的设计在思考的过程,思考到了,代码也就水到渠成了.   上篇文章讲述在设计之初,Richard所画出的一些草图,本篇对之前的草图做了进一步的思考.

[原创].NET 分布式架构开发实战五 Framework改进篇

原文:[原创].NET 分布式架构开发实战五 Framework改进篇 .NET 分布式架构开发实战五 Framework改进篇 前言:本来打算这篇文章来写DAL的重构的,现在计划有点改变.之前的文章,园子里的朋友给出了不少的反馈,特别感谢金色海洋和Virus两位朋友的一些反馈.周末的这两天,对文章中开发的那个Framework做了一些改进,虽然说系列文章会慢慢的给出代码,但是这两天的一些想法让我很兴奋,迫不及待的和大家分享一下,也当是对文章中以后给出的Framework先睹为快吧.   系列文

一起谈.NET技术,.NET 分布式架构开发实战之三 数据访问深入一点的思考

前言: 首先,感谢朋友们对文章的支持,感谢大家,希望本系列的文章能够真正的对大家起到一点帮助的作用.再次感谢大家. 大家也许想问,什么时候出代码,代码一定会出的,我不想一上来就开始抛出一大堆的代码,然后讲解,架构的设计在思考的过程,思考到了,代码也就水到渠成了. 上篇文章讲述在设计之初,Richard所画出的一些草图,本篇对之前的草图做了进一步的思考. 本篇的议题如下: 1.草图的一些问题在哪里 2.重审之前项目中数据层的问题 3.思维的一点突破 4.回首再看数据访问层 1.草图的一些问题在哪里

一起谈.NET技术,.NET分布式架构开发实战之一 故事起源

前言: 本系列文章主要讲述一个实实在在的项目开发的过程,主要包含:提出问题,解决问题,架构设计和各个逻辑层的实现以及新问题的出现和代码的重构.本系列文章以故事的形式展开,而且文章列举的很多项目的名称,大家也不用太关心,很多都是虚拟的. 本篇主要讲述项目的一些背景 新人Richard被分配到了一个企业自动化信息管理项目组--Automation Information Management Project(后面简称AIM),当Richard进入项目组的时候,这个项目已经开始了,项目的架构也已经在两