APIJSON 项目中 PUT 和 DELETE 请求的非 ID 条件使用指南

在 APIJSON 项目中，开发者经常需要处理基于非 ID 字段的条件查询、更新和删除操作。本文将深入探讨如何在不引入额外组件的情况下，实现这些高级数据操作功能。

核心配置调整

要启用基于非 ID 字段的条件操作，首先需要在项目中设置关键配置项：

IS_UPDATE_MUST_HAVE_ID_CONDITION = false

这一配置将解除系统对必须使用 ID 作为条件的限制，为更灵活的数据操作创造条件。

DELETE 请求的条件处理

DELETE 请求的处理逻辑相对简单直接：

• 所有在请求体中提供的键值对都会自动被视为删除条件
• 系统会将这些条件组合成 WHERE 子句来定位要删除的记录

示例请求结构：

{
  "User": {
    "name": "张三",
    "status": 0
  }
}

上述请求会删除所有 name 为"张三"且 status 为 0 的用户记录。

PUT 请求的条件处理

PUT 请求的条件处理更为精细，区分了条件字段和更新字段：

1. 带有功能符的字段：自动被视为条件
2. 普通字段：需要使用 @combine 功能符显式指定为条件

示例请求结构：

{
  "User": {
    "name@": "张三",
    "age@combine": ">18",
    "status": 1
  }
}

在这个示例中：

• name@ 是条件字段（使用功能符）
• age@combine 显式指定为条件
• status 是待更新的字段

功能符使用进阶

APIJSON 提供了丰富的功能符来支持复杂条件：

1. 比较运算符：=, !=, >, <, >=, <=
2. 模糊查询：% (LIKE)
3. 范围查询：{} (BETWEEN)
4. 空值判断：? (IS NULL), !? (IS NOT NULL)

这些功能符可以组合使用，构建出强大的查询条件。

实际应用场景

1. 批量更新：基于状态字段更新所有符合条件的记录
2. 条件删除：清理特定时间段内的日志数据
3. 复杂业务逻辑：实现基于多字段组合的业务规则更新

注意事项

1. 确保条件字段有适当的索引以提高性能
2. 对于重要数据操作，建议添加事务支持
3. 在生产环境中使用前，充分测试条件组合的正确性
4. 考虑添加适当的权限控制，防止误操作

通过合理配置和使用这些功能，开发者可以在不引入额外组件的情况下，实现灵活高效的数据操作，满足各种业务场景的需求。