最新消息:

基于平台WS发布和调用

开发文档 admin 2058浏览
平台可以将数据查询,数据操作,过程,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示例代码

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发布和调用