今天晚上看了一下Django文档的model部分,简要翻译一下,以备后用:
原文地址:
http://docs.djangoproject.com/en/dev/topics/db/models/
定义一个Model
每一个model必须是django.db.models.Model的一个子类
每个字段被定义为一个类的属性,每个属性对应数据库表的一个字段
from django.db import models
class Person(models.Model):
first_name = models.CharField(max_length=30)
last_name = models.CharField(max_length=30)
对应下面的sql:
CREATE TABLE myapp_person (
"id" serial NOT NULL PRIMARY KEY,
"first_name" varchar(30) NOT NULL,
"last_name" varchar(30) NOT NULL
);
默认情况下,Django会在model名的前面加上你的“应用的名称_”作为数据库表的名称。
比如你的应用是polls,定一个了一个model叫做Person,那么数据库表的名称是polls_person
默认情况下,Django汇给你自动增加一个叫做id的字段,并设置这个字段为主键。
使用Model
当定义了Model之后,你需要告诉Django去使用这些models,
修改settings.py中的INSTALLED_APPS属性,增加包含models.py的模块名称即可。
比如你的models.py文件的路径是 mysite.myapp.models.py那么只需要这样写即可:
INSTALLED_APPS = (
#...
'mysite.myapp',
#...
)
注意:如果你在settings.py的INSTALLED_APPS中添加了新的app,需要重新运行manage.py syncdb命令
字段类型
在model中的每一个字段都必须是Field类的一个实例。Django使用字段类型确定下面几件事情:
1、数据库字段的类型
2、在admin界面中使用的html组建,比如是文本框,还是单选框等。
3、必填项验证。
字段选项
每一个字段都有一些参数,比如CharField字段有一个max-length的参数,表示字段类型的长度。
Django定义了一些所有字段(类)都有的公共的参数,下面简单的总结一下他们的使用:
null
如果是True,Django会在数据库中将此字段的值置为NULL,默认值是False
blank
如果是True,那么这个字段是可以不填的。默认是False
blank和null的区别:null纯粹是与数据库有关系的。而blank是与页面必填项验证有关的。
如果blank=False,那么这个字段就是必填的。
choices
An iterable (e.g., a list or tuple) of 2-tuples to use as choices for this field. If this is given, Django's admin will use a select box instead of the standard text field and will limit choices to the choices given.
一个二维的元组被用作choices,如果这样定义,Django会select box代替普通的文本框,
并且限定choices的值是元组中的值
YEAR_IN_SCHOOL_CHOICES = (
('FR', 'Freshman'),
('SO', 'Sophomore'),
('JR', 'Junior'),
('SR', 'Senior'),
('GR', 'Graduate'),
)
default:
可以设置字段的默认值,它可以是一个普通的值,或者是一个可以调用(callable)的对象,如果是一个callable的对象,那么每次调用的时候都会创建一个新的对象。
primary_key:
如果是True,那么这个字段就是这个表的主键。
如果在model的字段上没有定义primary_key=True,那么Django会自动添加一个IntegerField(id)类型的字段,作为主键。所以一般情况下你不需要设置这个属性,除非你不想使用默认的设置。
unique
如果Ture,设定字段的值是唯一的。
Automatic primary key fields
默认情况下,Django会自动为每一个model定义如下字段:
id = models.AutoField(primary_key=True)
这是一个自增长的主键
你可以在任何一个字段上设置primary_key=True,如果Django发现你定义了这个属性,他就不会自动添加id字段了
Verbose field names
除了ForeignKey,ManyToManyField,OneToOneField外,每一个field类型的第一个参数,是一个可选参数-Verbose field names。如果没有这个参数,Django会自动的按照字段的名称创建一个。两个单词之间会用空格分割。
verbose name 是Person's first name
first_name = models.CharField("Person's first name", max_length=30)
verbose name是 first name
first_name = models.CharField(max_length=30)
ForeignKey, ManyToManyField and OneToOneField 要求第一个字段必须是一个model class,所以你可以使用
关键字参数定义verbose name:
poll = models.ForeignKey(Poll, verbose_name="the related poll")
sites = models.ManyToManyField(Site, verbose_name="list of sites")
place = models.OneToOneField(Place, verbose_name="related place")
这里约定verbose name的第一个字母不要大写。Django会在需要的时候,自动转化为大写。
Relationships
Django定一个三种通用的类型,去描述数据库表之间的关系:
many-to-one, many-to-many and one-to-one.
Many-to-one relationships:
使用ForeignKey来定一个Many-to-one的关联关系。就像使用普通的Field一样。
ForeignKey的第一个参数必须定义这个model与哪一个model关联
比如,Car model有一个Manufacturer:一个制造厂(one)可以生产很多汽车(Many),但是一个汽车只能有一个制造厂
class Manufacturer(models.Model):
# ...
class Car(models.Model):
#一个汽车只能有一个制造厂
manufacturer = models.ForeignKey(Manufacturer)
# ...
未完待续......