Vert.x中SharedData的getClusterWideMap与getAsyncMap有何区别？

这两个API看似相似，但核心定位和行为细节存在关键差异，具体如下：

1. 历史定位与兼容性 #

• getClusterWideMap()是Vert.x早期推出的集群专属异步Map实现，仅能在集群模式下正常工作，单机模式调用会直接抛出异常。
• getAsyncMap()是后续版本推出的通用异步Map抽象，既支持集群环境（启用Vert.x集群模式时），也兼容单机模式（此时内部自动退化为本地异步Map实现）。

2. 文档与行为细节 #

• 集群延迟提示：getAsyncMap()的文档专门标注了集群环境下操作存在网络延迟，这是因为它的通用设计需要提醒使用者跨节点调用的成本；而getClusterWideMap()作为早期集群专属API，默认使用者清楚集群操作的延迟特性，因此文档未额外标注，但实际集群环境下两者的延迟表现一致。
• 返回实例本质：两者返回的都是AsyncMap<K, V>接口实例，但getClusterWideMap()返回的实例绑定集群依赖，getAsyncMap()返回的实例则根据运行环境自动适配。

3. 使用场景建议 #

• 若服务明确只在集群环境部署，且需要清晰的集群数据共享语义，可使用getClusterWideMap()。
• 若服务需要兼容单机/集群两种部署模式，或追求更灵活的异步Map实现，优先选择getAsyncMap()。

内容的提问来源于stack exchange，提问作者Guss