金蝶EAS_V81_WebService开发指南.doc

Webservice开发指南 版权声明 本书著作权属于金蝶软件(中国)有限公司所有，在未经本公司许可的情况下，任何单位或个人不得以任何方式对本书的部分或全部内容擅自进行增删，改编，节录，翻译，翻印，改写。 金蝶软件（中国）有限公司 2015年8月 BOSWebService 1.1. BOSWebService原理 2 1.2. 发布WebService的约束 3 1.3. BOSWebService发布 3 1.3.1. 发布流程 3 1.3.2. 发布WebService 3 1.3.3. 编辑WebService配置文件 4 1.4. BOSWebService部署 5 1.4.1. 建立web工程 5 1.4.2. 部署发布文件 5 1.4.3. 测试是否正确 6 1.4.4. Web工程目录及文件截图 6 1.5. 客户端代码 6 1.5.1. 获取wsdl服务描述文件 6 1.5.2. 下载工具 7 1.5.3. 建立一个新工程 7 1.5.4. 使用java客户端 11 1.5.5. importVoucher（凭证引入 12 1.6. BOS webservice 安全性 13 1.6.1. BOS webservice 安全性概述 13 1.6.2. 不启用安全性 13 1.6.3. 启用安全性 13 1.6.4. 如何安全性启用 14 1.7. EASLogin 登陆webservice 说明 14 1.7.1. EASLogin 接口说明 14 1.7.2. EASLogin 异常说明 15 1.7.3. EASLogin 和前面版本的差别 16 1.8. webservice 异常查看 16 2. WebService 客户端开发指南 17 2.1. 前提条件 17 2.2. 获取WSDL文件 17 2.3. 生成客户端 18 2.3.1. 生成Java客户端 18 2.3.2. 建立一个新工程 18 2.3.3. 将获取到的WSDL文件拷贝到工程的根目录下： 19 2.3.4. 生成客户端 19 2.4. 使用java客户端 23 2.5. 生成C# 客户端 23 2.5.1. 使用命令行 23 2.5.2. 运行命令生成客户端 24 2.5.3. 使用客户端代码 25 3. webservice FAQ 27 3.1. 在EAS 上如何发布一个webservice ? 27 3.2. 如何调用一个 webservice？ 27 3.3. 有哪些工具能够简单的测试 webservice？ 27 3.4. EASLogin 服务登陆如何判断失败 27 3.5. 调用webservice时报 com.kingdee.bos.IllegalSessionStateException: Please login first 异常？ 27 3.6. EAS6.0调用webservice时报没有 WSConfig.getSrvURL() 方法。 28 3.7. 调用webservice时报.SocketTimeoutException: Read timed out 异常 28 BOSWebService BOSWebService原理 Webservice 主要由SOAP，WSDL, 以及UDDI 等几块技术组成，以XML格式进行数据的传输。是建立可互操作的分布式应用程序的新平台 Webservice的一个最基本的目的就是提供在各个不同平台的不同应用系统的协同工作能力。使各个异构系统之间实现无缝交互。在本质上是要为应用程序之间提供数据通讯的标准，为企业应用之间动态地提供大颗粒度的服务，并不适合于非常精细的基于会话的方法调 用以及复杂的事务（transaction）处理之中。 发布WebService的约束 在BOS Studio中发布webService时，只能发布Entity和Fa?ade两种元数据类型成WebService服务端的代码。 由于Entity或Fa?ade函数参数和返回值可能包含很多复杂的业务类型，在发布时会生成许多辅助类，一些复杂类型在其他异构系统中生成webService客户端时不能很好的 支持，因此建议在建立webService功能时，最好使用Fa?ade，并且提供简单类型的输入和返回参数。 BOSWebService发布 发布流程 先建立需要发布的Fa?ade,建立粗粒度的业务方法，业务方法尽可能提供简单数据类型的数据参数和返回参数。 发布WebService 运行BOS Studio，打开“包分类”视图，在其中选中要发布WebService的实体或Fa?ade