水利信息產(chǎn)品服務(wù)總則

中華人民共和國水利行業(yè)標(biāo)準(zhǔn)水利信息產(chǎn)品服務(wù)總則2020-07-24發(fā)布2020-10-24實(shí)施I3項(xiàng)水利行業(yè)標(biāo)準(zhǔn)的公告2020年第11號替代標(biāo)準(zhǔn)號發(fā)布日期實(shí)施日期123水利信息產(chǎn)品服務(wù)總則水利部2020年7月24日Ⅲ V 1 1 14水利信息產(chǎn)品服務(wù) 2 2 2 2 2 2 2 3 7附錄A(規(guī)范性附錄)產(chǎn)品服務(wù)日志內(nèi)容分類 8附錄B(資料性附錄)產(chǎn)品服務(wù)管理示例 9附錄C(資料性附錄)開發(fā)產(chǎn)品服務(wù)示例 本標(biāo)準(zhǔn)主要起草人：蔡陽程益聯(lián)陳子丹付靜雍熙張鵬程張麗麗國際合作與科技司(通信地址：北京市西城區(qū)白廣路二條2號；郵政編碼：100053;電話：010-1GB/T20258.3—2019基礎(chǔ)地理信息要素?cái)?shù)據(jù)字典第3部分：1:250001:500001:GB/T20258.4—2019基礎(chǔ)地理信息要素?cái)?shù)據(jù)字典第4部分：1:2500001:5000001:24.1.2通用信息產(chǎn)品服務(wù)應(yīng)遵守SOAP、REST或流媒體產(chǎn)品服務(wù)協(xié)議標(biāo)準(zhǔn)。a)地圖產(chǎn)品服務(wù)應(yīng)遵守OGC標(biāo)準(zhǔn)，包括WMTS、WMS、WFS、WPS四類產(chǎn)品服務(wù)，對于b)功能產(chǎn)品服務(wù)應(yīng)遵守SOAP協(xié)議標(biāo)準(zhǔn)。4.2.2地理信息產(chǎn)品服務(wù)的數(shù)據(jù)a)產(chǎn)品服務(wù)名稱適合計(jì)算機(jī)和數(shù)據(jù)庫技術(shù)的管理要求，產(chǎn)品提供者應(yīng)按產(chǎn)品特征和要素內(nèi)容，4.3.2通用信息產(chǎn)品服務(wù)命名應(yīng)符合GB/T20258.3與GB/T20258.4的要求。對于未列入其中的a)產(chǎn)品服務(wù)中文名稱包括產(chǎn)品服務(wù)內(nèi)容描述，名稱長度不超過60個(gè)漢字；b)產(chǎn)品服務(wù)英文名稱包括產(chǎn)品服務(wù)內(nèi)容描述，各單詞首字母大寫，名稱長度不超過256個(gè)字母；4.3.3地理信息產(chǎn)品服務(wù)命名除應(yīng)滿足通用信息產(chǎn)品服務(wù)命名規(guī)則外，各產(chǎn)品服務(wù)命名中要素描述應(yīng)符合SL729的規(guī)定。水利空間要素根據(jù)顯示要求進(jìn)行整合分級時(shí)，參照SL252—2017的分級標(biāo)準(zhǔn)與CH/Z9011—2011中的地圖顯示分級標(biāo)準(zhǔn)，在原名稱上添加級別后綴。a)產(chǎn)品服務(wù)調(diào)用權(quán)限檢查應(yīng)包括產(chǎn)品服務(wù)權(quán)限檢查(是否為可訪問產(chǎn)品服務(wù))和業(yè)務(wù)應(yīng)用權(quán)限檢查(是否已注冊授權(quán));3產(chǎn)品服務(wù)權(quán)限檢查接口應(yīng)符合表1的要求。階段是否必需是是是是響應(yīng)編碼，包括：NORMAL(1)、ERROR(一1)是具體信息產(chǎn)品服務(wù)注冊信息查詢接口應(yīng)符合表2的要求。階段否資源的關(guān)鍵詞否資源的類型ID(產(chǎn)品服務(wù)、數(shù)據(jù)、硬件、應(yīng)用)否否資源的注冊時(shí)間否資源的當(dāng)前狀態(tài)是是資源名稱是是資源類型名稱是資源注冊時(shí)間是資源狀態(tài)4表2產(chǎn)品服務(wù)注冊信息查詢接口說明表(續(xù))階段是否必需是資源可用性狀態(tài)是資源提供單位名稱是資源提供單位聯(lián)系人名稱是響應(yīng)編碼，包括：NORMAL(1)、ERROR(-1)、是具體信息產(chǎn)品服務(wù)運(yùn)行狀態(tài)查詢接口應(yīng)符合表3的要求。階段是否必需是資源編碼是資源運(yùn)行狀態(tài)：停止(0)、運(yùn)行(1)是響應(yīng)編碼，包括：NORMAL(1)、ERROR(-1)是具體信息產(chǎn)品服務(wù)性能數(shù)據(jù)監(jiān)控接口應(yīng)符合表4的要求，請求信息對象應(yīng)符合表5的要求。階段是否查詢起始時(shí)間否查詢終止時(shí)間是是是是者域名)是是是產(chǎn)品服務(wù)平均響應(yīng)時(shí)間是產(chǎn)品服務(wù)最大響應(yīng)時(shí)間是產(chǎn)品服務(wù)最小響應(yīng)時(shí)間5階段是否必需是questInfoList對象表說明)是響應(yīng)編碼，包括：NORMAL(1)、ERROR(-1)是具體信息是產(chǎn)品服務(wù)請求開始時(shí)間是產(chǎn)品服務(wù)請求結(jié)束時(shí)間是產(chǎn)品服務(wù)運(yùn)行狀態(tài)監(jiān)控接口說明應(yīng)符合表6的要求。階段是否必需是者域名)否監(jiān)控指標(biāo)類型，為空查詢?nèi)恐笜?biāo)包括：CPU(1)、內(nèi)存(2)、存儲空間(3)是是者域名)是是內(nèi)存信息是硬盤存儲信息是網(wǎng)絡(luò)狀態(tài)信息否是響應(yīng)編碼，包括：NORMAL(1)、ERROR(-1)、是具體信息產(chǎn)品服務(wù)監(jiān)控系統(tǒng)提供WebService的日志查詢接口供被監(jiān)控產(chǎn)品服務(wù)調(diào)用。被監(jiān)控產(chǎn)品服務(wù)應(yīng)按照規(guī)范要求的日志格式調(diào)用接口寫入日志內(nèi)容，供系統(tǒng)監(jiān)控和分析。日志寫入接口應(yīng)符合表7的要求，日志查詢接口應(yīng)符合表8的要求。6階段是否必需是日志名稱是使用產(chǎn)品服務(wù)時(shí)間是日志保存時(shí)長是是是日志類型，包括：DEBUG(01)、INFO(02)WARN(03)、ERROR(04)、FATAL(是日志內(nèi)容是進(jìn)行關(guān)聯(lián))是日志記錄的操作類型，包括：1—登錄；2—是日志記錄應(yīng)用ID(和注冊的應(yīng)用關(guān)聯(lián))是日志記錄的用戶ID(和用戶進(jìn)行關(guān)聯(lián))是否是響應(yīng)編碼，包括：NORMAL(1)、ERROR(—1)、是具體信息階段是否必需否日志名稱是日志查詢時(shí)間開始是日志查詢結(jié)束時(shí)間是日志保存時(shí)長否否日志類型，包括：DEBUG(01)、INFO(02)、WARN(03)、ERROR(04)、FATAL(否與日志相關(guān)的產(chǎn)品服務(wù)類型否否是日志記錄的操作類型，包括：1—登錄；2—注銷；否者域名)7表8日志查詢接口說明表(續(xù))階段是否必需是日志ID是日志名稱是日志記錄開始時(shí)間是日志記錄結(jié)束時(shí)間是日志保存時(shí)長是日志類型，包括：DEBUG(01)、INFO(02)、是日志內(nèi)容是否否與日志相關(guān)的產(chǎn)品服務(wù)類型否否否者域名)是日志記錄的操作類型，包括：1—登錄；2—注銷；是日志記錄應(yīng)用ID(和注冊的應(yīng)用關(guān)聯(lián))是日志記錄的用戶ID(和用戶進(jìn)行關(guān)聯(lián))是是響應(yīng)編碼，包括：NORMAL(1)、ERROR(-1)是具體信息產(chǎn)品服務(wù)提供方應(yīng)將該產(chǎn)品服務(wù)元數(shù)據(jù)信息注冊到產(chǎn)品服務(wù)注冊中心。注冊內(nèi)容按照SL473填數(shù)據(jù)庫及標(biāo)識符設(shè)計(jì)按SL478執(zhí)行。8產(chǎn)品服務(wù)日志內(nèi)容分類見表A.1。表A.1產(chǎn)品服務(wù)日志內(nèi)容分類安全類信息用戶退出正常寫數(shù)據(jù)庫正常調(diào)試信息性能類信息正常其中日志級別分為5類：a)ERROR(錯(cuò)誤):此信息輸出后，產(chǎn)品服務(wù)核心模塊正常工作，但無法確定系統(tǒng)會一直正常工作下去，需要修復(fù)ERRO)R這個(gè)錯(cuò)誤才能b)WARN(警告):此信息輸出后，產(chǎn)品服務(wù)一般模塊存在問題，不影響系統(tǒng)運(yùn)行；c)INFO(通知):此信息輸出后，主要是記錄產(chǎn)品服務(wù)運(yùn)行狀態(tài)等關(guān)聯(lián)信息；d)DEBUG(調(diào)試):產(chǎn)品服務(wù)的調(diào)試信息輸出，主要是記錄產(chǎn)品服務(wù)的調(diào)試信息，為開發(fā)者提e)TRACE(跟蹤):最細(xì)粒度的輸出，除卻上面各種情況外，希望輸出的相關(guān)信息，都可以在9B.3產(chǎn)品服務(wù)查詢等元數(shù)據(jù)信息對產(chǎn)品服務(wù)進(jìn)行查詢。產(chǎn)品服務(wù)查詢流程見圖B.1。圖B.1查詢檢索根據(jù)已知條件(如產(chǎn)品服務(wù)注冊名、產(chǎn)品服務(wù)顯示名、產(chǎn)品服務(wù)注冊類型、產(chǎn)品服務(wù)注冊日期、產(chǎn)品服務(wù)狀態(tài))查詢產(chǎn)品服務(wù)，對查詢結(jié)果進(jìn)行列表展示、查看產(chǎn)品服務(wù)詳情等。通用產(chǎn)品服務(wù)包括各種WebService產(chǎn)品服務(wù)，并以查詢產(chǎn)品服務(wù)為例介紹該類型產(chǎn)品服務(wù)的通用標(biāo)準(zhǔn)。此處說明調(diào)用產(chǎn)品服務(wù)遵循標(biāo)準(zhǔn)的WebService規(guī)范，請求參數(shù)和返回結(jié)果遵循標(biāo)準(zhǔn)的JSON數(shù)據(jù)傳輸格式，調(diào)用說明見表C.1。請求代理地址具體以申請使用調(diào)用后臺響應(yīng)的方法(例如：lucene.Lucene0010SearchLogic就是后臺對應(yīng)的查詢方法){"timeStamp":"2014—0因?yàn)閞equestData中還嵌套有其他的對象類，具體的對象中參數(shù)說比如requestData中的com.superAreaData對象參考queryAreaData為每次查詢返回的條數(shù)requestData類用于創(chuàng)建后臺請求的JSON字符串各個(gè)參數(shù)的類，可以通過JSON轉(zhuǎn)換方法將re-questData類轉(zhuǎn)換成JSON用于申請產(chǎn)品服務(wù)。繼承類以及類名應(yīng)符合表C.2的要求，參數(shù)設(shè)置應(yīng)符Dataclass名Dataclass名Dataclass物理名com.supermap.wegis.transdata.search.searc子類Dataclass物理名Class說明Class說明父類Class名com.supermap.wegis.services.data父類Class名詳細(xì)參數(shù)說明查詢的類型0:一級索引；1:二級索引；2:空間索引；3:常用查詢空間，屬性。6+2要素中分類(P201等)查詢二級索引時(shí)設(shè)定wegis.transData.search.search空間查詢類型空間查詢時(shí)設(shè)定—0:點(diǎn)；1:面比例尺空間查詢時(shí)設(shè)定。比例尺地圖的范圍空間查詢時(shí)設(shè)定。地圖的范圍wegis.lucene.data.pointDat點(diǎn)串空間查詢時(shí)設(shè)定。點(diǎn)串是否取得統(tǒng)計(jì)信息的范圍空間查詢時(shí)設(shè)定。地圖的范圍比例尺空間查詢時(shí)設(shè)定。比例尺查詢結(jié)果類型1:詳情；2:統(tǒng)計(jì)空或者0:全部查詢；1:只查返回?cái)?shù)據(jù)應(yīng)按照J(rèn)SON格式進(jìn)行組織，返回?cái)?shù)據(jù)的固定字段應(yīng)符合表C.4的要求，返回?cái)?shù)據(jù)查詢結(jié)果信息應(yīng)符合表C.5的要求。各個(gè)參數(shù)可參考的數(shù)據(jù)類型和代表的具體意義以本例為準(zhǔn)，其他查詢執(zhí)行信息java.util.List<com.supermap.wegis.transData.sjava.util.List<java.util.Map<查詢結(jié)果詳情Listjava.util.List<com.supermap.wegis.transData.sjava.util.List<java.util.List<com.super統(tǒng)計(jì)信息詳細(xì)Listjava.util.List<com.supermap.wegis.transData.sea二級詳細(xì)信息surveryData數(shù)據(jù)類型為java.util.List<com.supermap.wegis.transData.search.surveyData>java.util.List<com.sujava.util.List<java.util.Map信息查詢結(jié)果詳情ListcellData數(shù)據(jù)類型為java.util.List<com.supermap.wegis.transData.search.cellData>的數(shù)據(jù)，說明說明區(qū)域中心點(diǎn)Y區(qū)域Bounds查詢類型列寬是否選中小數(shù)點(diǎn)區(qū)域Code區(qū)域中心點(diǎn)X理產(chǎn)品服務(wù)接口。此處說明調(diào)用產(chǎn)品服務(wù)遵循標(biāo)準(zhǔn)的WebService規(guī)范，請求參數(shù)和返回結(jié)果遵循標(biāo)C.2.1切片地圖產(chǎn)品服務(wù)(WMT切片地圖產(chǎn)品服務(wù)包括getCapabitities產(chǎn)品服務(wù)和getTile產(chǎn)品服務(wù)，getCapabitities產(chǎn)品服務(wù)應(yīng)符合表C.8的要求，getTile產(chǎn)品服務(wù)應(yīng)符合表C.9的要求。表C.8getCapabitities產(chǎn)品服務(wù)產(chǎn)品服務(wù)類型。請求WMTS產(chǎn)品服務(wù)，請求類型需要設(shè)為“WMTS”請求名稱。請求getCapabilities操作，請求名稱需要設(shè)為“getCapabilities”R&OFFLEVEL=38.tileMatrix=48.tileRow=38.tile參數(shù)說明請求WMTS產(chǎn)品服務(wù)，請求類型需要設(shè)為“WMTS”請求名稱。請求getCapabilities操作，請求名稱需要設(shè)為“getCapabilities”版本號。必須有且唯一樣式。其值可以省略或者設(shè)為default格式。想要獲得的資源格式，必須有且唯一，superMapiServer切片矩陣。必須有且唯一請求的切片行。切片矩陣的行值從上到下依次是0、1……matrixHeight-1請求的切片列。切片矩陣的列值從左到右依次是0、1……matrixWidth-1網(wǎng)絡(luò)要素產(chǎn)品服務(wù)包括getCapabitities產(chǎn)品服務(wù)、describeFeatureType產(chǎn)品服務(wù)和getFeature產(chǎn)品服務(wù)，getCapabitities產(chǎn)品服務(wù)應(yīng)符合表C.10的要求，describeFeaturehttp://x×X.X××.XX×.X××/wservice=WFS&request=getCapabiliti產(chǎn)品服務(wù)類型。請求WFS產(chǎn)品服務(wù)，請求類型需要設(shè)為“WFS”請求名稱。請求getCapabilities操作，請求名稱需要設(shè)為“getCapabilities”表C.11describeFeatureType產(chǎn)品Name=HYPO:HYPO_6請求版本號。默認(rèn)為“1.0.0”產(chǎn)品服務(wù)類型。默認(rèn)為“WFS”請求名稱。請求describeFeatureType操作，請求名稱需要設(shè)為“describeFeatureType”要素類型列表。要素類型之間以英文逗號分隔。如果沒有設(shè)置typeName的值，表示請求WFS產(chǎn)品服務(wù)提供的所有要素類型輸出格式，指定用于描述要素類型的schema描述語言。默認(rèn)為“XMLSchema”。XMLSchema必須支持，其他格式，比如DTD也可以，只要在capabilities文檔請求版本號。默認(rèn)為“1.0.0”產(chǎn)品服務(wù)類型。默認(rèn)為“WFS”請求名稱。請求getFeature操作，請求名稱需要設(shè)為“getFeature”或者“getFeatureWithLock”。getFeatureWithLock跟getFeature相似，只是如果使用getFeatureWithLock,則會對被選擇的表C.12getFeature產(chǎn)品服務(wù)(續(xù))特性列表。參數(shù)列表規(guī)則參考請求參數(shù)規(guī)則?！啊弊址軌虮硎舅斜粰z索的特性。在每一或typeName列表和propertyName列表形成1:1的映射。默認(rèn)值表示所有特性都可以獲得。當(dāng)WFS產(chǎn)品服務(wù)遇到?jīng)]有選擇要素的全部必要特性的查詢時(shí)，WFS將會在內(nèi)部擴(kuò)大特性列表以保證其包含所有必要特性名，所以，一個(gè)WFS客戶端獲取的特性值可能比請求的要多如果沒有指定特性名稱，要素的所有特性將返回要素版本。如果支持要素版本，“All”表示獲取一個(gè)要素的所有版本。整數(shù)值“N”表示獲取一個(gè)要素的第N個(gè)版本。沒有值，表示提取最近的要素版本信息。版本號從1開始，1是最老的版本，如果版本值大于指定的最大版本號，最大要素個(gè)數(shù)。maxFeatures參數(shù)值設(shè)置為一個(gè)正整數(shù)，用來表示W(wǎng)FS對請求響應(yīng)的最大要素個(gè)數(shù)有設(shè)置該參數(shù)的值，將默認(rèn)最多返回2000個(gè)要素，此默認(rèn)值可以要素類型列表。如果已經(jīng)指定了featureID參數(shù)，要素標(biāo)識符。該參數(shù)與filter和BBox參數(shù)相斥過濾器。filter參數(shù)用來設(shè)置查詢限制條件?？臻g的或非空間的限制條件都可以進(jìn)行設(shè)該參數(shù)的設(shè)置遵照過濾器編碼規(guī)范。如果使用過濾器參數(shù)，對于每一個(gè)在typeName參數(shù)列表中的要素類以過濾器參數(shù)編碼的過濾器以英文圓括號表示，“(”和“)使用該參數(shù)必須要typeName參數(shù)。該參數(shù)與featureID和BBox參數(shù)相斥。邊界框。在featureID或者filter環(huán)境下，客戶端可以指定邊界框。使用該參數(shù)必須要typeName參數(shù)。該參數(shù)與featureID和filter參數(shù)相斥其他格式(包括非xml和二進(jìn)制的格式)也可以支持，只要在capabilities文檔中進(jìn)行聲明即可網(wǎng)絡(luò)地圖產(chǎn)品服務(wù)包括getCapabitities產(chǎn)品服務(wù)和getMap產(chǎn)品服務(wù)，getCapabitities產(chǎn)品服務(wù)表C.13getCapabitities產(chǎn)品服務(wù)service=WMS&request=getCapabiliti產(chǎn)品服務(wù)類型。請求WMS產(chǎn)品服務(wù)，請求類型需要設(shè)為“WMS”如果產(chǎn)品服務(wù)器不支持所請求的版本，會根據(jù)OGC標(biāo)準(zhǔn)返回一個(gè)不同的請求名稱。1.0.0版本的，不贊成使用，支持該值的目的是向后getMap&CRS=EPSG:4326&BBox=8.949618641415867,74,54,119.05038135858413&-foimage/png&layers=0.0,0.10,0.1,0.11,2,3,0.16,0.7,0.17,8,0.9,0.19&styles=8.width=5128.height=512&iled=true&t請求名稱。請求getMap操作，請求名稱需要設(shè)為“getMap”或者“map”(map的，不贊成使用，支持該值的目的是向后兼容)地圖圖層列表，地圖圖層之間以半角英文逗號進(jìn)行分隔。最左邊的圖層放到前一個(gè)的上面，依次類推。圖層名稱必須是getCapabilities操作返回的文元素的值。(不能請求只有title而沒有name屬性的layer)。如果客戶端請求了沒有name屬性的圖層或者不存在的圖層，產(chǎn)品服務(wù)器返回一個(gè)code為layerNotDefined的異常信息請求圖層的樣式列表，圖層樣式之間以逗號分隔。styles值與layers參數(shù)StyleName請求產(chǎn)品服務(wù)器預(yù)定義的圖層樣式，也可以通過SLD參SLD文檔的URI。SLD是用戶自定義的圖層樣式表，該URI必須對W問的空間坐標(biāo)參考系統(tǒng)。該參數(shù)值應(yīng)該是getCapabilities操作中產(chǎn)品服務(wù)器聲明的SRSBoundingbox(地圖范圍),該參數(shù)的值為半角英文逗號分隔的一串實(shí)數(shù)，形如“minx,miny,maxx,maxy”,分別代表指定SRS下的區(qū)域坐標(biāo)最小X、最小Y、最大X地圖的輸出格式。WMS產(chǎn)品服務(wù)器的capabilities文檔中聲明的getMap中的for