Menedżer modelu Django. Gdzie można znaleźć dokumentację?

Question

zawsze czytam, że powinienem użyć

model = Model(a=5, b=6) 
model.save() 

Ale właśnie widziałem tam jest funkcją menedżera tworzyć, bo widziałem aplikację opensource django używając go.

model = Model.objects.create(a=5, b=6) 
print model.pk 
1 

Czy sugeruje się korzystanie z niego? Czy nadal preferuje się stosowanie metody .save. Zgaduję, że objects.create spróbuje stworzyć go bez względu na wszystko, podczas gdy save może zapisać istniejący obiekt, jeśli określono pk.

Są docs, które znalazłem: https://docs.djangoproject.com/en/dev/topics/db/queries/#creating-objects

Answer 1

To na stronie "QuerySet API reference", połączonego z indeksu dokumentacji.

Answer 2

Zasadniczo te dwie metody to equivalent. Użytkowanie Model.objects.create może być preferowane, ponieważ jest bardziej dostosowane do stylu Django.

Answer 3

p = Person.objects.create(first_name="Bruce", last_name="Springsteen") 

odpowiednikiem:

p = Person(first_name="Bruce", last_name="Springsteen") 
p.save(force_insert=True) 

force_insert oznacza, że ​​nowy obiekt będzie zawsze tworzone.
Zazwyczaj nie musisz się o to martwić. Jeśli jednak model zawiera ręczną wartość klucza podstawowego, która została ustawiona, a wartość już istnieje w bazie danych, wywołanie metody create() zakończy się niepowodzeniem zIntegrityError, ponieważ klucze podstawowe muszą być unikalne. Przygotuj się na obsługiwać wyjątek, jeśli używasz ręcznych kluczy głównych.

Answer 4

Tworzenie zasadniczo robi to samo. poniżej znajduje się kod źródłowy do utworzenia.

def create(self, **kwargs): 
    """ 
    Creates a new object with the given kwargs, saving it to the database 
    and returning the created object. 
    """ 
    obj = self.model(**kwargs) 
    self._for_write = True 
    obj.save(force_insert=True, using=self.db) 
    return obj 

tworzy instancję, a następnie zapisuje ją.