LLBL Gen Pro 4.2 Lite 免费的对象关系映射开发框架与工具

LLBL Gen Pro是一款优秀的对象关系映射开发框架，自2003年发布以来，一直有广泛的客户群。LLBL Gen Pro有几个标志性的版本，2.5/2.6是一个很稳定的版本，公司的一些旧的项目仍然用的是这个版本。3.1 将项目的文件改成XML格式(llblgenproj)，极大的方便和简化了第三方工具与LLBL Gen交互，我的项目中用到的代码生成模板即使借助于解析它的XML格式文件，生成接口与实现文件。3.1也修改了生成实体的参数的顺序。比如2.5/2.6版本的送货单明细实体的代码如下：

public ShipmentDetailEntity(System.String refNo,System.Decimal entryNo):base("ShipmentDetailEntity")
{
       InitClassEmpty(null, null);
       this.Fields["EntryNo"].CurrentValue = entryNo;
       this.Fields["RefNo"].CurrentValue = refNo;
}

3.1则会生成如下的代码

public ShipmentDetailEntity(System.Decimal entryNo, System.String refNo):base("ShipmentDetailEntity")
{
       InitClassEmpty(null, null);
       this.Fields["EntryNo"].CurrentValue = entryNo;
       this.Fields["RefNo"].CurrentValue = refNo;
}

注意看两个构造方法的参数顺序有差异，2.x是以数据库中主键定义的顺序生成构造方法，3.1则是以主键的字母顺序为参数排列依据。

再到LLGL Gen Pro 3.5，3.5 抛弃了传统的EntityCollection，不再维护EntityCollection设计模式，而选用微软推荐的BindingSource控件，直接将BindingSource控件绑定到强类型的实体定义。

LLBL Gen Pro 4.2 Lite主界面如下图所示：

Lite 版没有使用时间上的限制，限制一个项目只能创建8个实体。做实际的项目开发可能远远不够，一个实际的项目通常都有几十上百个表，但是做项目练习或是学习已经足够了。

说点题外话，7.20微软就正式发布Visual Studio 2015，同时也会提供全功能版的Visual Studio Comunitiy Edition,可用于非商业软件的开发。这样策略可以让技术和工具得到进步，使用免费版的客户也可以提出许多合理的有建设性的建议。国内的一些软件也提供了这样的策略，在推广自己软件的同时，免费版完全免费使用，包含基本的功能，同时维护一些高级别的功能用于付费用户。也有些极端的做的很不友好的软件：百度网盘的客户端百度云，在没有提供加速下载功能前，速度是很快的，推出了加速下载服务，没有付费用户的下载慢如蜗牛，平时2MB的下载速度一下子跌到300K左右，这让免费用户情何以堪。这有点类似企业邮箱，免费的邮箱用户支持着付费用户，如果不是这些免费用户在用，在推广，付费用户肯定会大面积逃离。同样的是网盘功能，企业的付费用户共享一个文件，免费用户去读取，后者因为速度原因体验性太糟糕，最终影响的还是付费用户的流失。

企业应用架构模式一书中提到二种组织领域逻辑的模式：事务脚本(Transaction Script)和领域模型(Domain Model)。前者就是我们通常做的封装SQL语句到类型定义文件中，逻辑的组织方式通过SQL语句的封装调用来实现，来看一个事务脚本(Transaction Script)的例子：

界面层，直接读取类获取数据：

DataTable table = Database.GetPendingDesignTask(Database.CONNNECTION_STRING_COMPANY, Database.UserId);
table.Columns.Add("SubmitDrawing", typeof(string));
table.Columns.Add("SubmitSubmited", typeof(string));
designTaskBindingSource.DataSource = table;
gridDesignTask.DataSource = designTaskBindingSource;

逻辑层 Database类定义如下方法：

public static DataTable GetPendingDesignTask(string connectionString, string designer)
{
          DataTable table=new DataTable("Query");
          string query = @"SELECT [Recnum],[RefNo] ,[EntryNo],[TaskNo] ,[ScheduleDate]
                        ,[ProjectNo] ,[ProjectName],[OrderNo],[ItemNo],[ContractNo]
                        ,[Designer],[Reviewer],[Closed],[ClosedBy] ,[ClosedDate]
                        ,[Confirmed] ,[ConfirmDate] ,[ConfirmBy] ,[Path]
                        ,[Drawing] ,[SubmitDate] ,[Submited] ,[Reviewed]
                        ,[ReviewDate] ,[ContractProduct] ,[CheckIn]
                        ,[CheckInDate] ,[CheckInBy],[LibraryFolderName]
                        ,[LibraryFullPath] ,[EcnPath],[EcnDrawing]
                        FROM  [PdmDesignTaskDetail]  WHERE Confirmed='Y' AND Submited='N' AND Designer='{0}' ";
          table=SqlHelper.ExecuteDataTable(connectionString, string.Format(query, designer));
          return table;
}

事务脚本中，逻辑的组织方式通过代码组合SQL语句调用来实现。

再来看领域模型(Domain Model):

界面层，只做数据绑定

protected override void BindControls(EntityBase2 entity)
{
        base.BindControls(entity);
        this.salesBindingSource.DataSource = entity;

}

逻辑层 过帐逻辑部分代码例子：

private void ProcessPaymentDetail(Guid sessionId, AccountsPayablePaymentDetailEntity accountsPayablePaymentDetail)
{
          IAccountsPayableInvoiceManager accountsPayableInvoiceMapager = ClientProxyFactory.CreateProxyInstance<IAccountsPayableInvoiceManager>();
          if (!accountsPayableInvoiceMapager.IsInoviceExist(sessionId, accountsPayablePaymentDetail.InvoCtrlNo))
              return;

AccountsPayableInvoiceEntity apInvoice = accountsPayableInvoiceMapager.GetAccountsPayableInvoice(sessionId, accountsPayablePaymentDetail.InvoCtrlNo, null);
          this.UpdateSettledInvoice(apInvoice, accountsPayablePaymentDetail);
          this.UpdateSettlementsLedger(sessionId, accountsPayablePaymentDetail);

accountsPayablePaymentDetail.Posted = false;
          accountsPayablePaymentDetail.SettledAmt = 0m;
          accountsPayablePaymentDetail.LogNo = 0m;
          accountsPayablePaymentDetail.InvRoundDiff = 0m;
          accountsPayablePaymentDetail.LastLogNo = apInvoice.LastLogNo;

accountsPayableInvoiceMapager.SaveAccountsPayableInvoice(sessionId, apInvoice);
}

逻辑的组织方式是面向对象的编程，对象的交互调用。

当经历过几年的面向对象的编程洗礼后，遇到事务脚本类型的代码态度甚至是不可容忍的。我列举对象关系映射的几点实际经验，供读者参考：

1  跟踪一个变量的的值来源或计算方法。这是管理软件常常遇到的一项问题，追踪一个字段的计算方法。对于事务脚本，需要借助于SQL Server Profiler这样的工具在跟踪值的变化，或是用字段名称来搜索相关的程序代码调用，如果是用领域模型，你常常只需要在计算的赋值方法处放一个断点，再启动调用器：

这幅图是简单的给TranCount属性设置了一个set断点，简单的动作包含了深刻的含义，调试状态下，所有给TranCount赋值的地方都会暂停以下以方便观察值的计算方法。

如果有安装Resharper插件，在变量名称上点击右键，选Find Usage，呈现如下的窗口：

有了这个功能，简单的情况下不必要调试源代码就可以知道变量的计算方法。这个方法在维护大型系统经常用到，也是面向对象编程良好可维护性的体现。

2 当字段值有发生改变时才产生SQL语句。事务脚本或是领域模式最终都是生成SQL语句发送到数据库引擎中执行。如果是事务脚本，直接写一个字段的更新语句，例子如下

public static void UpdatePendingDesignTaskForSubmitApproval(string connectionString, string refNo,decimal entryNo,string drawing)
       {
           string query = string.Format(" UPDATE PdmDesignTaskDetail SET Submited='Y',[Path]='{2}', [Drawing]='{2}',SubmitDate=GETDATE()  WHERE RefNo='{0}' AND EntryNo={1} ", refNo, entryNo, drawing);
           SqlHelper.ExecuteNonQuery(connectionString, query);
       }

这样的代码会随着参数个数不同而膨胀的非常糟糕。当我需要修改，增加SET部分的字段值更新，则会导致需要修改SQL语句和接口文件，维系起来相当麻烦。

对于领域模型，LLBL Gen Pro在生成UPDATE 更新语句时会检测字段值是否发生变化，若没有变化则不生成SQL SET部分的更新语句。

所以，无论界面上修改了几个控件，保存的代码永远是这样一句：

adapter.SaveEntity(InventoryMovement, true, false);

可维护性方面甩事务脚本几条街。

3 面向对象优点(封装，继承，多态)体现在基于对象关系映射的项目，给项目开发和维护带来了极大的便利。

LLBL Gen Pro的生成实体的特性：

提供一套验证框架：包含字段验证，实体验证，删除验证，保存验证，更新验证

验证类型的例子代码：

[Serializable]
    public partial class AccountValidator : ValidatorBase
    {
        // Add your own validation code between the two region markers below. You can also use a partial class and add your overrides in that partial class.
        // __LLBLGENPRO_USER_CODE_REGION_START ValidationCode
        public override void ValidateEntityBeforeDelete(IEntityCore involvedEntity)
        {
            base.ValidateEntityBeforeDelete(involvedEntity);

AccountEntity account = (AccountEntity)involvedEntity;
            RelationPredicateBucket filterBucket = new RelationPredicateBucket();
            filterBucket.PredicateExpression.Add(VoucherDetailFields.AcctNo == account.AcctNo);

IVoucherDetailManager voucherDetailManager = ClientProxyFactory.CreateProxyInstance<IVoucherDetailManager>();
            if (voucherDetailManager.IsVoucherDetailExist(Shared.CurrentUserSessionId, filterBucket))
                throw new EntityValidationException(account.AcctNo, "Cannot delete. Voucher entry for account exists");
        }

提供一套对象间关系的表达方法：对象之间的关联引用与主从关系很容易上手和处理，一切皆是对象。

主从表的查询关系写法例子，表示仓库单据下面的仓库进出明细，还有仓库进出明细下的批号和货格也同时引用到。

private IPrefetchPath2 DefaultPrefetchPath
       {
           get
           {
               IPrefetchPath2 prefetchPath = new PrefetchPath2((int)EntityType.InventoryMovementEntity);
               IPrefetchPathElement2 element = prefetchPath.Add(InventoryMovementEntity.PrefetchPathInventoryMovementDetails);
               element.SubPath.Add(InventoryMovementDetailEntity.PrefetchPathInventoryMovementBins);
               element = element.SubPath.Add(InventoryMovementDetailEntity.PrefetchPathInventoryMovementLots);
               element.SubPath.Add(InventoryMovementLotEntity.PrefetchPathInventoryMovementSerials);

return prefetchPath;
           }
       }

提供几套查询语法，方便数据查询。LLBL Gen Pro提供以下几种查询语法：

传统的写法，这种写法的通用性好，可直接用代码生成器生成。

InventoryMovementEntity inventoryMovement = new InventoryMovementEntity(refNo);
bool found = adapter.FetchEntity(inventoryMovement, prefetchPath, null, fieldList);

QuerySpec的写法：

query.OrderBy("FullName".Ascending());

LINQ 写法：

var trans = new Transaction(IsolationLevel.ReadCommitted, "SSTest");
var metaData = new LinqMetaData(trans);
var q = from c in metaData.Customers select c;

后两种写法很少用在实际开发中，经验不足。

总结LLBL Gen 开发框架提供的基础功能：

1  代码生成器(GUI或Console) ，当字段变化或是增减实体时，可重新生成实体定义。

2  验证框架，提供对象或对象的值的验证。

3  查询语法，可以面向对象的方式检索数据。

4  对象关系的表达。LLBL Gen Pro可以基于数据库的主从关系，生成对象之间的主从关联，方便操作数据。

一般的基于数据库表的实体代码生成器，无法实现或是灵活简单的实现后面3条，在代码开发速度和可维护性方面远远低于LLBL Gen Pro。