• 每個model都是繼承自django.db.models.Model的子類
• 每個model都映射一個數據表
• model中的每個類屬性對應著數據表中的一列
• django支持ORM

• Django會自動生成表名（可以自定義）
• Django會自動增加主鍵一列（可以自定義）
• Django會根據不同數據庫創建不同的SQL語句

• null：允許該列數據為空（默認為False）
• blank：主要用于是否允許表單為空（默認為False）
• choices：為一個Field提供可選項（并且默認生成的表單為一個選項）

  from django.db import models
  
  class Person(models.Model):
      # choices的對象是一個可迭代對象，其元素為‘含有兩個元素的元組’
      SHIRT_SIZES = (
          ('S', 'Small'),
          ('M', 'Medium'),
          ('L', 'Large'),
      )
      name = models.CharField(max_length=60)
      shirt_size = models.CharField(max_length=1, choices=SHIRT_SIZES)
    
  # choice API
  >>> p = Person(name="Fred Flintstone", shirt_size="L")
  >>> p.save()
  >>> p.shirt_size
  'L'
  >>> p.get_shirt_size_display()   # get_FOO_display()方法可以顯示具體內容
  'Large'
  

• default：既可以是一個數值對象，也可以是一個可調用對象
• help_text：在生成的表單中展示‘幫助’信息
• primary_key：將某一列設置為主鍵（該列變為只讀）；默認為False，即Django會自動創建一個整型主鍵
• unique：該列中的每個數據必須獨一無二（默認為False）

id = models.AutoField(primary_key=True)

# 列名為"person's first name"
first_name = models.CharField("person's first name", max_length=30)

# 列名為"first_name"
first_name = models.CharField(max_length=30)

# 關聯表為"Poll"
poll = models.ForeignKey(
    Poll,
    on_delete=models.CASCADE,
    verbose_name="the related poll",
)

• Many-to-one 關聯
  使用django.db.models.ForeignKey，第一個位置參數需要指定關聯表名
• Many-to-many 關聯
  使用django.db.models.ManyToManyField（相關的兩個表中，只需要在一個表中指定即可）
  可以顯式的創建many-to-many的關聯數據表

  from django.db import models
  
  class Person(models.Model):
      name = models.CharField(max_length=128)
  
      def __str__(self):              # __unicode__ on Python 2
          return self.name
  
  class Group(models.Model):
      name = models.CharField(max_length=128)
      # 通過through指定關聯表
      members = models.ManyToManyField(Person, through='Membership')
  
      def __str__(self):              # __unicode__ on Python 2
          return self.name
  
  class Membership(models.Model):
      person = models.ForeignKey(Person, on_delete=models.CASCADE)
      group = models.ForeignKey(Group, on_delete=models.CASCADE)
      date_joined = models.DateField()
      invite_reason = models.CharField(max_length=64)
  

• One-to-one 關聯
  使用django.db.models.OneToOneField，可以用于擴展某一model

from django.db import models

class Ox(models.Model):
    horn_length = models.IntegerField()
    
    # class Meta 是可選項
    class Meta:
        ordering = ["horn_length"]
        verbose_name_plural = "oxen"

• __ str__()
• get_absolute_url()
  該方法告訴Django如何得到一個對象的URL（一般使用django的reverse()函數）

  def get_absolute_url(self):
      from django.urls import reverse
      return reverse('people.views.details', args=[str(self.id)])
  

from django.db import models

class Blog(models.Model):
    name = models.CharField(max_length=100)
    tagline = models.TextField()

    def save(self, *args, **kwargs):
        do_something()
        # 關鍵在于對Model.save()方法的繼承上，另外通過使用(*args, **kwargs)參數可以自動獲取相關參數
        super(Blog, self).save(*args, **kwargs) # Call the "real" save() method.
        do_something_else()

• Abstract base classes
• Multitable inheritance
• Proxy models

from django.db import models

class CommonInfo(models.Model):
    name = models.CharField(max_length=100)
    age = models.PositiveIntegerField()
    
    # 將CommonInfo聲明為一個abc類
    class Meta:
        abstract = True
        ordering = ['name']

class Student(CommonInfo):
    # Student 類自動繼承name和age列
    home_group = models.CharField(max_length=5)

    class Meta: 
        # Student 類會繼承CommonInfo中的Meta的信息
        # 不過在此之前會自動設置abstract=False（當然也可以自己顯式地設置abstract=True從而成為abc類）
        db_table = 'student_info'

# common/models.py
from django.db import models

class Base(models.Model):
    m2m = models.ManyToManyField(
        OtherModel,
        # 若不設置related_name，則默認為"子類名 + '_set'"
        # %(app_label)s 指代當前應用名稱
        # %(class)s 指代當前類的類名
        related_name="%(app_label)s_%(class)s_related",
        related_query_name="%(app_label)s_%(class)ss",
    )

    class Meta:
        abstract = True

# OtherModel 使用 ChildA 類時的屬性名將是'common_childa_related'
class ChildA(Base):
    pass

class ChildB(Base):
    pass

from django.db import models

class Person(models.Model):
    first_name = models.CharField(max_length=30)
    last_name = models.CharField(max_length=30)

class MyPerson(Person):
    class Meta:
        # 指定該類為Person的代理數據模型
        proxy = True
        # 在該proxy model中可以增加一個額外的Meta屬性
        odering = ['last_name']

    # 在該proxy model中可以增加一些額外的方法
    def do_something(self):
        # ...
        pass

# 需要注意的一點是Person和MyPerson類都可以調用Person數據表中的數據
# 不同之處在于通過Person類創建/查找到的實例中沒有ordering屬性，也不能調用do_something方法