NC系统Webservice接口开发培训

1、NC5X 系统 Webservice接口开发培训用友软件股份有限公司-北京分公司xxx2012年04月20日培 训 内 容什么是Webservice？ 是由企业发布的完成其特定商务需求的在线应用服务,其他公司或应用软件能够通过Internet来访问并使用这项在线服务。它是一种构建应用程序的普遍模型,可以在任何支持网络通信的操作系统中实施运行;它是一种新的web应用程序分支，是自包含、自描述、模块 化的应用，可以发布、定位、通过web调用。Web Service是一个应用组件,它逻辑性的为其他应用程序提供数据与服务.各应用程序通过网络协议和规定的一些标准数据格式（Http，XML，Soap)来访

2、问Web Service,通过Web Service内部执行得到所需结果.Web Service可以执行从简单的请求到复杂商务处理的任何功能。一旦部署以后，其他Web Service应用程序可以发现并调用它部署的服务。Webservice的优势以web服务的方式发布，可以通过外网或内网访问。可以供多个外系统调用，接口接入点统一。根据业务要求，只提供特殊数据的查询或更新，非常安全。不提倡给外系统开放中间库或中间表，不能让外系统直接操作数据库。而是采用提供Webservice接口的方式，将外系统需要的特定数据发布出去。使用Webservice接口，可以在程序中进行业务逻辑的编写和运算。Webser

3、vice向外发布的数据格式可以是xml格式、String等，根据业务要求运用起来非常灵活。Webservice服务的适用范围多系统间的数据同步。比如以NC系统的人员档案为主数据，其他外系统与NC系统人员档案进行同步，就可以由NC系统向外发布人员档案同步的Webservice接口服务，其他系统调用该接口进行人员档案查询同步。两系统间进行数据的更新。比如结算系统进行业务结算后，需要向NC系统单据发送一个结算状态。那么就可以由NC系统提供一个单据的状态更新Webservice接口服务，结算系统调用该接口（例如：传入参数为单据号、已结算）进行NC单据的状态更新。当然，其他业务系统也可以发布Webser

4、vice接口服务，NC系统来调用。NC Webservice开发1.开发流程所需jar包需要将nc.uap.mde.wstools_1.0.3.jar放到Eclipse下的plugins目录下。该jar包放于“相关文档需要的jar包”目录下Webservice开发流程 - 步骤1打开Eclipse，新建一个工程，创建一个Webservice接口类和实现类，如下例：接口样例：public interface IHelloWorld public String sayHelloName(String userid, String name); 接口实现样例：public class HelloWo

5、rldImpl implements IHelloWorld public String sayHelloName(String userid, String name) String strSay = Welcome + userid + : + name + to UFIDA !;return strSay; Webservice开发流程- 步骤2然后在接口IHelloWorld类上点击右键，选择“WS Tools”- “Public Web Service”，如图：Webservice开发流程- 步骤3下一步：填写upm配置文件的名称，用于打补丁时部署EJB用。Webservice开发流

6、程- 步骤4下一步：填写插件名称、接口以及接口实现类。Webservice开发流程- 步骤5下一步：将Webservice接口发布为 wsdl文件。Webservice开发流程- 步骤6下一步：在下面的页面中,必须将”是否要求认证授权”的勾去掉,然后点击”Finish”。至此，一个简单的Webservice接口程序开发完毕！Webservice开发流程- 步骤7下一步：在Eclipse中运行NC中间件。Webservice开发流程- 步骤8启动后，打开IE，在地址栏中输入：/uapws/service如果有如下显示，则表明Webservice部署正确：2.制作补丁

7、Webservice制作补丁- 步骤1需要将接口、接口实现类，以及ws目录下的wsdl文件和 META-INF目录下的upm文件选中，如图：Webservice制作补丁- 步骤2对选中的文件上点击右键，选择“导出”-”NC模块补丁包”，如图：Webservice制作补丁- 步骤3对生成的NC补丁包进行解压，会生成META-INF、modules、nc三个文件夹，如图：META-INF 、nc这两个文件夹需要移动到modules文件夹下的其他位置，见下文！Webservice制作补丁- 步骤4nc文件夹中包含wsdl文件，需要将其覆盖到modulesuapclasses目录下，如图：META-I

8、NF文件夹中包含upm文件，需要将其覆盖到modulesuap目录下，如图：Webservice制作补丁- 步骤5最后就可以将modules文件覆盖到中间件nchome目录下，部署EJB后，重启NC中间件即可。3.用soapUI工具测试测试工具 soapUI安装1.先将soapUI工具安装完成。2.运行NC中间件。3.打开IE浏览器，输入/uapws/service，找到要测试的Webservice接口地址，如图：4.运行soapUI工具，进行后续测试，见下文！测试工具 soapUI使用1.在Project上点击右键，选择“New soapUI Project”，

9、如图：2.在WSDL框中，录入测试地址/uapws/service/helloworld?wsdl。最后点击OK，如图：测试工具 soapUI测试1.依次点开左边窗口的树形结构，双击最后的“Request1”，如图：2.在右边窗口录入查询参数，然后点击绿色运行箭头，即可运行结果，如图：4.代码调用Webservice调用Webservice所需的jar包在“用于测试Webservice的代码java调用Webservice需用到的jar包lib”可以找到如下jar包，需要将这些jar包覆盖至nchomelib目录下，如图：调用接口地址为Wsdl结尾的代码如果是以

10、/uapws/service/helloworld?wsdl 这种形式发布的Webservice服务，则使用如下代码样例进行调用：/webservice服务访问地址String webserviceURL = /uapws/service/ISyncDataServer;Service service = new Service();Call call = (Call) service.createCall();call.setTargetEndpointAddress(new .URL(webserviceURL);/调用的方法名c

11、all.setOperationName(getAllCorpInfo);/设置输入参数类型（不能写成String作为参数，否则会提示错误）call.addParameter(new QName(datasource), org.apache.axis.encoding.XMLType.XSD_STRING, javax.xml.rpc.ParameterMode.IN);/设置返回值类型call.setReturnType(org.apache.axis.encoding.XMLType.XSD_SCHEMA);/调用接口List list = (List)call.invoke(new O

12、bject datasource);调用接口地址为asmx结尾的代码如果是以 50/WebService/Service.asmx 这种形式发布的Webservice服务，则使用如下代码样例进行调用：/webservice服务访问地址 从参数设置中获取String webserviceURL = “50/WebService/Service.asmx “; String nameSpaceURI = /;String soapActionURI = /NotesServi

13、ce;String method = NotesService; /要调用的方法名Service service = new Service();Call call = (Call) service.createCall();call.setTargetEndpointAddress(webserviceURL); /设置客户端访问的远程端点call.setOperationName(new QName(nameSpaceURI, method); / 设置调用的方法名call.addParameter(new QName(nameSpaceURI, indentity), org.apach

14、e.axis.encoding.XMLType.XSD_STRING, javax.xml.rpc.ParameterMode.IN); /设置输入参数类型call.addParameter(new QName(nameSpaceURI, xml), org.apache.axis.encoding.XMLType.XSD_STRING, javax.xml.rpc.ParameterMode.IN);/设置返回值类型call.setReturnType(org.apache.axis.encoding.XMLType.XSD_STRING);call.setUseSOAPAction(true);call.setSOAPActionURI(soapActionURI); /wsdl中方法的soapActionURI /调用接口String result =