DB32-T 2777-2015生態(tài)環(huán)境監(jiān)控系統(tǒng)建設(shè)規(guī)范 服務(wù)集成與信息傳輸

ICS35.020

L01

備案號：46311-2015DB32

江蘇省地方標準

DB32/T2777-2015

生態(tài)環(huán)境監(jiān)控系統(tǒng)建設(shè)規(guī)范服務(wù)集成與信

息傳輸

Specificationsforconstructionofecologicalenvironmentmonitoringsystem—

Serviceintegrationandinformationtransmission

2015-06-15發(fā)布2015-08-15實施

江蘇省質(zhì)量技術(shù)監(jiān)督局發(fā)布

DB32/T2777-2015

前言

本標準按照GB/T1.1—2009的規(guī)定編制。

本標準由江蘇省環(huán)境保護廳提出并歸口。

本標準起草單位：江蘇省生態(tài)環(huán)境監(jiān)控中心、江蘇省標準化研究院、江蘇潤和軟件股份有限公司。

本標準主要起草人：劉玨、何春銀、許萌君、黃藝青、陳媛、徐潔、陳曉龍、寇曉芳。

II

DB32/T2777-2015

生態(tài)環(huán)境監(jiān)控系統(tǒng)建設(shè)規(guī)范服務(wù)集成與信息傳輸

1范圍

本標準規(guī)定了生態(tài)環(huán)境監(jiān)控系統(tǒng)中服務(wù)集成與信息傳輸平臺的總體架構(gòu)、接口規(guī)范、服務(wù)調(diào)用及部

署要求、集成服務(wù)編寫要求、公共服務(wù)規(guī)范和服務(wù)接口的應(yīng)用。

本標準適用于服務(wù)集成與信息傳輸平臺的設(shè)計、開發(fā)和管理。

2規(guī)范性引用文件

下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。

GB/T5271.1－2000信息技術(shù)詞匯第1部分：基本術(shù)語

GB/T5271.17－2010信息技術(shù)詞匯第17部分：數(shù)據(jù)庫

3術(shù)語、定義和縮略語

GB/T5271.1－2000、GB/T5271.17－2010確立的以及下列術(shù)語和定義適用于本部分。

3.1術(shù)語和定義

3.1.1

服務(wù)集成與信息傳輸平臺

由服務(wù)總線、服務(wù)監(jiān)控、服務(wù)目錄、服務(wù)管理、公共服務(wù)組成的，實現(xiàn)SOA集成項目中用戶及權(quán)限

管理、服務(wù)注冊與管理、基礎(chǔ)數(shù)據(jù)管理、審計管理配置等功能的集成平臺。

3.1.2

單點登錄

用戶通過一次登錄就可訪問所有相互信任的應(yīng)用系統(tǒng)的一種登錄方式。

3.2縮略語

MSMQ不同的應(yīng)用之間實現(xiàn)相互通信的一種異步傳輸模式MessageQueue

SOA面向服務(wù)的體系結(jié)構(gòu)

SOAP簡單對象訪問協(xié)議SimpleObjectAccessProtocol

SOAPHeader有關(guān)SOAP消息的應(yīng)用程序?qū)Ｓ眯畔impleObjectAccessProtocolHeader

SSO單點登錄SingleSignOn

WSDL用來描述Web服務(wù)和說明如何與Web服務(wù)通信的XML語言WebServicesDescription

Language

XML可擴展標記語言ExtensibleMarkupLanguage

1

DB32/T2777-2015

XMLSchema以XML語言為基礎(chǔ)的架構(gòu)ExtensibleMarkupLanguageSchema

4總體架構(gòu)

4.1組成與要求

4.1.1基本特性

服務(wù)集成與信息傳輸平臺采用總分結(jié)構(gòu)，架構(gòu)圖如圖1，平臺應(yīng)具有如下基本特征：

1)能連接多個應(yīng)用系統(tǒng)，其提供的服務(wù)供其他應(yīng)用系統(tǒng)中有使用權(quán)限的用戶調(diào)用；

2)能實現(xiàn)服務(wù)接入、服務(wù)接出及跨分（子）平臺的服務(wù)(平臺服務(wù)級聯(lián))調(diào)用；

3)應(yīng)有身份認證服務(wù)器用于存放和管理密鑰；

4)應(yīng)有相應(yīng)的應(yīng)用系統(tǒng)服務(wù)提供方，作為服務(wù)功能技術(shù)實現(xiàn)的實體；

5)可向應(yīng)用系統(tǒng)的服務(wù)調(diào)用方提供所需信息，服務(wù)調(diào)用方可以是一個終端客戶，也可以是另一

個應(yīng)用系統(tǒng)。

圖1平臺總體架構(gòu)圖

4.1.2工作機制

統(tǒng)一接入代理

平臺應(yīng)能為應(yīng)用系統(tǒng)接入的SOAP協(xié)議提供統(tǒng)一的接入代理服務(wù)，為實現(xiàn)業(yè)務(wù)應(yīng)用與平臺之間的松耦

合提供良好的支持。

動態(tài)路由

平臺代理服務(wù)應(yīng)為服務(wù)使用者提供統(tǒng)一的訪問入口，業(yè)務(wù)服務(wù)的路由能根據(jù)用戶的請求服務(wù)標識進

行動態(tài)識別，由平臺根據(jù)服務(wù)的配置信息動態(tài)路由到指定的業(yè)務(wù)服務(wù)。

2

DB32/T2777-2015

業(yè)務(wù)服務(wù)透明訪問

請求的服務(wù)名稱、用戶、密碼等公共信息或控制信息應(yīng)放在平臺報文頭中。

業(yè)務(wù)無關(guān)性要求

業(yè)務(wù)相關(guān)的信息可以由服務(wù)的提供者自行定義。服務(wù)使用者可通過平臺實現(xiàn)對業(yè)務(wù)服務(wù)的透明訪

問。

公共認證和授權(quán)服務(wù)

用戶的認證和服務(wù)的授權(quán)可被封裝成可重用的服務(wù)單元，由平臺處理流程或者外部模塊調(diào)用，實現(xiàn)

服務(wù)級別的重用性。

多開發(fā)語言支持

平臺應(yīng)提供.net、JAVA等多種開發(fā)語言的支持。

多種調(diào)用方式支持

支持服務(wù)請求方使用同步或異步調(diào)用等多種調(diào)用方式調(diào)用業(yè)務(wù)服務(wù)時，平臺能提供必要的調(diào)用方式

的轉(zhuǎn)換。

4.1.3功能設(shè)計

組成

由平臺核心服務(wù)、平臺管理服務(wù)、平臺請求服務(wù)、平臺接口服務(wù)4大模塊組成，組成圖見圖2。

圖2平臺功能組成圖

要求

3

DB32/T2777-2015

.1平臺核心服務(wù)應(yīng)提供服務(wù)接入及服務(wù)調(diào)用，實現(xiàn)服務(wù)目錄服務(wù)、安全驗證、服務(wù)代理、服

務(wù)路由。

.2平臺管理服務(wù)應(yīng)實現(xiàn)對集成平臺基礎(chǔ)數(shù)據(jù)的管理，包括用戶管理、權(quán)限管理、服務(wù)管理、

審計管理、服務(wù)監(jiān)控和異常管理等。

.3平臺請求服務(wù)應(yīng)提供服務(wù)轉(zhuǎn)換消息的存儲與處理，并且通過服務(wù)通道進行交換的處理，異

步處理時，能通過隊列方式存儲服務(wù)信息，并且依照順序進行消息處理。

.4平臺接口服務(wù)應(yīng)提供服務(wù)注冊、兩級平臺的服務(wù)對接工作，提供注冊服務(wù)的同步，提供服

務(wù)查詢接口的同步工作。

4.2服務(wù)調(diào)用方式

4.2.1分類

平臺應(yīng)提供服務(wù)透明調(diào)用功能。服務(wù)調(diào)用方式可分為同步、異步帶返回結(jié)果和異步不帶返回結(jié)果三

種。

4.2.2同步調(diào)用

調(diào)用過程

同步調(diào)用過程見圖3。

圖3基于同步的服務(wù)請求經(jīng)由平臺的處理過程

實現(xiàn)方式

具體為：

1)客戶端同步向平臺發(fā)出調(diào)用服務(wù)的請求，當此阻塞并等待返回結(jié)果；

2)平臺接收此服務(wù)調(diào)用請求后，經(jīng)由服務(wù)總線同步調(diào)用目標服務(wù)，阻塞并等待目標服務(wù)返回結(jié)

果；

3)目標服務(wù)返回處理后的調(diào)用結(jié)果至服務(wù)總線；

4)服務(wù)總線將最終結(jié)果同步返回到當前客戶端。

4.2.3異步調(diào)用方式

被動請求結(jié)果

.1調(diào)用過程

異步調(diào)用方式中對于被動請求結(jié)果的調(diào)用過程見圖4。

4

DB32/T2777-2015

圖4基于異步的服務(wù)被動返回結(jié)果經(jīng)由平臺的處理過程

.2實現(xiàn)方式

具體為：

1)客戶端異步向平臺發(fā)出調(diào)用服務(wù)的請求，不等待返回結(jié)果；

2)平臺同步調(diào)用目標服務(wù)，等待返回結(jié)果；

3)目標服務(wù)執(zhí)行完畢，同步返回結(jié)果到服務(wù)總線；

4)平臺調(diào)用客戶端提供的回調(diào)服務(wù)通知返回結(jié)果，如客戶端為異步調(diào)用，返回結(jié)果的匹配可

由調(diào)用客戶端自行匹配。

主動請求結(jié)果

.1調(diào)用過程

異步調(diào)用方式中按照請求標識ID序列發(fā)出請求，對于主動請求結(jié)果的調(diào)用過程見圖5。

圖5基于異步主動請求返回結(jié)果的服務(wù)請求經(jīng)由平臺的處理過程

.2實現(xiàn)過程

具體為：

5

DB32/T2777-2015

1)客戶端異步向平臺發(fā)出調(diào)用服務(wù)的請求，不等待返回結(jié)果；

2)平臺同步調(diào)用目標服務(wù)，等待返回結(jié)果；

3)目標服務(wù)執(zhí)行完畢，同步返回結(jié)果到服務(wù)總線；

4)平臺調(diào)用客戶端提供的回調(diào)服務(wù)通知返回結(jié)果，如客戶端為異步調(diào)用，調(diào)用標識的ID及

返回結(jié)果的匹配可由調(diào)用客戶端自行匹配。

5接口規(guī)范

5.1接口類型

5.1.1平臺對外接口分為應(yīng)用服務(wù)接口和管理服務(wù)接口，大批量數(shù)據(jù)交互服務(wù)考慮用數(shù)據(jù)交換方式實

現(xiàn)。

5.1.2應(yīng)用服務(wù)接口提供生態(tài)環(huán)境監(jiān)控系統(tǒng)所包含的具體的應(yīng)用和信息服務(wù)。

5.1.3管理服務(wù)接口提供總分兩級平臺之間，分（子）平臺之間的平臺管理服務(wù)的信息傳輸服務(wù)。

5.1.4平臺接口的調(diào)用架構(gòu)見圖6。

應(yīng)用服務(wù)接口管理服務(wù)接口

圖6平臺接口的調(diào)用架構(gòu)

5.2接口功能

5.2.1用戶管理功能：提供平臺管理用戶的管理功能，能實現(xiàn)用戶新增、修改、刪除等功能。

5.2.2權(quán)限管理功能：提供服務(wù)調(diào)用者與具體信息服務(wù)使用權(quán)限綁定的功能，能實現(xiàn)綁定和解除綁定。

5.2.3服務(wù)同步功能：提供各級平臺之間同步信息服務(wù)的功能，能實現(xiàn)同步增加和同步卸載。

5.2.4審計管理功能：提供服務(wù)調(diào)用情況記錄的查詢功能，能實現(xiàn)請求結(jié)果的查詢和服務(wù)日志的審計

和管理。

6

DB32/T2777-2015

5.2.5安全服務(wù)功能：提供對平臺使用者進行身份驗證的功能，能實現(xiàn)對用戶行為監(jiān)控，對用戶訪問

行為進行策略設(shè)置等。

5.2.6服務(wù)查詢功能：提供平臺上注冊的信息服務(wù)的查詢功能，能實現(xiàn)關(guān)鍵字查詢和服務(wù)類型查詢等。

5.3技術(shù)要求

平臺接口的WebService應(yīng)能支持如下協(xié)議：

——SOAP1.1或SOAP1.2；

——WSDL1.1；

——SOAPAttachments；

——operation支持Document-oriented和literalencoding。

5.4輸入輸出格式

5.4.1應(yīng)用服務(wù)接口

應(yīng)采用支持SOAP1.1或SOAP1.2數(shù)據(jù)類型的WebService，請求報文格式應(yīng)符合表1和表2的要求，返

回報文格式應(yīng)符合表3的要求。SOAP1.1具體報文格式要求見附錄A，SOAP1.2具體報文格式要求見附錄

B。

表1請求報文SOAPHeader屬性的值和含義

SOAPHeader:SHeader

屬性名稱出現(xiàn)次數(shù)說明

username1用戶名

Userinfopassword1密碼

userorg1所屬機構(gòu)

Srcapp1來源應(yīng)用，用GUID表示

SvcinfoToken1或0異步的功能的令牌

Callbackurl1或0異步服務(wù)回調(diào)的地址

表2請求報文SOAPBody屬性的值和含義

SOAPBody

名稱出現(xiàn)次數(shù)說明

*1請求報文，里面內(nèi)容可以是任意的業(yè)務(wù)報文內(nèi)容

表3返回報文的SOAPBody屬性的值和含義

SOAPBody

屬性名稱出現(xiàn)次數(shù)說明

**遵守soap協(xié)議標準的業(yè)務(wù)相關(guān)數(shù)據(jù)

5.4.2管理服務(wù)接口

7

DB32/T2777-2015

分類

管理服務(wù)接口又分為管理接口和服務(wù)接口，兩種接口都應(yīng)以WebService方式提供接口服務(wù)。各級

平臺在提供管理時都需要提供服務(wù)停用、服務(wù)啟用兩種接口，在提供服務(wù)時需提供服務(wù)同步接口，同步

接口分為主動同步和被動同步。

報文規(guī)范

.1管理接口

管理接口請求報文屬性應(yīng)符合表4的要求，服務(wù)停用參數(shù)規(guī)范和返回值規(guī)范應(yīng)分別符合表5和表6的

要求，服務(wù)啟用參數(shù)規(guī)范和返回值規(guī)范應(yīng)分別符合表7和表8的要求，SOAP1.1具體報文格式要求見附錄

A，SOAP1.2具體報文格式要求見附錄B。

表4請求報文報頭規(guī)范

SOAPHeader:SHeader

屬性名稱出現(xiàn)次數(shù)說明

username1用戶名

Userinfopassword1密碼

userorg1所屬機構(gòu)

表5服務(wù)停用報文SOAPBody參數(shù)規(guī)范

SOAPBody:Disable

名稱出現(xiàn)次數(shù)說明

Serviced1請求報文，里面內(nèi)容可以是停用服務(wù)的編號

表6服務(wù)停用報文返回值參數(shù)規(guī)范

SOAPBody:Disable

名稱出現(xiàn)次數(shù)說明

Result1返回服務(wù)停用的結(jié)果,成功：true；失敗:false

Exception1如果有異常，則寫入異常信息，無異?？蔀榭?/p>

表7服務(wù)啟用報文SOAPBody參數(shù)規(guī)范

SOAPBody:Enable

名稱出現(xiàn)次數(shù)說明

Serviced1請求報文，里面內(nèi)容可以是停用服務(wù)的編號

表8服務(wù)啟用報文返回值規(guī)范

8

DB32/T2777-2015

SOAPBody:Ensable

名稱出現(xiàn)次數(shù)說明

Result1返回服務(wù)啟用用的結(jié)果,成功：true；失敗:false

Exception1如果有異常，則寫入異常信息，無異?？梢詾榭?/p>

.2服務(wù)接口

服務(wù)接口請求報文報頭屬性的值和含義應(yīng)符合表9的要求。

表9請求報文報頭屬性的值和含義

SOAPHeader:SHeader

屬性名稱出現(xiàn)次數(shù)說明

username1用戶名

userinfopassword1密碼

userorg1所屬機構(gòu)

.3主動同步服務(wù)

主動服務(wù)是由各級平臺向省平臺送服務(wù)信息，主動同步的服務(wù)參數(shù)內(nèi)容可參考如下示例：

<sync>

<process>

0/1/2<!—處理方式0:新增/1:停用/2:啟用-->

</process>

<catalog>

<id><!—服務(wù)的ID，用GUID表示--></id>

<name><!—服務(wù)的目錄名--></name>

<url><!—服務(wù)的地址--></url>

</catalog>

</sync>

.4被動同步服務(wù)

被動服務(wù)是由各級平臺提供服務(wù)同步的接口，由省平臺向各級平臺同步服務(wù)信息，被動同步的服務(wù)

參數(shù)的具體內(nèi)容應(yīng)按照.3的要求。

6服務(wù)調(diào)用及部署要求

6.1總分平臺間服務(wù)調(diào)用架構(gòu)

6.1.1總分平臺間服務(wù)調(diào)用

總服務(wù)平臺通過總平臺服務(wù)目錄進行管理，總服務(wù)平臺上的服務(wù)通過服務(wù)總線自定義生成服

務(wù)，服務(wù)調(diào)用經(jīng)用戶驗證判斷，不應(yīng)匿名訪問。

總服務(wù)平臺與分（子）分別部署獨立的服務(wù)總線，總分平臺之間相互服務(wù)調(diào)用應(yīng)經(jīng)服務(wù)總線

調(diào)用，總分平臺間服務(wù)調(diào)用如圖7所示。

9

DB32/T2777-2015

圖7總分平臺間服務(wù)調(diào)用示意圖

6.2分（子）平臺間服務(wù)調(diào)用架構(gòu)

分（子）平臺的服務(wù)在分（子）平臺本地服務(wù)總線上發(fā)布并注冊到本地平臺服務(wù)目錄，通過服務(wù)同

步，同步到總服務(wù)平臺的服務(wù)目錄，根據(jù)不同分（子）平臺標識分別路由到各分（子）平臺服務(wù)總線。

分（子）平臺間服務(wù)調(diào)用如圖8所示。

10

DB32/T2777-2015

圖8地市間服務(wù)調(diào)用

7集成服務(wù)編寫要求

7.1服務(wù)設(shè)計開發(fā)原則

7.1.1高增長性

應(yīng)對服務(wù)請求的未來增長進行預(yù)計，使服務(wù)能適應(yīng)不斷增加的吞吐量。

7.1.2可重用性

使服務(wù)能被需求提出者以外的人重用，并宜使服務(wù)達到最大應(yīng)用范圍。

7.1.3可適應(yīng)性

應(yīng)根據(jù)業(yè)務(wù)服務(wù)的實際情況提供多種調(diào)用模式，宜提供以下調(diào)用模式：

——基于HTTP的SOAP報文同步調(diào)用；

——基于.NET過程調(diào)用的本地存根調(diào)用；

——基于.JAVA過程調(diào)用的本地存根調(diào)用。

7.1.4無狀態(tài)與自包含

服務(wù)不應(yīng)依賴于使用者和提供者間長期存在的關(guān)系，操作調(diào)用也不應(yīng)隱式地依賴于前一個調(diào)用。服

務(wù)應(yīng)設(shè)計為可避免維護會話上下文的需求，服務(wù)完成的操作所依賴的信息只需在本身內(nèi)部查找即可。

7.1.5考慮并發(fā)性

應(yīng)充分考慮服務(wù)的并發(fā)性調(diào)用，除在業(yè)務(wù)操作層面要求服務(wù)必須同步返回結(jié)果外，大部分服務(wù)宜采

11

DB32/T2777-2015

用異步調(diào)用方式，避免因并發(fā)量太多導致對服務(wù)提供者和服務(wù)總線的性能影響。

7.2服務(wù)分類

服務(wù)按業(yè)務(wù)類型進行分類，各應(yīng)用服務(wù)根據(jù)類型向服務(wù)平臺注冊，提供服務(wù)調(diào)用者調(diào)用。服務(wù)類型

定義應(yīng)符合表10的規(guī)定,可拓展。

表10服務(wù)應(yīng)用類型代碼

類型代碼業(yè)務(wù)要素名稱

01水環(huán)境

02空氣環(huán)境

03重點污染源

04機動車尾氣

05飲用水源地

06輻射環(huán)境

07危險固廢

08應(yīng)急風險源

……

90基礎(chǔ)服務(wù)類

……

91管理類

……

92安全類

……

99其他

7.3服務(wù)命名

7.3.1平臺通過服務(wù)注冊的方式，對各項服務(wù)進行統(tǒng)一的管理。

7.3.2平臺上注冊的服務(wù)需要按照服務(wù)命名的規(guī)則在服務(wù)平臺上注冊和被調(diào)用。

7.3.3服務(wù)的命名規(guī)則以XXX.YYY.SSS.MMM.FFF的方式進行命名并做注冊，含義分別為：

——XXX：表示為服務(wù)范圍；

——YYY：表示為服務(wù)屬地；

——SSS：表示為服務(wù)系統(tǒng)定義；

——MMM：表示為服務(wù)系統(tǒng)模塊定義；

——FFF:表示為服務(wù)方法定義。

7.3.4服務(wù)范圍定義

XXX（服務(wù)范圍定義）作為服務(wù)平臺工作范圍的標識，表示服務(wù)是從哪里產(chǎn)生的，在生態(tài)環(huán)境監(jiān)控

系統(tǒng)中缺省定義為XXX:JSHB。

7.3.5服務(wù)屬地定義

YYY（服務(wù)屬地定義）表示是從哪一級部門產(chǎn)生的服務(wù)。在生態(tài)環(huán)境監(jiān)控系統(tǒng)中服務(wù)屬地定義用各

地的行政區(qū)劃編碼簡寫來表示，服務(wù)屬地定義應(yīng)符合表11的要求。

12

DB32/T2777-2015

表11服務(wù)屬地定義

屬地編碼屬地名稱

3200江蘇省環(huán)保廳

3201南京市環(huán)保局

3202無錫市環(huán)保局

3203徐州市環(huán)保局

3204常州市環(huán)保局

3205蘇州市環(huán)保局

3206南通市環(huán)保局

3207連云港市環(huán)保局

3208淮安市環(huán)保局

3209鹽城市環(huán)保局

3210揚州市環(huán)保局

3211鎮(zhèn)江市環(huán)保局

3212泰州市環(huán)保局

3213宿遷市環(huán)保局

7.3.6服務(wù)系統(tǒng)定義

SSS（服務(wù)系統(tǒng)定義）表示是從哪一系統(tǒng)產(chǎn)生的服務(wù)。服務(wù)系統(tǒng)定義用生態(tài)環(huán)境監(jiān)控系統(tǒng)中建設(shè)的

各個應(yīng)用系統(tǒng)的簡稱來表示，系統(tǒng)簡稱全部用半角字符表示，可以由小寫字母和數(shù)字組合組成，所屬子

系統(tǒng)定義可參照表12的內(nèi)容。

表12子系統(tǒng)定義舉例

系統(tǒng)簡稱系統(tǒng)名稱

zxxt信用征集系統(tǒng)

zbtx指標體系系統(tǒng)

yjfk意見反饋系統(tǒng)

7.3.7服務(wù)系統(tǒng)模塊定義

MMM（服務(wù)系統(tǒng)模塊定義）由服務(wù)編寫者提供，服務(wù)名稱全部用半角字符表示，可以由小寫字母和

數(shù)字組合組成。服務(wù)編寫者應(yīng)確認編寫的服務(wù)在平臺上具有唯一的命名，并且提交平臺管理員注冊成功

后使用。

7.3.8服務(wù)方法定義

FFF（服務(wù)方法定義）由服務(wù)編寫者提供，服務(wù)名稱全部用半角字符表示，可以由小寫字母和數(shù)字

組合組成。服務(wù)編寫者應(yīng)確認編寫的服務(wù)在平臺上具有唯一的命名，并且提交平臺管理員注冊成功后使

用。

7.3.9服務(wù)命名示例

單點登錄系統(tǒng)Base模塊，統(tǒng)計在線人數(shù)方法的服務(wù)定義為：jshb.3200.base.sso.onlineusers

13

DB32/T2777-2015

7.4服務(wù)編號

7.4.1平臺能夠提供根據(jù)服務(wù)編號訪問服務(wù)的功能。

7.4.2服務(wù)編號是按照服務(wù)范圍、服務(wù)屬地、服務(wù)系統(tǒng)定義、服務(wù)系統(tǒng)模塊、服務(wù)名稱進行順序編號。

7.4.3服務(wù)系統(tǒng)模塊的編號為3位數(shù)，編號原則為順序號，不足3位的以0填充。

7.4.4服務(wù)名稱的編號為3位數(shù)，編號原則為順序號，不足3位的以0填充。

7.4.5以統(tǒng)計在線人數(shù)方法的服務(wù)定義（jshb.3200.base.sso.onlineusers）為例：

jshb.3200.base.sso.onlineusers

jshb.3200.90.001.001

統(tǒng)計在線人數(shù)方法的服務(wù)定義用編號定義為：jshb.3200.90.001.001

7.5服務(wù)報文

7.5.1服務(wù)請求報文

示例如下:

<s:Envelopexmlns:s="/soap/envelope/">

<s:Header>

<h:SHeaderxmlns:h="/"xmlns=/

xmlns:xsi="/2001/XMLSchema-instance"

xmlns:xsd="/2001/XMLSchema">

<userinfo>

<username>張三</username>

<password>123456</password>

<userorg>1</userorg>

</userinfo>

<svcinfo>

<srcapp>b4c02ef6-be33-470f-af92-f8c60c901703</srcapp>

<tokennumber>a52ad9ca-d9a1-4638-b539-307467cc190e</tokennumber>

<callbackurl>:1668/service/jshb.system.model.helloworld</callback

url>

</svcinfo>

</h:SHeader>

</s:Header>

<s:Bodyxmlns:xsi="/2001/XMLSchema-instance"

xmlns:xsd="/2001/XMLSchema">

<modifyxmlns="/">

<in0>user1</in0>

<in1>123456</in1>

<in2>1234567</in2>

<in3>1234567</in3>

</modify>

</s:Body>

</s:Envelope>

7.5.2服務(wù)調(diào)用者請求報文

14

DB32/T2777-2015

平臺中服務(wù)的調(diào)用者應(yīng)通過目錄服務(wù)獲取訪問服務(wù)在地址，然后按服務(wù)訪問要求規(guī)范提供服務(wù)訪問

報文的報頭信息，服務(wù)訪問調(diào)用服務(wù)的報頭可參考如下示例:

<s:Header>

<h:SHeaderxmlns:h="/"xmlns=/

xmlns:xsi="/2001/XMLSchema-instance"

xmlns:xsd="/2001/XMLSchema">

<userinfo>

<username>張三</username>

<password>123456</password>

<userorg>1</userorg>

</userinfo>

<svcinfo>

<srcapp>b4c02ef6-be33-470f-af92-f8c60c901703</srcapp>

<tokennumber>a52ad9ca-d9a1-4638-b539-307467cc190e</tokennumber>

<callbackurl>:1668/service/jshb.system.model.helloworld</callback

url>

</svcinfo>

</h:SHeader>

</s:Header>

注1：報文SoapHeader中xmlns=/為命名空間，應(yīng)與實際服務(wù)相對應(yīng)。

注2：報文SoapHeader中的用戶名和密碼應(yīng)通過服務(wù)集成平臺的身份驗證，否則不能使用服務(wù)。

注3：調(diào)用者在調(diào)用服務(wù)時，與實際業(yè)務(wù)相關(guān)的報文信息，按照服務(wù)提供者的要求生成實際報文。

7.5.3服務(wù)調(diào)用者返回報文

正常結(jié)果

示例如下：

<?xmlversion="1.0"encoding="utf-8"?>

<soap:Envelopexmlns:soap="/soap/envelope/"

xmlns:xsi="/2001/XMLSchema-instance"

xmlns:xsd="/2001/XMLSchema">

<soap:Body>

<modifyResponsexmlns="/">

<modifyResult>400</modifyResult>

</modifyResponse>

</soap:Body>

</soap:Envelope>

注1：報文SoapHeader中xmlns=/為命名空間，應(yīng)需要與實際服務(wù)相對應(yīng)。

注2：調(diào)用者在獲得服務(wù)結(jié)果時，與實際業(yè)務(wù)相關(guān)的報文信息，按照服務(wù)提供者的實際內(nèi)容獲取。

異常結(jié)果

通過平臺使用服務(wù)時，平臺根據(jù)報頭和報文捕獲異常，并將異常返回到調(diào)用者，平臺的異常狀態(tài)編

碼如表13。

15

DB32/T2777-2015

表13服務(wù)平臺的異常狀態(tài)

異常編碼異常描述

550請求的目錄不存在

551請求的目錄已停用

552請求的報頭不規(guī)范

553用戶不存在或無權(quán)限

554遠程服務(wù)器錯誤

555獲取異步服務(wù)結(jié)果令牌失效

8公共服務(wù)規(guī)范

8.1概述

各級平臺的公共服務(wù)是對外提供服務(wù)信息查詢、服務(wù)目錄查詢服務(wù)，名稱和接口類型如表13所示。

表14平臺的公共服務(wù)對外提供服務(wù)信息查詢、服務(wù)目錄查詢服務(wù)

服務(wù)名稱描述接口類型

IServiceFindService服務(wù)信息查詢WebService

IServiceFindRouting服務(wù)目錄查詢WebService

8.2要求

8.2.1服務(wù)信息查詢

查詢內(nèi)容

服務(wù)查詢是通過傳入的輸入?yún)?shù)來查找平臺服務(wù)目錄中的服務(wù)，服務(wù)信息查詢模塊調(diào)用平臺管理提

供的服務(wù)查詢接口來查詢服務(wù)的信息。返回的服務(wù)信息包括:服務(wù)基本信息、服務(wù)狀態(tài)信息、服務(wù)所擁

有的方法、版本信息等。

服務(wù)參數(shù)要求

查詢服務(wù)相關(guān)信息的服務(wù)名稱為IServiceFindService，查詢WSDL地址為http://服務(wù)器IP地址:端

口/IServiceFindService.asmx?wsdl，其服務(wù)方法參照表15，輸入?yún)?shù)和輸出參數(shù)分別參照表16和表17。

表15服務(wù)信息查詢服務(wù)方法

服務(wù)方法方法說明備注

GetServiceInfo查詢服務(wù)的信息見輸入/輸出參數(shù)說明

表16服務(wù)信息查詢輸入?yún)?shù)說明

標識符說明類型備注

Directory服務(wù)目錄String當前查詢服務(wù)的目錄

表17服務(wù)信息查詢輸出參數(shù)說明

標識符說明類型備注

16

DB32/T2777-2015

Id服務(wù)編號Int

rout_name服務(wù)名String

rout_directory服務(wù)目錄String

rout_path服務(wù)目錄String

rout_description服務(wù)描述String

rout_attach是否包含附件Int0:不包含，1:包含

rout_soapActionSoapActionString

rout_asyn調(diào)用方式String0:同步，1:異步

rout_asyntype異步回調(diào)方式Int0:主動，1:被動

rout_disabled是否禁用Int0:啟用，1:禁用

rout_log是否記錄日志Int0:不記錄日志,1:記錄日

志

rout_status服務(wù)狀態(tài)Int

rout_checkuser是否驗證用戶Int0:不驗證,1:驗證

user_id創(chuàng)建用戶Int

CreateDate服務(wù)上線時間DateTime

注：綁定類型為WebService，調(diào)用方式為同步調(diào)用

服務(wù)調(diào)用者請求報文格式示例

服務(wù)信息查詢服務(wù)調(diào)用者請求報文格式可參考如下示例，有關(guān)服務(wù)接口的WebService請求報文規(guī)

范內(nèi)容，應(yīng)符合本部分5.4的規(guī)定：

<s:Envelopexmlns:s="/soap/envelope/">

<s:Body>

<GetServiceInfoxmlns="/"

xmlns:i="/2001/XMLSchema-instance">

<dirctory>jshb.3200.base.sso.getonlineusers</dirctory>

</GetServiceInfo>

</s:Body>

</s:Envelope>

服務(wù)調(diào)用者結(jié)果返回報文格式示例

服務(wù)信息查詢服務(wù)調(diào)用者請求報文格式可參考如下示例，有關(guān)服務(wù)接口的WebService返回報文規(guī)

范內(nèi)容，應(yīng)符合本部分5.4的規(guī)定：

<?xmlversion="1.0"encoding="utf-8"?>

<soap:Envelopexmlns:soap="/soap/envelope/"

xmlns:xsi="/2001/XMLSchema-instance"

xmlns:xsd="/2001/XMLSchema">

<soap:Body>

<GetServiceInfoResponsexmlns="/">

<GetServiceInfoResult>

<id>22</id>

17

DB32/T2777-2015

<rout_name>獲取在線人數(shù)</rout_name>

<rout_directory>jshb.3200.base.sso.getonlineusers</rout_directory>

<rout_directory_ids>3.94</rout_directory_ids>

<rout_path>0:8088/WebServiceSSO.asmx</rout_path>

<rout_description>獲取集成平臺實時在線人數(shù)</rout_description>

<rout_attach>1</rout_attach>

<rout_soapAction>/GetOnlineUsers</rout_soapAction>

<rout_asyn>0</rout_asyn>

<rout_asyntype>0</rout_asyntype>

<rout_disabled>0</rout_disabled>

<rout_log>0</rout_log>

<rout_status>1</rout_status>

<rout_checkuser>0</rout_checkuser>

<user_id>0</user_id>

<CreateDate>2012-07-13T10:00:14.64</CreateDate>

</GetServiceInfoResult></GetServiceInfoResponse>

</soap:Body>

</soap:Envelope>

8.2.2服務(wù)目錄查詢

查詢內(nèi)容

服務(wù)查詢是通過傳入的輸入?yún)?shù)來查找平臺服務(wù)目錄中的服務(wù)，服務(wù)信息查詢模塊調(diào)用平臺管理提

供的服務(wù)查詢接口來查詢服務(wù)的信息。返回的服務(wù)信息包括:服務(wù)基本信息、服務(wù)狀態(tài)信息、服務(wù)所擁

有的方法、版本信息等。

服務(wù)參數(shù)要求

查詢服務(wù)相關(guān)信息的服務(wù)名稱為IServiceFindRouting，查詢WSDL地址為http://服務(wù)器IP地址:端

口號/IServiceFindRouting.asmx?wsdl，其服務(wù)方法參照表18，目錄查詢不需要請求不需要參數(shù)，參數(shù)

WSDL表示該服務(wù)發(fā)布的網(wǎng)絡(luò)描述語言，輸出參數(shù)參照表19。

表18服務(wù)目錄查詢服務(wù)方法

服務(wù)方法方法說明備注

GetRoutingList查詢目錄列表見輸入/輸出參數(shù)說明

表19服務(wù)目錄查詢輸出參數(shù)說明

標識符說明類型備注

Directory服務(wù)目錄String

注：綁定類型為WebService，調(diào)用方式為同步調(diào)用

服務(wù)調(diào)用者請求報文格式示例

18

DB32/T2777-2015

服務(wù)信息查詢服務(wù)調(diào)用者請求報文格式可參考如下示例，有關(guān)服務(wù)接口的WebService請求報文規(guī)

范內(nèi)容，應(yīng)符合本部分5.4的規(guī)定：

<s:Envelopexmlns:s="/soap/envelope/">

<s:Body>

<GetRoutingListxmlns="/"

xmlns:i="/2001/XMLSchema-instance"/>

</s:Body>

</s:Envelope>

服務(wù)調(diào)用者結(jié)果返回報文格式示例

服務(wù)信息查詢服務(wù)調(diào)用者請求報文格式可參考如下示例，有關(guān)服務(wù)接口的WebService返回報文

規(guī)范內(nèi)容，應(yīng)符合本部分5.4的規(guī)定：

<soap:Envelopexmlns:soap="/soap/envelope/"

xmlns:xsi="/2001/XMLSchema-instance"

xmlns:xsd="/2001/XMLSchema">

<soap:Body>

<GetRoutingListResponsexmlns="/">

<GetRoutingListResult>

<Directory>

<Name>jshb.3200.basewaithandle.getwaitreaddbmailstotal</Name>

</Directory>

<Directory>

<Name>jshb.3200.base.sso.getonlineusersinfo</Name>

</Directory>

<Directory>

<Name>jshb.3200.base.waithandle.getwaitmessageslist</Name>

</Directory>

<Directory>

<Name>jshb.3200.base.waithandle.getwaitmessagestotal</Name>

</Directory>

<Directory>

<Name>jshb.3200.base.waithandle.getwaitreaddbmailslist</Name>

</Directory>

<Directory>

<Name>jshb.3200.base.pwd.modify</Name>

</Directory>

<Directory>

<Name>jshb.3200.base.huanbao.executerequst</Name>

</Directory>

<Directory>

<Name>jshb.3200.base.msq.restoremessage</Name>

</Directory>

<Directory>

19

DB32/T2777-2015

<Name>jshb.3200.base.sso.getonlineusers</Name>

</Directory>

</GetRoutingListResult>

</GetRoutingListResponse>

</soap:Body>

</soap:Envelope>

9服務(wù)接口應(yīng)用

9.1應(yīng)用舉例描述

平臺桌面與單點登錄系統(tǒng)服務(wù)調(diào)用交互情景等內(nèi)容時，如果要修改用戶的密碼，則需向單點登錄系

統(tǒng)在服務(wù)平臺注冊的服務(wù)地址（http://服務(wù)器地址/jshb.3200.base.pwd.modify）發(fā)出請求，平臺將

請求轉(zhuǎn)發(fā)給單點登錄系統(tǒng)，由單點登錄系統(tǒng)將處理結(jié)果返回給應(yīng)用桌面。

9.2服務(wù)調(diào)用

9.2.1平臺發(fā)出服務(wù)調(diào)用請求

其服務(wù)調(diào)用請求報文可參考如下示例，其中請求目錄為jshb.3200.base.pwd.modify：

<s:Envelopexmlns:s="/soap/envelope/">

<s:Header>

<h:SHeaderxmlns:h="/"xmlns=/

xmlns:xsi="/2001/XMLSchema-instance"

xmlns:xsd="/2001/XMLSchema">

<userinfo>

<username>張三</username>

<password>123456</password>

<userorg>1</userorg>

</userinfo>

<svcinfo>

<srcapp>b4c02ef6-be33-470f-af92-f8c60c901703</srcapp>

<tokennumber>a52ad9ca-d9a1-4638-b539-307467cc190e</tokennumber>

<callbackurl>:1668/service/jshb.system.model.helloworld</callback

url>

</svcinfo>

</h:SHeader>

</s:Header>

<s:Bodyxmlns:xsi="/2001/XMLSchema-instance"

xmlns:xsd="/2001/XMLSchema">

<modifyxmlns="/">

<in0>axcdd</in0>

<in1>password</in1>

<in2>1234567</in2>

<in3>1234567</in3>

20

DB32/T2777-2015

</modify>

</s:Body>

</s:Envelope>

9.2.2