使用ActiveJDBC时，如何在save()或create()后获取自增主键值？

针对你提到的离线客户端队列操作+主键替换需求，我来分享一下具体的实现思路和ActiveJDBC相关的关键点：

核心思路 #

离线阶段用临时主键标记操作队列中的数据（确保和数据库自增主键不冲突），网络恢复后批量执行插入操作，获取数据库生成的真实主键，再替换队列中后续关联该临时主键的更新/删除操作，最后执行这些修正后的操作。

1. ActiveJDBC中获取生成的主键 #

ActiveJDBC在执行save()或create()后，会自动将数据库生成的自增主键填充到模型对象中，你可以直接通过以下方式获取：

用create()静态方法

create()会直接返回创建后的模型实例，主键已经被填充：

// 创建新用户并获取真实主键
User newUser = User.create("name", "Alice", "email", "alice@example.com");
Long realPrimaryKey = newUser.getId(); // 直接获取DB生成的自增ID

用save()方法

如果是先构建模型对象再调用save()，只要是新对象（未持久化过），执行save()后同样能获取主键：

User newUser = new User();
newUser.set("name", "Bob");
newUser.set("email", "bob@example.com");
newUser.save(); // 执行插入
Long realPrimaryKey = newUser.getId(); // 获取生成的主键

注意：如果是更新已存在的对象，save()不会改变主键，getId()返回的还是原来的数据库主键。

2. 离线队列与主键替换的具体实现 #

步骤1：离线时生成临时主键并记录操作

临时主键要避免和数据库自增主键冲突，比如用负数序列（假设DB自增从1开始）或者UUID字符串：

// 生成临时主键（示例：用负数时间戳）
Long tempId = -System.currentTimeMillis();

// 构建离线操作数据
Map<String, Object> userData = new HashMap<>();
userData.put("id", tempId); // 标记临时主键
userData.put("name", "Charlie");
userData.put("email", "charlie@example.com");

// 将操作存入本地队列（自定义Operation类记录操作类型、表名、数据、临时主键）
OfflineOperationQueue.add(new Operation(
    OperationType.INSERT,
    "users",
    userData,
    tempId
));

// 后续的更新/删除操作同样用tempId关联
OfflineOperationQueue.add(new Operation(
    OperationType.UPDATE,
    "users",
    Map.of("id", tempId, "email", "charlie_updated@example.com"),
    tempId
));

步骤2：网络恢复后批量执行并替换主键

// 开启事务确保操作原子性
try (DBTransaction tx = DB.beginTransaction()) {
    // 先处理所有插入操作，收集临时主键和真实主键的映射
    Map<Long, Long> tempToRealIdMap = new HashMap<>();
    List<Operation> insertOps = OfflineOperationQueue.getOpsByType(OperationType.INSERT);
    
    for (Operation op : insertOps) {
        Map<String, Object> data = new HashMap<>(op.getData());
        data.remove("id"); // 移除临时主键，让DB生成自增ID
        
        // 根据表名实例化模型（这里可以用反射或者工厂类处理多表场景）
        User user = new User();
        user.fromMap(data);
        user.save();
        
        // 记录临时主键和真实主键的映射
        tempToRealIdMap.put(op.getTempId(), user.getId());
    }

    // 处理后续的更新/删除操作，替换临时主键为真实主键
    List<Operation> modifyOps = OfflineOperationQueue.getOpsByType(OperationType.UPDATE, OperationType.DELETE);
    for (Operation op : modifyOps) {
        Long tempId = op.getTempId();
        Long realId = tempToRealIdMap.get(tempId);
        if (realId == null) {
            // 关联的插入操作可能失败，跳过或标记重试
            continue;
        }

        Map<String, Object> data = op.getData();
        data.put("id", realId); // 替换主键

        // 执行操作
        if (op.getType() == OperationType.UPDATE) {
            User user = User.findById(realId);
            user.fromMap(data);
            user.save();
        } else if (op.getType() == OperationType.DELETE) {
            User.deleteById(realId);
        }
    }

    tx.commit();
    // 清理已完成的操作
    OfflineOperationQueue.clearCompletedOps();
} catch (SQLException e) {
    // 回滚事务，保留队列等待下次重试
    DB.rollbackTransaction();
    // 记录错误日志
    e.printStackTrace();
}

3. 关键注意事项 #

• 临时主键冲突避免：确保临时主键的范围和数据库自增主键完全不重叠，比如DB用正整数，临时主键用负整数；如果是字符串主键，临时主键可以加前缀（如temp-+UUID）。
• 事务原子性：批量执行时一定要用事务，避免部分操作成功部分失败导致数据不一致。
• 重试机制：如果网络恢复后执行失败，要保留队列并设置重试策略（比如指数退避），避免丢失操作。

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