消息合约与任何其他类型的 API 合约没有什么不同,您可以相应地对待它们。将任何公共 API 视为走向世界的东西,您无法控制使用该 API 的每个人。
有很多关于合同版本控制的很好的指导方针,那里没有任何特定于 MassTransit 的内容。
另一方面,MassTransit 在文档中提供了一些关于如何处理消息版本的建议。特别是,如果您遵循弱模式方法并添加可以为空且对消费者不重要的属性,我们建议不要创建新版本。此外,您可以使用接口组合,例如文档中的这个示例:
class RemoteImageCachedEvent :
RemoteImageCached,
RemoteImageCachedV2
{
Guid EventId { get; set; }
DateTime Timestamp { get; set; }
Guid InitiatingCommandId { get; set; }
Uri ImageSource { get; set; }
string LocalCacheKey { get; set; }
Uri LocalImageAddress { get; set; }
}
因此,当您发布 的实例时RemoteImageCachedEvent
,它将被传递到两个接口的消息交换中。
如果您完全改变您的 API 表面,这是消息、Grpc 还是 REST,您需要考虑向后兼容性并在一段时间内同时使用旧消息和新消息。给人们一些时间从一个版本更改为另一个版本,并在需要时终止旧版本。