标准解读丨ASAM SOVD系列之三:基于HTTP REST的SOVD API

文摘   汽车   2024-08-06 16:30   天津  



编者寄语:2022年6月底,ASAM SOVD 1.0.0版本正式发布。为了应对智能网联汽车时代井喷的软件诊断需求,SOVD如何应对?让我们共同来研究!



01

HTTP REST概念介绍

SOVD API符合HTTP REST原则,这意味着会以资源形式提供诊断内容。关于HTTP REST的基本介绍内容如下:

01

HTTP REST概念解析

REST表述性状态传递(英文全称:Representational State Transfer,简称REST)是Roy Fielding博士在2000年他的博士论文中提出来的一种软件架构风格。REST是一种针对网络应用的设计和开发方式,可以降低开发的复杂性,提高系统的可伸缩性。

REST在Browser/Server的基础上添加了另外3个规范性的组成,第一个为统一接口,第二个为分层系统,第三个为按需代码


02

REST特性分析

在三种主流的Web服务实现方案中,因为REST模式的Web服务与复杂的SOAPXML-RPC对比来讲明显的更加简洁,越来越多的web服务开始采用REST风格设计和实现。例如,Amazon.com提供接近REST风格的Web服务进行图书查找;雅虎提供的Web服务也是REST风格的。


REST概念介绍


REST(‌Representational State Transfer)‌方法主要包括GET、‌POST、‌PUT、‌DELETE四种HTTP方法。

  • GET方法:‌用于获取资源,‌可以类比于数据库操作中的SELECT操作,‌用于从服务器获取数据。‌例如,‌通过GET方法可以获取所有学员的信息或者特定ID的学员信息。‌
  • POST方法:‌用于新建资源,‌也可以用于更新资源,‌可以类比于数据库操作中的INSERT操作,‌用于向服务器提交新的数据。‌
  • PUT方法:‌用于更新资源,‌可以类比于数据库操作中的UPDATE操作,‌用于修改服务器上的数据。‌
  • DELETE方法:‌用于删除资源,‌可以类比于数据库操作中的DELETE操作,‌用于从服务器上删除数据。
这些方法构成了RESTful API的基础,‌通过不同的HTTP方法,‌客户端可以对服务器上的资源进行创建、‌读取、‌更新和删除操作。‌RESTful API的设计风格强调资源导向、‌无状态性、‌统一接口、‌分层系统和可缓存性,‌这些特性使得RESTful API在构建可扩展、‌高性能的Web服务时非常有用。

RESTful适用于许多不同的应用场景,包括:

Web 应用程序

RESTful可以用于构建Web应用程序,如社交媒体网站、博客、在线商店等。

移动应用程序

RESTful可以用于构建移动应用程序,如手机应用程序、平板电脑应用程序、车端应用程序等。

后端应用程序

RESTful可以用于构建后端应用程序,如数据库服务器、消息队列服务器等

物联网设备

RESTful可以用于构建物联网设备,如智能家居设备、智能城市设备等



02

基于HTTP REST原则的SOVD API


在SOVD中,资源路径由单个实体路径和为该实体提供的标准化资源和资源集合组成。


采用HTTP方法表示单个诊断内容的可用操作。SOVD采用以下HTTP方法(即REST):

HTTP方法

目的

GET

从资源中读取内容

PUT

更新资源内容(如,通过写入新值)

POST

新建(临时)资源

DELETE

删除已创建的资源,内容重置为默认

以下将通过具体案例简要说明SOVD基于REST的方法。以实现车窗控制功能的车载软件应用为例,可提供“RearWindows(后车窗)”位置等相关信息。


就SOVD而言,通过提供包含“RearWindows(后车窗)”叶资源的“WindowControl(车窗控制)”SOVD实体予以实现,而该叶资源可以通过GET操作读取。

以上案例的代码示例:
Request:
GET {base_uri}/apps/WindowControl/data/RearWindows HTTP/1.1


THE END


以上即为本次分享的内容。ASAM SOVD为收费标准,ASAM会员单位可免费查看与下载,非会员单位可单独进行购买。

如需获取ASAM SOVD标准内容目录,请关注“CASAM标准组织”公众号输入“SOVD1.0”关键字获取官网下载链接。

C-ASAM工作组联系人:魏文渊

手机号:15022601236

工作邮箱:weiwenyuan@catarc.ac.cn



往期推荐

标准解读丨ASAM SOVD系列之一:概述与特性

标准解读丨ASAM SOVD系列之二:典型应用场景分析

重磅成果丨ASAM OpenScenario 2.0正式发布

重磅成果丨ASAM OpenXOntology概念白皮书正式发布


C-ASAM组织
ASAM(自动化及测量系统标准协会)1998年成立于德国,是一家非盈利性技术组织,致力于为汽车行业制定、提高和推广标准提供平台。中汽数据与ASAM于2019年联合成立C-ASAM工作组,协调ASAM中国会员,制定ASAM标准。
 最新文章