NC开发流程一览表说明.docx

1、NC开发流程一览表说明单表体的卡片型单据制作单表体的单据：指装载界面数据的聚合VO表头为空，只存在一组表体VO。UI工厂设计了接口ISingleController，单表体单据界面控制类应实现此接口，并实现isSingleDetail方法。前期准备：单据注册，模板初始化等等，在构造好类框架后要修改界面控制类。1. 注册单据类型2. 注册VO对象 如下：public String getBillVoName() Return new String;public String getPKField() Return “pk_sample”;public String getChildPKField

2、() Return “pk_sample”;注意此时的表头，表体的VO类一致。3是否走平台public int getBusinessActionType() R4.注册按钮public int getCardButtonAry() Return new int IBillButton.Query,IBillButton.Add, IBillButton.Edit, IBillButton.Line, IBillButton.Save, IBillButton.Cancel, IBillButton.Refresh,;最重要的一步，实现isSingleDetail方法。public Boole

3、an isSingleDetail()/单表体明细 /单表体 Return true;ISingleController用来支持单表头或单表体的单据，因此，当isSingleDetail方法返回true时，单据为单表体；当返回false时，单据为但表头。单表头的卡片型单据制作除了显示有很大差异外，单表头于单表体的唯一区别在于isSingleDetail方法的返回值。另外，在单表头界面增加浏览按钮和去掉行操作按钮。虚拟主子表的卡片型单据制作虚拟主子表单据:指的是那种数据来源于一张表，却根据（自定义的）特定规则虚拟主子表的结构，将一部分放到表头，剩下的字段放到表体的单据。它通常用于数据的分组，即把

4、数据根据（自定义的）特定字段的值进行分组。字段值相等的数据自然的被归为一类，然后，把特定字段放到表头显示，属于它的一组数据在表体列表显示，形成了标准主子表的结构。由于数据分组的特定规则取决于业务，因此UI工厂无法做缺省的实现。但加载数据库数据一般都在查询时完成，所以可以定制查询事件的行为，这需要为单据创建按钮事件处理器，并重载查询时基类调用的方法。加载数据的步骤如下：1 第一步，与前面的步骤一样，并配置好界面控制器类。2 在UI类重载按钮事件处理器类的方法，如下：Protected CardEventHandler createEventHandler() Return new SampleC

5、ardEventHandle(this.getUIControl();3. 构造按钮事件处理器类，重载onBoQuery方法。如下：Protected void onBoQuery() throws Exception UIDialog querydialog = getQueryUI(); If(querydialog.showModel()=(INormalQuery)querydialog; String strWhere=query.getWhereSql(); If(strWhere=null) strWhere=”1=1”; strWhere=”(”+strWhere+”) and

6、 (isnull(dr,0)=0)”; /将查询对话框条件加到整个查询条件后 If(getHeadCondition()!=null) strWhere=strWhere+”and”+getHeadCondition(); /查询数据表数据 SuperVO queryVos=getBusinessAction().queryHeadAllData( Class.forName(getUIController().getBillVoName()1), getUIController().getBillType(), strWhere)； /清空缓冲数据 getBUfferData().clear

7、(); if(queryVos=null|queryVos.length=0) getBillUI().setBillOperate(IBillOperate.OP_INIT); getBufferData().setCurrentRow(-1);else /根据规则将数据进行分组 AggregatedValueObject bills=createBillVOs(queryVos); getBillUI().setBillOperate(IBillOperate.OP_NOTEDIT); getBufferData().setCurrentRow(0);/*对一组VO数据进行分类*param

8、待分类的VO数据*return 分类的结果*/Private AggregatedValueObject/聚合值对象数据 createBillVOs(CircularlyAccessibleValueObjectvos)/循环获得值对象数组 if(vos=null|vos.length=0) return null; /按照年度，月度将数据分组HashMap tmpMap=Hashlize.hashlizeObjects(vos,new VOHashKeyAdapter(new String“vyear”,”vmonth”); AggregatedValueObject bills=new A

9、ggregatedValueObjecttmpMap.size(); Int i=0;Iterator it=tmpMap.keySet().iterator()For(;it.hasNext();i+) Object key=it.next();ArrayList al=(ArrayList)tmpMap.get(key);B/设置表头数据billi.setChildrenVO( (SuperVO).toArray(new SuperVO0);Return bills;对数据增，删，改的控制因为是虚拟主子表的数据结构，它在进行数据的操作时需要额外的控制。这个问题的本质是在将前台数据写回后台时

10、，需将前台的主子表结构还原为单表结构。1. 数据修改时的控制，这包括新增和编辑在编辑（行操作）完毕，点击保存按钮。程序会从界面取得被修改的数据，这些数据被标志成新增，删除，修改等状态，提交给后台处理。对于真正的主子表，表头数据和标题数据会分别存储到对应的表中，但对于虚拟主子表的单据，主表数据加上字表数据的一行才构成数据表中的一行记录。这个问题的解决方法如下：在获取界面VO时做控制，方法是重载UI类重载基类的getChangedVOFramUI方法：Public AggregateValueObject getChangeVOFromUI()Throws Exception Aggregated

11、ValueObject vo=super.getChangedVOFromUI(); If(vo!=null) /将聚合VO的主表设为空 Vo.setParentVO(null);Return vo;通过将聚合VO的主表舍为空，后台不会再处理主表的数据。在编辑时，将需要存储的主表数据放到字表中。这需要控制行操作的行为，方法是时间处理器重载基类的行操作方法：/*增行方法*/P Super.onBoLineAdd(); addDefaultData();/*粘贴行的方法*/Protected void onBoLinePaste() throws Exception Super.onBoLineP

12、aste();addDefaultData();/*插入行方法*/Protected void onBoLineIns() throws Exception super.onBoLineIns(); addDefaultData();/*将表头数据放到表体中*/Private void addDefaultData() throws Exception Int currentBodyrow=getBillCardPanelWrapper().getBillCardPanel().getBillTable().getSelectedRow();Object vyear=getBillCardPa

13、nelWrapper().getBillCardPanel().getHeadItem(“vyear”).getValue();getBillCardPanelWrapper().getBillCardPanel().setBodyValueAt(vyear,currentBodyrow,”vyear”);Object vmonth=getBillCardPanelWrapper().getBillCardPanel().getHeadItem(“vmonth”).getValue();getBillCardPanelWrapper().getBillCardPanel().setBodyVa

14、lueAt(vmonth,currentBodyrow,”vmonth”);可以看到，在每个意在更新数据的行操作方法中，都会调用将表头相关数据放到表体当前操作行的方法。控制保存后否再次查询数据库，以取得数据库最新数据。对于真正的主子表，在数据库更新数据后重新查询一下最新数据并向前台返回，是具有意义的，并且根据表头数据的主键即可获得表头数据和表体数据。而虚拟主子表，如前所述，数据的组织在UI端完成，后台没有足够的信息区查询和组织数据。因此，此时只能向前台返回当前的数据。UI工厂使用IRetCurrentDataAfterSave借口做此标志，如果UI类的getUserObject方法返回的对象实

15、现了此接口，则在保存后部重新读取数据库。我们加了一个RetCurrentDataAfterSaveImpl类，让它实现IRetCurrentDataAfterSave接口。如：Public Object getUserObject() Return new RetCurrentDataAfterSaveImpl();需要注意的是：从程序健壮性考虑，我们应该加一些前台校验类，依照前面介绍，我们创建前台校验类，并在单据类型中注册。3 对数据的删除控制这需要让事件处理器重载基类的onBoDelete方法，如：Protected void onBoDelete() throws Exception I

16、f(MessageDialog.showYesNoDlg( getBillUI(),”档案删除”，”是否确认删除该基本档案？”)！=UIDialog.ID_YES) return; AggregateValueObject modelVo=getBufferData().getCurrentVO(); /将聚合VO的表头设为空 modelVo.setParentVo(null); getBusinesssAction().delete( modelVo, getBillUI()._getDate().toString(), getBillUI.getUserObject(); getBuffe

17、rData().removeCurrentRow();if(getBufferData().getVOBufferSize()=0)getBillUI().setBillOperate(IBillOperate.OP_INIT);elsegetBillUI().setBillOperate(IBillOperate.OP_NOTEDIT);注：删除单据时，并不涉及到界面的数据，因此只需控制BillUIBuffer中的缓存的当前VO。多子表卡片型单据多子表单据在界面显示上通常是表头+多页签的表体，每一个页签代表一个子表。在UI工厂中，这种单据得到了抽象，主要从以下两个角度：1. 对UI显示界面的

18、抽象。多子表单据的UI类不使用BillCardUI做基类，而是继承与一个新的UI基类，MultiChildBillCardUI，它封装了多个页签的界面显示。2. 对VO数据的抽象。在NC应用中，主子表数据存储在 聚合VO中，它支持一个主表+一个子表的结构，但是，这种结构不适合于多子表的情况。因此，UI工厂设计了接口IExAggVO，需要装载多子表数据的聚合VO类，应该实现此接口，并实现它的关键方法。制作多子表单据的步骤定义多子表VO多子表Vo是聚合VO，同事又像一个装载多个字表数据的容器，因此它必然继承自AggregatedValueObject的类层次，又实现多子表VO的接口，IExAggV

19、O，具体如下：P /用来装载多子表数据的hashmap Private HashMap hmChildVOs=new HashMap(); /* *返回各个子表的编码 *必须与单据模板的页签编码对应 */ P Return new String“sample_table1”,”sample_table2”;/*返回各个子表的中文名称*创建日期：（01-3-20 17:36:56）*/P Return new String“字表一”，”字表二”；/*取得所有子表的所有VO对象*/Public CircularlyAccessibleValueObject getAllChildrenVO() A

20、rrayLIst all=new ArrayList(); For(int i=0;i0) dataHashTable.put(tableCodes0,AVOs);/将查询的数据子表一的数据放入hashtableIf(BVOs!=null&BVOs.length0)dataHashTable.put(tableCodes1,BVOs);/将查询的数据子表二的数据放入hashtable Return dataHashTable;5.定义单据UI类创建一个继承MultiChildBillCardUI类的单据UI类，并关联上先前创建的界面控制类，业务代理类：/*关联上界面控制类*/Protected

21、 ICardController createController() Return new SampleCardController();/*关联上业务代理类*/Protected BusinessDelegator createBusinessDelegator() Return new SampleCardDelegator();如何制作列表型单据列表型单据统一的界面基类是ListCardUI，统一的事件处理基类是ListEventHandler，统一的界面控制接口为IListController。对于数据表满足真正的主子表结构的单据，要开发单表头，单表体，多子表的单据非常简单，只是在类

22、的继承关系上有所不同，因此在制作列表型单据时，绝大部分过程都可以仿照卡片型单据的制作。标准的列表型单据和卡片型单据相比，不同之处是：列表型单据的控制器实现IListController接口，并且应该把按钮的设置实现在getListButtonAry方法中，如：Public int getListButtonAry() Return new int IBillButton.Query,IBillButton.Edit,IBillButton.Line,IBillButton.Save,IBillButton.Cancel,IBillButton.Refresh,;与多子表的卡片单据相比，有两个不

23、同：1. 多子表列表型单据的UI类继承自MultiChildlistUI类；2. 多子表列表型单据的界面控制类实现IListController接口。需要注意的是：列表型单据也应该创建自己的业务代理类，负责加载多页签的数据。单表头和单表体的列表型单据：因为列表界面的表头和表体都是由列表组成的，所以单表头和单表体对于列表型单据在界面显示上是一致的。UI工厂定义了ISingleController接口来指定单据时单表头还是单表体，因此，如果单据的界面控制类实现ISingleController接口，辅之以配套的单据模板，就可以实现单列表的界面。需要注意的是：1.列表型单据不支持新增，而卡片型单据可

24、以新增.2.就是列表型单据支持UI初始化时自动加载数据，而卡片型单据要初始化时自动加载，只能在构造函数中调用数据加载的方法。虚拟主子表的列表型单据：制作虚拟主子表的列表型单据，基本策略和办法还是和卡片型单据一样。因为列表型单据在UI初始化时可以调用加载单据数据的方法。BillListUI初始化时调用initBillData方法加载单据数据因此我们在UI子类重载此方法：/*初始化时加载单据数据*/Protected void initBillData(String strWhere)throws Exception If(strWhere=null) strWhere=”1=1”;strWher

25、e = “(“+strWhere+”)and(isnull(dr,0)=0)”;SuperVO queryVos= getBusiDelegator().queryHeadAllData(Class.forName(getUIControl().getBillVoName()1),getUIControl().getBillTye(),strWhere);/清空缓冲数据getBufferData().clear();if(queryVos=null|query.length=0) setBillOperate(IBillOPerate.OP_INIT); setListHeadData(queryVos); getBufferData().setCurrentRow(-1);else /将VO数据分组 AggregatedValueObject bills=createBillVOs(queryVos); getBufferData().addVOsToBuffer(bills); /将表头数据加到表头的列表中 setListHeadData(getBufferData(