SOME/IP 协议介绍(六)接口设计的兼容性规则

接口设计的兼容性规则(信息性)

对于所有序列化格式而言,向较新的服务接口的迁移有一定的限制。使用一组兼容性规则,SOME / IP允许服务接口的演进。可以以非破坏性的方式进行以下添加和增强:

• 向服务中添加新方法

• 必须先在服务器端实现。

• 将参数添加到方法的输入或输出参数的末尾

• 当接收者首先添加它们时,必须定义默认值

• 当发送者首先添加它们时,接收者将忽略它们

• 将异常添加到方法可以引发的异常列表中

• 应先更新客户端

• 如果异常未知,则需要抛出"未知异常"。但是,异常描述字符串可以复制过来。

• 向联合中添加新类型

• 应先更新接收者

• 如果未知,则可以跳过(发送方先更新)

• 为新方法定义新数据类型

• 为新方法定义新异常

并非所有这些更改都可以首先在客户端或服务器端引入。在某些情况下,只能首先更改客户端或服务器。例如,使用较新的实现发送附加参数时,旧实现只能跳过此参数。

例如,当消息的接收者添加要接收的新参数时,必须定义默认值。这在发送具有旧版本服务的发送方发送不带附加参数的消息时需要。

接口规范中的某些更改可以以非破坏性的方式实现:

• 删除函数中的参数

• 需要先在接收者端添加默认值,并且参数需要位于列表末尾

• 从函数中删除异常

• 服务器端很简单

• 如果遇到旧异常,客户端需要抛出"未知异常"

• 可以重命名参数、函数和服务,因为名称不会被传输。生成的代码只查看ID和参数排序,迁移中不应更改它们。

如果接口规范配置结构体具有长度字段,则可以执行以下操作:

• 向结构体末尾添加/删除字段

目前不支持以下更改:

• 重新排序参数

• 将超类型替换为子类型(如面向对象编程语言中)

相关推荐
隐擎fox22 分钟前
Linux eBPF 与 XDP 高性能网络出口架构:动态连接追踪、丢包诊断与住宅网关 QoS 调优实战
linux·网络·网络协议·tcp/ip·架构
Multipath71241 分钟前
多链路聚合设备:助力智慧农业发展的网络基石——让农田网络不断连,让智能设备不失控
网络·网络协议·5g·udp·无人机
似是燕归来1 小时前
Rtthread OS 功能开发之 socket udp协议程序开发
网络·stm32·网络协议·udp·socket·rtthread
wespaul1 小时前
VeapAI 自然语言操作实战|第 07 篇:执行层——编排引擎与全局语义命令
服务器·人工智能·milvus
lambo mercy1 小时前
Day4:流式传输
运维·服务器·网络
I'm Jie1 小时前
Rhost v2.0.0 版本发布!!!不止 SSH 终端,内置 AI Agent 支持自然语言操作远程服务器
运维·服务器·rust·开源·ssh·tauri·finalshell
Spatial3Ddddd2 小时前
2026空间三维重建服务商横向对比
java·服务器·人工智能
比兔代理2 小时前
HTTP 代理与 TLS 指纹:如何避免被识别为代理流量?
网络·网络协议·http
H.莓飛2 小时前
【Linux】进程的创建与终止
linux·运维·服务器·c语言·visual studio
上海云盾-小余2 小时前
自定义端口 HTTPS 部署:高防接入遇到的问题与调优方案
网络协议·http·https