19-03 Adaptive AUTOSAR 通信管理需求规范(

4.2.3 RESTful 通信

4.2.3.1 应用程序的通信

[RS_CM_00300] 通信管理应提供一个框架来支持由REST: Architectural Styles and the Design of Network-based Software Architectures引入的RESTful通信范例。

【类型：草稿

描述：如果没有服务器跟踪的有关客户端的信息，则通信管理应提供支持RESTful通信的框架。

原理：RESTful通信本质上是无状态的。 服务器应用程序不跟踪其客户端的任何状态。 要获得有关RESTful通信范例的详细介绍，请参见[3]。

依赖：–

用例：在Adaptive应用程序之间以面向数据的方式交换数据。

支持材料：–】

[RS_CM_00301] 通信管理应为RESTful服务提供网络协议的抽象

【类型：草稿

描述：通信管理应为RESTful服务提供网络协议的抽象。

原理：需要这种抽象来确保Adaptive应用程序的可移植性。 例如，同一RESTful Adaptive应用程序可以与HTTP / 1.1或IPC绑定一起使用，而无需更改任何应用程序代码。

依赖：–

用例：Adaptive 应用程序的移植性。

支持材料：–】

[RS_CM_00304] 通信管理应支持根据RFC3986 [4]的URI来标识数据。

【类型：草稿

描述：（相关）URI应充当数据的全局标识符。 URI必须使用RFC3986 [4]的语法。

原理：使用URI作为资源标识符在请求中标识各个资源。资源本身在概念上与返回给客户端的表示形式是分开的。比如，服务器不会发送它的数据库，但会发送一些HTML, XML或JSON来表示一些数据库记录。

依赖：–

用例：标识RESTful服务资源

支持材料：–】

[RS_CM_00309] 通信管理应提供一种将请求与相应服务器处理句柄进行匹配的方法，反之亦然。

【类型：草稿

描述：对于每个客户端请求，服务器端可能都有一个自己的函数来处理该请求。客户端应能够使Response与先前发送的Request相匹配。

原理：–

依赖：–

用例：Restful 请求的路由功能有RESTful Adaptive应用程序提供。

支持材料：–】

[RS_CM_00310] 通信管理应提供安装请求处理句柄的接口。

【类型：草稿

描述：对于每个客户端请求，服务器端可能都有一个自己的函数来处理该请求。 服务器应能够注册多个处理句柄。

原理：–

依赖：–

用例：Restful 请求的路由功能有RESTful Adaptive应用程序提供。

支持材料：–】

[RS_CM_00311] 通信管理应为C++的标准抽象组件提供类型别名。

【类型：草稿

描述：就资源控制和安全而言，标准C ++组件可能至关重要。 因此，应该存在一个抽象。

原理：–

依赖：–

用例：–

支持材料：–】

4.2.3.2 网络绑定

[RS_CM_00302] 通信管理应提供通过多个网络协议同时提供RESTful服务的方式。

【类型：草稿

描述：通信管理应提供通过多个网络协议同时提供RESTful服务的方式。

原理：Adaptive服务器应用程序可以同时通过多个网络绑定提供RESTful服务，比如IPC和HTTP 1.1。

依赖：–

用例：相同的Adaptive 服务程序同时使用的网络绑定。

支持材料：–】

[RS_CM_00314] 通信管理应提供Websockets来建立事件通信。

【类型：草稿

描述：RESTful服务之间基于事件的通信应该使用Websocket来实现。

原理：–

依赖：–

用例：在位于不同计算机上的自适应应用程序之间传输RESTful事件。

支持材料：–】

[RS_CM_00312] 通信管理应支持HTTP 1.1来传输RESTful request和responses。

【类型：草稿

描述：通信管理应支持HTTP 1.1来传输RESTful request和responses。详见 RFC2616[6].

原理：–

依赖：–

用例：在位于不同计算机上的自适应应用程序之间传输RESTful事件。

支持材料：–】

[RS_CM_00313] 通信管理应该为RESTful的request和response提供基于JSON的序列化。

【类型：草稿

描述：RESTful通信应该使用JSON来序列化/发序列化payload。详见RFC 7159 [7]

原理：–

依赖：–

用例：在Adaptive应用程序之间传输RESTful数据payload。

支持材料：–】

4.2.2.3.3 数据表示

[RS_CM_00305] 通信管理应将数据表示为对象树。

【类型：草稿

描述：Adaptive应用程序中的所有数据应表示成书对象图中的对象。

原理：对象图以树状结构表示数据，可以由RESTful Adaptive 应用程序遍历和操纵。

依赖：–

用例：所使用的payload 格式的抽象（比如 JSON或XML）

支持材料：–】

[RS_CM_00306] 通信管理应提供一个与所使用的序列化格式无关的对象图

【类型：草稿

描述：对象图应独立于使用的序列化格式。

原理：对象图可以表示任何树形数据结构。

依赖：–

用例：所使用的payload 格式的抽象（比如 JSON或XML）

支持材料：–】

[RS_CM_00307] 通信管理应提供一个对象图，其中每个对象都应严格键入。

【类型：草稿

描述：对象图的每个对象都应该严格键入。

原理：–

依赖：–

用例：所使用的payload 格式的抽象（比如 JSON或XML）

支持材料：–】

[RS_CM_00308] 通信管理应该提供方法来读取和操作对象图。

【类型：草稿

描述：应用程序应该可以操作对象图。

原理：–

依赖：–

用例：所使用的payload 格式的抽象（比如 JSON或XML）

支持材料：–】

4.3 非功能性需求（质量）

N/A

5 需求追踪

N/A

6 参考文档

[1] Standardization Template

AUTOSAR_TPS_StandardizationTemplate

[2] Glossary

AUTOSAR_TR_Glossary

[3] REST: Architectural Styles and the Design of Network-based Software Architectures

[4] RFC 3986, Uniform Resource Identifier (URI): Generic Syntax

[5] RFC 6455, The WebSocket Protocol

[6] RFC 2616, Hypertext Transfer Protocol – HTTP/1.1

[7] RFC 7159, The JavaScript Object Notation (JSON) Data Interchange Format

[8] Main Requirements

AUTOSAR_RS_Main