_meta
API модели ¶
-
класс
Options
¶
_meta
API модели лежит в основе Django ORM. Это позволяет другим частям системы, таким как поиск, запросы, формы и администратор, понимать возможности каждой модели. API доступен через _meta
атрибут каждого класса модели, который является экземпляром
django.db.models.options.Options
объекта.
Предоставляемые в нем методы можно использовать для:
- Получить все экземпляры полей модели
- Получить один экземпляр поля модели по имени
API доступа к полям ¶
Получение одного экземпляра поля модели по имени ¶
-
Options.
get_field
( имя_поля ) ¶ Возвращает экземпляр поля по имени поля.
field_name
может быть именем поля в модели, полем в абстрактной или унаследованной модели или полем, определенным в другой модели, которое указывает на модель. В последнем случаеfield_name
будет (в порядке предпочтения)related_query_name
заданное пользователем,related_name
заданное пользователем или имя, автоматически сгенерированное Django.Hidden fields
не может быть получен по имени.Если поле с заданным именем не найдено,
FieldDoesNotExist
будет возбуждено исключение.>>> from django.contrib.auth.models import User # A field on the model >>> User._meta.get_field('username') <django.db.models.fields.CharField: username> # A field from another model that has a relation with the current model >>> User._meta.get_field('logentry') <ManyToOneRel: admin.logentry> # A non existent field >>> User._meta.get_field('does_not_exist') Traceback (most recent call last): ... FieldDoesNotExist: User has no field named 'does_not_exist'
Получение всех экземпляров полей модели ¶
-
Options.
get_fields
( include_parents = True , include_hidden = False ) ¶ Возвращает кортеж полей, связанных с моделью.
get_fields()
принимает два параметра, которые можно использовать для управления возвращаемыми полями:include_parents
True
по умолчанию. Рекурсивно включает поля, определенные в родительских классах. Если установленоFalse
,get_fields()
будет искать только поля, объявленные непосредственно в текущей модели. Поля из моделей, которые напрямую наследуются от абстрактных моделей или прокси-классов, считаются локальными, а не родительскими.include_hidden
False
по умолчанию. Если установлено значениеTrue
,get_fields()
будут включены поля, которые используются для поддержки функций других полей. Это также будет включать любые поля, которые имеютrelated_name
(напримерManyToManyField
, илиForeignKey
), начинающиеся с «+».
>>> from django.contrib.auth.models import User >>> User._meta.get_fields() (<ManyToOneRel: admin.logentry>, <django.db.models.fields.AutoField: id>, <django.db.models.fields.CharField: password>, <django.db.models.fields.DateTimeField: last_login>, <django.db.models.fields.BooleanField: is_superuser>, <django.db.models.fields.CharField: username>, <django.db.models.fields.CharField: first_name>, <django.db.models.fields.CharField: last_name>, <django.db.models.fields.EmailField: email>, <django.db.models.fields.BooleanField: is_staff>, <django.db.models.fields.BooleanField: is_active>, <django.db.models.fields.DateTimeField: date_joined>, <django.db.models.fields.related.ManyToManyField: groups>, <django.db.models.fields.related.ManyToManyField: user_permissions>) # Also include hidden fields. >>> User._meta.get_fields(include_hidden=True) (<ManyToOneRel: auth.user_groups>, <ManyToOneRel: auth.user_user_permissions>, <ManyToOneRel: admin.logentry>, <django.db.models.fields.AutoField: id>, <django.db.models.fields.CharField: password>, <django.db.models.fields.DateTimeField: last_login>, <django.db.models.fields.BooleanField: is_superuser>, <django.db.models.fields.CharField: username>, <django.db.models.fields.CharField: first_name>, <django.db.models.fields.CharField: last_name>, <django.db.models.fields.EmailField: email>, <django.db.models.fields.BooleanField: is_staff>, <django.db.models.fields.BooleanField: is_active>, <django.db.models.fields.DateTimeField: date_joined>, <django.db.models.fields.related.ManyToManyField: groups>, <django.db.models.fields.related.ManyToManyField: user_permissions>)