摘要：當然還有其他高級的使用，日后再說完整的用戶名郵箱聯系地址留言信息用戶留言信息使用之前已經定義好了數據模型的字段元數據方法等。

接續前文，上一篇文章主要涉及了 Django 項目的基礎配置等，這篇主要涉及數據庫相關的 ORM ，也就是 Django 中的 Model 的使用，MVT 三層之間的交互

教程基本都是東拼西湊的，防止有些東西表述不準確，因為我之前寫 JavaScript 比較多。但是里邊注入了自己的理解，盡量講清楚。

Pycharm 2018

Django 2.0.3

Python 3.6.4

mxonline start 分支

代替使用原生的 SQL 語句操作數據庫。

# {BASE_DIR}/apps/message/models.py
import MySQLdb
def book_list(request):
    db = MySQLdb.connect(user="me", db="mydb", password="secret", host="localhost")
    cursor = db.cursor()
    cursor.execute("SELECT name FORM books ORDER BY name")
    names = [row[0] for row in cursor.fetchall()]
    db.close()

具體的一些細節知識下面會進行敘述。這里只是展示一下如何配置。

# {BASE_DIR}/apps/message/models.py

# 從 Django 中引入 models
from django.db import models


# Create your models here.
class UserMessage(models.Model):
    name = models.CharField(max_length=20, verbose_name=u"用戶名")
    email = models.EmailField(verbose_name=u"郵箱")
    address = models.CharField(max_length=100, verbose_name=u"聯系地址")
    message = models.CharField(max_length=500, verbose_name=u"留言信息")

    class Meta:
        verbose_name = u"用戶留言信息"
        verbose_name_plural = verbose_name

model 創建完成，接下來是生成數據表。

$ python manage.py makemigrations message
$ python manage.py migrate message

然后查看數據庫是不是生成了表。

之前有十個表，分別是:

+----------------------------+
| Tables_in_test_django      |
+----------------------------+
| auth_group                 |
| auth_group_permissions     |
| auth_permission            |
| auth_user                  |
| auth_user_groups           |
| auth_user_user_permissions |
| django_admin_log           |
| django_content_type        |
| django_migrations          |
| django_session             |
+----------------------------+
10 rows in set (0.00 sec)

現在：

+----------------------------+
| Tables_in_test_django      |
+----------------------------+
| auth_group                 |
| auth_group_permissions     |
| auth_permission            |
| auth_user                  |
| auth_user_groups           |
| auth_user_user_permissions |
| django_admin_log           |
| django_content_type        |
| django_migrations          |
| django_session             |
| message_usermessage        |
+----------------------------+
11 rows in set (0.00 sec)

mysql> desc message_usermessage;
+---------+--------------+------+-----+---------+----------------+
| Field   | Type         | Null | Key | Default | Extra          |
+---------+--------------+------+-----+---------+----------------+
| id      | int(11)      | NO   | PRI | NULL    | auto_increment |
| name    | varchar(20)  | NO   |     | NULL    |                |
| email   | varchar(254) | NO   |     | NULL    |                |
| address | varchar(100) | NO   |     | NULL    |                |
| message | varchar(500) | NO   |     | NULL    |                |
+---------+--------------+------+-----+---------+----------------+
5 rows in set (0.04 sec)

對應上面 Model 中的字段，完美~

ChartField 必須指定 max_length。

稍候會有完整的 Model 例子。

每一個模型都可以包含有任意數量的字段，每個字段都會對應數據表中的一個字段，我們需要指定字段的屬性。

name = models.CharField(max_length=20, verbose_name=u"用戶名")

上述字段的名稱是 name，類型是 models.CharField。對應到 MySQL 數據中是 varchar 類型。varchar 類型的字段都是需要去指定一個長度值，對應到 Django 的 ORM 模型上就是 max_length 屬性。

下面列舉一下目前筆者在開發中用到的一些字段：

max_length：指定字段的長度值，接受一個數字，CharField 必須指定最大長度， TextField 不需要。

verbose_name：字段標簽的可讀名稱，接受一個字符串。如果不指定，Django 會從字段名稱去推斷默認的詳細名稱，建議每一個字段都進行指定。

default：字段默認值。

null：是否可以為 null，接受 True 或者 False。

blank： 是否可以為空，同樣接受 True 或者 False。

primary_key：如果設置為 Ture，則該字段置為模型主鍵，如果模型中沒有指定主鍵，則 Django 會自動為模型添加一個主鍵，默認為 id。

help_text：為 HTML 表單文本提供單文本標簽。

choices：一組字段選項，提供這一項的時候，默認對應的表單不見是選擇字段的盒子，而不是標準文本字段。

CharField：用來定義短到中等長度的字段字符串，必須指定 max_length 屬性。

TextField：用于大型的任意長度字符串，不強制要求指定 max_length 屬性，指定的 max_length 僅僅當該字段以表單顯示才會使用，不會再數據庫級別進行強制執行。

IntegerField：用于存儲整形數據，在用于表單中驗證輸入的值需要時整數。

FloatField：用于存儲浮點型數據

DateField 和 DateTimeField：用于存儲／表示日期和日期／時間信息（分別是Python.datetime.date和datetime.datetime對象。這些字段可以另外表明（互斥）參數auto_now=Ture （在每次保存模型時將該字段設置為當前日期），auto_now_add（僅設置模型首次創建時的日期）和default（設置默認日期，可以被用戶覆蓋）。一般筆者選擇的默認日期是 datetime.now。

EmailField：用來存儲和驗證電子郵件地址。

FileField：用于上傳文件，需要提供 upload_to 指定上傳到的地方。

ImageField：和上傳文件表現基本相似，會額外進行是否為圖像的驗證。

AutoField：是一種 IntegerField 自增的特殊類型，如果模型沒有指定主鍵的話，此類型的主鍵將自動添加到模型中。

ForeignKey：外鍵，用于指定與另一個數據庫模型的一對多關系。關系 “一” 側是包含密鑰的模型。和 flask 指定外鍵的方式不同。

ManyToManyField：用于指定多對多關系，例如，一本書可以有幾種類型，每種類型可以包含幾本書）。在我們的圖書館應用程序中，我們將非常類似地使用它們ForeignKeys，但是可以用更復雜的方式來描述組之間的關系。這些具有參數on_delete來定義關聯記錄被刪除時會發生什么（例如，值models.SET_NULL將簡單地設置為值NULL）。筆者用的不是很多。

通過聲明 class Meta 來聲明模型級別的元數據

class UserMessage(models.Model):
    # Config Field
        
    class Meta:
        ordering = ["id"]
       verbose_name = u"用戶留言信息"
       verbose_name_plural = verbose_name

這里最有用的功能是可以指定模型返回數據時候的默認的順序，更多的文檔可以查看這里

一個模型也可以有方法，最基本的使用就是定義一個標準的 Python 類方法： __str__：

class UserMessage(models.Model):
    # Config Field
    
    # Config Meta
    
    def __str__(self):
       return self.message    

這樣為每個對象返回一個人類可讀的字符串。當然還有其他高級的使用，日后再說

# {BASE_DIR/apps/message/models.py}

from django.db import models


# Create your models here.
class UserMessage(models.Model):
    name = models.CharField(max_length=20, verbose_name=u"用戶名")
    email = models.EmailField(verbose_name=u"郵箱")
    address = models.CharField(max_length=100, verbose_name=u"聯系地址")
    message = models.CharField(max_length=500, verbose_name=u"留言信息")

    class Meta:
        ordering = ["id"]
        verbose_name = u"用戶留言信息"
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.message

之前已經定義好了數據模型的字段（Field）、元數據（Meta）、方法（Method）等。現在要做的是把頁面上提交過來的數據通過 ORM 來存放到數據庫中，通過 ORM 來進行數據的 CURD 操作。

在 templates 中已經創建了 message_form.html 模板文件，現在進行修改，修改 form 的 action 目標地址：

這里根據自己配置的 Url 來自行決定，由于筆者配置的是 /，所以這里就配置成這個樣子。

這里指定的是使用 form 的原生事件 post 事件進行提交，但是在實際的開發中，為了實現更精確的控制，我們常常不會使用原生事件，而更傾向于使用 ajax 進行提交，當然這里的重點不是前端的邏輯，重點在于 Django 后端邏輯的處理，顧不贅述。

接下來的任務就是：拿到 POST 發來的數據，然后存入數據庫中。

之前使用 Django 的 ORM 進行了數據庫中數據表的配置，現在使用 Django 的 ORM 將數據保存到數據庫中。

在 Django 中，我們使用不是傳統的 MVC 架構，我們使用的是一種叫 MVT 的方式。不同的 Template（模板） 呈現不同的 View。我們將在 View（請求視層）中獲取用戶提交的數據，以及將從 Model（數據層） 中獲得的數據傳遞給 Template(模板層)。

MVT 的概念本身就來自于 Django 框架，下面進行代碼的展示：

# {BASE_DIR/apps/message/views.py}
from django.shortcuts import render  # 引入 render 方法
from .models import UserMessage      # 引入之前配置好的 Model


# Create your views here.

def get_form(request):
    if request.method == "POST":
        name = request.POST.get("name", "")
        message = request.POST.get("name", "")
        address = request.POST.get("address", "")
        email = request.POST.get("email", "")
        user_message = UserMessage()
        user_message.name = name
        user_message.message = message
        user_message.address = address
        user_message.email = email
        user_message.save()
    return render(request, "message_form.html")

通過 POST 方法提交的數據會存儲到 request 對象的 POST 屬性下邊，通過 Django 提供的 get 方法就可以取到對應的字段。其中 get 接收兩個參數，分別是字段的名稱和默認值。

在取到 Template 提交過來的每一個字段之后，就可以使用 ORM 提供的方法將其存入數據庫中。

實例化引入的 Model，然后將之前定義的字段進行賦值，然后就可以調用實例的 save() 方法將數據存入數據庫。

然后就可以通過 Navicat 或者終端等方式查看數據是否保存到了數據庫中。

之前已經實現了數據的存儲，這部分將實現數據的讀取功能。

# {BASE_DIR/apps/message/views.py}
from django.shortcuts import render
from .models import UserMessage


# Create your views here.

def get_form(request):
    message = None
    all_message = UserMessage.objects.filter(name="test")
    if all_message:
        message = all_message[0]
    return render(request, "message_form.html", {"my_message": message})

這里會涉及到 Django 的 QuerySets（查詢集）相關知識，這里撿著用的著的部分看一下。

首先先聲明 message，值為 None，用于存儲取到的數據。

從本質上講，QuerySets 是給定對象模型（這里是 UserModel）的對象列表（list），允許我們從數據庫中讀取數據，選擇以及排序。通過這種方式操作的話，就可以避免直接操作數據庫。從而抹平不同數據庫操作的差異，這部分由 Django 幫我們來完成。

上面的代碼中有這樣的一句：

UserMessage.objects.filter(name="test")

作用是從數據庫中查找 name 值為 test 的所有條目，返回的是一個 列表，并賦值給 all_message。同時我們也可以發現，QuerySet 可以鏈式調用。類似于 JavaScript 中的 Promise。

然后如果 all_message 不為空的話，取出列表第一項，然后傳遞給 my_message 模板。

關于 QuerySet 的詳細知識，可以查看 Django 的官方文檔的這一部分

在上面步驟中，我們將符合預設條件的數據從數據庫中取出來，傳遞到模板中，這里的目標是將數據正確的顯示與渲染。部分語法類似于 ejs 模板的語法，但同時 Django 又在模板中內置了很多常用的函數。但是 Django 不像 Java 那樣，允許在模板中寫一些 Java 代碼，Django 的 Template 中不允許將 Python 代碼混進來。

由于模板代碼過長，這里只放一些關鍵部分的代碼，完整的代碼可以查看文章對應的代碼倉庫。

    
        姓名 :
        
    
    
        留言 :
        {{ my_message.message }}
    
    {% csrf_token %}

在上一篇文章中，提到過，path 接收 name 參數。在 template 中可以通過 name 來取到對應的 url，方法如下：

action="{% url "go_form" %}"

這樣做提供了另一種獲取 url 的方式，當我們因為某種原因去修改了 url 地址之后，通過 name 還能找到它。

在 textarea 中，有這樣一段代碼：

{{ my_message.message }}

作用是取到傳入的 my_message 對象的 message 屬性取出來并顯示，由于 html 基本屬于前端部分了，所以用前端的方式進行描述。

雙花括號（八字胡）語法： {{...}} 在任何模板語言中都很常見，作用是將數據渲染到雙括號內部。

上面還有一部分代碼是這樣子的：

{% if my_message.name == "test" %}test{% endif %}"

意思很好懂的，是吧。

具體的 Django 中模板的語法可以查看官方文檔。

這里只是簡單的介紹了一下 Django 中 Model 層、View 層、以及 Template 層之間交互的部分知識，很簡略，不詳細。在每部分的后邊都附加了詳細的官方文檔地址。如果以后有時間了可以對每部分進行詳細的闡述。

Python升級3.6 強力Django+殺手級Xadmin打造在線教育平臺

MDN 的 Django教程 ———— 設計LocalLibrary模型

Django 官方文檔 Model 部分

Django Girls 教程