转载

解析大型.NET ERP系统高质量.NET代码设计模式

1 缓存 Cache

系统中大量的用到缓存设计模式，对系统登入之后不变的数据进行缓存，不从数据库中直接读取。耗费一些内存，相比从SQL Server中再次读取数据要划算得多。缓存的基本设计模式参考下面代码：

private static ConcurrentDictionary<string, LookupDialogEntity> _cachedLookupDialogEntities = new ConcurrentDictionary<string, LookupDialogEntity>();  if (!_cachedLookupDialogEntities.ContainsKey(key))        lookupDialog = _cachedLookupDialogEntities.GetOrAdd(key, lookupDialog); else        _cachedLookupDialogEntities[key] = lookupDialog;

主要用到的数据结构是字典，字典中的项目不存在时，向其增加，以后再调用时，直接从内存中取值。

列举一下，我可以看到的ERP系统中应用缓存设计模式的地方，主要分数据缓存和对象缓存，资源缓存：

1) 系统翻译 ERP系统中的文句翻译内容保存在数据库表中，只需要在系统登入时读取一次，缓存到DataTable中。

2) 系统参数登入系统之后，当前的财年，会计期间，采购单批核流程，物料编码长度，是否实施批号和序号，记帐凭证过帐前是否需要审核，成本核算的来源(物料成本，物料成本+人工成本，物料成本+人工成本+机器成本），这些参数都可以缓存在Entity中，用户修改这些参数值，需要提醒或是强制用户退出重新登入。

3) 系统查询系统中可预定义一组查询语句，在代码中将查询语句转化为查询对象，将查询对象缓存，节省SQL语句到查询对象的转化时间。

4) 对象实例以插件方式在搜索程序集中包含的系统功能时，搜索到后，会将程序功能对应的类型缓存，所以第二次执行功能的速度会相当快。参考下面的例子代码加深印象：

public void OpenFunctionForm(string functionCode) {   functionCode = functionCode.ToUpper().Trim();   Type formBaseType = null;   if (!_formBaseType.TryGetValue(functionCode, out formBaseType))   {      Assembly assembly = Assembly.GetExecutingAssembly();      foreach (Type type in assembly.GetTypes())      {      try      {       object[] attributes = type.GetCustomAttributes(typeof(FunctionCode), true);       foreach (object obj in attributes)       {        FunctionCode attribute = (FunctionCode)obj;        if (!string.IsNullOrEmpty(attribute.Value))        {         if (!_formBaseType.ContainsKey(attribute.Value))          _formBaseType.Add(attribute.Value, type);         if (formBaseType == null && attribute.Value.Equals(functionCode,StringComparison.InvariantCultureIgnoreCase))          formBaseType = type;        }        if (formBaseType != null)        {         goto Found;                  }       }      }      catch      {      }     }    }    Found:    if (formBaseType != null)    {     object entryForm = Activator.CreateInstance(formBaseType) as Form;     Form functionForm = (Form)entryForm;     OpenFunctionForm(functionForm);    }   }

在我的通用应用程序开源框架中，有上面这个例子的完整代码。

5) 资源缓存系统中会用到一些以嵌入方式编译到程序集中的资源文件，在搜索到资源文件后，也是以字典的方式缓存资源(图标Icon，图片Image，文本Text，查询语句Query)。

2 查询优化 Query Optimize

这是个很容易理解的设计模式，贵在坚持。我们在读取数据时，只读取最少的可用的数据，避免读取不需要的数据。用查询语句表达如下，下面是没有效率的查询数据：

SELECT   *    FROM Company

经过改善之后的语句，改成只读需要使用的数据，改善后的查询如下：

SELECT   CompanyCode, CompanyName    FROM Company

后者的性能会好很多。对于我使用的LLBL Gen Pro，把上面的代码转化为程序代码，也就是下面的例子程序所示：

IncludeFieldsList fieldList = new IncludeFieldsList(); fieldList.Add(FiscalPeriodFields.Period); fieldList.Add(FiscalPeriodFields.FiscalYear); fieldList.Add(FiscalPeriodFields.PeriodNo);  IFiscalPeriodManager fiscalPeriodManager = ClientProxyFactory.CreateProxyInstance<IFiscalPeriodManager>(); FiscalPeriodEntity fiscalPeriodEntity = fiscalPeriodManager.GetFiscalPeriod(Shared.CurrentUserSessionId, this.VoucherDate, null, fieldList);  this.Period = fiscalPeriodEntity.Period; this.FiscalYear = fiscalPeriodEntity.FiscalYear; this.PeriodNo = fiscalPeriodEntity.PeriodNo;

即使没有接触过LLBL Gen Pro，也可感受到类型IncludeFieldsList 的作用是为了挑选要读取的数据列，也就是要使用什么字段，就读什么字段，避免读取不需要的字段。

对于上面的程序，它的性能开销主要在读取数据和创建对象方面，为了性能再快一点，考虑读取数据转化为DataTable，可读性上有所降低但性能又提升了一些。

IRelationPredicateBucket  filterBucket = new RelationPredicateBucket(); filterBucket.PredicateExpression.Add(ShipmentFields.CustomerNo == this.CustomerNo); filterBucket.PredicateExpression.Add(ShipmentFields.Posted == true);  filterBucket.Relations.Add(new EntityRelation(ShipmentDetailFields.OrderNo, SalesOrderDetailFields.OrderNo, RelationType.ManyToMany)); filterBucket.PredicateExpression.Add(ShipmentDetailFields.QtyShipped == SalesOrderDetailFields.Qty);  ResultsetFields fields = new ResultsetFields(4); fields.DefineField(ShipmentFields.RefNo, 0); fields.DefineField(ShipmentFields.PayTerms, 1); fields.DefineField(ShipmentFields.Ccy, 2); fields.DefineField(ShipmentFields.ShipmentDate, 3); System.Data.DataTable shipments = userDefinedQueryManager.GetQueryResult(Shared.CurrentUserSessionId, fields, filterBucket, null, null, false, false);

继续改善查询的性能，假设场景是销售订单表要读取客户编号和客户名称，我们直接在销售订单表中增加客户名称字段，这样每次加载销售订单时，可直接读取到销售订单表自身的客户名称字段，而不用左连接关联到客户表读取客户名称。

Entity Framework或是第三方的ORM 查询接口，应该都具备上面列举的特性。

ORM查询不推荐使用LINQ，性能是主要考虑的方面。ORM框架将查询转化为实体对象时，因为不能预料到后面会用到实体的哪些属性，预先读取所有的字段绑定到属性中，性能难以接受，这跟前面提到的SELECT * 读取所有字段是同样的意思，延迟绑定属性，用到属性时再读取相应的数据库字段，每用一个属性都去读取一次数据库，对数据库的连接次数过于频繁，也不可接受。

下面的写法是我最不能忍受的查询写法，参考代码中的例子：

EntityCollection<AccountsReceivableJournalEntity> journalCollection = adapter.FetchEntityCollection<AccountsReceivableJournalEntity>(filterBucket, 1, sorter, null, fieldList);  AccountsReceivableJournalEntity   lastJournal = journalCollection[journalCollection.Count-1];

为了取一个表中的最后一笔记录，居然将整个表都读取到内存中，再取最后一条记录。

这种查询可以改善成SELECT TOP 1 + ORDER BY，读一笔数据的性能肯定优于读取未知笔数据记录。

3 延迟加载 Delay Load

在使用对象时，只有当需要使用对象的方法或属性，我们才实例化对象。设计模式的代码例子如下：

PayTermEntity payTerm = null; payTerms.TryGetValue(dataRow["PayTerms"].ToString(), out payTerm); if (payTerm == null) {     payTerm = payTermManager.GetPayTerm(Shared.CurrentUserSessionId, dataRow["PayTerms"].ToString());     payTerms.Add(payTerm.PayTerms, payTerm); }

突然想到这种模式就是系统缓存的实现方法。在类型中定义一个私有静态变量，使用这个变量时我们才去初始化它的实例。延迟加载避免了系统启动时创建所有缓存对象耗费的内存和时间，有些对象或许根本不会用到，也就不应该去创建。

比如用户仅登入进系统，没有做任何业务单据操作然后退出。如果在登入时就创建货币或付款条款的缓存，而用户又没有使用这些数据，影响了系统性能。

4 后台线程与多线程 BackgroundWorker/WorkerThreadBase

.NET 提供了后台线程控件，解决了长时间操作避免主界面卡死的问题。在系统中，凡是涉及到数据库操作，不能在很短时间内完成的，都放到BackgroundWorker后台线程中执行。系统中大量使用BackgroundWorker的地方：

1) 单据增删查改所有单据对数据的Insert,Delete,Update都用BackgroundWorker操作。

2) 查询所有关于数据的查询封装到BackgroundWorker中执行。

3) 数据操作类功能：数据初始化，数据再开始，核算供应商帐，核算客户帐，数据存档，数据备份，数据还原。

4) 业务单据过帐，业务单据完成，业务单据取消，业务单据修改。

当没有界面时，无法使用BackgroundWorker，可以用多线程组件改善性能。参考下面的例子代码：

private sealed class LoadItemsWorker : WorkerThreadBase {        private MrpEntity _mrp;        private ConcurrentBag<DataRow> _itemMasterRows;         protected override void Work()       {           //long time operation       }

调用上面的多线程组件，参看下面的例子代码：

List<LoadItemsWorker> workers = new List<LoadItemsWorker>(); for (int i = 0; i < MAX_RUNNING_THREAD; i++) {        LoadItemsWorker worker = new LoadItemsWorker(sessionId, this, mrp);        workers.Add(worker); } WorkerThreadBase.StartAndWaitAll(workers.ToArray());

多线程组件WorkerThreadBase可以在Code Project上找到源代码和讲解文章。

5 数据字典 Data Dictionary

主要介绍不可变的数据字典的设计模式，先看一下性别Gender的数据字典设计：

public enum Gender {  [StringValue("M")]  [DisplayValue("Male")]  Male,  [StringValue("F")]  [DisplayValue("Female")]  Female }

为枚举类型增加了二个特性，StringValue用于存储，DisplayValue用于界面控件中显示，这跟数据绑定中的介绍的数据源的ValueMember和DisplayMember是一样的原理。再来看使用代码：

Employee employee=... employee.Gender=StringEnum<Gender>.GetStringValue(Gender.Male);

也可以这样调用获取显示的值DisplayValue:

string displayValue=StringEnum<Gender>.GetDisplayValue(Gender.Male);

这样设计模式解决了数据字典的文档更新的烦恼。编写源代码同时就设计好了文档，想知道数据字典的值，直接打开枚举类型定义即可。

6 校验-执行-验证 Validate-Post-Verify

对业务逻辑的业务操作，遵守校验-执行-验证设计约定，来看一段代码加深印象：

try {  adapter.StartTransaction(IsolationLevel.ReadCommitted, "PostInvoice");     this.ValidateBeforePost(sessionId, accountsReceivableAllocation);  this.Post(sessionId, accountsReceivableAllocation);  this.VerifyGeneratedVoucher(sessionId, accountsReceivableAllocation);   adapter.Commit(); } catch {   adapter.Rollback();   throw; }

先校对要执行操作的数据，再对数据进行操作，操作完成之后，再对期望的数据进行验证。

比如发票生成凭证，先要验证发票上的金额是否大于零，开发票的时间是否是当前期间等业务逻辑，再执行凭证生成(Voucher)动作，最后验证生成的凭证的借贷方是否一致，是否考虑到小数点进位导致的借货方不一致，生成的凭证金额是否与原发票上的金额相等。

7 执行前-执行-执行后 OnBefore-Perform-OnAfter

第六条讲解是的业务记帐方法，第七条这里讲解的是公共框架与应用程序互动的方法。继承的.NET窗体或派生类要能改变基类的行为，需要设计一种方法来达到此目的。先看一段代码熟悉这种设计模式：

CancelableRecordEventArgs e = new CancelableRecordEventArgs(this.CurrentEntity); this.OnBeforeCancelEdit(e); if (this._beforeCancelEdit != null)      this._beforeCancelEdit(this, e); if (e.Cancel)       return false;  bool flag = this.DoPerformCancelEdit(this.CurrentEntity);

RecordEventArgs args2 = new RecordEventArgs(this.CurrentEntity); this.OnAfterCancelEdit(args2); if (this._afterCancelEdit != null)      this._afterCancelEdit(this, args2);

为了加深了解这种设计模式，我对上面的代码段用两行空格分开成三个部分，下面详细讲解这三个部分：

OnBefore 在执行操作前，派生类可以设定参数到基类中，影响基类的行为。比如可以执行一个事件，也可以向基类传递取消条件，派生类向基类传递Cancel=true的标志位，完全取消当前的操作。这是派生类影响基类行为的一种设计方式。另一种方法是抛出异常，异常会导致整个堆栈回滚。

Perform 执行要做的操作，这个命名是按照.NET的规范。比如我们想在代码中直接执行按钮的点击事件，可以这样写调用代码的方法：btnOK.PerformClick();

OnAfter 在执行完成后。可以对执行的结果重写，也可以调用派生类中的事件。

8 元数据 Metadata

框架能完成很多应用程序一句话调用就能完成的功能，元数据的功劳最大。系统中的实体对象的每个字段都有一张附加属性表，参考下面的代码定义：

private static void SetupCustomPropertyHashtables() {          _customProperties = new Dictionary<string, string>();          _fieldsCustomProperties = new Dictionary<string, Dictionary<string, string>>();          _customProperties.Add("SupportDocumentApproval", @"");           _customProperties.Add("SupportExternalAttachment", @"");          Dictionary<string, string> fieldHashtable;          fieldHashtable = new Dictionary<string, string>();          _fieldsCustomProperties.Add("Recnum", fieldHashtable);          fieldHashtable = new Dictionary<string, string>();          fieldHashtable.Add("AllowEditForNewOnly", @"");          fieldHashtable.Add("CapsLock", @"");          _fieldsCustomProperties.Add("RefNo", fieldHashtable);          fieldHashtable = new Dictionary<string, string>();          fieldHashtable.Add("ReadOnly", @"");

看到上面的代码，当前实体的每一个属性都可以绑定一个Dictionary对象，这段代码是用代码生成器完成。于是发挥想象力，将字段的特殊属性放到实体属性的附加属性中，框架可完成很多基础功能。

看到上面的RefNo属性中增加了AllowEditForNewOnly和CapsLock两条元数据。在系统框架部分，代码参考如下：

Dictionary<string, string> fieldsCustomProperties = GetFieldsCustomProperties(boundEntity, bindingMemberInfo.BindingField); if (fieldsCustomProperties != null) {         if (fieldsCustomProperties.ContainsKey("CapsLock"))         {          base.CharacterCasing = CharacterCasing.Upper;         }         else if (!(this.AlwaysReadOnly || !fieldsCustomProperties.ContainsKey("AllowEditForNewOnly")))         {           this._allowEditForNewOnly = true;         }