Django - 模型

模型是一個類，它代表資料庫中的表或集合，其中類的每個屬性都是表或集合的欄位。模型定義在 app/models.py 中（在我們的例子中：myapp/models.py）

建立模型

以下是一個名為 Dreamreal 的示例模型：

from django.db import models

class Dreamreal(models.Model):

   website = models.CharField(max_length = 50)
   mail = models.CharField(max_length = 50)
   name = models.CharField(max_length = 50)
   phonenumber = models.IntegerField()

   class Meta:
      db_table = "dreamreal"

每個模型都繼承自 django.db.models.Model。

我們的類有 4 個屬性（3 個 CharField 和 1 個 Integer），它們將成為表的欄位。

帶有 db_table 屬性的 Meta 類允許我們定義實際的表或集合名稱。Django 會自動命名錶或集合：myapp_modelName。這個類允許你強制將表名設定為你想要的名稱。

建立模型後，你需要 Django 來生成實際的資料庫：

$python manage.py syncdb

資料操作 (CRUD)

讓我們建立一個名為 "crudops" 的檢視來了解如何對模型執行 CRUD 操作。我們的 myapp/views.py 將如下所示：

myapp/views.py

from myapp.models import Dreamreal
from django.http import HttpResponse

def crudops(request):
   #Creating an entry
   
   dreamreal = Dreamreal(
      website = "www.polo.com", mail = "sorex@polo.com", 
      name = "sorex", phonenumber = "002376970"
   )
   
   dreamreal.save()
   
   #Read ALL entries
   objects = Dreamreal.objects.all()
   res ='Printing all Dreamreal entries in the DB : <br>'
   
   for elt in objects:
      res += elt.name+"<br>"
   
   #Read a specific entry:
   sorex = Dreamreal.objects.get(name = "sorex")
   res += 'Printing One entry <br>'
   res += sorex.name
   
   #Delete an entry
   res += '<br> Deleting an entry <br>'
   sorex.delete()
   
   #Update
   dreamreal = Dreamreal(
      website = "www.polo.com", mail = "sorex@polo.com", 
      name = "sorex", phonenumber = "002376970"
   )
   
   dreamreal.save()
   res += 'Updating entry<br>'
   
   dreamreal = Dreamreal.objects.get(name = 'sorex')
   dreamreal.name = 'thierry'
   dreamreal.save()
   
   return HttpResponse(res)

其他資料操作

讓我們探索一下我們可以在模型上執行的其他操作。請注意，CRUD 操作是在模型的例項上執行的，現在我們將直接使用表示模型的類。

讓我們在 **myapp/views.py** 中建立一個 'datamanipulation' 檢視

from myapp.models import Dreamreal
from django.http import HttpResponse

def datamanipulation(request):
   res = ''
   
   #Filtering data:
   qs = Dreamreal.objects.filter(name = "paul")
   res += "Found : %s results<br>"%len(qs)
   
   #Ordering results
   qs = Dreamreal.objects.order_by("name")
   
   for elt in qs:
      res += elt.name + '<br>'
   
   return HttpResponse(res)

模型關聯

Django ORM 提供了三種關聯模型的方式：

我們將在這裡看到的第一個例子是一對多關係。正如你在上面的例子中看到的，Dreamreal 公司可以有多個線上網站。透過使用 django.db.models.ForeignKey 來定義這種關係：

myapp/models.py

from django.db import models

class Dreamreal(models.Model):
   website = models.CharField(max_length = 50)
   mail = models.CharField(max_length = 50)
   name = models.CharField(max_length = 50)
   phonenumber = models.IntegerField()
   online = models.ForeignKey('Online', default = 1)
   
   class Meta:
      db_table = "dreamreal"

class Online(models.Model):
      domain = models.CharField(max_length = 30)
   
   class Meta:
      db_table = "online"

正如你在更新後的 myapp/models.py 中看到的，我們添加了 online 模型並將其與 Dreamreal 模型關聯。

讓我們透過 manage.py shell 檢查這一切是如何工作的：

首先，讓我們在 Django shell 中建立一些公司（Dreamreal 條目）進行測試：

$python manage.py shell

>>> from myapp.models import Dreamreal, Online
>>> dr1 = Dreamreal()
>>> dr1.website = 'company1.com'
>>> dr1.name = 'company1'
>>> dr1.mail = 'contact@company1'
>>> dr1.phonenumber = '12345'
>>> dr1.save()
>>> dr2 = Dreamreal()
>>> dr1.website = 'company2.com'
>>> dr2.website = 'company2.com'
>>> dr2.name = 'company2'
>>> dr2.mail = 'contact@company2'
>>> dr2.phonenumber = '56789'
>>> dr2.save()

現在是一些託管域名：

>>> on1 = Online()
>>> on1.company = dr1
>>> on1.domain = "site1.com"
>>> on2 = Online()
>>> on2.company = dr1
>>> on2.domain = "site2.com"
>>> on3 = Online()
>>> on3.domain = "site3.com"
>>> dr2 = Dreamreal.objects.all()[2]
>>> on3.company = dr2
>>> on1.save()
>>> on2.save()
>>> on3.save()

從線上域名訪問託管公司（Dreamreal 條目）的屬性很簡單：

>>> on1.company.name

如果我們想知道 Dreamreal 中所有由公司託管的線上域名，我們將使用以下程式碼：

>>> dr1.online_set.all()

要獲取 QuerySet，請注意我們之前看到的所有操作方法（filter、all、exclude、order_by……）

你也可以訪問連結模型的屬性進行過濾操作，例如，你想獲取所有 Dreamreal 名稱包含 'company' 的線上域名：

>>> Online.objects.filter(company__name__contains = 'company'

**注意** - 此類查詢僅支援 SQL 資料庫。它不適用於不存在連線且有兩個 '_' 的非關係型資料庫。

但這並不是關聯模型的唯一方法，你還可以使用 OneToOneField，這是一種保證兩個物件之間關係唯一的關聯。如果我們在上面的例子中使用 OneToOneField，這意味著每個 Dreamreal 條目只有一個 Online 條目，反之亦然。

最後一個是 ManyToManyField，用於表之間的 (n-n) 關係。請注意，這些與基於 SQL 的資料庫相關。

列印頁面