Django_-_podrobnoe_rukovodstvo

стое значение, скорее всего, приведет к ошибке базы данных. По умолчанию равен False.

Отметим, что пустые строковые значения всегда сохраняются как пустые строки, а не как значение NULL. Значение null=True следует использовать только для не-строковых полей, например, целых чисел, булевских значений и дат. В любом случае нужно также задать blank=True, чтобы разрешить оставлять незаполненные поля в формах, так как параметр null влияет только на сохранение в базе данных (см. раздел «Параметр blank»).

Не используйте параметр null для строковых полей, например CharField и TextField, если на то нет веской причины. Если для строкового поля задано null=True, то образуется два способа выразить семантику «отсутствия данных»: NULL и пустая строка. В большинстве случаев такая неоднозначность ни к чему; в Django принято соглашение использовать в этом случае пустую строку, а не NULL.

Примечание

При работе с СУБД Oracle параметр null=True принудительно задается для строковых полей, допускающих пустые значения, и для обозначения пустой строки в базу данных записывается NULL.

Дополнительную информацию по этому поводу см. в разделе «Как сделать необязательными поля даты и числовые поля» главы 6.

Параметр blank

Если имеет значение True, то поле может быть оставлено пустым. По умолчанию False.

Отметим, что этот параметр отличается от null. Последний относится только к базе данных, тогда как первый – к проверке данных. Если для некоторого поля определен атрибут blank=True, то административный интерфейс Django позволит не заполнять его. Если же указан атрибут blank=False, то поле должно быть заполнено обязательно.

Параметр choices

Итерируемый объект (например, список или кортеж), каждым элементом которого является описание одного из допустимых значений поля.

Список choices выглядит следующим образом:

YEAR_IN_SCHOOL_CHOICES = ( (‘FR’, ‘Freshman’), (‘SO’, ‘Sophomore’), (‘JR’, ‘Junior’), (‘SR’, ‘Senior’), (‘GR’, ‘Graduate’),

)

Первый элемент в каждом кортеже – фактическое сохраняемое значение, второй – понятное для человека описание.

Список choices можно включить в класс модели:

class Foo(models.Model): GENDER_CHOICES = (

(‘М’, ‘Мужчина’), (‘Ж’, ‘Женщина’),

)

gender = models.CharField(max_length=1, choices=GENDER_CHOICES)

А можно определить и вне класса модели:

GENDER_CHOICES = ( (‘М’, ‘Мужчина’), (‘Ж’, ‘Женщина’),

)

class Foo(models.Model):

gender = models.CharField(max_length=1, choices=GENDER_CHOICES)

Можно также объединить допустимые варианты в именованные группы для более осмысленного расположения в форме:

MEDIA_CHOICES = ( (‘Audio’, (

(‘vinyl’, ‘Vinyl’), (‘cd’, ‘CD’),

)

), (‘Video’, (

(‘vhs’, ‘VHS Tape’), (‘dvd’, ‘DVD’),

)

),

(‘unknown’, ‘Unknown’),

)

Первый элемент в каждом кортеже – имя группы, второй – итерируемый объект, кортеж из двух элементов, каждый из которых содержит значение и понятное человеку описание варианта. Сгруппированные варианты можно объединять в один список с несгруппированными (как в случае варианта unknown выше).

Наконец, отметим, что варианты могут быть представлены любым итерируемым объектом, не обязательно списком или кортежем. Это позволяет конструировать варианты динамически. Но для динамического построения параметра choices лучше воспользоваться таблицей базы данных с внешним ключом (полем типа ForeignKey). Параметр choices все же предназначен для описания статических данных, которые изменяются редко.

пример, как ограничить выбор связанных объектов только теми, для которых значение поля pub_date раньше текущего момента:

limit_choices_to = {‘pub_date__lte’: datetime.now}

limit_choices_to не влияет на встроенные объекты FormSet, которые создаются для отображения связанных объектов в административным интерфейсе.

Параметр related_name

Имя, по которому связанная модель будет ссылаться на данную.

Параметр to_field

Поле в связанной модели, указанной в данном отношении. По умолчанию Django использует имя первичного ключа, определенного в связанной модели.

Класс ManyToManyField

Отношение многие-ко-многим. Конструктор принимает обязательный позиционный параметр – класс модели, с которой связана отношением данная модель. Работает точно так же, как в классе ForeignKey, включая возможность определения рекурсивных и опережающих связей.

Для представления отношения многие-ко-многим Django за кулисами создает промежуточную связующую таблицу. По умолчанию имя этой таблицы образуется из имен двух соединяемых таблиц. Поскольку некоторые СУБД не поддерживают длинные имена таблиц, то получившееся имя автоматически обрезается до 64 знаков, а для гарантии уникальности добавляется автоматически генерируемый суффикс. Поэтому не удивляйтесь, увидев имя вида author_books_9cdf4, – это абсолютно нормально. Параметр db_table позволяет определить имя связующей таблицы вручную.

Конструктор класса ManyToManyField принимает также дополнительные параметры (все они необязательны), с помощью которых можно уточнить поведение отношения.

Параметр related_name

То же, что related_name в классе ForeignKey.

Параметр limit_choices_to

То же, что limit_choices_to в классе ForeignKey.

Параметр limit_choices_to игнорируется, если поле типа ManyToManyField используется совместно с нестандартной связующей таблицей, заданной параметром through.

Параметр symmetrical

Используется только при определении отношения ManyToManyField с параметром self. Рассмотрим следующую модель:

class Person(models.Model):

friends = models.ManyToManyField(“self”)

При обработке этой модели Django обнаруживает отношение ManyToManyField модели с самой собой, поэтому не добавляет в класс Person атрибут person_set. Вместо этого предполагается, что связь ManyToManyField симметрична (если я – твой друг, то ты – мой друг).

Если вы не хотите, чтобы связь многие-ко-многим была симметричной, то передайте параметр symmetrical со значением False. Тогда Django добавит дескриптор для обратной связи, разрешая асимметрию

ManyToManyField.

Параметр through

Django автоматически создает связующую таблицу для реализации отношения многие-ко-многим. Но при желании вы можете определить ее самостоятельно, указав в параметре through модель, соответствующую этой таблице.

Обычно эта возможность применяется, когда с отношением многие-ко- многим необходимо ассоциировать дополнительные данные.

Параметр db_table

Имя связующей таблицы для отношения многие-ко-многим. Если не определено, по умолчанию будет образовано имя, состоящее из имен двух соединяемых таблиц.

Класс OneToOneField

Отношение один-к-одному. Концептуально аналогично ForeignKey с атрибутом unique=True, но в отличие от него каждый объект модели на «противоположной стороне» отношения связан с единственным объектом данной модели.

Обычно употребляется для определения первичного ключа модели, которая в некотором смысле «расширяет» данную; например, наследование таблиц реализуется путем явного добавления связи один-к-одному от дочерней модели к родительской.

Конструктор принимает один обязательный позиционный параметр – класс модели, с которой связывается данная модель. Работает точно так же, как в классе ForeignKey, включая возможность определения рекурсивных и опережающих связей.

Кроме того, конструктор класса OneToOneField принимает все дополнительные параметры, разрешенные для ForeignKey, плюс еще один:

Параметр parent_link

Если имеет значение True и употребляется в модели, которая наследует другую (уточняемую) модель, то это означает, что для обратной ссылки на родительский класс следует использовать данное поле – вместо дополнительного поля типа OneToOneField, которое обычно неявно создается для реализации отношения класс-подкласс.

Метаданные модели

Метаданные модели располагаются в классе Meta, определенном внутри класса модели:

class Book(models.Model):

title = models.CharField(maxlength=100)

class Meta:

# Здесь находятся метаданные модели

...

К метаданным модели относится «все, что не является полем», например, параметры сортировки и прочее. В следующих разделах описаны все параметры метаданных, ни один из которых не является обязательным. Класс Meta можно вообще не включать, если он не нужен.

Параметр abstract

Если имеет значение True, то данная модель является абстрактным базовым классом. О том, что это такое, см. документацию по Django.

Параметр db_table

Имя таблицы базы данных, соответствующей данной модели:

db_table = ‘music_album’

Имена таблиц

В целях экономии времени Django автоматически формирует имя таблицы базы данных из имени класса модели и приложения, в котором этот класс находится. Имя таблицы образуется путем конкатенации метки приложения (имени, которое было указано в команде manage.py startapp), знака подчеркивания и имени класса модели.

Например, если в приложении bookstore (созданном командой manage.py startapp bookstore) определена модель Book, то в базе данных появится таблица bookstore_book.

Чтобы определить другое имя таблицы, воспользуйтесь параметром db_table в классе Meta.

Ничего страшного не произойдет, если имя таблицы – зарезервированное слово языка SQL или содержит символы, не допустимые в именах

переменных Python (прежде всего, дефис). Django заключает имена таблиц и столбцов в кавычки.

Параметр db_tablespace

Имя табличного пространства базы данных, в котором должна находиться соответствующая модели таблица. Если СУБД не поддерживает табличные пространства, этот параметр игнорируется.

Параметр get_latest_by

Имя поля модели типа DateField или DateTimeField. Определяет, какое поле будет по умолчанию использоваться в методе latest класса Manager.

Например:

get_latest_by = “order_date”

Параметр managed

По умолчанию имеет значение True, то есть Django будет создавать необходимые таблицы при выполнении команды django-admin.py syncdb и удалять их при выполнении команды reset. Иными словами, Django берет на себя управление таблицами базы данных.

Если параметру указать значение False, то для данной модели никакие объекты базы данных не создаются и не удаляются. Эту особенность можно использовать, когда модель описывает уже существующую таблицу или представление, созданные иными средствами. Это единственное, что отличает значения True и False данного параметра. Все остальные аспекты поведения модели одинаковы, в частности:

•• Если первичный ключ для модели не указан явно, он добавляется автоматически. Чтобы не вводить в заблуждение тех, кто будет читать ваш код, лучше описывать в неуправляемой модели все без исключения столбцы базы данных.

•• Если модель, для которой managed=False, содержит поле типа ManyTo­­ ManyField, указывающее на другую неуправляемую модель, то связующая таблица для соединения многие-ко-многим не создается. Однако для связи между управляемой и неуправляемой моделью связующая таблица создается.

Если вы хотите изменить это поведение, то явно создайте модель для связующей таблицы (задав параметр managed, как того требуют обстоятельства) и укажите ее с помощью атрибута through.

Для тестирования моделей, в которых определен атрибут managed=False, вы сами должны создать необходимые таблицы на этапе подготовки тестовой среды.