`com.mongodb.client.model.Updates` 类常用的更新方法

com.mongodb.client.model.Updates 类是 MongoDB Java 驱动中的一部分，提供了用于构建更新操作的静态工厂方法。这些方法可以用来创建 $set, $unset, $inc 等各种更新操作的文档对象。以下是一些常用的更新方法及其简要说明：

1. set(String fieldName, Object value)
   • 设置字段的值。如果字段不存在，则会添加该字段并设置指定的值。
2. unset(String fieldName)
   • 从文档中移除指定的字段。
3. inc(String fieldName, Number incValue)
   • 增加（或减少，如果值为负）字段的数值。如果字段不存在，则默认值为0。
4. mul(String fieldName, Number mulValue)
   • 将字段的数值乘以指定的值。如果字段不存在，则默认值为0。
5. rename(String fieldName, String newName)
   • 重命名字段。注意：MongoDB 不直接支持 rename 操作作为更新操作的一部分，此方法可能涉及复杂的更新策略。
6. setOnInsert(String fieldName, Object value)
   • 在 upsert 操作中，如果需要插入新文档时，设置指定字段的值。如果文档已存在，则不会修改该字段。
7. currentDate(String fieldName) / currentDate(List<String> fieldNames)
   • 将字段的值设置为当前日期，可以是 Date 或 Timestamp 类型，取决于服务器端配置。
8. min(String fieldName, Object value) / max(String fieldName, Object value)
   • 如果现有字段的值小于（对于 min）或大于（对于 max）提供的值，则更新字段值。
9. addToSet(String fieldName, Object value)
   • 将值添加到数组字段中，但仅当该值尚不存在于数组中时才执行此操作。
10. popFirst(String fieldName) / popLast(String fieldName)
    • 从数组字段中删除第一个元素（对于 popFirst）或最后一个元素（对于 popLast）。
11. pull(String fieldName, Object value)
    • 从数组字段中移除所有匹配给定值的元素。
12. push(String fieldName, Object value)
    • 向数组字段中添加一个或多个值。

还有一些相对不那么常用但非常有用的方法：

1. combine(List\<Bson> updates)
   • 将多个更新操作组合成一个单一的更新操作。这在需要同时执行多个更新操作时很有用。
2. pullByFilter(Bson filter)
   • 根据指定的过滤条件从数组字段中删除匹配的所有元素。此方法允许你使用更复杂的条件来决定哪些元素应该被移除。
3. pushEach(String fieldName, Iterable<?> values, int position, int slice, boolean sortAscending)
   • 向数组字段中添加多个值，并提供额外的功能来控制如何执行这些添加操作（例如，指定位置、限制数组大小、排序等）。
4. pushEachWithSortAndSlice(String fieldName, Iterable<?> values, Integer position, Integer slice, Bson sort)
   • 此方法是 pushEach 的扩展版本，允许更细粒度地控制插入到数组中的元素的位置、数组的最大长度以及如何对数组进行排序。
5. pullAll(String fieldName, Iterable<?> values)
   • 从数组字段中删除所有与提供的值列表匹配的元素。这与 pull 不同，后者仅基于单个值进行匹配。
6. bitwiseAnd(String fieldName, long value) / bitwiseOr(String fieldName, long value) / bitwiseXor(String fieldName, long value)
   • 对整数类型的字段执行按位 AND、OR 或 XOR 操作，并将结果存储回该字段。
7. mulEach(String fieldName, Number mulValue)
   • 这个方法可能是指对数组内的每个数值元素乘以指定的值，但实际上 Updates 类并没有直接提供这种方法。对于类似需求，您可能需要结合 $map 等聚合表达式来实现。