定义模型
定义模型的注意事项及特性说明.
1. 在模型中定义属性,会生成表中的字段
2. django根据属性的类型确定以下信息:
3. 当前选择的数据库支持字段的类型
4. 渲染管理表单时使用的默认html控件
5. 在管理站点最低限度的验证
6. django会为表增加自动增长的主键列,每个模型只能有一个主键列,如果使用选项设置某属性为主键列后,则django不会再生成默认的主键列
7. 属性命名限制
8. 不能是python的保留关键字
9. 由于django的查询方式,不允许使用连续的下划线
字段类型
AutoField:一个根据实际ID自动增长的IntegerField,通常不指定,如果不指定,一个主键字段将自动添加到模型中
BooleanField:true/false 字段,此字段的默认表单控制是CheckboxInput
NullBooleanField:支持null、true、false三种值
CharField(max_length=字符长度):字符串,默认的表单样式是 TextInput
TextField:大文本字段,一般超过4000使用,默认的表单控件是Textarea
IntegerField:整数
DecimalField(max_digits=None, decimal_places=None):使用python的Decimal实例表示的十进制浮点数
DecimalField.max_digits:位数总数
DecimalField.decimal_places:小数点后的数字位数
FloatField:用Python的float实例来表示的浮点数
DateField[auto_now=False, auto_now_add=False]):使用Python的datetime.date实例表示的日期
参数DateField.auto_now:每次保存对象时,自动设置该字段为当前时间,用于"最后一次修改"的时间戳,它总是使用当前日期,默认为false
参数DateField.auto_now_add:当对象第一次被创建时自动设置当前时间,用于创建的时间戳,它总是使用当前日期,默认为false
该字段默认对应的表单控件是一个TextInput. 在管理员站点添加了一个JavaScript写的日历控件,和一个“Today"的快捷按钮,包含了一个额外的invalid_date错误消息键
auto_now_add, auto_now, and default 这些设置是相互排斥的,他们之间的任何组合将会发生错误的结果
TimeField:使用Python的datetime.time实例表示的时间,参数同DateField
DateTimeField:使用Python的datetime.datetime实例表示的日期和时间,参数同DateField
FileField:一个上传文件的字段
ImageField:继承了FileField的所有属性和方法,但对上传的对象进行校验,确保它是个有效的image
字段选项
通过字段选项,可以实现对字段的约束
在创建字段对象时通过关键字参数指定
null:如果为True,Django 将空值以NULL 存储到数据库中,默认值是 False
blank:如果为True,则该字段允许为空白,默认值是 False
对比:null是数据库范畴的概念,blank是表单验证证范畴的
db_column:字段的名称,如果未指定,则使用属性的名称
db_index:若值为 True, 则在表中会为此字段创建索引
default:默认值
primary_key:若为 True, 则该字段会成为模型的主键字段
unique:如果为 True, 这个字段在表中必须有唯一值
关系
关系的类型包括
ForeignKey:一对多,将字段定义在多的端中
ManyToManyField:多对多,将字段定义在两端中
OneToOneField:一对一,将字段定义在任意一端中
用一访问多:对象.模型类小写_set
bookinfo.heroinfo_set
用一访问一:对象.模型类小写
heroinfo.bookinfo
访问id:对象.属性_id
heroinfo.book_id
元选项
在模型类中定义类Meta,用于设置元信息
元信息db_table:定义数据表名称,推荐使用小写字母,
ordering:对象的默认排序字段,获取对象的列表时使用,接收属性构成的列表
管理器
当定义模型类时没有指定管理器,则Django会为模型类提供一个名为objects的管理器
objects:是Manager类型的对象,用于与数据库进行交互
当为模型类指定管理器后,django不再为模型类生成名为objects的默认管理器
管理器是Django的模型进行数据库的查询操作的接口,Django应用的每个模型都拥有至少一个管理器
自定义管理器的两种方法;
1.向管理类中添加额外的方法
2.修改管理器返回的原始查询集
class BookInfoManager(models.Manager):
# 该管理器将原始的查询集进行了筛选,值显示未被逻辑删除的
def get_queryset(self):
return super(BookInfoManager, self).get_queryset().filter(isDelete=False)
class BookInfo(models.Model):
...
books = BookInfoManager()
调用的时候就不能调用默认的管理器object了
调用方法:
BookInfo.books.all(),返回结果管理器筛选之后的对象的一个类列表的数据,但实际上不是列表
快速的为对象添加属性
方法一
class BookInfoManager(models.Manager):
def create_book(self, title, pub_date):
book = self.model()
book.btitle = title
book.bpub_date = pub_date
book.bread=0
book.bcommet=0
book.isDelete = False
return book
class BookInfo(models.Model):
...
books = BookInfoManager()
_____________________
调用:book=BookInfo.books.create_book("abc",datetime(1980,1,1))
保存:book.save()
方法二
class BookInfoManager(models.Manager):
def create_book(self, title, pub_date):
# 调用父类的create方法,直接创建并保存
book = self.create(btitle = title,bpub_date = pub_date,bread=0,bcommet=0,isDelete = False)
return book
class BookInfo(models.Model):
...
books = BookInfoManager()
调用:book=Book.books.create_book("abc",datetime(1980,1,1))
查看:book.pk
也可以在模型类中使用类方法来完成,但不建议使用.
一个简单的模型类示例
from django.db import models
class BookInfoManage(models.Manager):
def get_queryset(self):
return super(BookInfoManage,self).get_queryset().filter(isDelete=False)
class BookInfo(models.Model):
btitle = models.CharField(max_length=20)
bpub_date = models.DateTimeField(db_column='pub_date')
bread = models.IntegerField(default=0)
bcommet = models.IntegerField(default=0)
isDelete = models.BooleanField(default=False)
books = models.Manager()
books2 = BookInfoManage()
class Meta():
db_table = 'bookinfo'
def __str__(self):
return self.btitle.encode('utf-8')
class HeroInfo(models.Model):
hname = models.CharField(max_length=20)
hgender = models.BooleanField(default=True)
hbook = models.ForeignKey('BookInfo')
hcontent = models.CharField(max_length=100)
isDelete = models.BooleanField(default=False)
def __str__(self):
return self.hname.encode('utf-8')