Q/GDW 11817-2018 应用集成接口技术规范.pdf

Q/GDW 11817-2018 应用集成接口技术规范.pdf
积分0.00
特惠
积分0
VIP全站资料免积分下载
立即下载
同类资料根据编号标题搜索
文档
仅供个人学习
反馈
标准编号:Q/GDW 11817-2018
文件类型:.pdf
资源大小:34.9 M
标准类别:电力标准
资源ID:256797
VIP资源

Q/GDW 11817-2018标准规范下载简介:

内容预览由机器从pdf转换为word,准确率92%以上,供参考

Q/GDW 11817-2018 应用集成接口技术规范.pdf

同步请求/响应模式如图3所示,由服务调用者发起请求,服务提供者处理请求,具体交互过程如下: 服务调用者向服务总线发起请求: b) 服务总线对请求进行鉴权、路由、转换等处理: C) 服务总线将请求转发到服务提供者: d) 服务提供者对请求进行处理: e 服务提供者向服务总线返回响应: f 服务总线对响应进行路由、转换等处理: 服务总线将响应转发到服务调用者。

6.1.2异步请求/响应集成模式

图3同步请求/响应集成模式

异步请求/响应集成模式如图4所示,由两个同步请求/响应调用构成,具体交互过程如下: a 服务调用者发起请求; b) 服务总线转发请求: c) 服务提供者收到请求: 2 服务提供者不进行处理就立即进行应答: e 服务总线转发应答: f) 服务调用者收到应答后,可自由执行其他操作: 服务提供者对请求进行处理; h) 服务提供者处理完请求后,向服务调用者发起请求,提供请求处理结果: i) 服务总线转发请求:

GB/T 12784-2017 橡胶塑料加压式捏炼机j)服务调用者收到请求处理结果; k)服务调用者对服务提供者进行应答: 1)服务总线转发应答: m)服务提供者对应答进行处理。

j)服务调用者收到请求处理结果;

D/GDW 118172018

)服务调用者收到请求处理结果: )服务调用者对服务提供者进行应答; 服务总线转发应答: )服务提供者对应答进行处理。

6.2消息总线集成模式

6.2.1发送/接收集成模式

图4异步请求/响应集成

发送/接收集成模式如图5所示,消息发送者(Sender)将消息发送到消息总线(队列),消息接收 者(Receiver)从消息总线(队列)中获取消息。发送/接收模式是单向模式,消息发送者不需要消息 接收者进行响应,具体交互过程如下: a)消息发送者发送消息到消息总线(队列)中; 消息总线向消息发送者返回应答; 消息总线(队列)保留着消息,直到消息被消费或超时: 消息接收者从消息总线(队列)中接收消息: e) 消息接收者向消息总线(队列)返回消息已接收确认; 消息接收者处理消息

6.2.2发布/订阅集成模式

图5发送/接收集成模式

图6发布/订阅集成模式

本标准制定的消息结构是抽象和中立的,无论应用集成采用何种实现技术,系统间交互的消息采用 可种表现形式(例如XML或者JSON或者二进制),都应遵循以下语义和语法规范。本规范中的语义定义 又用于约束服务请求的消息构成方式,不对服务提供者的接口名称定义进行约束。

在消息中,名词用于指定消息体的类 业务场景,由Q/GDW703标准定义的 抽象组成

7.2.3.1需要消息体的场

7.2.3.2不需要消息体的场景

当满足以下条件之一时,不需要消息体: 在响应无效get请求的reply消息中; b 在响应create、update、delete、close或cancel的reply消息中; 在delete、close或cancel的请求消息中,当对象的ID被通过Request.ID元素指定时: d) 在get请求中,当过滤请求的参数被通过消息中的Request元素提供时,或者在Request.any 元素中使用get描述时。

Q/GDW 118172018

图7通用消息信封结构

表2消息总体结构元素表

消息头的结构应符合图8所示,结构中各元素的说明见表3,示例参见附录B。

表3消息头结构元素表

表3消息头结构元素表

Q/GDW118172018

7.3.3请求消息结构

个重要用途是避免在消息头或消息体的定义中放置系统指定的请求参数。Request中没有必需的 素,各元素的说明见表4,示例参见附录C

Q/GDW118172018

表4请求消息结构元素表

表4请求消息结构元素

A/GDW 118172018

D/GDW118172018

7.3.4应答消息结构

应答消息的结构应符合图10所示,示例参见附录E

7.3.4.2 Reply.Result结构

Reply.Result取值范围如下

OK:在没有发生错误,并且所有的结果都被返回的情况下使用。此时不需要给出Reply.Error 元素。 PARTIAL:只在返回了一部分的结果的情况下使用,结果中可包含也可不含错误。此时可给出 一个含编码的Reply.Error元素,以显示错误和非错误信息。 C)ERROR:在只返回了任何的含编码的错误记录的情况下使用,以显示实际错误

a)OK:在没有发生错误,并且所有的结果都被返回的情况下使用。此时不需要给出Reply.Err 元素。 b) PARTIAL:只在返回了一部分的结果的情况下使用,结果中可包含也可不含错误。此时可给 一个含编码的Reply.Error元素,以显示错误和非错误信息。 C)ERROR:在只返回了任何的含编码的错误记录的情况下使用,以显示实际错误

3.4.3Replv.Error 结松

可在消息体中提供更具体的错误消息,消息结构应符合图11所示,错误消息的关键属性取值如下: a)如果一个请求消息只有一个响应消息,并且响应消息没有严重的错误,那么Reply.Result就 可被设置成OK,同时Reply.Error.code被设置成“o.0”。 b) 如果一个请求消息只有一个响应消息,但是响应消息中至少包含了一个严重错误,那么 Reply.Result就将被设置成FATAL。这样的响应消息将是一个包括数据和错误通知的混合体 Reply.Error.code、Reply.Error.ID以及与Reply.Error结构相关的属性都将根据每个错误 或者报告条件的不同被设置成对应的值、 C 如果一个请求消息被返回多个响应消息,Reply.Result就将被设置成PARTIAL。这样的响应消 息将是一个包括数据和错误通知的混合体。Reply.Error.code、Reply.Error.ID以及与 Reply.Error结构相关的属性都将根据每个错误或者报告条件的不同被设置成对应的值。如果 无法确定响应消息集合中的最后一条消息,那么集合中的所有消息的Reply.Error.code都将 被设置成“0.1”

可在消息体中提供更具体的错误消息,消息结构应符合图11所示,错误消息的关键属性取值如下: a)如果一个请求消息只有一个响应消息,并且响应消息没有严重的错误,那么Reply.Result就 可被设置成OK,同时Reply.Error.code被设置成“o.0”。 b) 如果一个请求消息只有一个响应消息,但是响应消息中至少包含了一个严重错误,那么 Reply.Result就将被设置成FATAL。这样的响应消息将是一个包括数据和错误通知的混合体 Reply.Error.code、Reply.Error.ID以及与Reply.Error结构相关的属性都将根据每个错误 或者报告条件的不同被设置成对应的值、 C 如果一个请求消息被返回多个响应消息,Reply.Result就将被设置成PARTIAL。这样的响应消 息将是一个包括数据和错误通知的混合体。Reply.Error.code、Reply.Error.ID以及与 Reply.Error结构相关的属性都将根据每个错误或者报告条件的不同被设置成对应的值。如果 无法确定响应消息集合中的最后一条消息,那么集合中的所有消息的Reply.Error.code都将 被设置成“0.1”

7.3.6故障消息结构

散障消总通用于表示会试处 双的结果, 消息结构应符合图13所示。故障消息只 故障消息示例参见附录G。

表5消息体结构元素表

表5消息体结构元素表

表6描述了消息体中Any、OperationSet、Compressed、Format元素取不同值的组合用法

7.3.8操作集的结构

操作集的结构应符合图15所示,结构中各元素的说明见表7,示例参见附录I。

Q/GDW 118172018

表7操作集结构元素表

Q/GDW118172018

当应用集成有不同需求时,可参照表8采用不同的集成模式。应用集成示例与开发指南参见附录

9.1基于服务总线集成

Q/GDW118172018

ice和RESTService为载体,相关协议要求分别见表

表9WebService协议机

表10RESTService协议栈

WebService应采用基于XML的数据格式,RESTService应采用基于JSON的数据格式

GB/T 28249-2012 带轮滚刀 型式和尺寸9.2基于消息总线集成

应用集成以JMS为载体,相关协议要求见表11

TMS服务传输的数据为二进制字节码。

附录A (资料性附录) 通用消息信封示例

GB/T 30357.4-2015 乌龙茶 第4部分:水仙表A.1通用消息信封示例

表A.1通用消息信封示例

©版权声明
相关文章