金蝶EAS_V81_WebService开发指南

Webservice开发指南版权声明本书著作权属于金蝶软件(中国)有限公司所有，在未经本公司许可的情况下，任何单位或个人不得以任何方式对本书的部分或全部内容擅自进行增删，改编，节录，翻译，翻印，改写。金蝶软件（中国）有限公司2015年8月BOSWebService1.1.BOSWebService原理.....................................................41.2.发布WebService的约束.................................................51.3.BOSWebService发布.....................................................51.3.1.发布流程........................................................51.3.2.发布WebService..................................................51.3.3.编辑WebService配置文件.........................................61.4.BOSWebService部署.....................................................71.4.1.建立web工程....................................错误!未定义书签。1.4.2.部署发布文件....................................................71.4.3.测试是否正确....................................................81.4.4.Web工程目录及文件截图...........................................81.5.客户端代码............................................................91.5.1.获取wsdl服务描述文件...........................................91.5.2.下载工具.......................................................101.5.3.建立一个新工程.................................................101.5.4.使用java客户端................................................131.5.5.importVoucher（凭证引入........................................141.6.BOSwebservice安全性................................................151.6.1.BOSwebservice安全性概述......................................151.6.2.不启用安全性...................................................151.6.3.启用安全性.....................................................151.6.4.如何安全性启用.................................................161.7.EASLogin登陆webservice说明.........................................161.7.1.EASLogin接口说明..............................................161.7.2.EASLogin异常说明..............................................171.7.3.EASLogin和前面版本的差别......................................181.8.webservice异常查看..................................................182.WebService客户端开发指南...............................................192.1.前提条件.............................................................192.2.获取WSDL文件........................................................192.3.生成客户端...........................................................202.3.1.生成Java客户端................................................202.3.2.建立一个新工程.................................................202.3.3.将获取到的WSDL文件拷贝到工程的根目录下：......................212.3.4.生成客户端.....................................................212.4.使用java客户端......................................................252.5.生成C#客户端........................................................252.5.1.使用命令行.....................................................252.5.2.运行命令生成客户端.............................................262.5.3.使用客户端代码.................................................273.webserviceFAQ.........................................................293.1.在EAS上如何发布一个webservice?....................................293.2.如何调用一个webservice？............................................293.3.有哪些工具能够简单的测试webservice？.................................293.4.EASLogin服务登陆如何判断失败........................................293.5.调用webservice时报com.kingdee.bos.IllegalSessionStateException:Pleaseloginfirst异常？..........................................................293.6.EAS6.0调用webservice时报没有WSConfig.getSrvURL()方法。............303.7.调用webservice时报java.net.SocketTimeoutException:Readtimedout异常30BOSWebService1.1.BOSWebService原理Webservice主要由SOAP，WSDL,以及UDDI等几块技术组成，以XML格式进行数据的传输。是建立可互操作的分布式应用程序的新平台Webservice的一个最基本的目的就是提供在各个不同平台的不同应用系统的协同工作能力。使各个异构系统之间实现无缝交互。在本质上是要为应用程序之间提供数据通讯的标准，为企业应用之间动态地提供大颗粒度的服务，并不适合于非常精细的基于会话的方法调用以及复杂的事务（transaction）处理之中。1.2.发布WebService的约束在BOSStudio中发布webService时，只能发布Entity和Façade两种元数据类型成WebService服务端的代码。由于Entity或Façade函数参数和返回值可能包含很多复杂的业务类型，在发布时会生成许多辅助类，一些复杂类型在其他异构系统中生成webService客户端时不能很好的支持，因此建议在建立webService功能时，最好使用Façade，并且提供简单类型的输入和返回参数。1.3.BOSWebService发布1.3.1.发布流程先建立需要发布的Façade,建立粗粒度的业务方法，业务方法尽可能提供简单数据类型的数据参数和返回参数。1.3.2.发布WebService运行BOSStudio，打开“包分类”视图，在其中选中要发布WebService的实体或Façade对象（可同时选中多个），点击鼠标右键，在弹出菜单中选择“发布WebService”,将弹出“发布WebService”向导：选择实体或Façade对象下要发布的方法，手工输入或者点击“浏览”按钮来指定发布生成代码存放的目录，可以同时勾中“追加到配置文件”。这样BOSStudio将会根据选中的对象和要发布的方法生成WebService代码和wsdl描述1.3.3.编辑WebService配置文件在“包分类”视图中，选择要编辑其配置文件的解决方案，点击工具栏上的“编辑WebService配置文件”按钮，将会弹出配置文件编辑向导在其间，可以增加或删除要发布的对象（方法），选择好要发布的对象（方法）后，点击“完成”按钮，即可完成对配置文件的编辑。配置文件位于解决方案的根目录下。1.4.BOSWebService部署1.4.1.部署发布文件发布成功以后，在临时目录里会生成一个wsdd文件和一个目录，例如：D:\webtest\AcctCussentCheckFacade.wsddD:\webtest\com\kingdee\eas\fi\gl\app\webservice\WSAcctCussentCheckFacadeSrvProxy.javaWSAcctCussentCheckFacadeSrvProxy.java文件拷贝到解决方案src目录中，注意包名和路径一致；AcctCussentCheckFacade.wsdd处理方法如下：找到解决方案的runtime\server\deploy\eas.ear目录，用解压缩软件打开web.war，进入WEB-INF目录把AcctCussentCheckFacade.wsdd添加进去；把AcctCussentCheckFacade.wsdd文件里的service节点内容添加到server-config.wsdd文件。操作方法建议：提取server-config.wsdd文件到临时目录，用编辑工具打开，再打开AcctCussentCheckFacade.wsdd，拷贝service节点内容粘贴到server-config.wsdd文件，注意XML格式一致；保存server-config.wsdd文件并拷回到web.war压缩包里。1.4.2.测试是否正确上面的步骤操作完成后，快测已经可以看到新建的WebService。通