如何自动将旧OpenAPI生成的C++ Pistache服务器函数体迁移至新存根？

1. 用官方推荐的代码分离机制（最省心） #

OpenAPI Generator给Pistache生成存根时，默认会把框架代码和业务代码分开：

• 初始生成后，你会看到两类文件：比如UserApi.h/cpp（框架生成的基础存根，重新生成会被覆盖）和UserApiImpl.h/cpp（专门用来写自定义业务逻辑的文件，重新生成不会被覆盖）。
• 你只需要在*ApiImpl.cpp里实现端点函数的业务逻辑，后续更新YAML重新生成时，只会替换基础存根文件，你的业务代码会完整保留。

2. 自定义模板+脚本实现精准代码注入 #

如果默认的分离方式满足不了需求，可以自定义模板加脚本实现自动整合：

• 找到OpenAPI Generator的Pistache模板（比如apiImpl.mustache），修改模板，在函数体位置加上固定标记：

  void {{operationId}}(...) {
      // BEGIN CUSTOM CODE
      // END CUSTOM CODE
  }
  

• 写个简单的shell脚本，从旧存根里提取标记之间的代码，再插入到新生成的文件对应位置：

  # 从旧文件提取自定义代码块
  custom_code=$(sed -n '/\/\/ BEGIN CUSTOM CODE/,/\/\/ END CUSTOM CODE/p' old_UserApiImpl.cpp)
  # 将代码插入新文件的标记区域
  sed -i "/\/\/ BEGIN CUSTOM CODE/r /dev/stdin" new_UserApiImpl.cpp <<< "$custom_code"
  

3. 用diff工具合并已修改的核心文件（不推荐，但应急可用） #

如果你之前不小心修改了生成的核心*Api.cpp文件，也可以用diff工具救场：

• 生成新存根前，先备份旧的核心文件。
• 生成新存根后，用diff生成差异补丁，再合并到新文件：

  # 生成新旧文件的差异补丁
  diff -u old_UserApi.cpp new_UserApi.cpp > api_diff.patch
  # 应用补丁，手动解决冲突
  patch new_UserApi.cpp api_diff.patch
  

必看最佳实践 #

• 绝对不要直接修改*Api.h/cpp这类框架生成的基础文件，所有业务逻辑都放到*ApiImpl文件里，这是官方设计的初衷，能彻底避免代码丢失问题。
• 最好把核心业务逻辑封装到独立的服务类里，*ApiImpl文件只做简单的调用转发，这样即使存根结构变化，也只需要调整转发逻辑，核心业务代码完全不受影响。

内容的提问来源于stack exchange，提问作者Razvan George Costan