ObjectBox实体如何插入唯一值？是否支持Room的@Insert冲突替换策略？

有没有类似Room的@Insert(onConflict = OnConflictStrategy.REPLACE)的实现？ #

答案是：有，但形式不一样。很多从Room转用ObjectBox的开发者都会有这个疑问，其实ObjectBox通过@Unique注解提供了类似的冲突策略控制，甚至支持更灵活的唯一约束（包括复合唯一）。

你可以直接在需要唯一约束的字段上添加@Unique注解，并指定onConflict属性，来定义遇到重复值时的处理逻辑：

@Entity
public class User {
    @Id
    long id;
    
    // 当email重复时，自动替换原有条目
    @Unique(onConflict = ConflictStrategy.REPLACE)
    String email;
    
    String username;
    int age;
    
    // 构造函数、getter/setter 省略
}

ObjectBox提供三种冲突策略：

• ConflictStrategy.REPLACE：遇到重复唯一值时，删除旧实体，插入新实体（和Room的REPLACE效果完全一致）
• ConflictStrategy.IGNORE：忽略本次插入操作，保留原有实体，不会抛出异常
• ConflictStrategy.FAIL：默认行为，抛出DbException异常提示冲突

如果需要复合唯一约束（多个字段组合起来唯一），可以在实体类上使用@Unique注解指定多个字段：

@Entity
// 当userId和productId组合重复时，自动忽略插入
@Unique(propertyNames = {"userId", "productId"}, onConflict = ConflictStrategy.IGNORE)
public class UserCartItem {
    @Id
    long id;
    long userId;
    long productId;
    int quantity;
}

如果需要更自定义的逻辑，怎么避免重复条目？ #

如果内置的冲突策略满足不了你的需求（比如只更新部分字段，而不是完全替换整个实体），可以手动实现「先查询，再决定插入或更新」的逻辑：

// 获取User实体的Box对象
Box<User> userBox = MyObjectBox.builder().build().boxFor(User.class);

// 待插入的新用户
User newUser = new User("john@example.com", "JohnDoe", 28);

// 根据唯一字段查询是否已存在
User existingUser = userBox.query()
        .equal(User_.email, newUser.getEmail())
        .build()
        .findFirst();

if (existingUser == null) {
    // 不存在则插入新条目
    userBox.put(newUser);
} else {
    // 存在则仅更新需要修改的字段
    existingUser.setUsername(newUser.getUsername());
    existingUser.setAge(newUser.getAge());
    userBox.put(existingUser); // 更新已有条目
}

这种方式的好处是你可以完全控制更新的内容，比如只同步部分字段，而不是替换整个实体。

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