上一篇： 数据开放平台（一）：从 SQL2API 到数据开放平台的演进

SQL 转 API 引擎是整个数据开放平台的核心。用户在界面上写一条受控 SQL 模板，配好参数规则，系统自动生成一个可调用的 API。听起来简单，但要做到"运行时解析、校验、执行、审计"这一整套链路，细节其实不少。

下面看看这个引擎到底是怎么实现的。

一、为什么选 JdbcTemplate

结论：这个场景里，执行层放在 JdbcTemplate 上。

为什么不是 JPA？因为 JPA 要求编译期定义 Entity，SQL2API 的 SQL 在运行时才确定，核心不知道返回什么字段。JPA 的 EntityManager 也执行原生 SQL，但返回值绑死在 Entity 上，灵活性为零。

为什么不是 MyBatis？MyBatis 的 XML 是编译时写死的，要支持运行时动态 SQL 得 hack 进 Configuration 对象，线程不安全、内存泄漏、复杂度高。收益为零。

JdbcTemplate 的好处是足够薄：

// 运行时执行任意 SQL，返回 List<Map>
List<Map<String, Object>> result = jdbcTemplate.queryForList(
    "SELECT * FROM user WHERE status = ? AND name LIKE ?",
    status, "%" + name + "%"
);
// 结果直接是通用 Map，不用定义任何 Entity
// 连接自动归还，异常自动处理，参数自动绑定防注入

它不要求提前定义 Entity，也不强行接管 SQL 生成过程。对于"运行时执行 SQL 模板，返回通用结构"这个场景，JdbcTemplate 的抽象刚刚好：连接释放、异常转换、参数绑定这些脏活它来做，SQL 的控制权仍然在平台手里。