webserviceinterfaceintroduction.docx

webserviceinterfaceintroduction.docx

《webserviceinterfaceintroduction.docx》由会员分享，可在线阅读，更多相关《webserviceinterfaceintroduction.docx（16页珍藏版）》请在冰豆网上搜索。

webserviceinterfaceintroduction

语义服务WebService接口说明书

Version：

1.3.0

作成者：

郭金飞

语义服务WebService接口概述

语义服务WebService提供两类服务：

语义表达式解析服务和数据获取服务。

其WebService的接口定义请参见《LDMQueryService.xml》。

语义表达式解析服务接口签名及说明

java.lang.Stringcheck（java.lang.String）检查输入的SQL是否符合标准SQL92的语法；

java.lang.Stringparse（java.lang.String）解析输入的LSQL为PSQl；

数据获取服务接口签名及说明

java.lang.Stringfetch（java.lang.String）解析输入的LSQL为PSQl，并执行该PSQl同步获取数据；

java.lang.StringPrepareData（java.lang.String）解析输入的LSQL为PSQl，异步执行该PSQl获取数据；

java.lang.StringQueryReadyState（java.lang.String）查看指定的异步获取数据任务的处理状态；

语义服务WebService请求响应格式

check（java.lang.String）

请求格式：

xmlversion="1.0"encoding="UTF-8"standalone="yes"?

>

Guojinfei

000000001

T000000000000000000KEN

0

20110124144812888

V0000000001

01：

地市路由

R00000000000000001

SELECT[客户.姓名],[客户.手机号],'201002'STAT_MONTH,[GPRS月汇总_201002.通信费]FEEFROM[GPRS月汇总_201002]

G2,[客户]U

说明：

元素值为要检查的LSQL。

响应格式：

xmlversion="1.0"encoding="UTF-8"standalone="yes"?

>

0

20110302094444

0

正确

parse（java.lang.String）

请求格式：

xmlversion="1.0"encoding="UTF-8"standalone="yes"?

>

Guojinfei

000000001

T000000000000000000KEN

0

20110124144812888

V0000000001

01：

地市路由

R00000000000000001

SELECT[客户.姓名],[客户.手机号],'201002'STAT_MONTH,[GPRS月汇总_201002.通信费]FEEFROM[GPRS月汇总_201002]

G2,[客户]U

说明：

元素值为要解析的LSQL。

响应格式：

xmlversion="1.0"encoding="UTF-8"standalone="yes"?

>

0

20110302095516

SELECTU.name,U.telphone,'201002'ASSTAT_MONTH,G2.feeASFEEFROM（SELECTfeeASfee,

codeAScodeFROMgprssum_201002）G2,（SELECTnameASname,sexASsex,telphoneAStelphone

FROMuser）U

说明：

元素值为LSQL解析后的PSQL。

fetch（java.lang.String）

请求格式：

xmlversion="1.0"encoding="UTF-8"standalone="yes"?

>

Guojinfei

000000001

T000000000000000000KEN

0

20110124144812888

V0000000001

01：

地市路由

R00000000000000001

001

[CDATA[SELECT[客户.姓名],[客户.手机号],'201002'STAT_MONTH,[GPRS月汇总_201002.通信费]FEEFROM[GPRS月汇总_201002]G2,[客户]U]]>

说明：

SQLType

查询语句类型

001表示查询语句为逻辑模型查询语句；

002表示查询语句为直接和物理数据库交互的SQL；

SqlContent

查询语句

数据查询语句

响应格式：

xmlversion="1.0"encoding="UTF-8"standalone="yes"?

>

0

20110302100739

4

ID

NAME

DESC

PARENT_ID

TYPE1

TYPE2

TYPE3

AI-UT

统一接触平台

0

AI-UT-QT

统一接触平台-前台

AI-UT

AI-JF

经分平台

0

AI-JF-YX

经分平台-营销平台

AI-JF

PrepareData（java.lang.String）

请求格式：

xmlversion="1.0"encoding="UTF-8"standalone="yes"?

>

Guojinfei

000000001

T000000000000000000KEN

0

20110124144812888

V0000000001

01：

地市路由

R00000000000000001

001

[CDATA[SELECT[客户.姓名],[客户.手机号],'201002'STAT_MONTH,[GPRS月汇总_201002.通信费]FEEFROM[GPRS月汇总_201002]G2,[客户]U]]>

说明：

SQLType

查询语句类型

001表示查询语句为逻辑模型查询语句；

002表示查询语句为直接和物理数据库交互的SQL；

SqlContent

查询语句

数据查询语句

响应格式：

xmlversion="1.0"encoding="UTF-8"standalone="yes"?

>

0

20110302100858

5fd3769c-aa6a-4e33-9461-2212f26fee22

20110302101858

10

20110304000858

FTP

ftp:

//127.0.0.1/dataset/5fd3769c-aa6a-4e33-9461-2212f26fee22.csv

user01

10102002

QueryReadyState（java.lang.String）

请求格式：

xmlversion="1.0"encoding="UTF-8"standalone="yes"?

>

Guojinfei

000000001

T000000000000000000KEN

0

20110124144812888

V0000000001

01：

地市路由

R00000000000000001

5fd3769c-aa6a-4e33-9461-2212f26fee22

2fd3769c-aa6a-4e33-9461-2212f26fee24

……

说明：

Sequence

唯一标识号

该值和准备数据方法的应答消息的唯一标识号相同。

LDM

可以有多个

响应格式：

xmlversion="1.0"encoding="UTF-8"standalone="yes"?

>

0

20110302101144

5fd3769c-aa6a-4e33-9461-2212f26fee22

9

2fd3769c-aa6a-4e33-9461-2212f26fee24

9

……

WebService异常格式

xmlversion="1.0"encoding="UTF-8"standalone="yes"?

>

999

20110302101547

OtherErr

语义表达式错误,找不到指定的实体:

GPRS月汇201002

WebService获取敏感级别

请求格式：

xmlversion="1.0"encoding="UTF-8"standalone="yes"?

>

Guojinfei

000000001

T000000000000000000KEN

0

20110124144812888

V0000000001

01：

地市路由

R00000000000000001

T_Name

mda_sys_kpi

C_Name

column2

说明：

name

标识号

value

英文表名或英文列名

可以有多个

响应格式：

xmlversion="1.0"encoding="UTF-8"standalone="yes"?

>

0

20110719112105

A