Django模型(_Meta属性)
Python有反射机制,Django也不例外,也有很好的反射机制,每个Django模型都有一个属性_meta,_meta也有属性和方法,这些属性和方法反射出了模型的一些特性
在django项目中,定义一个模型,然后用dir()函数打印出该模型的_meta的属性和方法,结果如下:
_meta的属性和方法: '__class__', '__delattr__', '__dict__', '__doc__', '__format__', '__getattribute__', '__hash__', '__init__', '__module__', '__new__', '__reduce__',
'__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', '__weakref__', '_field_cache', '_field_name_cache', '_fields',
'_fill_fields_cache', '_fill_m2m_cache', '_fill_related_many_to_many_cache', '_fill_related_objects_cache', '_join_cache', '_m2m_cache', '_many_to_many',
'_name_map', '_prepare', '_related_many_to_many_cache', '_related_objects_cache', '_related_objects_proxy_cache', 'abstract', 'abstract_managers',
'add_field', 'add_virtual_field', 'admin', 'app_label', 'auto_created', 'auto_field', 'concrete_managers', 'concrete_model', 'contribute_to_class',
'db_table', 'db_tablespace', 'duplicate_targets', 'fields', 'get_add_permission', 'get_all_field_names', 'get_all_related_m2m_objects_with_model',
'get_all_related_many_to_many_objects', 'get_all_related_objects', 'get_all_related_objects_with_model', 'get_ancestor_link', 'get_base_chain',
'get_change_permission', 'get_delete_permission', 'get_field', 'get_field_by_name', 'get_fields_with_model', 'get_latest_by', 'get_m2m_with_model',
'get_ordered_objects', 'get_parent_list', 'has_auto_field', 'init_name_map', 'installed', 'local_fields', 'local_many_to_many', 'managed', 'many_to_many',
'module_name', 'object_name', 'order_with_respect_to', 'ordering', 'parents', 'permissions', 'pk', 'pk_index', 'proxy', 'proxy_for_model', 'related_fkey_lookups',
'setup_pk', 'setup_proxy', 'unique_together', 'verbose_name', 'verbose_name_plural', 'verbose_name_raw', 'virtual_fields'
下面介绍一下它的主要属性和方法:
_field_cache:
字段类型的缓存,是个元组,里面的元素反映该模型各个字段的类型,返回结果形式如下:
((<django.db.models.fields.AutoField: id>, None), (<django.db.models.fields.DateTimeField: create_time>, None),
(<django.db.models.fields.related.ForeignKey: create_user>, None), (<django.db.models.fields.DateTimeField: write_time>, None),
(<django.db.models.fields.related.ForeignKey: write_user>, None), (<django.db.models.fields.related.ForeignKey: confirm_user>, None),
(<django.db.models.fields.DateTimeField: confirm_date>, None))
_field_name_cache:
跟上面的_field_cache差不多,返回的结果形式如下:
[<django.db.models.fields.AutoField: id>, <django.db.models.fields.DateTimeField: create_time>,
<django.db.models.fields.related.ForeignKey: create_user>, <django.db.models.fields.DateTimeField: write_time>,
<django.db.models.fields.related.ForeignKey: write_user>, <django.db.models.fields.related.ForeignKey: confirm_user>]
abstract:
布尔型,表示是否是抽象类,抽象类是不能实例化的。由于python 没有抽象类、接口的概念,所以要实现这种功能得abc这个模块
abstract_managers:
返回抽象管理器列表,管理器是Django 的模型进行数据库查询操作的接口。Django 应用的每个模型都拥有至少一个管理器
add_field():
按顺序来插入字段,函数原型add_field(field, private=False, virtual=NOT_PROVIDED),file参数是字段类型实例。可参加这部分的源码,链接如下 :https://github.com/django/django/blob/master/django/db/models/base.py
add_virtual_field():
添加一个虚拟的字段,函数原型add_virtual_field(field, varargs=None, keywords=None, defaults=None),可用_meta的virtual_fields属性可以查看该模型下所有的虚拟字段
app_label:
属性,该模型所在app包的名称
auto_created:
布尔值,表示是否自动创建
auto_field:
属性,返回所有自增字段类型的字段,一般是`id`字段,如<django.db.models.fields.AutoField: id
concrete_managers:
返回具体的管理器列表,默认情况下,Django 为每个模型类添加一个名为objects的管理器,所以默认情况下,该值至少含义一个objects管理器。如果你自定义了管理器,那么这个自定义管理器可以通过这个属性获得。
concrete_model:
属性,返回该模型本身,通过该属性值,可以用'.'操作访问它的某个字段的属性,包括字段名,是否可以为空等等
contribute_to_class():
不知道起什么作用,源码https://github.com/django/django/blob/master/django/db/models/options.py
db_table:
属性,该模型所用的数据表的名称,关于数据表的名称,可参见django文档,http://python.usyiyi.cn/django/ref/models/options.html
db_tablespace:
当前模型所使用的数据库表空间 的名字。默认值是项目设置中的DEFAULT_TABLESPACE,如果它存在的话
duplicate_targets:
属性,返回值是字典,表示该模型中,字段属性一样只是名字不一样的字段,例如下例:
from django.db import models from django.contrib.auth.models import User class A(models.Model): create_time = models.DateTimeField(auto_now_add=True) create_user = models.ForeignKey(User,related_name='%(app_label)s_%(class)s_create_user') write_time = models.DateTimeField(auto_now=True,blank=True,null=True) write_user = models.ForeignKey(User,related_name='%(app_label)s_%(class)s_write_user',blank=True) confirm_user = models.ForeignKey(User,blank=True,null=True,) confirm_date = models.DateTimeField(blank=True,null=True) owner = models.ForeignKey(User,related_name='purchases_owner') review = models.ForeignKey(User,blank=True, null=True,related_name='review')
那么A._meta.duplicate_targets的值就为{'create_user_id': set(['review_id', 'write_user_id', 'owner_id']), 'review_id': set(['create_user_id', 'write_user_id', 'owner_id']), 'write_user_id': set(['create_user_id', 'review_id', 'owner_id']), 'owner_id': set(['create_user_id', 'review_id', 'write_user_id'])} 它们都关联类一个User。
fields:
属性,返回一个列表,列出了该模型的所有字段,如下:
[<django.db.models.fields.AutoField: id>, <django.db.models.fields.DateTimeField: create_time>, <django.db.models.fields.related.ForeignKey: create_user>,
<django.db.models.fields.DateTimeField: write_time>, <django.db.models.fields.related.ForeignKey: write_user>, <django.db.models.fields.related.ForeignKey: parent>,
<django.db.models.fields.CharField: state>, <django.db.models.fields.related.ForeignKey: owner>, <django.db.models.fields.related.ForeignKey: review>,
<django.db.models.fields.CharField: name>, <django.db.models.fields.CharField: tags>,]
我们知道字段其实是个Field对象,它的属性可以反映这个字段的特性,也就是模型字段选项,比如verbose_name, name, primary_key,max_length, unique, blank等等(Field类的源码参见https://github.com/django/django/blob/master/django/db/models/fields/__init__.py,模型字段选项含义参见http://python.usyiyi.cn/django/ref/models/fields.html)
get_add_permission():
获取“添加”权限,返回一个字符串,类似的还有get_change_permission(),get_delete_permission()
get_all_field_names():
返回一个列表,列表元素是该模型的所有字段名,怎么理解这个所有呢?这个所有不仅包括该模型自己定义的字段,还包括与其它模型中与它有关联的字段(即ForeignKey,ManyToManyField,OneToOneField)
get_all_related_m2m_objects_with_model():
获取与该模型存在ManyToManyField关系的所有模型,返回一个列表,例如[(<RelatedObject: human:humansupplier related to user>, None), (<RelatedObject: human:humanrole related to user>, None)]
get_all_related_many_to_many_objects():
跟上面的方法差不多,只是返回值的形式略有不同[<RelatedObject: human:humansupplier related to user>, <RelatedObject: human:humanrole related to user>] ,类似的还有get_all_related_objects(),get_all_related_objects_with_model(),
获取与该模型存在关联关系的所有模型
get_field():
原型get_field(name,many_to_many=True),field_name是字符串,返回模型该字段名对应的字段Field对象,如<django.db.models.fields.related.ForeignKey: create_user>,如果该字段名不存在,返回一个FieldDoesNotExist 异常
get_field_by_name():
同上,返回值比上面要丰富些(<django.db.models.fields.related.ForeignKey: create_user>, None, True, False),分别表示 (field_object, model, direct, m2m),如果模型该字段存在direct是 True,如果模型存在ManyToManyField关系,则m2m为True
get_fields_with_model():
返回该模型所有字段的(字段,模型)对序列,该模型对于当前模型上的字段,元素为无
get_latest_by:
属性,返回模型中某个可排序的字段的名称,如果你在模型的元选项中定义了get_latest_by的值,则_meta.get_latest_by会返回元选项中定义的get_latest_by的值,否则返回None,关于元选项,参见django文档http://python.usyiyi.cn/django/ref/models/options.html
get_m2m_with_model():
是get_fields_with_model()的many-to-many版本
get_ordered_objects():
返回根据此对象排序的选项对象的列表
has_auto_field:
属性,返回布尔值,表示该模型有没有自增字段
init_name_map():
初始化字段名到字段对象(即Field对象)的映射,
installed:
属性,布尔值,该模型所在的app是否在django的setting文件里配置,即setting文件的INSTALLED_APPS里是否有该模型所在的app的名称
local_fields:
属性,返回该模型的所有本地字段,返回值是个列表,元素是字段类型
local_many_to_many:
属性,返回该模型的所有是many_to_many关系的字段,不包括其父类,返回值是个列表;类似的还有一个many_to_many返回模型及其父类中所有是many_to_many关系字段的列表。
managed:属性,布尔值
module_name:属性,返回模型名,是小写的,类型是字符串
object_name:属性,模型名,字符串,但是不是小写的,定义模型时用的是什么名字这儿显示的就是什么名字,是原型
ordering:属性,返回一个列表,对象默认的顺序。如果你在模型的元选项中定义了ordering的值,则_meta.ordering会返回元选项中定义的ordering的值,否则返回[]
permissions:属性,返回一个列表,返回创建对象时权限表中额外的权限.如果你在模型的元选项中定义了permissions的值,则_meta.permissions会返回元选项中定义的permissions的值,否则返回[],类似这种机制的还有unique_together, verbose_name, verbose_name_plural, verbose_name_raw
pk:属性,返回主键字段类型
pk_index():方法,返回fields列表中主键字段的索引。