标准规范下载简介
SL/T 798-2020 水利信息产品服务总则(清晰无水印)ICS 03.080.99 P55
Generalrulesofwaterinformationproductsservice
XJJ 126-2020标准下载中华人民共和国水利部发布
中华人民共和国水利部 关于批准发布《水利水电工程水文计算规范》等 3项水利行业标准的公告 2020年第11号
中华人民共和国水利部批准《水利水电工程水文计算规范》(SL/T278一2020)等3项为水 业标准,现予以公布
水利部 2020年7月24日
范围·. 规范性引用文件 水利信息产品服务 4.1产品服务分类 4.2产品数据格式 4.3产品服务命名规则 水利信息产品服务功能与接口.…… 5.1一般规定. 5.2产品服务功能 5.3产品服务接口 6水利信息产品服务注册.... 附录A(规范性附录) 产品服务日志内容分类 附录B(资料性附录)产品服务管理示例 附录C(资料性附录) 开发产品服务示例
本标准规定了水利信息产品服务的类型、注册参数、访问接口和注册流程。 本标准适用于水利信息产品服务的设计、开发和注册,
下列文件中的内容通过文中的规范性引用而构成本标准必不可少的条款。其中,注日期的引用文 件,仅该日期对应的版本适用于本标准;不注日期的引用文件,其最新版本(包括所有的修改单)适 用于本标准。 GB/T20258.3—2019基础地理信息要素数据字典第3部分:1:250001:500001: 100000比例尺 GB/T20258.4—2019基础地理信息要素数据字典第4部分:1:2500001:5000001: 1000000比例尺 SL252一2017水利水电工程等级划分及洪水标准 SL473水利信息核心元数据 SL478水利信息数据库表结构及标识符编制规范 SL729水利空间要素数据字典 CH/Z9011一2011地理信息公共服务平台电子地图数据规范
水利信息产品waterinformationproduct 水事活动中利用相关数据加工提炼形成的,能够为其他水事或涉水活动再利用,描述某个或某类 对象特征的表格、图示和地图等数据成果。 3.2 产品服务productservice 可供业务应用调用的特定信息产品的在线或离线服务。 3.3 产品服务注册中心productserviceregistrationcenter 统一管理产品服务的环境,为各产品服务的注册、协议转换、路由、同步等提供基础支撑,将已 注册产品服务更新通知发送给产品服务消费者。 3.4 产品服务注册productserviceregistration 产品服务提供方将该产品服务元数据注册到产品服务注册中心的行为。 3.5 产品服务监控productservicemonitoring 产品服务注册中心对已注册产品服务的运行状态进行监视和运行进程进行控制的行为。
4.1.1水利信息产品服务应划分为通用信息产品服务和地理信息产品服务两类。
水利信息产品服务应划分为通用信息产品服务和地理信息产品服务两类。 通用信息产品服务应遵守S()AP、REST或流媒体产品服务协议标准。 地理信息产品服务应分成地图产品服务和功能产品服务两类。 a)地图产品服务应遵守(OGC标准,包括WMTS、WMS、WFS、WPS四类产品服务,对于 ()GC标准不支持的多时相瓦片等产品服务,应遵循REST标准; b)功能产品服务应遵守S()AP协议标准
4.2.1通用信息产品服务的数据格式应按结构化数据、半结构化和非结构化数据划分。 4.2.2地理信息产品服务的数据格式宜包括地图切片、TIF影像和空间要素SHP/E00文件。
水利信息产品服务功能与接口
产品服务被调用时,应首先对产品服务调用者的访问权限进行检查,包括产品服务调用权限和产 品服务数据访问权限: a)产品服务调用权限检查应包括产品服务权限检查(是否为可访问产品服务)和业务应用权限 检查(是否已注册授权); b)产品服务数据访问权限检查应根据授权规则检查产品服务涉及的数据类型和访问范围
产品服务被调用运行过程中,应采取适当方式提供产品服务的运行状态,并接受对产品服务 程进行控制的指令。产品服务注册中心通过管理平台应能监视产品服务当前运行状态,并对产 进行暂停运行、重启运行和停止运行等操作
产品服务日志应记录产品服务运行的异常信息、状态信息、性能指标及操作日志。 产品服务日志记录内容应包括产品服务名称、产品服务类型、产品服务位置、产品服务状态、叫 阿 应时间、实施操作的用户、操作时间、IP地址、操作内容等。日志级别及日志记录格式见附录A
产品服务权限检查接口应符合表1的要求
表1产品服务权限检查接口说明表
5.3.2注册信息查询接口
产品服务注册信息查询接口应符合表2的要求。
册信息查询接口应符合
服务注册信息查询接口说
SL/T798—2020
品服务注册信息查询接口说明表 (续
5.3.3运行状态查询接口
产品服务运行状态查询接口应符合表3的要求
表 品服务运行状态查询接口说明表
表 产品服务性能数据监控接口说明表
SL/T 798—2020
表4 产品服务性能数据监控接口说明表(续
表5请求信息对象说明表
5.3.5运行状态监控接
品服务运行状态监控接口说明应符合表6的要习
表6产品服务运行状态监控接口说明表
5.3.6日志访问接口
产品服务监控系统提供WebService的日志查询接口供被监控产品服务调用。被监控产品服 安照规范要求的日志格式调用接口写人日志内容,供系统监控和分析。日志写入接口应符合表 日志查询接口应符合表8的要求
表8日志查询接口说明表(续)
产品服务提供方应将该产品服务元数据信息注册到产品服务注册中心。注册内容按照SL.4 司, 包括产品服务的名称、地址、产品服务类型、版本、权限范围等。产品服务管理示例见附录 数据库及标识符设计按SI.478执行
SL/T 7982020
附录A (规范性附录) 产品服务日志内容分类
附录A (规范性附录) 产品服务日志内容分类
表A.1产品服务日志内容分类
其中日志级别分为5类: a)ERR()R(错误):此信息输出后,产品服务核心模块正常工作,但无法确定系统会一直正常 工作下去,需要修复ERROR这个错误才能正常工作; b)WARN(警告):此信息输出后,产品服务一般模块存在问题,不影响系统运行; c)INF()(通知):此信息输出后,主要是记录产品服务运行状态等关联信息; d)DEBUG(调试):产品服务的调试信息输出,主要是记录产品服务的调试信息,为开发者提 供支持; e)TRACE(跟踪):最细粒度的输出,除却上面各种情况外,希望输出的相关信息,都可以在 这里。
附 (资料性附录) 产品服务管理示例
资源管理提供产品服务注册、查询、注销、聚合和元数据编辑更新等功能,并对产品服务进行监 控管理。 产品服务管理主要是对标准化产品服务的发布、使用、状态监控等全面管理,并对产品服务的生 命周期进行维护,支撑对基于产品服务的资源共享、使用、管理和更新。主要由产品服务注册、产品 服务查询、产品服务维护、产品服务聚合、元数据编辑更新、产品服务监控管理等功能组成,
面向其他系统已经发布的产品服务,资源管理提供产品服务注册的功能。产品服务注册能够将其 他系统的产品服务元数据信息注册到资源管理中,用户可以通过统一的产品服务定位与查询模块对这 些已注册的产品服务进行检索,进而使用该产品服务
为用户提供多种途径进行产品服务的定位和查询。用户可以按照产品服务类型、产品服务关键字 等元数据信息对产品服务进行查询。产品服务查询流程见图B.1。
根据已知条件(如产品服务注册名、产品服务显示名、产品服务注册类型、产品服务注册 产品服务状态)查询产品服务,对查询结果进行列表展示、查看产品服务详情等。
通用产品服务包括各种WebService产品服务,并以查询产品服务为例介绍该类型产品服务的通 准。此处说明调用产品服务遵循标准的WebService规范,请求参数和返回结果遵循标准的 数据传输格式,调用说明见表C.1。
C.1.1产品服务类定义
SL/T 798—2020
requestData类用于创建后台请求的JSON字符串各个参数的类,可以通过JSON转换方法将re questData类转换成JSON用于申请产品服务。继承类以及类名应符合表C.2的要求,参数设置应符 合表C.3的要求。
挖孔灌注桩的施工工艺标准表C.2继承类以及类名
C.1.2服务返回数据定义
返回数据应按照JS()N格式进行组织,返回数据的固定字段应符合表C.4的要求,返回数据查 询结果信息应符合表C.5的要求。各个参数可参考的数据类型和代表的具体意义以本例为准,其他 查询方式应具体分析JSON对应的变量信息
某干部培训中心装饰工程施工组织设计表C.4返回数据固定字段
返回数据查询结果信息
表C.6 返回数据查询结果信息