U9研发体系(COMMONCRUD使用手册)

U9研发(CommonCRUD使用手册)适用版本：U9 V1.5 UBF2.0修改状态：编写人： 熊悦阅审核人： 刘小东此部分要记录该文档形成过程中的历次版本变更过程及变更的内容版本 修改与修改时间 修改原因 修改内容 审批人 参与人1.0 熊悦阅 2008-7-8 原始文档建立 刘小东1.概述UFIDA CommonCRUD是一套标准的服务，为表示层提供公共的查询、创建、更新、删除操作。

2.构架原理2.1 CommonCRUD的主要功能CommonCRUD功能同名称一样，为前台提供了公共的创建、查询、更新、删除记录的服务。

CommonCURD一共提供了两个标准的U9服务（参见服务相关手册），使用UIModel为参数。

两个服务分别如下：函数声明 说明UIModelQuery（IUIModel） 查询数据UIModelUpdate（IUIModel） 创建，更新，删除数据CommonCRUD在业务应用中，起到重要的作用，简化了大量的代码，U9中70%以上的查询，创建，更新，删除行为，都使用CommonCRUD完成。

它是表示层与持久层的重要桥梁。

3. 使用指南3.1 UIModelQueryUIModelQuery提供数据查询的功能，它使用IUIModel作为参数，返回符合条件的IUIModel数据。

3.1.1 UIModelQuery的调用方法//创建UIModelQuery代理UIModelQueryProxy queryBp = new UIModelQueryProxy();//设置传入参数queryBp.Model = model;//执行查询操作并接受返回值IUIModel result = queryBp.Do();3.1.2传入参数传入参数只有IUIModel对象，UIModelQuery将使用IUIModel中的一些属性，进行数据查询操作，属性如下：属性 功能说明View.ViewDealFlag 只能ViewDealFlag为CommonDealFlag.Load的才加载数据，加载关联数据时，不受此影响。

View.QueryGlobalizationOption 语种信息。

语种信息包括2种选项，1.Auto，只加载当前上下文的语种2.Manual，加载所有语种View.IUIFieldCollection 通过View.IUIFieldCollection产生查询的Select子句 View.SelectOQLString 如果设置了SelectOQLString属性，将替换IUIFieldCollection产生的Select子句View.CurrentFilter 过滤条件，产生Where子句View.EntityFullName 查询的Entity对象，控制From子句View.FromOQLString 如果设置了FromOQLString属性，将替换View.EntityFullName产生的From子句View.PageStrategy.IsUsing 是否进行分页查询，当View.IsMain为True时，View.PageStrategy.IsUsing总是为TrueView.PageStrategy.CurrentPageIndex 当前的页号，控制加载第几页数据View.PageStrategy.PageSize 每页记录的条数3.1.3使用示例示例场景：有一个叫DepartmentUIModel的UIModel，其中包括两个UIView，分别为Department和Person，对应实体DepartmentBE和PersonBE。

视图的关键属性如下：Department的属性ViewDealFlag CommonDealFlag.LoadQueryGlobalizationOption AutoIUIFieldCollection ID, Name,DeptTypeSelectOQLStringCurrentFilterEntityFullName DepartmentBEFromOQLStringPageStrategy.IsUsing TruePageStrategy.CurrentPageIndex 1PageStrategy.PageSize 20IsMain TrueViewName DeptPerson的属性ViewDealFlag CommonDealFlag.Load QueryGlobalizationOption AutoIUIFieldCollection ID, Name,DeptID SelectOQLStringCurrentFilterEntityFullName PersonBEFromOQLStringPageStrategy.IsUsing FalsePageStrategy.CurrentPageIndex 1PageStrategy.PageSize 20IsMain FalseViewName PersonDepartment和Person构架1：N的组合关系示例1：加载Department和Person的数据//创建UIModelQuery代理UIModelQueryProxy queryBp = new UIModelQueryProxy();//设置传入参数queryBp.Model = model;//执行查询操作并接受返回值IUIModel result = queryBp.Do();将会加Department第一页的数据和相应的所有Person的记录 示例2：设置过滤条件UIModel.View[“Dept”].CurrentFilter.OPath=”Name = ‘开发部’”; //创建UIModelQuery代理UIModelQueryProxy queryBp = new UIModelQueryProxy();//设置传入参数queryBp.Model = model;//执行查询操作并接受返回值IUIModel result = queryBp.Do();将会加载Department中开发部的数据和开发部所有Person的记录示例3：综合过滤条件UIModel.View[“Dept”].CurrentFilter.OPath=”Name = ‘开发部’”;UIModel.View[“Person”].CurrentFilter.OPath = “Name like ’王%’”;//创建UIModelQuery代理UIModelQueryProxy queryBp = new UIModelQueryProxy();//设置传入参数queryBp.Model = model;//执行查询操作并接受返回值IUIModel result = queryBp.Do();将会加载Department中开发部的数据和开发部所有姓王的Person的记录示例4：使用上下文进行查询UIModel.View[“Person”].CurrentFilter.OPath = “Name = #erName#”;//创建UIModelQuery代理UIModelQueryProxy queryBp = new UIModelQueryProxy();//设置传入参数queryBp.Model = model;//执行查询操作并接受返回值IUIModel result = queryBp.Do();将会加载Department中第一页的数据和与当前登陆用户姓名相同的Person的记录示例5：查询每个部门的员工数//这个例子中需要对查询的Select和Where部分进行自定义//自定义Select 部份UIModel.View[“Dept”].SelectOQLString = “max(ID),Name, count(ID) “;//自定义Where部份UIModel.View[“Dept”].CurrentFilter.OPath = “ group by Name “;//设置不加载Person的数据，因为我们在这个例子中不需要PersonUIModel.View[“Person”].CurrentFilter.OPath = “1=2”;//创建UIModelQuery代理UIModelQueryProxy queryBp = new UIModelQueryProxy();//设置传入参数queryBp.Model = model;//执行查询操作并接受返回值IUIModel result = queryBp.Do();这个例子执行时，会产生一句如下的OQLselect max(ID) as ID,Name, count(ID) as DeptType from departmentBE group by Name 实现我们加载数据的目的。

注意一个细节，我们把统计的员工数加载到了DeptType字段中，更好的实现方法是新建一个叫PersonCount或其它的字段。

3.2UIModelUpdateUIModelUpdate为UIModel提供创建，更新，删除操作。

它根据记录的状态（Record.State）的值进行相应的操作，详细信息请参见UIModel手册中记录状态一节。

3.2.1 UIModelUpdate的调用方法//创建UIModelUpdate代理UIModelUpdateProxy updateBp = new UIModelUpdateProxy();//设置传入参数updateBp.Model = model;//执行更新操作并接受返回值IUIModel result = updateBp.Do();3.2.2创建记录当记录状态为New时，UIModelUpdate会创建一条相应的记录，如下：//创建新记录IEntity new = Entity.Create( view.EntityFullName,null);然后，对new对象进行赋值，将Record的值Copy到new 中，最后调用持久层Session 对象的Commit方法保存。

获得一条新增状态的Record，通常调用View.NewUIRecord方法，如下：//创建新记录IUIRecord new = View.NewUIRecord()；示例6：创建Dept//建立一条新的记录IUIRecord newDept = model.Views[“Dept”].NewUIRecord();//赋值操作newDept[“Name”] = “设计部”;newDept[“DeptType”] = DeptType.Normal;//此时newDept的ID为负数，State为New//将newDept加入model的Record集合中。