1、金蝶 BOS 快速开发指南Web 开发平台目录1. 概述 .31.1. 简介 31.2. 产品功能 31.3. 产品特性 31.4. 定义、首字母缩写词和缩略语 31.5. 参考资料 32. 开发过程 .42.1. 概述 42.2. 环境准备 42.2.1. 开发工具 42.2.2. JDK 约束 .42.3. 开发规约 42.4. WEB 单据开发 52.4.1. WEB 单据开发过程 52.4.2. 框架内置服务 202.4.3. WEB 主菜单管理 212.4.4. 功能服务 222.4.5. 权限服务 222.4.6. 编码规则服务 232.4.7. 套打服务 242.4.8. 日志服
2、务 252.4.9. 工作流服务 262.4.10. 单据转换 282.4.10.1. 概述 282.4.10.3.单据关联生成 282.4.11.字段权限服务 292.4.11.1.设置支持字段权限 292.4.11.2.启用字段权限 292.4.11.3. 设置字段权限 302.4.11.4. 字段权限 302.5. 集成 EAS 门户 .302.5.1. 编制 jsp 页面 .302.5.2. 配置 portlet 模板信息 .312.5.3. Portlet 业务配置信息设置 312.5.4. Portlet 基础定义设置 312.5.5. 页签配置 323. 技术特性 .333.1.
3、 编程模型 333.1.1. AOM 333.1.2. 数据校验 333.1.3. 数据绑定 343.1.4. Ajax 技术 .353.1.5. 拦截器 363.1.6. 对象注入 403.1.7. Winlet.413.1.8. 多语言处理 453.1.9. 多色彩方案 463.1.10. 应用上下文 473.1.11. 登录认证 483.1.12. 异常处理 493.2. 部署模型 501. 概述1.1. 简介Web 开发平台的核心职能类似 GUI 框架，是 EAS Web 产品开发的基础平台，跟 GUI 应用框架共用 EAS Web 服务端组件，协同 BOS 框架和业务模型(BIM)
4、实现模型驱动架构(MDA)。它提供统一的业务开发模型，简化开发逻辑，形成一致的开发模式，最大限度实现代码的重用机制。Web 开发平台作为业务逻辑的核心支撑平台，主要负责以下控制： UI 处理流程管理，如页面打开展现等； UI 通用处理，如 RPC 交互、数据绑定、异常处理、通用查询等； 业务服务调用，如权限控制、BOTP、工作流等。Web 开发平台与 EAS BOS 平台的关系： Web 开发平台是金蝶 BOS 平台的一个组成部分； 跟 GUI 共用一套元数据模型和设计工具； 跟 GUI 共用一个应用服务器； 基于更先进的技术特性，如动态注入、IoVC 、约定优先于配置等。1.2. 产品功能W
5、eb 开发平台提供了业务开发的基类体系和界面模板库，以及集成了单点登录认证、权限管理、套打、BOTP、工作流、编码规则、网络互斥、日志及色彩方案等基本服务。1.3. 产品特性 与 GUI 应用开发一致，减少学习成本 支持业务建模与典型界面向导，快速开发业务单据 提供 GUI 界面转换 Web 界面工具，快速完成 Web 应用迁移 内嵌 Apusic Web 服务器，便于开发和测试 支持热替换，发布元数据和修改代码不需要重启服务器 Web 开发平台本身集成功能定义、工具栏、权限、日志、主菜单等功能，让业务开发的功能很容易使用这些通用服务进行协同工作，让业务功能集成和部署更加方便、轻松。1.4.
6、定义、首字母缩写词和缩略语 AOM：Apusic OperaMask，金蝶中间件公司的 Web 开发框架 AAS：Apusic Application Server：金蝶中间件公司的 J2EE 应用服务器产品 Ext JS：一套基于 Java Script 的浏览器端 UI 组件库1.5. 参考资料 张留欢， Waf 使用指南及规范.doc2008-6 陈乐辉， Waf 开发指南.doc ，2008-8 李大伟，贺鹏辉web 开发帮助文档.doc2008-10 张留欢， 金蝶 BOS Web 开发平台.ppt ，2008-11 EAS BOS V6.2Web 设计器用户使用指南.doc2. 开
7、发过程2.1. 概述基于 Web 开发平台开发业务系统，也是一个模型驱动的开发过程，下面以协同办公的费用报销系统为案例作为基础，实现从费用申请开始，到费用报销结束的一个业务过程，来介绍如何基于 Web 开发平台来做业务系统开发。2.2. 环境准备2.2.1. 开发工具下载地址：http:/www.operamasks.org/download/aom_downloadApusic：http:/Apusic Studio：http:/Operamasks：http:/www.operamasks.org/dist/aom_eas/Operamasks Demos：http:/www.operam
8、asks.org/dist/aom-demos/，其中 rcdemos 是AOM 比较全面的控件示例，开发过程中必不可少的宝典之一。Web 设计器:BOS Studio 的一部分，请安装 bos6.2 及以后版本的 Bos Studio 即可.Ext： http:/ 控件: http:/ JDK 约束目前 Waf 必须基于 jdk1.5 及以上版本，所以开发时，必须先安装 jdk1.5， ，在 apusic工程使用编译时会报版本不一致的问题。因此不能 w:jdk，而应该使用W:easServerjdk，如果这个还是有问题，到 Sun 的网站下载一个 jdk1.5。注意：研发内网不能采用 w:j
9、dk，这个是被精简处理过的2.3. 开发规约Web 开发平台对于 view 页面和对应的 Bean 的映射，采用“约定优先于配置”的原则，因此在建立 Apusic 标准工程的时候需要指定默认命名空间。以协同业务系统为例子说明这样一个命名原则：假定业务系统包名为 com.kingdee.eas.cp.bc ，后台 web 目录为 eas_web.war ，开发单据 testBill。根据开发一个业务功能需要对应一个 View 页面和对应的后台 Managed Bean，那么相应的命名规范： View 页面规范view 页面取 com.kingdee.eas 之后的 cp.bc 报名生成目录.ea
10、s_web.warcpbctestBill.xhtml 对应的 Managed Bean 命名规范对应 com.kingdee.eas.cp.bc 之后添加 web 作为 bean 存放包名：testBill 对应的包名为 com.kingdee.eas.cp.bc.web；ManagedBean 对应的类名为：页面名称（首字母大写） + Bean；例如 testBill 对应的 ManagedBean 全名为：com.kingdee.eas.cp.bc.web.TestBillBean。 Managed Bean 别名规范别名的定义规范为：页面路径(路径分隔符号用.表示) + Managed
11、Bean 类名例如：testBill 对应的别名为：cp.bc.TestBillBean因此，最终开发 testBill 功能生成的文件为下面 2 个：cpbctestBill.xhtmlManagedBean(name=“cp.bc.TestBillBean“)com.kingdee.eas.cp.bc.web.TestBillBean2.4. WEB 单据开发2.4.1. WEB 单据开发过程2.4.1.1. 创建 WEB 单据1 在“业务单元”视图中，选择右键菜单，选择新建业务单元，如下图：2 弹出“创建业务单元”向导3 输入名称和别名。4 如下图选择“基础模板”和”客户端应用”注:目前
12、业务单据只支持多分录单据基础模板;基础资料单据只支持单级基础资料模板5 点击【下一步】,直到完成,即可创建一个 WEB 单据,含编辑界面和序时簿2.4.1.2. GUI 生成 WEB UI1. 选中 GUI 单据,右键【配置业务单元】2. 导入已存在的 WEB ui,或者选中自动生成,自动生成 WEB UI3. 点击确定,GUI 自动生成 WEB UI2.4.1.3. 调整布局2.4.1.4. 工具栏1 模板自动生成工具栏,如图：2 工具栏上的各个按钮与相应的 Action 绑定，其中 queryAction 实现了通用过滤3 在业务单元-菜单定义,可以根据业务需要自定义工具栏2.4.1.4
13、查询1 模板自动提供通用过滤2 如图3 设置“查询”按钮的 action 服务端事件，以便处理查询逻辑2.4.1.5.发布代码处理业务逻辑在“业务单元”视图中，选择需要发布代码的 Web 单据（可以多选） ，弹出右键菜单，选择发布业务单元进入代码发布向导。如下图2.4.1.6 后台逻辑(ManageBean) 实现序时簿界面后台一般从 ListBean 集成，列表界面的集成体系如下，列表界面（List Winlet）ManagedBean 从 ListBean 继承，请实现如下方法： getQueryPK() getEditBeanName() getEditUrl() getBizInter
14、face()1、 getQueryPK()要求返回查询当前列表数据结果的 Query PK，例如：Overrideprotected IMetaDataPK getQueryPK() return new MetaDataPK(“com.kingdee.eas.mydemo.app.PurReqQuery“);2、 getEditBeanName()要求返回列表对象对应的编辑界面的 ManagedBean 的名称，例如：Overrideprotected String getEditBeanName() return “mydemo.PurReqEditBean“;3、 getEditUrl(
15、)要求返回列表对象对应的编辑界面的 Url，例如：Overrideprotected String getEditUrl() return “/mydemo/purReqEdit.jsf“;4、 getBizInterface()类似编辑界面的同样接口实现。该业务接口的获取可以通过注入方式实现，例如：IBOSBizCtrlprivate IPurReq service;Overrideprotected ICoreBase getBizInterface() return service; 页面模板及组件模板 templates/list-templates.xhtml定义了列表界面的布局模板
16、，业务单据的列表界面视图从此模板继承，并提供相应的模板内容实现。如何使用模板，请参考 purOrderDemo 的相关 demo。组件 WEB-INF/components/billList-toolbar.xhtml封装了单据列表界面工具条部分的内容，提供了标准的操作按钮以及统一的 Action 绑定，相关业务使用此组件时只需设置组件的 beanName 属性即可。用法如下： WEB-INF/components/baseList-toolbar.xhtml封装了基础资料列表界面工具条部分的内容，提供了标准的操作按钮以及统一的Action 绑定，相关业务使用此组件时只需设置组件的 beanN
17、ame 属性即可。用法如下： WEB-INF/components/inner-window.xhtml封装了列表界面跟其他页面进行 Ajax 交互的载体，支持 UIWindow 的弹出框（适用于通用过滤等） ，也支持其他通过 javascript 脚本弹出的对话框或新窗口（例如编辑界面或 BOTP 转换界面等） 。组件内容大概如下：用法如下：编辑界面的继承体系如下：编辑界面（Edit Winlet）ManagedBean 从 EditBean 继承，请实现如下几个方法： createNewModel：新增业务对象 getBizInterface：业务操作接口可选实现： getSelector
18、s1、createNewModel例如以采购申请单为例子，实现大概如下：Overridepublic void createNewModel() model = new PurReqInfo();(PurReqInfo)model).setState(PurType.InPut);2、getBizInterface该业务接口的获取可以通过注入方式实现，例如：IBOSBizCtrlprivate IPurReq service;Overrideprotected ICoreBase getBizInterface() return service;说明：IBOSBizCtrl 标签 表示注入一个
19、 ICoreBase 的业务接口，上面代码中， IPurReq extends ICoreBase。运行时，框架会自动根据产品部署形态配置，构造相应的业务接口并返回。上面的代码相当于下面的：Overrideprotected ICoreBase getBizInterface() try service = com.kingdee.eas.mydemo.PurReqFactory.getLocalInstance(WafContext.getInstance().getContext(); catch (Exception e) / TODO Auto-generated catch bloc
20、ke.printStackTrace();return service;3、getSelectors获取所选单据VO属性，子类可覆盖实现。例如：protected SelectorItemCollection getSelectors() SelectorItemCollection col = new SelectorItemCollection();col.add(“*“);col.add(“creator.*“);col.add(“requestor.*“);col.add(“entries.*“);col.add(“entries.material.*“);col.add(“entri
21、es.measureUnit.*“);return col;除了上面两个必须实现的方法外，若单据含有分录，则需要在保存或提交之前对分录的VO 做处理，可根据代码生成的注释说明对 updateModel()补充实现。 页面模版和组件模板 templates/edit-templates.xhtml定义了编辑界面的布局模板，业务单据的编辑界面视图从此模板继承，并提供相应的模板内容实现。如何使用模板，请参考 purOrderDemo 的相关 demo。组件 WEB-INF/components/billEdit-actions.xhtml封装了编辑界面下方按钮部分的内容，提供了标准的操作按钮以及统一
22、的 Action 绑定，相关业务使用此组件时只需设置组件的 beanName 属性即可。用法如下： WEB-INF/components/ billEntry-actions.xhtml封装了分录的基本操作以及统一的 Action 绑定，相关业务使用此组件时只需设置组件的 beanName 属性即可。用法如下：“ WEB-INF/components/ billEdit-toolbar.xhtml封装了单据与其他单据相关常用功能的操作及Action绑定，例如上一个单据、下一个单据、单据转换等，相关业务使用此组件时只需设置组件的beanName属性即可。用法如下：2.4.2. 框架内置服务 We
23、b 主菜单管理在 Web 框架主菜单树中添加菜单项，指向 WebU 单据 功能定义功能与 WebUI 的 Action 进行绑定 权限定义权限项与实体方法、WebUI 的 Action 进行绑定 编码规则生成单据编码，在 WebUI 中显示 套打自动生成 WebUI 的套打格式 日志添加 WebUI 相关功能的日志项，对用户操作进行记录 工作流工作流节点能指定显示的 WebUI 单据转换与 GUI 一样，WebUI 可通过下推和上拉等功能使用单据转换 字段权限支持配置字段的修改权,查看权 网络互斥目前框架已经实现了数据互斥，避免避免同时修改同一张单据。 色彩方案目前支持蓝、绿、红、橙四种色彩方
24、案，默认蓝色；支持扩展（增加相应的色彩方案目录结构）2.4.3. WEB 主菜单管理1.BOS 工具 ,方案- 主菜单管理,设置业务单元级别的 WEB 菜单2.EAS,系统-客户化菜单编辑 ,菜单类型选择”WEB 菜单 ”,设置 WEB UI 级别的菜单2.4.4. 功能服务业务单元-功能定义,根据业务需要 ,增加自定义功能2.4.5. 权限服务方案-权限管理,设置 WEB 单据权限2.4.6. 编码规则服务2.4.6.1. 定义编码规则编码规则的定义需要注意相关规约：不允许断号和新增显示必须选择其中一个，如果都不选，表示该规则不起作用。 【新增显示】表示改规则在新增时就自动生成；【不允许断号
25、】表示新增时不用输入，而在保存和提交时自动产生然后框架自动保存到数据库。2.4.6.2. 应用编码规则Web 框架默认已经集成了编码规则服务，只要给单据定义了编码规则，在单据编辑界面提交就能应用编码规则服务。2.4.7. 套打服务2.4.7.1. 生成套打模板发布业务单元过程中,自动生成套打模板2.4.7.2. 套打2.4.8. 日志服务2.4.8.1. 定义日志方案-日志管理,定义 WEB 日志2.4.8.2. 日志2.4.9. 工作流服务2.4.9.1. 定义工作流在 BOS IDE 里对工作流进行流程配置。2.4.9.2. 提交工作流Web 框架默认已经集成了工作流服务，只要给单据定义了
26、工作流，在单据编辑界面提交就能应用工作流服务。2.4.9.3. 工作流审批 Web 审批处理界面： 节点流程图2.4.10. 单据转换2.4.10.1. 概述单据的生成有两种方式：手工录入和单据转换生成。单据转换指的是上游单据根据配置好的规则，自动转换生成下游单据。根据案例，上游单据费用申请单已经开发完成了，根据上面【序时簿开发】和【单据开发】的方法，可以完成案例的下游单据费用报销单的序时簿和单据开发。2.4.10.2 定义单据转换规则登录 GUI 系统平台中，可以定义相关单据的转换规则。2.4.10.3.单据关联生成在序时簿中点击【关联生成】按钮生成下游单据，也可以在下游单据编辑界面通过【上
27、拉】的操作生成单据并显示到当前页面。关联生成的单据可以通过单据上下联查查询出来。2.4.11.字段权限服务2.4.11.1.设置支持字段权限选中字段,属性: 是否支持字段权限 是2.4.11.2.启用字段权限EAS,打开用户管理,业务-字段权限设置 ,启用字段权限2.4.11.3. 设置字段权限EAS,打开用户管理,分配权限-字段授权,设置字段的查看权,修改权2.4.11.4. 字段权限销售员,显示无权限;销售组织 ,灰掉2.5. 集成 EAS 门户2.5.1. 编制 jsp 页面在目录 serverdeployeas.earcp_web.warhtmlportlet 新建一个目录，并在新建目录下创建一个 jsp 文件。
