webservice开发说明(流程步骤).docVIP

webservice开发说明： ---lihw 流程 webservice是内控web修改过来的一个web包，同样运行在tomcat里，该包命名为hsdc。部署时可拷贝一份内控tomcat到另台机子，并将部署后的hsdc文件夹放到tomcat/webapps下，启动和内控web一样；或者将hsdc文件夹放到tomcat/webapps里面与hsicpweb在一个文件夹下，和内控一起启动。 源代码在myeclipse开发完成后，在myeclipse里部署到配置的用于开发的tomcat5.5里，测试正确后将webapps里面的hsdc拷贝到风控的tomcat/webapp里面。 安装 1.1 myeclipse和tomcat 安装jdk1.5 , myeclipse版本6.5.0。 用于开发的tomcat5.5，拷贝到任意文件夹解压。在myeclipse中配置这个tomcat5.5。 1.2 源代码导入到myeclipse 1. 在myeclipse左侧框点右键，选择“Import”,选择“Existing Projects into Workspace”,然后选择目录选中源代码的hsdc目录。勾上“Copy projects into workspace”,点击“finish”。 在myeclipse中如下图所示： 2．在myeclipse中配置开发的tomcat5.5，将工程hsdc部署上去。如下图所示： 开发 --以下开发说明基于国海证券的基金净值webservice。 需求：客户传入日期(oc_date)、基金代码(jjdm)，数据中心通过webservice返回该日期下该基金代码的基金净值。 2.1 编写WSDL文件 注：WSDL（网络服务描述语言，Web Services Description Language）是一门基于 XML 的语言，用于描述 Web Services 以及如何对它们进行访问。 HsdcNetassetinfo.wsdl，HsdcNetassetinfo_schema.xsd，HsdcResultSet.xsd共三个文件。 HsdcNetassetinfo.wsdl为描述webservice的文件，描述了输入输出的方法。 HsdcNetassetinfo_schema.xsd被1引用，描述了输入输出的具体参数名和参数类型。 HsdcResultSet.xsd被2引用，描述了用于输出的参数名和类型。即结果集类型。 对于新的需求，需要编写HsdcNetassetinfo.wsdl和HsdcNetassetinfo_schema.xsd即可，文件名改成需要的名字；HsdcResultSet.xsd为所有需求共用的，不用改动。 2.2 WSDL文件解释 2.2.1 HsdcNetassetinfo.wsdl definitions标签里面name=NetassetinfoService 代表这个webservice的服务名。一个wsdl对应一个服务名。 targetNamespace=/ws/hsdc/netassetinfo/ 代表的这个网络服务的命名空间，等后面导入到myeclipse就后对应的相应目录。 导入HsdcNetassetinfo_schema.xsd 定义输入输出对象，”getNetassetinfo”是输入对象，”getNetassetinfoResponse”是输出对象。这两个对象在上面导入的HsdcNetassetinfo_schema.xsd文件中定义。 定义操作，操作名叫”getNetassetinfo”， 端口类型叫”NetassetinfoDelegate” 定义绑定，这部分格式固定。type等于上面定义的端口类型。 服务名为”NetassetinfoService”，binding等于上面定义的绑定。soap标签中的location为客户访问这个webservice服务的地址。这个地址由tomcat提供服务。（注：示例的WSDL里的地址写成了”http://localhost:8080/hsdc/NetassetinfoService”，改成NetassetinfoPort） 2.2.2 HsdcNetassetinfo_schema.xsd 引入HsdcResultSet.xsd，这个文件用于定义结果集类型。 定义输入输出参数。 定义输入参数的类型的定义。前两个参数是操作员号和密码，这个在内控平台里先建个用户，不用分配权限，客户端输入参数的时候输入。 返回的类型，引用了HsdcResultSet.xsd里面的resultset类型。 HsdcResultSet.xsd 用于结果集类型定义。数据中心在数据库里得到好数据后把数据构造成这个结果