Django blog - Django models 介绍

Posted 2021-05-01 全栈运维

Abstract

Django 模型models是与数据库相关的。Django 为 sqlite3, mysql, PostgreSQL，Oracle等数据库提供统一的API访问。
与数据库相关的代码一般写在 models.py 中，只需要在settings.py中配置即可，不用更改models.py中的代码。

---

数据库配置介绍

系统默认给出了sqlite3的配置

'ENGINE': 'django.db.backends.sqlite3', 
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),

这里给出一个MySQL配置的例子

'ENGINE': 'django.db.backends.mysql',                          
'USER': 'monitor',
'PASSWORD': 'Montor@123',                                      
'HOST': '127.0.0.1',
'PORT': 3306,
'OPTIONS' : {
    'init_command': 'SET storage_engine=INNODB', 
    'charset':'utf8',
}

这里最核心的是ENGINE参数， 通过其确认是我们是用那种数据库引擎
其余配置简单一目了然

---

models

举例

rom django.db import models

class Person(models.Model):
    first_name = models.CharField(max_length=30)
    last_name = models.CharField(max_length=30)
    age = models.IntegerField()
    add_date = models.Date()

    class Meta:
        db_table = 'colin_person'

转换成MySQL语句如下：

create table colin_person(
id int NOT NULL auto_increment, 
first_name varchar(30) NOT NULL,
last_name varchar(30) NOT NULL,
age int not null,
add_date date,
primary key(id)
)

---

关于Django模型models需要注意的几个地方：

• Django 模型字段说明

refer to: django/db/models/fields/__init__.py

Field
|--AutoField
|--BooleanField
|--CharField
|  |--EmailField
|  |--SlugField
|  `--URLField
|--DateField
|  `--DateTimeField
|--DecimalField
|--FilePathField
|--FloatField
|--IntegerField
|  |--BigIntegerField
|  |--PositiveIntegerField
|  `--PositiveSmallIntegerField
|--IPAddressField
|--GenericIPAddressField
|--NullBooleanField
|--TextField
|--TimeField
`--BinaryField

• 字段属性说明

refer to: https://docs.djangoproject.com/en/1.11/topics/db/models/

verbose_name=None   #显示名
name=None           #域名
primary_key=False   #是否为主键
max_length=None     #在CharFiled中用到
unique=False        #是否唯一
blank=False
null=False          #是否允许为空
db_index=False
rel=None
default=NOT_PROVIDED
editable=True       #是否可编辑
serialize=True
unique_for_date=None
unique_for_month=None
unique_for_year=None
choices=None
help_text=''
db_column=None
db_tablespace=None
auto_created=False
validators=[]
error_messages=None

• Meta属性

官网列举了很多，具体可以参考 https://docs.djangoproject.com/en/1.11/ref/models/options/

这里举例说明几个常见的

# 字段排序，默认为升序， `-` 为降序
ordering = ['pubdate', '-addtime']

# 数据库表名
# 默认为 appname_modelclassname
db_table = 'colin_person'

# 索引
# 第一个是组合索引
# 第二个是指定索引名称
indexes = [
  models.Index(fields=['last_name', 'first_name']),
  models.Index(fields=['first_name'], name='first_name_idx'),
]

• 特殊说明

• def  __str__(self): or  def __unicode__(self):

  python3 用 def  __str__(self):
  python2 用 def __unicode__(self):

  目的在于使用 python manage.py shell 进行models查询的时候显示友好话名称输出，至于具体的意思，大家亲自尝试会更容易理解

• models.ForeignKey
  Refer to ForeignKey

• models.ManyToManyField
  Refer to ManyToManyField

• models.OneToOneField
  Refer to OneToOneField

---

ForeignKey举例说明：

Refer to https://my.oschina.net/hevakelcj/blog/383179

class Author(models.Model):
    name = models.CharField(max_length=100)

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.ForeignKey(Author) #定义外键

我们可以执行如下的查询

book_title = "Python程序设计"

# 找到title为"Python程序设计"的book对象this_book
this_book = Book.objects.get(title=book_title)  

# 由this_book获得作者对象author
author = this_book.author   

# 根据author获得所有的书，得到books数组
books = author.book_set.all()   

# 打印每一本书
for book in books: 
    print(book.title)

在Book中加入了ForeignKey(Author)之后，Django会在Author对象中添加一个属性叫：book_set。

但是，如果用的是ForeignKey(Author, related_name="books")，也就是告诉django在Author端对应的属性名叫"books"，而不再django默认的"book_set"了。

至于多对多(ManyToManyField) 和一对一(OneToOneField) 大家可以自行试验看看。加深理解