定義模型類

• 模型類被定義在"應用/models.py"檔案中。
• 模型類必須繼承自Model類，位於包django.db.models中。

接下來首先以"圖書-英雄"管理為例進行演示。

1 定義

建立應用booktest，在models.py 檔案中定義模型類。

from django.db import models

#定義圖書模型類BookInfo
class BookInfo(models.Model):
    btitle = models.CharField(max_length=20, verbose_name='名稱')
    bpub_date = models.DateField(verbose_name='釋出日期')
    bread = models.IntegerField(default=0, verbose_name='閱讀量')
    bcomment = models.IntegerField(default=0, verbose_name='評論量')
    is_delete = models.BooleanField(default=False, verbose_name='邏輯刪除')

    class Meta:
        db_table = 'tb_books'  # 指明資料庫表名
        verbose_name = '圖書'  # 在admin站點中顯示的名稱
        verbose_name_plural = verbose_name  # 顯示的複數名稱

    def __str__(self):
        """定義每個資料物件的顯示資訊"""
        return self.btitle

#定義英雄模型類HeroInfo
class HeroInfo(models.Model):
    GENDER_CHOICES = (
        (0, 'male'),
        (1, 'female')
    )
    hname = models.CharField(max_length=20, verbose_name='名稱') 
    hgender = models.SmallIntegerField(choices=GENDER_CHOICES, default=0, verbose_name='性別')  
    hcomment = models.CharField(max_length=200, null=True, verbose_name='描述資訊') 
    hbook = models.ForeignKey(BookInfo, on_delete=models.CASCADE, verbose_name='圖書')  # 外來鍵
    is_delete = models.BooleanField(default=False, verbose_name='邏輯刪除')

    class Meta:
        db_table = 'tb_heros'
        verbose_name = '英雄'
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.hname
 

1） 資料庫表名

模型類如果未指明表名，Django預設以 小寫app應用名_小寫模型類名 為資料庫表名。

可通過db_table 指明資料庫表名。

2） 關於主鍵

django會為表建立自動增長的主鍵列，每個模型只能有一個主鍵列，如果使用選項設定某屬性為主鍵列後django不會再建立自動增長的主鍵列。

預設建立的主鍵列屬性為id，可以使用pk代替，pk全拼為primary key。

3） 屬性命名限制

• 不能是python的保留關鍵字。
• 不允許使用連續的下劃線，這是由django的查詢方式決定的。

• 定義屬性時需要指定欄位型別，通過欄位型別的引數指定選項，語法如下：

  屬性=models.欄位型別(選項)
   
  

4）欄位型別

5） 選項

null是資料庫範疇的概念，blank是表單驗證範疇的

6） 外來鍵

在設定外來鍵時，需要通過on_delete選項指明主表刪除資料時，對於外來鍵引用表資料如何處理，在django.db.models中包含了可選常量：

• CASCADE 級聯，刪除主表資料時連通一起刪除外來鍵表中資料

• PROTECT 保護，通過丟擲ProtectedError異常，來阻止刪除主表中被外來鍵應用的資料

• SET_NULL 設定為NULL，僅在該欄位null=True允許為null時可用

• SET_DEFAULT 設定為預設值，僅在該欄位設定了預設值時可用

• SET() 設定為特定值或者呼叫特定方法，如

  from django.conf import settings
  from django.contrib.auth import get_user_model
  from django.db import models
  
  def get_sentinel_user():
      return get_user_model().objects.get_or_create(username='deleted')[0]
  
  class MyModel(models.Model):
      user = models.ForeignKey(
          settings.AUTH_USER_MODEL,
          on_delete=models.SET(get_sentinel_user),
      )
  

• DO_NOTHING 不做任何操作，如果資料庫前置指明級聯性，此選項會丟擲IntegrityError異常

2 遷移

將模型類同步到資料庫中。

1）生成遷移檔案

python manage.py makemigrations

2）同步到資料庫中

python manage.py migrate

3 新增測試資料

insert into tb_books(btitle,bpub_date,bread,bcomment,is_delete) values
('射鵰英雄傳','1980-5-1',12,34,0),
('天龍八部','1986-7-24',36,40,0),
('笑傲江湖','1995-12-24',20,80,0),
('雪山飛狐','1987-11-11',58,24,0);

insert into tb_heros(hname,hgender,hbook_id,hcomment,is_delete) values
('郭靖',1,1,'降龍十八掌',0),
('黃蓉',0,1,'打狗棍法',0),
('黃藥師',1,1,'彈指神通',0),
('歐陽鋒',1,1,'蛤蟆功',0),
('梅超風',0,1,'九陰白骨爪',0),
('喬峰',1,2,'降龍十八掌',0),
('段譽',1,2,'六脈神劍',0),
('虛竹',1,2,'天山六陽掌',0),
('王語嫣',0,2,'神仙姐姐',0),
('令狐沖',1,3,'獨孤九劍',0),
('任盈盈',0,3,'彈琴',0),
('嶽不群',1,3,'華山劍法',0),
('東方不敗',0,3,'葵花寶典',0),
('胡斐',1,4,'胡家刀法',0),
('苗若蘭',0,4,'黃衣',0),
('程靈素',0,4,'醫術',0),
('袁紫衣',0,4,'六合拳',0);