官網的手寫版如下:
-
update_or_create
( defaults=None, **kwargs) ¶
A convenience method for updating an object with the given kwargs
, creating a new one if necessary. The defaults
is a dictionary of (field, value) pairs used to update the object. The values in defaults
can be callables.
Returns a tuple of (object, created)
, where object
is the created or updated object and created
is a boolean specifying whether a new object was created.
The update_or_create
method tries to fetch an object from database based on the given kwargs
. If a match is found, it updates the fields passed in the defaults
dictionary.
This is meant as a shortcut to boilerplatish code. For example:
大致意思是創建或者更新,當過濾條件匹配到查詢結果則將更新defaults字典中的字段,否則創建一條記錄,字段內容為defaults字段中的內容。
返回(對象,已創建)的元組,其中object是已創建或已更新的對象,created是一個布爾值,指定是否創建了新對象。
defaults = {'first_name': 'Bob'} try: obj = Person.objects.get(first_name='John', last_name='Lennon') for key, value in defaults.items(): setattr(obj, key, value) obj.save() except Person.DoesNotExist: new_values = {'first_name': 'John', 'last_name': 'Lennon'} new_values.update(defaults) obj = Person(**new_values) obj.save()
以上的方法使用update_or_create實現
obj, created = Person.objects.update_or_create( first_name='John', last_name='Lennon', defaults={'first_name': 'Bob'}, )