EAS_BOS架构_模型与架构_WebService使用指南.pdfVIP

WebService 使用指南 1. BOS Web Service 的范围 BOS Web Service 主要实现了将实体和 Façade发布为标准的 WebService 提供给不同的客户端调用。 目前只支持将实体和Façade两种对象发布为WebService。 BOS Web Service 的发布流程如下： 2. 在 BOS Studio 中发布Web Service 2.1. 发布 WebService 运行 BOS Studio，打开“包分类”视图，在其中选中要发布WebService 的实体或 Façade对象（可 同时选中多个），点击鼠标右键，在弹出菜单中选择“发布WebService”,将弹出“发布 WebService”向 导： 选择实体或 Façade对象下要发布的方法，手工输入或者点击“浏览”按钮来指定发布生成代码存放 的目录，可以同时勾中“追加到配置文件”。这样 BOS Studio 将会根据选中的对象和要发布的方法生成 WebService 代码。 2.2. 编辑 WebService 配置文件 在“包分类”视图中，选择要编辑其配置文件的解决方案，点击工具栏上的“编辑 WebService 配置 文件”按钮 ，将会弹出配置文件编辑向导： 在其间，可以增加或删除要发布的对象（方法），选择好要发布的对象（方法）后，点击“完成”按 钮，即可完成对配置文件的编辑。配置文件位于解决方案的根目录下。 3. 日构建自动发布WebService 在 编 辑 好 WebServiceDeploy.xml 文 件 的 提 前 下 ， 在 日 构 建 的 Ant 脚 本 中 调 用 com.kingdee.bos.tool.Generator 类的 main 方法即可自动发布 WebService，其参数有两种：1）传入一 个参数”-h”或”-help” (不区分大小写)；2)传入四个参数 (配置文件 WebServiceDeploy.xml 所在目录 全路径名, 需要产生 WebService 的元数据目录全路径名, 放置生成的相关 Java 文件的目录全路径名放 置 生 成 的 相 关 WSDL 文 件 的 目 录 全 路 径 名 ) 。 对 于 第 一 种 参 数 ， 将 得 到 com.kingdee.bos.tool.Generator.main(String[])方法的详细用法。对于第二种参数，将根据指定的配 置文件和元数据生成 WebService 相关的 Java 代码与配置文件。 4. WebServiceDeploy.xml 文件格式 WebServiceDeploy.xml 文件的格式如下定义，其中 “[”与“]”之间的字符需根据实际需要而适当更改。 <?xml version="1.0" encoding="UTF-8"?> <deployObjects> <deployObject> <type>[entity或 Façade]</type> <name>[ 实体或 Façade 名称]</name> <package>[ 实体或 Façade 的包名]</package> <deployMethods> <deployMethod id="[ 要发布成 WebService 的方法 InnerID]" /> <deployMethod id="[ 要发布成 WebService 的方法 InnerID]" /> …….. </deployMethods> </deployObject> <deployObjects> 5. Web Service 部署方式 5.1. 相关依赖 BOS Web Service 的部署依赖 Apache 的 axis 第三方组件，此组件经过 BOS 的封装，可以从 BOSWEBService 项目中下载 webapp 目录进行部署。 5.2. 部署步骤 发布出来的 Web Service 可以部署在标准的 J2EE 容器中，下面以 Apusic3.1 为例说明 Web Service 的部署步骤。其他WEB 容