def save(self, cascade=None, full_clean=True, force_insert=False):
"""Save this document into MongoDB.
If there is no value for the primary key on this Model instance, the
instance will be inserted into MongoDB. Otherwise, the entire document
will be replaced with this version (upserting if necessary).
:parameters:
- `cascade`: If ``True``, all dereferenced MongoModels contained in
this Model instance will also be saved.
- `full_clean`: If ``True``, the
:meth:`~pymodm.MongoModel.full_clean` method
will be called before persisting this object.
- `force_insert`: If ``True``, always do an insert instead of a
replace. In this case, `save` will raise
:class:`~pymongo.errors.DuplicateKeyError` if a document already
exists with the same primary key.
:returns: This object, with the `pk` property filled in if it wasn't
already.
"""
cascade = validate_boolean_or_none('cascade', cascade)
full_clean = validate_boolean('full_clean', full_clean)
force_insert = validate_boolean('force_insert', force_insert)
if full_clean:
self.full_clean()
if cascade or (self._mongometa.cascade and cascade is not False):
for field_name in self:
for referenced_object in self._find_referenced_objects(
getattr(self, field_name)):
referenced_object.save()
if force_insert or self._mongometa.pk.is_undefined(self):
result = self._mongometa.collection.insert_one(self.to_son())
self.pk = result.inserted_id
else:
result = self._mongometa.collection.replace_one(
{'_id': self._mongometa.pk.to_mongo(self.pk)},
self.to_son(),
upsert=True)
return self
def save(self, cascade=None, full_clean=True, force_insert=False):
"""Save this document into MongoDB.
If there is no value for the primary key on this Model instance, the
instance will be inserted into MongoDB. Otherwise, the entire document
will be replaced with this version (upserting if necessary).
:parameters:
- `cascade`: If ``True``, all dereferenced MongoModels contained in
this Model instance will also be saved.
- `full_clean`: If ``True``, the
:meth:`~pymodm.MongoModel.full_clean` method
will be called before persisting this object.
- `force_insert`: If ``True``, always do an insert instead of a
replace. In this case, `save` will raise
:class:`~pymongo.errors.DuplicateKeyError` if a document already
exists with the same primary key.
:returns: This object, with the `pk` property filled in if it wasn't
already.
"""
cascade = validate_boolean_or_none('cascade', cascade)
full_clean = validate_boolean('full_clean', full_clean)
force_insert = validate_boolean('force_insert', force_insert)
if full_clean:
self.full_clean()
if cascade or (self._mongometa.cascade and cascade is not False):
for field_name in self:
for referenced_object in self._find_referenced_objects(
getattr(self, field_name)):
referenced_object.save()
if force_insert or self._mongometa.pk.is_undefined(self):
result = self._mongometa.collection.insert_one(self.to_son())
self.pk = result.inserted_id
else:
result = self._mongometa.collection.replace_one(
{'_id': self._mongometa.pk.to_mongo(self.pk)},
self.to_son(), upsert=True)
return self