这是本节的多页打印视图。 点击此处打印.

返回本页常规视图.

参考手册

Capa SDK API参考文档

本节包含 Capa SDK 组件的 API 参考文档。

API 文档

Capa 为云应用开发提供统一的 API 层。以下参考文档可用：

核心 API

  • Service Invocation (RPC) - HTTP/gRPC 服务间通信
  • Configuration - 动态配置管理
  • Pub/Sub - 发布订阅消息
  • State Management - 键值状态存储
  • Telemetry - 日志、指标和分布式追踪

API 规范

Capa API 规范遵循社区标准，定义在 cloud-runtimes-jvm 仓库中。

1 - 版本与兼容性

Capa API、SDK、运行时与适配器的发布版本和兼容边界。

Capa API 契约、SDK、运行时和云适配器分别发布。集成时应明确匹配版本，不要假设所有仓库共享同一个版本号。

当前文档版本

组件版本或状态用途
cloud-runtimes-jvm1.19.RELEASEJVM API 契约和部分运行时 adapter
capa-java1.11.13.2.RELEASEJava 富 SDK
capa-java-aws1.11.13.5.RELEASECapa Java 的 AWS SPI 模块
cloud-runtimes-golang接口规范Go API 契约，不包含运行时实现
cloud-runtimes-pythonAlpha 源码 API修正后的制品发布前使用源码安装
capa实验性独立演进的 Go Sidecar/运行时

兼容规则

  1. SDK 与 adapter 使用 adapter 仓库明确记录的版本组合。
  2. 确认所选 adapter 已实现应用实际调用的每个操作。
  3. API 存在只表示契约已定义，不代表运行时已经支持。
  4. 上生产前针对目标中间件或云服务运行集成测试。
  5. 跨 minor 或 RELEASE 后缀版本升级前检查发布说明和源码差异。

Java API 类型可从 cloud-runtimes-api 源码开始查阅；Java SDK 用法请参考 capa-java examples。