金蝶EAS BOS开发学习笔记.docx

金蝶EAS BOS开发学习笔记一 环境准备先把需要用到的透视图和相应的视图打开，在后面的练习中需要用到。导入eas包后的结构如上图所示。BOS透视图下常用到的窗口如上图所示，这些必须打开。项目属性配置如下图所示：下面是Java透视图中的配置。 EAS 项目的配置数据中心配置调试Config二 需要用到的热键CTRL+SHIFT+R打开资源CTRL+SHIFT+T打开类型三 制作第一个列表查询界面打开“金蝶BOS设计开发工具”透视图1. 打开 eas/metadata/com/kingdee/eas/demo 节点说明：app目录下一般存放实体、表、查询等元数据；Client目录下一般存放ui，即界面数据；其他公共对象，如枚举、异常等通常放在与app、client同级目录中。2. 在app文件夹下新建实体XueLi(学历)，父实体选择 com.kingdee.eas.framework.app.DataBase3. 右击XueLi.entity，在弹出菜单中选择“实体导出表”,保留默认值，名称为T_DE_XueLi4. 打开T_DE_XueLi.table，修改主键名称，避免因为重名导致建表错误5. 右击T_DE_XueLi.table，选择“导出.”，在弹出窗口中选择“导出数据表”6. 打开管理控制台，在“数据中心”选择使用的数据中心，再打开“数据库管理”,把生成的CreateTable.sql中的内容COPY进去，点击工具栏的“执行(F5)”，最后“提交”。7. 在app文件夹下新建查询XueLiQuery,实体选择XueLi.entity8. 打开查询XueLiQuery,选择字段标签页，选择“导入”，将要查询的字段添加进来，并调整各字段顺序。还应该在“其它”页中定义排序和主键字段。9. 在client文件夹下新建UI，父对象选择com.kingdee.eas.framework.client.ListUI(列表界面)，BO对象选择XueLiQuery.query，其他用默认值即可。(W:apusicmetas)10. 单击鼠标右键，在弹出菜单中选择“编辑表信息”，选择ID列，把hide属性值修改为true，以隐藏不希望在列表中显示的列。注意：ID列不管是否需要显示，必须要存在于列表中，否则会出现后文所述的错误。四 发布列表界面，查看效果1. 建立Java发布目录：D:gmis310_srcdemodevsrc2. 选择包的根节点eas，右键选择属性，在弹出窗口中选择Solution发布方案信息，新增一个发布方案,命名为demo3. Java发布目录输入前面建立的目录，J2EE发布目录及元数据发布目录输入与其他发布方案相同的目录 W:apusicmetas4. 选择app目录下XueLi.entity，单击右键，选择发布；发布方案选择demo，完成后察看“校验信息”视图，发现有错误提示，直接双击，打开错误 5. 在逻辑键信息中增加CoreBase.id，保存6. 清除校验信息视图中的内容，再点击工具栏上的“清除元数据缓存”，否则有可能会导致再次发布失败 7. 再次发布XueLi.entity，成功。8. 选择demo文件夹，右键，选择“发布”,将前面建立的所有元数据（.table,.entity,.query,.ui）全部选中，再次进行发布。9. 切换到Java透视图。10. 选择bs_dio节点，单击鼠标右键，刷新，让新建立的demo文件夹显示出来。11. 选择bs_dio节点，单击鼠标右键，“构建路径”-“配置构建路径”，将demo/dev/src添加进来，在自动构建完成之后，可以在 D:gmis310_srcbincomkingdeeeasdemo 看到编译好了的class文件12. 重新启动gmis_server服务器，然后用administrator用户登录13. 打开“系统-客户化菜单编辑”，新增菜单，UI对象为com.kingdee.eas.demo.client.XueLiListUI14. 保存后重新登录，进入系统后可以看到此菜单，但此时双击报错，查看控制台日志，可知是有抽象类方法没有实现15. 在Java透视图中打开XueLiListUI.java文件,此时可以看到有错误提示，点击鼠标，自动实现接口类的框架代码。此时可以看到项目已经不再报错了。进入系统后，发现点击“新增”按钮时报错。16. 按CTRL+SHIFT+T,查找DiplomaListUI，打开DiplomaListUI.class文件（这是系统中已有的学历窗体）。17. 在XueLiListUI.java中，参考DiplomaListUI实现getEditUIName和getBizInterface方法。protected ICoreBase getBizInterface() throws Exception return XueLiFactory.getRemoteInstance();protected String getEditUIName() return com.kingdee.eas.basedata.hraux.client.DiplomaEditUI;至此，列表UI已可正常执行，但新增界面调用的是系统原有的DiplomaEditUI。接下来再实现我们自己的EditUI。五 制作对应的编辑界面1. 切换到BOS设计视图，在Client下新建UI，命名为XueLiEditUI，父对象为com.kingdee.eas.framework.client.EditUI（编辑界面），BO对象选择XueLi.entity，绑定控件时只保留需要用户输入的控件。2. 发布此UI，发布方案选择demo3. 切换到Java透视图，刷新 /bs_dio/demo/dev/src 目录，让新加的UI出现在树中，此时会自动构建，提示有错误4. 打开 XueLiEditUI.java，查看错误信息，发现是有未实现的抽象方法，生成它5. 打开DiplomaEditUI的JAVA类，将createNewData和getBizInterface方法的代码COPY到XueLiEditUI.java中，并做相应修改。6. 打开XueLiListUI.java，修改getEditUIName方法，返回值改成 com.kingdee.eas.demo.client.XueLiEditUI7. 重新运行代码，可以看到现在已可以调出新做的编辑窗口，增加二条数据，可以成功保存。8. 返回到ListUI，点击各条记录时，发现提示没有定义正确的keyField，请重载getKeyFileedNmae()方法。（如果前面步骤严格按照截图中操作，则不会出现此错误，因此不需要后面的这几步）9. 经比较，发现在查询对象中没有定义主键ID。因此，打开XueLiQuery.query，在字段页中增加id字段，在其它页中增加id字段的主键定义。10. 问题还不在这里。打开XueLiListUI，重新绑定XueLiQuery.query，把ID列加入到表格中，然后设置此列为隐藏。11. 保存后重新发布，再在java视图中刷新，重新构造应用。12. 重启Server，然后起动应用，测试成功。六 需要注意的问题1. 关于发布的问题只要是更改了app下的对象，一定要重新发布。由于app的发布目录是在W:apusicmetascomkingdeeeasdemoapp目录下，这是服务器的目录，因此发布之后必须要重启服务器才能生效。如果更改了client下的对象，由于只是在客户端的，因此发布后只需重启应用即可。2. 关于查询时的过滤条件问题如下图所示，在查询时，过滤条件中没有可供选择的内容。解决方法是打开列表界面的查询对象，如上图所示，在扩展属性中加入通用查询条件即可。注意此扩展属性是针对每个字段进行设置的。3. EditUI中数据保存前，对数据进行合法性校验的问题通常有二种方法。一种是重载actionSubmit动作，在代码中进行处理。此种方法需要先在EditUI中生成Action事件，以便在发布后超类中有相应的虚方法，如此在继承类中才可以重载方法。 public void actionSubmit_actionPerformed(ActionEvent e) throws Exception /名称是否可为空if (txtName.getText() = null | txtName.getText().trim().length() = 0) MsgBox.showError(this, 请输入名称！);this.txtName.requestFocusInWindow();return; /编码是否为空if (txtNumber.getText() = null | txtNumber.getText().trim().length() = 0) MsgBox.showError(this, 请输入编码！);this.txtNumber.requestFocusInWindow();return; super.actionSubmit_actionPerformed(e); 此种方法较繁琐。另一种方法较简单。打开基类的EditUI.class，可以看到有verifyInput方法是空的，在保存之前基类会调用此方法。因此，只需要在继承类中重载实现此方法即可。在大多数情况下，推荐使用此种方法进行数据合法性校验。protected void verifyInput(ActionEvent e) throws Exception super.verifyInput(e); /名称是否可为空if (txtName.getText() = null | txtName.getText().trim().length() = 0) MsgBox.showError(this, 请输入名称！);this.txtName.requestFocusInWindow();SysUtil.abort(); /编码是否