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主界面如下图所示:

image

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这样的工具在跟踪值的变化,或是用字段名称来搜索相关的程序代码调用,如果是用领域模型,你常常只需要在计算的赋值方法处放一个断点,再启动调用器:

image

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

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

image

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

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。

原文地址:https://www.cnblogs.com/JamesLi2015/p/4615057.html