《生态环境监控系统建设规范服务集成与信息传输.doc》由会员分享，可在线阅读，更多相关《生态环境监控系统建设规范服务集成与信息传输.doc（28页珍藏版）》请在三一办公上搜索。
1、ICS35.020L 01 DB32江苏省地方标准DB 32/ TXXXXXXXX生态环境监控系统建设规范 服务集成与信息传输Specifications for construction of ecological environment monitoring system Service integration and information transmission XXXX - XX - XX发布XXXX - XX - XX实施江苏省质量技术监督局发布目次前言II1范围12规范性引用文件13术语、定义和缩略语14总体架构24.1组成与要求24.2服务调用方式45接口规范65.1接口类型
2、65.2接口功能65.3技术要求75.4输入输出格式76服务调用及部署要求96.1总分平台间服务调用架构96.2分（子）平台间服务调用架构107集成服务编写要求117.1服务设计开发原则117.2服务分类127.3服务命名127.4服务编号147.5服务报文148公共服务规范168.1概述168.2要求169服务接口应用209.1应用举例描述209.2服务调用209.3服务注册管理219.4统计229.5更新检查229.6废止22附录A（规范性附录）SOAP1.1报文格式23附录B（规范性附录）SOAP1.2报文格式24前言本标准按照GB/T 1.12009的规定编制。本标准由江苏省环境保护厅
3、提出并归口。本标准起草单位：江苏省生态环境监控中心、江苏省标准化研究院、江苏润和软件股份有限公司。本标准主要起草人：刘珏、何春银、许萌君、黄艺青、陈媛、徐洁、陈晓龙、寇晓芳。 生态环境监控系统建设规范 服务集成与信息传输1 范围本标准规定了生态环境监控系统中服务集成与信息传输平台的总体架构、接口规范、服务调用及部署要求、集成服务编写要求、公共服务规范和服务接口的应用。本标准适用于服务集成与信息传输平台的设计、开发和管理。2 规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。G
4、B/T 5271.12000信息技术 词汇 第1部分：基本术语GB/T 5271.172010信息技术 词汇 第17部分：数据库3 术语、定义和缩略语GB/T 5271.12000、GB/T 5271.172010确立的以及下列术语和定义适用于本部分。3.1 术语和定义3.1.1服务集成与信息传输平台 由服务总线、服务监控、服务目录、服务管理、公共服务组成的，实现SOA集成项目中用户及权限管理、服务注册与管理、基础数据管理、审计管理配置等功能的集成平台。3.1.2单点登录用户通过一次登录就可访问所有相互信任的应用系统的一种登录方式。3.2 缩略语MSMQ不同的应用之间实现相互通信的一种异步传输
5、模式Message QueueSOA面向服务的体系结构SOAP简单对象访问协议Simple Object Access ProtocolSOAPHeader有关 SOAP 消息的应用程序专用信息Simple Object Access Protocol HeaderSSO单点登录Single Sign OnWSDL用来描述Web服务和说明如何与Web服务通信的XML语言Web Services Description LanguageXML可扩展标记语言Extensible Markup LanguageXML Schema以XML语言为基础的架构Extensible Markup Langu
6、age Schema4 总体架构4.1 组成与要求4.1.1 基本特性服务集成与信息传输平台采用总分结构，架构图如图1，平台应具有如下基本特征：1) 能连接多个应用系统，其提供的服务供其他应用系统中有使用权限的用户调用；2) 能实现服务接入、服务接出及跨分（子）平台的服务(平台服务级联)调用；3) 应有身份认证服务器用于存放和管理密钥；4) 应有相应的应用系统服务提供方，作为服务功能技术实现的实体；5) 可向应用系统的服务调用方提供所需信息，服务调用方可以是一个终端客户，也可以是另一个应用系统。图1 平台总体架构图4.1.2 工作机制4.1.2.1 统一接入代理平台应能为应用系统接入的SOAP
7、协议提供统一的接入代理服务，为实现业务应用与平台之间的松耦合提供良好的支持。4.1.2.2 动态路由平台代理服务应为服务使用者提供统一的访问入口，业务服务的路由能根据用户的请求服务标识进行动态识别，由平台根据服务的配置信息动态路由到指定的业务服务。4.1.2.3 业务服务透明访问请求的服务名称、用户、密码等公共信息或控制信息应放在平台报文头中。4.1.2.4 业务无关性要求业务相关的信息可以由服务的提供者自行定义。服务使用者可通过平台实现对业务服务的透明访问。4.1.2.5 公共认证和授权服务用户的认证和服务的授权可被封装成可重用的服务单元，由平台处理流程或者外部模块调用，实现服务级别的重用性
8、。4.1.2.6 多开发语言支持平台应提供.net、JAVA等多种开发语言的支持。4.1.2.7 多种调用方式支持支持服务请求方使用同步或异步调用等多种调用方式调用业务服务时，平台能提供必要的调用方式的转换。4.1.3 功能设计4.1.3.1 组成由平台核心服务、平台管理服务、平台请求服务、平台接口服务4大模块组成，组成图见图2。图2 平台功能组成图4.1.3.2 要求4.1.3.2.1 平台核心服务应提供服务接入及服务调用，实现服务目录服务、安全验证、服务代理、服务路由。4.1.3.2.2 平台管理服务应实现对集成平台基础数据的管理，包括用户管理、权限管理、服务管理、审计管理、服务监控和异常
9、管理等。4.1.3.2.3 平台请求服务应提供服务转换消息的存储与处理，并且通过服务通道进行交换的处理，异步处理时，能通过队列方式存储服务信息，并且依照顺序进行消息处理。4.1.3.2.4 平台接口服务应提供服务注册、两级平台的服务对接工作，提供注册服务的同步，提供服务查询接口的同步工作。4.2 服务调用方式4.2.1 分类平台应提供服务透明调用功能。服务调用方式可分为同步、异步带返回结果和异步不带返回结果三种。4.2.2 同步调用4.2.2.1 调用过程同步调用过程见图3。图3 基于同步的服务请求经由平台的处理过程4.2.2.2 实现方式具体为：1) 客户端同步向平台发出调用服务的请求，当此
10、阻塞并等待返回结果；2) 平台接收此服务调用请求后，经由服务总线同步调用目标服务，阻塞并等待目标服务返回结果；3) 目标服务返回处理后的调用结果至服务总线；4) 服务总线将最终结果同步返回到当前客户端。4.2.3 异步调用方式4.2.3.1 被动请求结果4.2.3.1.1 调用过程异步调用方式中对于被动请求结果的调用过程见图4。图4 基于异步的服务被动返回结果经由平台的处理过程4.2.3.1.2 实现方式具体为：1) 客户端异步向平台发出调用服务的请求，不等待返回结果；2) 平台同步调用目标服务，等待返回结果；3) 目标服务执行完毕，同步返回结果到服务总线；4) 平台调用客户端提供的回调服务通
11、知返回结果，如客户端为异步调用，返回结果的匹配可由调用客户端自行匹配。4.2.3.2 主动请求结果4.2.3.2.1 调用过程异步调用方式中按照请求标识ID序列发出请求，对于主动请求结果的调用过程见图5。图5 基于异步主动请求返回结果的服务请求经由平台的处理过程4.2.3.2.2 实现过程具体为：1) 客户端异步向平台发出调用服务的请求，不等待返回结果；2) 平台同步调用目标服务，等待返回结果；3) 目标服务执行完毕，同步返回结果到服务总线；4) 平台调用客户端提供的回调服务通知返回结果，如客户端为异步调用，调用标识的ID及返回结果的匹配可由调用客户端自行匹配。5 接口规范5.1 接口类型5.
12、1.1 平台对外接口分为应用服务接口和管理服务接口，大批量数据交互服务考虑用数据交换方式实现。5.1.2 应用服务接口提供生态环境监控系统所包含的具体的应用和信息服务。5.1.3 管理服务接口提供总分两级平台之间，分（子）平台之间的平台管理服务的信息传输服务。5.1.4 平台接口的调用架构见图6。管理服务接口应用服务接口图6 平台接口的调用架构5.2 接口功能5.2.1 用户管理功能：提供平台管理用户的管理功能，能实现用户新增、修改、删除等功能。5.2.2 权限管理功能：提供服务调用者与具体信息服务使用权限绑定的功能，能实现绑定和解除绑定。5.2.3 服务同步功能：提供各级平台之间同步信息服务
13、的功能，能实现同步增加和同步卸载。5.2.4 审计管理功能：提供服务调用情况记录的查询功能，能实现请求结果的查询和服务日志的审计和管理。5.2.5 安全服务功能：提供对平台使用者进行身份验证的功能，能实现对用户行为监控，对用户访问行为进行策略设置等。5.2.6 服务查询功能：提供平台上注册的信息服务的查询功能，能实现关键字查询和服务类型查询等。5.3 技术要求平台接口的Web Service应能支持如下协议： SOAP1.1或SOAP1.2 ； WSDL1.1； SOAP Attachments； operation支持Document-oriented和literal encoding。5.
14、4 输入输出格式5.4.1 应用服务接口应采用支持SOAP1.1 或SOAP1.2数据类型的Web Service，请求报文格式应符合表1和表2的要求，返回报文格式应符合表3的要求。SOAP1.1 具体报文格式要求见附录A，SOAP1.2 具体报文格式要求见附录B。表1 请求报文 SOAP Header属性的值和含义SOAP Header: SHeader属性名称出现次数说明Userinfousername1用户名password1密码userorg1所属机构SvcinfoSrcapp1来源应用，用GUID表示Token1或0异步的功能的令牌Callbackurl1或0异步服务回调的地址表2
15、请求报文 SOAP Body属性的值和含义SOAP Body名称出现次数说明*1请求报文，里面内容可以是任意的业务报文内容表3 返回报文的 SOAP Body属性的值和含义SOAP Body属性名称出现次数说明*遵守soap协议标准的业务相关数据5.4.2 管理服务接口5.4.2.1 分类管理服务接口又分为管理接口和服务接口，两种接口都应以Web Service方式提供接口服务。各级平台在提供管理时都需要提供服务停用、服务启用两种接口，在提供服务时需提供服务同步接口，同步接口分为主动同步和被动同步。5.4.2.2 报文规范5.4.2.2.1 管理接口管理接口请求报文属性应符合表4的要求，服务停
16、用参数规范和返回值规范应分别符合表5和表6的要求，服务启用参数规范和返回值规范应分别符合表7和表8的要求，SOAP1.1 具体报文格式要求见附录A，SOAP1.2 具体报文格式要求见附录B。表4 请求报文报头规范SOAP Header: SHeader属性名称出现次数说明Userinfousername1用户名password1密码userorg1所属机构表5 服务停用报文SOAP Body参数规范SOAP Body:Disable名称出现次数说明Serviced1请求报文，里面内容可以是停用服务的编号表6 服务停用报文返回值参数规范SOAPBody:Disable名称出现次数说明Result
17、1返回服务停用的结果,成功：true；失败:falseException1如果有异常，则写入异常信息，无异常可为空表7 服务启用报文SOAP Body参数规范SOAP Body:Enable名称出现次数说明Serviced1请求报文，里面内容可以是停用服务的编号表8 服务启用报文返回值规范SOAP Body:Ensable名称出现次数说明Result1返回服务启用用的结果,成功：true；失败:falseException1如果有异常，则写入异常信息，无异常可以为空5.4.2.2.2 服务接口服务接口请求报文报头属性的值和含义应符合表9的要求。表9 请求报文报头属性的值和含义SOAPHeade
18、r: SHeader属性名称出现次数说明userinfousername1用户名password1密码userorg1所属机构5.4.2.2.3 主动同步服务主动服务是由各级平台向省平台送服务信息，主动同步的服务参数内容可参考如下示例：0/1/25.4.2.2.4 被动同步服务被动服务是由各级平台提供服务同步的接口，由省平台向各级平台同步服务信息，被动同步的服务参数的具体内容应按照5.4.2.2.3的要求。6 服务调用及部署要求6.1 总分平台间服务调用架构6.1.1 总分平台间服务调用6.1.1.1 总服务平台通过总平台服务目录进行管理，总服务平台上的服务通过服务总线自定义生成服务，服务调用
19、经用户验证判断，不应匿名访问。6.1.1.2 总服务平台与分（子）分别部署独立的服务总线，总分平台之间相互服务调用应经服务总线调用，总分平台间服务调用如图7所示。图7 总分平台间服务调用示意图6.2 分（子）平台间服务调用架构分（子）平台的服务在分（子）平台本地服务总线上发布并注册到本地平台服务目录，通过服务同步，同步到总服务平台的服务目录，根据不同分（子）平台标识分别路由到各分（子）平台服务总线。分（子）平台间服务调用如图8所示。图8 地市间服务调用7 集成服务编写要求7.1 服务设计开发原则7.1.1 高增长性应对服务请求的未来增长进行预计，使服务能适应不断增加的吞吐量。7.1.2 可重用
20、性使服务能被需求提出者以外的人重用，并宜使服务达到最大应用范围。7.1.3 可适应性应根据业务服务的实际情况提供多种调用模式，宜提供以下调用模式： 基于 HTTP 的 SOAP 报文同步调用； 基于.NET过程调用的本地存根调用； 基于.JAVA过程调用的本地存根调用。7.1.4 无状态与自包含服务不应依赖于使用者和提供者间长期存在的关系，操作调用也不应隐式地依赖于前一个调用。服务应设计为可避免维护会话上下文的需求，服务完成的操作所依赖的信息只需在本身内部查找即可。7.1.5 考虑并发性应充分考虑服务的并发性调用，除在业务操作层面要求服务必须同步返回结果外，大部分服务宜采用异步调用方式，避免因
21、并发量太多导致对服务提供者和服务总线的性能影响。7.2 服务分类服务按业务类型进行分类，各应用服务根据类型向服务平台注册，提供服务调用者调用。服务类型定义应符合表10的规定,可拓展。表10 服务应用类型代码类型代码业务要素名称01水环境02空气环境03重点污染源04机动车尾气05饮用水源地06辐射环境07危险固废08应急风险源90基础服务类91管理类92安全类99其他7.3 服务命名7.3.1 平台通过服务注册的方式，对各项服务进行统一的管理。7.3.2 平台上注册的服务需要按照服务命名的规则在服务平台上注册和被调用。7.3.3 服务的命名规则以XXX.YYY.SSS.MMM.FFF的方式进行
22、命名并做注册，含义分别为： XXX：表示为服务范围； YYY：表示为服务属地； SSS：表示为服务系统定义； MMM：表示为服务系统模块定义； FFF: 表示为服务方法定义。7.3.4 服务范围定义XXX（服务范围定义）作为服务平台工作范围的标识，表示服务是从哪里产生的，在生态环境监控系统中缺省定义为XXX:JSHB。7.3.5 服务属地定义YYY（服务属地定义）表示是从哪一级部门产生的服务。在生态环境监控系统中服务属地定义用各地的行政区划编码简写来表示，服务属地定义应符合表11的要求。表11 服务属地定义属地编码属地名称3200江苏省环保厅3201南京市环保局3202无锡市环保局3203徐州
23、市环保局3204常州市环保局3205苏州市环保局3206南通市环保局3207连云港市环保局3208淮安市环保局3209盐城市环保局3210扬州市环保局3211镇江市环保局3212泰州市环保局3213宿迁市环保局7.3.6 服务系统定义SSS（服务系统定义）表示是从哪一系统产生的服务。服务系统定义用生态环境监控系统中建设的各个应用系统的简称来表示，系统简称全部用半角字符表示，可以由小写字母和数字组合组成，所属子系统定义可参照表12的内容。表12 子系统定义举例系统简称系统名称zxxt信用征集系统zbtx指标体系系统yjfk意见反馈系统7.3.7 服务系统模块定义MMM（服务系统模块定义）由服务编
24、写者提供，服务名称全部用半角字符表示，可以由小写字母和数字组合组成。服务编写者应确认编写的服务在平台上具有唯一的命名，并且提交平台管理员注册成功后使用。7.3.8 服务方法定义FFF（服务方法定义）由服务编写者提供，服务名称全部用半角字符表示，可以由小写字母和数字组合组成。服务编写者应确认编写的服务在平台上具有唯一的命名，并且提交平台管理员注册成功后使用。7.3.9 服务命名示例单点登录系统Base模块，统计在线人数方法的服务定义为：jshb.3200.base.sso.onlineusers7.4 服务编号7.4.1 平台能够提供根据服务编号访问服务的功能。7.4.2 服务编号是按照服务范围
25、、服务属地、服务系统定义、服务系统模块、服务名称进行顺序编号。7.4.3 服务系统模块的编号为3位数，编号原则为顺序号，不足3位的以0填充。7.4.4 服务名称的编号为3位数，编号原则为顺序号，不足3位的以0填充。7.4.5 以统计在线人数方法的服务定义（jshb.3200.base.sso.onlineusers）为例：jshb . 3200 . base . sso . onlineusersjshb . 3200 . 90 . 001 . 001统计在线人数方法的服务定义用编号定义为：jshb.3200.90.001.0017.5 服务报文7.5.1 服务请求报文示例如下: 张三 123
26、456 1 b4c02ef6-be33-470f-af92-f8c60c901703a52ad9ca-d9a1-4638-b539-307467cc190e http:/127.0.0.1:1668/service/jshb.system.model.helloworld user1 123456 1234567 1234567 7.5.2 服务调用者请求报文平台中服务的调用者应通过目录服务获取访问服务在地址，然后按服务访问要求规范提供服务访问报文的报头信息，服务访问调用服务的报头可参考如下示例: 张三 123456 1 b4c02ef6-be33-470f-af92-f8c60c901703
27、a52ad9ca-d9a1-4638-b539-307467cc190e http:/127.0.0.1:1668/service/jshb.system.model.helloworld 注1： 报文Soap Header中xmlns=http:/tempuri.org/为命名空间，应与实际服务相对应。注2： 报文Soap Header中的用户名和密码应通过服务集成平台的身份验证，否则不能使用服务。注3： 调用者在调用服务时，与实际业务相关的报文信息，按照服务提供者的要求生成实际报文。7.5.3 服务调用者返回报文7.5.3.1 正常结果示例如下： 400 注1： 报文Soap Header
28、中xmlns=http:/tempuri.org/为命名空间，应需要与实际服务相对应。注2： 调用者在获得服务结果时，与实际业务相关的报文信息，按照服务提供者的实际内容获取。7.5.3.2 异常结果通过平台使用服务时，平台根据报头和报文捕获异常，并将异常返回到调用者，平台的异常状态编码如表13。表13 服务平台的异常状态异常编码异常描述550请求的目录不存在 551请求的目录已停用 552请求的报头不规范 553用户不存在或无权限 554远程服务器错误 555获取异步服务结果令牌失效8 公共服务规范8.1 概述各级平台的公共服务是对外提供服务信息查询、服务目录查询服务，名称和接口类型如表13所
29、示。表14 平台的公共服务对外提供服务信息查询、服务目录查询服务服务名称描述接口类型IServiceFindService服务信息查询WebServiceIServiceFindRouting服务目录查询WebService8.2 要求8.2.1 服务信息查询8.2.1.1 查询内容服务查询是通过传入的输入参数来查找平台服务目录中的服务，服务信息查询模块调用平台管理提供的服务查询接口来查询服务的信息。返回的服务信息包括:服务基本信息、服务状态信息、服务所拥有的方法、版本信息等。8.2.1.2 服务参数要求查询服务相关信息的服务名称为IServiceFindService，查询WSDL地址为ht
30、tp:/服务器IP地址:端口/IServiceFindService.asmx?wsdl，其服务方法参照表15，输入参数和输出参数分别参照表16和表17。表15 服务信息查询服务方法服务方法方法说明备注GetServiceInfo查询服务的信息见输入/输出参数说明表16 服务信息查询输入参数说明标识符说明类型备注Directory服务目录String当前查询服务的目录表17 服务信息查询输出参数说明标识符说明类型备注Id服务编号Introut_name服务名Stringrout_directory服务目录Stringrout_path服务目录Stringrout_description服务描述
31、Stringrout_attach是否包含附件Int0:不包含，1:包含rout_soapActionSoapActionStringrout_asyn调用方式String0:同步，1:异步rout_asyntype异步回调方式Int0:主动，1:被动rout_disabled是否禁用Int0:启用，1:禁用rout_log是否记录日志Int0:不记录日志,1:记录日志rout_status服务状态Introut_checkuser是否验证用户Int0:不验证,1:验证user_id创建用户IntCreateDate服务上线时间DateTime注： 绑定类型为Web Service，调用方式为
32、同步调用8.2.1.3 服务调用者请求报文格式示例服务信息查询服务调用者请求报文格式可参考如下示例，有关服务接口的Web Service请求报文规范内容，应符合本部分5.4的规定： jshb.3200.base.sso.getonlineusers 8.2.1.4 服务调用者结果返回报文格式示例服务信息查询服务调用者请求报文格式可参考如下示例，有关服务接口的Web Service返回报文规范内容，应符合本部分5.4的规定： 22 获取在线人数 jshb.3200.base.sso.getonlineusers 1.90.72.73.94 http:/10.32.200.20:8088/WebS
33、erviceSSO.asmx 获取集成平台实时在线人数 1 http:/tempuri.org/GetOnlineUsers 0 0 0 0 1 0 0 2012-07-13T10:00:14.64 8.2.2 服务目录查询8.2.2.1 查询内容服务查询是通过传入的输入参数来查找平台服务目录中的服务，服务信息查询模块调用平台管理提供的服务查询接口来查询服务的信息。返回的服务信息包括:服务基本信息、服务状态信息、服务所拥有的方法、版本信息等。8.2.2.2 服务参数要求查询服务相关信息的服务名称为IServiceFindRouting，查询WSDL地址为http:/服务器IP地址:端口号/IS
34、erviceFindRouting.asmx?wsdl，其服务方法参照表18，目录查询不需要请求不需要参数，参数 WSDL 表示该服务发布的网络描述语言，输出参数参照表19。表18 服务目录查询服务方法服务方法方法说明备注GetRoutingList查询目录列表见输入/输出参数说明表19 服务目录查询输出参数说明标识符说明类型备注Directory服务目录String注： 绑定类型为Web Service，调用方式为同步调用8.2.2.3 服务调用者请求报文格式示例服务信息查询服务调用者请求报文格式可参考如下示例，有关服务接口的Web Service请求报文规范内容，应符合本部分5.4的规定：s:Envelope xmlns:s=http:/schemas.xmlsoap.org/soap/envelope/
