MongoEngine - 添加/删除文档
我们已经使用 Document 类的 save() 方法在集合中添加了一个文档。 可以在以下参数的帮助下进一步自定义 save() 方法 −
| force_insert | 默认为 False，如果设置为 True 则不允许更新现有文档。 |
| validate | 验证文档； 设置为 False 跳过。 |
| clean | 调用文档清理方法，validate 验证参数应为 True。 |
| write_concern | 将用作结果 getLastError 命令的选项。 例如，save(..., write_concern={w: 2, fsync: True}, ...) 将等到至少有两个服务器记录了写入并强制在主服务器上进行同步。 |
| cascade | 设置级联保存的标志。 您可以通过在文档 __meta__ 中设置"cascade"来设置默认值。 |
| cascade_kwargs | 要传递给级联保存的可选关键字参数。 相当于 cascade=True。 |
| _refs | 用于级联保存的已处理引用列表 |
| save_condition | 仅当数据库中的匹配记录满足条件时才执行保存。 如果不满足条件，则引发 OperationError |
| signal_kwargs | 要传递给信号调用的 kwargs 字典。 |
您可以在调用 save() 之前设置文档验证的清理规则。 通过提供自定义的 clean() 方法，您可以进行任何预验证/数据清理。
class MyDocument(Document):
...
...
def clean(self):
if <condition>==True:
msg = 'error message.'
raise ValidationError(msg)
请注意，只有在打开验证和调用 save() 时才会调用清理。
Document 类还有insert() 方法来执行批量插入。 它有以下参数 −
| doc_or_docs | 要插入的文档或文档列表 |
| load_bulk | 如果为 True，返回文档实例列表 |
| write_concern | 额外的 keyword 关键字参数被传递给 insert() ，它将用作结果 getLastError 命令的选项。 |
| signal_kwargs | （可选）要传递给信号调用的 kwargs 字典 |
如果文档包含任何 ReferenceField 对象，则默认情况下 save() 方法不会保存对这些对象的任何更改。 如果您还希望保存所有引用，请注意每次保存都是一个单独的查询，然后将级联作为 True 传递给保存方法将保存任何级联。
通过调用 delete() 方法，从其集合中删除文档非常容易。 请记住，只有在文档之前已保存时它才会生效。 delete() 方法具有以下参数 −
| signal_kwargs | （可选）要传递给信号调用的 kwargs 字典。 |
| write_concern | 额外的关键字参数被传递下来，它们将用作结果 getLastError 命令的选项。 |
要从数据库中删除整个集合，请使用 drop_collecction() 方法。 它从数据库中删除与此文档类型关联的整个集合。 如果文档没有集合集（例如，如果它是抽象的），则该方法引发 OperationError。
文档类中的modify() 方法对数据库中的文档执行原子更新并重新加载其更新版本。如果文档已更新，则返回 True；如果数据库中的文档与查询不匹配，则返回 False。 请注意，如果该方法返回 True，所有对文档所做的未保存的更改都将被拒绝。
参数
| query | 仅当数据库中的文档与查询匹配时才会执行更新 |
| update | Django 风格的更新关键字参数 |
