金蝶EASBOS开发学习笔记

1、.金蝶EAS BOS开发学习笔记环境准备先把需要用到的透视图和相应的视图打开,在后面的练习中需要用到。导入eas包后的结构如上图所示。BOS透视图下常用到的窗口如上图所示,这些必须打开。项目属性配置如下图所示：下面是Java透视图中的配置。EAS 项目的配置数据中心配置调试Config需要用到的热键CTRL+SHIFT+R打开资源CTRL+SHIFT+T打开类型制作第一个列表查询界面打开金蝶BOS设计开发工具透视图打开 eas/metadata/com/kingdee/eas/demo 节点说明：app目录下一般存放实体、表、查询等元数据；Client目录下一般存放ui,即界面数据；其他公共对

2、象,如枚举、异常等通常放在与app、client同级目录中。右击XueLi.entity,在弹出菜单中选择实体导出表,保留默认值,名称为T_DE_XueLi打开T_DE_XueLi.table,修改主键名称,避免因为重名导致建表错误右击T_DE_XueLi.table,选择导出.,在弹出窗口中选择导出数据表打开管理控制台,在数据中心选择使用的数据中心,再打开数据库管理,把生成的CreateTable.sql中的内容COPY进去,点击工具栏的执行,最后提交。在app文件夹下新建查询XueLiQuery,实体选择XueLi.entity打开查询XueLiQuery,选择字段标签页,选择导入,将要查

3、询的字段添加进来,并调整各字段顺序。还应该在其它页中定义排序和主键字段。在client文件夹下新建UI,父对象选择com.kingdee.eas.framework.client.ListUI,BO对象选择XueLiQuery.query,其他用默认值即可。单击鼠标右键,在弹出菜单中选择编辑表信息,选择ID列,把hide属性值修改为true,以隐藏不希望在列表中显示的列。注意：ID列不管是否需要显示,必须要存在于列表中,否则会出现后文所述的错误。发布列表界面,查看效果建立Java发布目录：D:gmis310_srcdemodevsrc选择包的根节点eas,右键选择属性,在弹出窗口中选择Solu

4、tion发布方案信息,新增一个发布方案,命名为demoJava发布目录输入前面建立的目录,J2EE发布目录及元数据发布目录输入与其他发布方案相同的目录 W:apusicmetas选择app目录下XueLi.entity,单击右键,选择发布；发布方案选择demo,完成后察看校验信息视图,发现有错误提示,直接双击,打开错误在逻辑键信息中增加CoreBase.id,保存清除校验信息视图中的内容,再点击工具栏上的清除元数据缓存,否则有可能会导致再次发布失败再次发布XueLi.entity,成功。选择demo文件夹,右键,选择发布,将前面建立的所有元数据.table,.entity,.query,.ui

5、全部选中,再次进行发布。切换到Java透视图。选择bs_dio节点,单击鼠标右键,刷新,让新建立的demo文件夹显示出来。选择bs_dio节点,单击鼠标右键,构建路径-配置构建路径,将demo/dev/src添加进来,在自动构建完成之后,可以在 D:gmis310_srcbincomkingdeeeasdemo 看到编译好了的class文件重新启动gmis_server服务器,然后用administrator用户登录保存后重新登录,进入系统后可以看到此菜单,但此时双击报错,查看控制台日志,可知是有抽象类方法没有实现在Java透视图中打开XueLiListUI.java文件,此时可以看到有错误提

6、示,点击鼠标,自动实现接口类的框架代码。此时可以看到项目已经不再报错了。进入系统后,发现点击新增按钮时报错。按CTRL+SHIFT+T,查找DiplomaListUI,打开DiplomaListUI.class文件这是系统中已有的学历窗体。在XueLiListUI.java中,参考DiplomaListUI实现getEditUIName和getBizInterface方法。protected ICoreBase getBizInterface throws Exception return XueLiFactory.getRemoteInstance;protected String getE

7、ditUIName return com.kingdee.eas.basedata.hraux.client.DiplomaEditUI;至此,列表UI已可正常执行,但新增界面调用的是系统原有的DiplomaEditUI。接下来再实现我们自己的EditUI。制作对应的编辑界面切换到BOS设计视图,在Client下新建UI,命名为XueLiEditUI,父对象为com.kingdee.eas.framework.client.EditUI编辑界面,BO对象选择XueLi.entity,绑定控件时只保留需要用户输入的控件。发布此UI,发布方案选择demo切换到Java透视图,刷新 /bs_dio/

8、demo/dev/src 目录,让新加的UI出现在树中,此时会自动构建,提示有错误打开 XueLiEditUI.java,查看错误信息,发现是有未实现的抽象方法,生成它打开DiplomaEditUI的JAVA类,将createNewData和getBizInterface方法的代码COPY到XueLiEditUI.java中,并做相应修改。重新运行代码,可以看到现在已可以调出新做的编辑窗口,增加二条数据,可以成功保存。返回到ListUI,点击各条记录时,发现提示没有定义正确的keyField,请重载getKeyFileedNmae方法。如果前面步骤严格按照截图中操作,则不会出现此错误,因此不需

9、要后面的这几步经比较,发现在查询对象中没有定义主键ID。因此,打开XueLiQuery.query,在字段页中增加id字段,在其它页中增加id字段的主键定义。问题还不在这里。打开XueLiListUI,重新绑定XueLiQuery.query,把ID列加入到表格中,然后设置此列为隐藏。保存后重新发布,再在java视图中刷新,重新构造应用。重启Server,然后起动应用,测试成功。需要注意的问题关于发布的问题只要是更改了app下的对象,一定要重新发布。由于app的发布目录是在W:apusicmetascomkingdeeeasdemoapp目录下,这是服务器的目录,因此发布之后必须要重启服务器才

10、能生效。如果更改了client下的对象,由于只是在客户端的,因此发布后只需重启应用即可。关于查询时的过滤条件问题如下图所示,在查询时,过滤条件中没有可供选择的内容。解决方法是打开列表界面的查询对象,如上图所示,在扩展属性中加入通用查询条件即可。注意此扩展属性是针对每个字段进行设置的。EditUI中数据保存前,对数据进行合法性校验的问题通常有二种方法。一种是重载actionSubmit动作,在代码中进行处理。此种方法需要先在EditUI中生成Action事件,以便在发布后超类中有相应的虚方法,如此在继承类中才可以重载方法。publicvoid actionSubmit_actionPerform

11、ed throws Exception /名称是否可为空if txtName.getText = null | txtName.getText.trim.length = 0 MsgBox.showError;this.txtName.requestFocusInWindow;return; /编码是否为空if txtNumber.getText = null | txtNumber.getText.trim.length = 0 MsgBox.showError;this.txtNumber.requestFocusInWindow;return; super.actionSubmit_ac

12、tionPerformed; 此种方法较繁琐。另一种方法较简单。打开基类的EditUI.class,可以看到有verifyInput方法是空的,在保存之前基类会调用此方法。因此,只需要在继承类中重载实现此方法即可。在大多数情况下,推荐使用此种方法进行数据合法性校验。protectedvoid verifyInput throws Exception super.verifyInput;/名称是否可为空if txtName.getText = null | txtName.getText.trim.length = 0 MsgBox.showError;this.txtName.requestFocusInWindow;Sys