文章目录
平台可以将数据查询，数据操作，过程，Java方法等快速发布为WEB服务。其中数据操作包括执行Insert，Update，Delete三种SQL。
1、WS发布
进入平台WS服务配置页面，可以在此页面快速发布WEB服务。
1.1 发布查询SQL为WEB服务
其中${}括起部分为参数，在WS执行此SQL之前会用传入参数paramList中对应的参数值替换掉此部分内容。如果此参数值为字符型，需要自行添加单引号来实现。平台会根据所属应用的数据库连接信息来执行SQL。
1.2 发布数据操作SQL为WEB服务
其中${}括起部分为参数，在WS执行此SQL之前会用传入参数paramList中对应的参数值替换掉此部分内容。如果此参数值为字符型，需要自行添加单引号来实现。
数据操作中的SQL可以为Insert、Update和Delete三种。平台会根据所属应用的数据库连接信息来执行SQL。
1.3 发布数据库函数为WEB服务
其中${param}作为参数，需要在paramList这个参数中以Json串形式传入，如”{‘param’:’This is WS call database function Test’}”
Oracle示例代码
FUNCTION wstest(param VARCHAR2) RETURN VARCHAR2 IS
BEGIN
–返回值格式如下，其中flag 0表示成功，1为失败,在result下还可以加入其它内容，根据自己业务需要自己添加
RETURN ‘<result><flag>0</flag><msg>WEB服务测试函数执行成功。参数值为:’ || param || ‘</msg></result>’;
END;
1.4 发布Java方法为WEB服务
其中${param}作为参数，需要在paramList这个参数中以Json串形式传入，如”{‘param’:’This is WS call database function Test’}”
Java示例代码
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
package com.xzsoft.xip.platform.conc; publicclass ConcTest { /** * wsTest:(供WS调用Java方法示例) * * @param param * 传入参数 * @return返回XML字符串 * @author GuoXiuFeng * @versionVer 1.0 * @sinceVer 1.0 */ public String wsTest(String param) { // 返回字符串格式如下，其中flag为0表示成功，1为失败，msg为提示信息，在result下面可以根据业务需要添加需要的返回内容。其中flag和msg是两个默认必须返回的两项。 return"<result><flag>0</flag><msg>" + param + "</msg></result>"; } } |
2、WS调用
平台提供了基于JS调用WEB服务，调用平台Action发送请求调用WEB服务，还有在Java代码中调用平台提供的Java方法调用WEB服务。
2.1 基于JS调用WEB服务
在WB7开发中可以直接在IDE中直接键入Xip.就会提示出Xip下的所有方法，其中Xip.callWebService方法就是前端调用WEB服务的方法。如果是在原生Extjs开发中则需要引入平台xip/js/xip.js文件，然后通过Xip.callWebService可调用WEB服务，平台会将WEB服务返回的XML格式的数据转换成Json返回给js方法
Xip.callWebService参数：
wsdl：WEB服务WSDL完整的URL例如 http://localhost/xip/services/PlatformWS?wsdl
methodName：方法名称
args：方法对应的参数Json对象格式如{‘key1′:’value1′,’key2′:’value2’}
返回Json字符串，其中如果调用WEB服务失败，返回json中的flag为1，如果flag为0，msg则是WEB服务的返回内容
示例
var ret = Xip.callWebService(‘http://localhost/xip/services/platformWS?wsdl’,’executeSQL’,”{‘sqlKey’:’XIP002′,’paramList’:{‘param’:’JS call WEB Service Demo’},loginName:’ADMIN’,password:’xzsoft’}”);
alert(ret);
2.2 通过发送请求到平台Action调用WEB服务
Action URL：/platformAction.do?method=webService
参数：
wsdl：WEB服务WSDL完整的URL例如 http://localhost/xip/services/PlatformWS?wsdl
methodName：方法名称
args：方法对应的参数Json对象格式如{‘key1′:’value1′,’key2′:’value2’}
返回Json串，其中如果调用WEB服务失败，返回json中的flag为1，如果flag为0，msg则是WEB服务的返回内容
2.3 Java方法中调用平台方法调用WEB服务
com.xzsoft.xip.platform.util.XipUtil.callWebService
参数：
wsdl：WEB服务WSDL完整的URL例如 http://localhost/xip/services/PlatformWS?wsdl
methodName：方法名称
args：为需要传入参数的对象数组
返回字符串，为WEB服务的返回内容
转载请注明：兴竹集成开发平台 » 基于平台WS发布和调用