如何用模板函数统一调用不同命名空间的Kubernetes CRI API？

问题背景 #

Kubernetes的CRI API包含v1和v1alpha两个高度相似的版本，通过protoc转换为C++头文件供客户端发起远程调用。不同集群对版本支持情况各异：部分仅支持v1alpha，部分仅支持v1，还有部分两者都支持。客户端需要优先尝试v1版本，若调用失败则降级到v1alpha。

现有两种调用代码（仅命名空间前缀不同）：

// v1版本调用
auto stub = runtime::v1::RuntimeService::NewStub(unixSockPath);
runtime::v1::ListContainersRequest req;
runtime::v1::ListContainersResponse resp;
stub->ListContainers(req, &resp);

// v1alpha版本调用
auto stub = runtime::v1alpha::RuntimeService::NewStub(unixSockPath);
runtime::v1alpha::ListContainersRequest req;
runtime::v1alpha::ListContainersResponse resp;
stub->ListContainers(req, &resp);

希望实现如下调用逻辑，疑问在于：能否通过以命名空间（runtime::v1、runtime::v1alpha）作为模板参数的模板函数来复用代码，还是必须将所有用到的类型（如RuntimeService、ListContainersRequest等）逐一作为模板参数传入？

std::list<std::string> listContainers() {
    try {
        if (g_useV1)
            return __listContainers<runtime::v1>();
    } catch (const not_supported &ex) {
        g_useV1 = false;
    }
    
    return __listContainers<runtime::v1alpha>();
}

解答 #

完全可以通过以命名空间作为模板参数的模板函数实现代码复用，无需将每个类型单独作为模板参数传入。

具体实现示例 #

利用C++模板的依赖类型查找特性，基于命名空间编写通用模板函数：

#include <list>
#include <string>

// 全局标记：记录v1版本是否可用，避免重复尝试
bool g_useV1 = true;

// 通用模板函数：接受CRI版本命名空间作为模板参数
template <typename CRIVersion>
std::list<std::string> __listContainers() {
    // 创建对应版本的Stub
    auto stub = CRIVersion::RuntimeService::NewStub(unixSockPath);
    
    // 构造请求和响应对象
    typename CRIVersion::ListContainersRequest req;
    typename CRIVersion::ListContainersResponse resp;
    
    // 发起调用（假设不支持时会抛出not_supported异常）
    grpc::ClientContext context;
    grpc::Status status = stub->ListContainers(&context, req, &resp);
    
    if (!status.ok()) {
        if (status.error_code() == grpc::StatusCode::UNIMPLEMENTED) {
            throw not_supported("CRI v1 version not supported");
        }
        // 处理其他错误
        throw std::runtime_error("Failed to list containers: " + status.error_message());
    }
    
    // 转换响应为目标格式
    std::list<std::string> containerIds;
    for (const auto& container : resp.containers()) {
        containerIds.push_back(container.id());
    }
    
    return containerIds;
}

// 对外暴露的调用入口
std::list<std::string> listContainers() {
    try {
        if (g_useV1) {
            return __listContainers<runtime::v1>();
        }
    } catch (const not_supported& ex) {
        g_useV1 = false;
    }
    // 降级到v1alpha版本
    return __listContainers<runtime::v1alpha>();
}

关键说明 #

1. 模板参数的本质：虽然C++不能直接将命名空间作为模板参数，但这里的CRIVersion实际指代的是命名空间下的类型上下文——由于v1和v1alpha版本的API结构完全一致，模板函数可以通过CRIVersion::XXX的方式直接访问对应命名空间下的所有类型（如RuntimeService、ListContainersRequest等）。
2. 代码复用性：仅需维护一份模板函数，无需为两个版本重复编写几乎完全相同的代码，后续新增CRI版本时也只需扩展模板调用逻辑。
3. 前提条件：必须确保两个版本的protoc生成代码具有完全一致的接口（包括类型名称、方法签名、字段结构等），否则模板函数会出现编译错误。

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