NC系统Webservice接口开发培训

单击此处编辑母版文本样式,单击此处编辑母版标题样式,单击此处编辑母版标题样式,单击此处编辑母版文本样式,第二级,第三级,单击此处编辑母版标题样式,单击此处编辑母版文本样式,第二级,第三级,单击此处编辑母版标题样式,单击此处编辑母版文本样式,第二级,第三级,单击此处编辑母版标题样式,单击此处编辑母版文本样式,单击此处编辑母版标题样式,单击此处编辑母版文本样式,NC5X,系统,Webservice,接口开发培训,用友软件股份有限公司,-,北京分公司,xxx,2012,年,04,月,20,日,培 训 内 容,什么是,Webservice,？,是由企业发布的完成其特定商务需求的在线应用服务,其他公司或应用软件能够通过,Internet,来访问并使用这项在线服务。,它是一种构建应用程序的普遍模型,可以在任何支持网络通信的操作系统中实施运行,;,它是一种新的,web,应用程序分支，是自包含、自描述、模块 化的应用，可以发布、定位、通过,web,调用。,Web Service,是一个应用组件,它逻辑性的为其他应用程序提供数据与服务,.,各应用程序通过网络协议和规定的一些标准数据格式（,Http,，,XML,，,Soap),来访问,Web Service,通过,Web Service,内部执行得到所需结果,.Web Service,可以执行从简单的请求到复杂商务处理的任何功能。一旦部署以后，其他,Web Service,应用程序可以发现并调用它部署的服务。,Webservice,的优势,以,web,服务的方式发布，可以通过外网或内网访问。,可以供多个外系统调用，接口接入点统一。,根据业务要求，只提供特殊数据的查询或更新，非常安全。,不提倡给外系统开放中间库或中间表，不能让外系统直接操作数据库。而是采用提供,Webservice,接口的方式，将外系统需要的特定数据发布出去。,使用,Webservice,接口，可以在程序中进行业务逻辑的编写和运算。,Webservice,向外发布的数据格式可以是,xml,格式、,String,等，根据业务要求运用起来非常灵活。,Webservice,服务的适用范围,多系统间的数据同步。比如以,NC,系统的人员档案为主数据，其他外系统与,NC,系统人员档案进行同步，就可以由,NC,系统向外发布人员档案同步的,Webservice,接口服务，其他系统调用该接口进行人员档案查询同步。,两系统间进行数据的更新。比如结算系统进行业务结算后，需要向,NC,系统单据发送一个结算状态。那么就可以由,NC,系统提供一个单据的状态更新,Webservice,接口服务，结算系统调用该接口（例如：传入参数为单据号、已结算）进行,NC,单据的状态更新。,当然，其他业务系统也可以发布,Webservice,接口服务，,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,HelloWorldImpl,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,开发流程,-,步骤,4,下一步：填写插件名称、接口以及接口实现类。,Webservice,开发流程,-,步骤,5,下一步：将,Webservice,接口发布为,wsdl,文件。,Webservice,开发流程,-,步骤,6,下一步：,在下面的页面中,必须将,”,是否要求认证授权,”,的勾去掉,然后点击,”,Finish,”,。至此，一个简单的,Webservice,接口程序开发完毕！,Webservice,开发流程,-,步骤,7,下一步：在,Eclipse,中运行,NC,中间件。,Webservice,开发流程,-,步骤,8,启动后，打开,IE,，在地址栏中输入：,http:/127.0.0.1/uapws/service,如果有如下显示，则表明,Webservice,部署正确：,2.,制作补丁,Webservice,制作补丁,-,步骤,1,需要将接口、接口实现类，以及,ws,目录下的,wsdl,文件和,META-INF,目录下的,upm,文件选中，如图：,Webservice,制作补丁,-,步骤,2,对选中的文件上点击右键，选择,“,导出,”,-,”,NC,模块补丁包,”,，如图：,Webservice,制作补丁,-,步骤,3,对生成的,NC,补丁包进行解压，会生成,META-INF,、,modules,、,nc,三个文件夹，如图：,META-INF,、,nc,这两个文件夹需要移动到,modules,文件夹下的其他位置，见下文！,Webservice,制作补丁,-,步骤,4,nc,文件夹中包含,wsdl,文件,，需要将其覆盖到,modulesuapclasses,目录下，如图：,META-INF,文件夹中包含,upm,文件,，需要将其覆盖到,modulesuap,目录下，如图：,Webservice,制作补丁,-,步骤,5,最后就可以将,modules,文件覆盖到中间件,nchome,目录下，部署,EJB,后，重启,NC,中间件即可。,3.,用,soapUI,工具测试,测试工具,soapUI,安装,1.,先将,soapUI,工具安装完成。,2.,运行,NC,中间件。,3.,打开,IE,浏览器，输入,http:/127.0.0.1/uapws/service,，找到要测试的,Webservice,接口地址，如图：,4.,运行,soapUI,工具，进行后续测试，见下文！,测试工具,soapUI,使用,1.,在,Project,上点击右键，选择,“,New soapUI Project,”,，如图：,2.,在,WSDL,框中，录入测试地址,http:/127.0.0.1/uapws/service/helloworld?wsdl,。最后点击,OK,，如图：,测试工具,soapUI,测试,1.,依次点开左边窗口的树形结构，双击最后的,“,Request1,”,，如图：,2.,在右边窗口录入查询参数，然后点击绿色运行箭头，即可运行结果，如图：,4.,代码调用,Webservice,调用,Webservice,所需的,jar,包,在,“,用于测试,Webservice,的代码,java,调用,Webservice,需用到的,jar,包,lib,”,可以找到如下,jar,包，需要将这些,jar,包覆盖至,nchomelib,目录下，如图：,调用接口地址为,Wsdl,结尾的代码,如果是以,http:/127.0.0.1/uapws/service/helloworld?wsdl,这种形式发布的,Webservice,服务，则使用如下代码样例进行调用：,/webservice,服务访问地址,String webserviceURL = http:/127.0.0.1/uapws/service/ISyncDataServer;,Service service = new Service();,Call call = (Call) service.createCall();,call.setTargetEndpointAddress(new .URL(webserviceURL);,/,调用的方法名,call.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 Object datasource);,调用接口地址为,asmx,结尾的代码,如果是以,http:/10.2.1.150/WebService/Service.asmx,这种形式发布的,Webservice,服务，则使用如下代码样例进行调用：,/webservice,服务访问地址 从参数设置中获取,String webserviceURL =,“,http:/10.2.1.150/WebService/Service.asmx,“,;,String nameSpaceURI = http:/tempuri.org/;,String soapActionURI = http:/tempuri.org/NotesService;,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.apache.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 = (String)call.invoke(new Object BjsascUfida, postXml.toString();,项目实例,实例项目,水利部项目,NC,与业务系统数据接口,需求描述：,水利部综合事业局有自己的业务系统，需要定时从,NC,系统中抽取相关数据，需要由,NC,系统提供,Webservice,接口，供业务系统进行调用。,查询数据包括：公司、部门、登录用户、人员档案、币种、客户、会计科目、辅助核算、凭证分录、余额表、固定资产卡片等等。,实际效果演示,