使用Django開發Web應用的過程中,很多人都是急急忙忙地寫視圖,寫前端頁面,把最根本的模型設計給忽略了。
模型中定義了數據如何在數據庫內保存,再直白點說就是數據表的定義。這部分工作體現在Django的代碼中,其實就是model類的設計。
一、 數據庫模型設計
作為一個用戶登錄和注冊項目,需要保存的都是各種用戶的相關信息。很顯然,我們至少需要一張用戶表User,在用戶表里需要保存下面的信息:
- 用戶名
- 密碼
- 郵箱地址
- 性別
- 創建時間
進入login/models.py
文件,這里將是我們整個login應用中所有模型的存放地點,代碼如下:
from django.db import models # Create your models here. class User(models.Model): gender = ( ('male', "男"), ('female', "女"), ) name = models.CharField(max_length=128, unique=True) password = models.CharField(max_length=256) email = models.EmailField(unique=True) sex = models.CharField(max_length=32, choices=gender, default="男") c_time = models.DateTimeField(auto_now_add=True) def __str__(self): return self.name class Meta: ordering = ["-c_time"] verbose_name = "用戶" verbose_name_plural = "用戶"
各字段含義:
- name必填,最長不超過128個字符,並且唯一,也就是不能有相同姓名;
- password必填,最長不超過256個字符(實際可能不需要這么長);
- email使用Django內置的郵箱類型,並且唯一;
- 性別使用了一個choice,只能選擇男或者女,默認為男;
- 使用
__str__
幫助人性化顯示對象信息; - 元數據里定義用戶按創建時間的反序排列,也就是最近的最先顯示;
注意:這里的用戶名指的是網絡上注冊的用戶名,不要等同於現實中的真實姓名,所以采用了唯一機制。如果是現實中可以重復的人名,那肯定是不能設置unique的。另外關於密碼,建議至少128位長度,原因后面解釋。
二、 設置數據庫后端
定義好了模型后,就必須選擇我們用來保存數據的數據庫系統。Django支持Mysql,SQLite,Oracle等等。
Django中對數據庫的設置在settings文件中,如下部分:
Django默認使用SQLite數據庫,並內置數據庫訪問API,也就是說和Python一樣原生支持SQLite。
本項目使用SQLite作為后端數據庫,因此不需要修改settings中這部分內容。如果你想要使用別的數據庫,請自行修改該部分設置。
三、注冊app
每次創建了新的app后,都需要在全局settings中注冊,這樣Django才知道你有新的應用上線了。
在settings的下面部分添加‘login’,建議在最后添加個逗號。
INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'login', ]
四、創建記錄和數據表
app中的models建立好了后,並不會自動地在數據庫中生成相應的數據表,需要你手動創建。
進入Pycharm的terminal終端,激活虛擬環境,執行下面的命令:
python manage.py makemigrations
Django自動為我們創建了login\migrations\0001_initial.py
文件,保存了我們的第一次數據遷移工作,也就是創建了User模型。
接着執行下面的命令:
python manage.py migrate
測試一下數據庫連接,此時可能需要安裝驅動,這時候查看數據庫已經生成了login_user表
Django將在數據庫內創建真實的數據表。如果是第一次執行該命令,那么一些內置的框架,比如auth、session等的數據表也將被一同創建
五、在admin中注冊模型
admin后台本質上是Django給我們提供的一個app,默認情況下,它已經在settings中注冊了,如下所示的第一行!
同樣的還有session會話框架,后面我們會使用的。
INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'login', ]
進入login/admin.py
文件,代碼如下:
from django.contrib import admin # Register your models here. from . import models admin.site.register(models.User)
暫時簡單點,直接注冊就好了。
六、創建超級管理員
Django的admin后台擁有完整的較為安全的用戶認證和授權機制,防護等級還算可以。
要進入該后台,需要創建超級管理員,該管理員和我們先前創建的User用戶不是一個概念,要注意區別對待。
同樣在Pycharm的終端中,執行下面的命令:
python manage.py createsuperuser
用戶名、郵箱和密碼請自行設定,但一定不要忘記。(郵箱是非必填項,密碼需要一定強度,否則通過不了。)
七、啟動開發服務器
創建好超級管理員后,就可以啟動我們的開發服務器了,然后在瀏覽器中訪問http://127.0.0.1:8000/admin/
地址,可以看到如下的登錄界面:
輸入我們先前創建的超級管理員賬戶,進入管理界面:
注意,圖中下方的認證和授權
是admin應用自身的賬戶管理,上面的LOGIN欄目才是我們自己創建的login應用所對應的User模型。
點擊Login欄目中的用戶鏈接,進入用戶列表界面,發現是空的,因為我們當前沒有任何用戶。點擊右上方的增加用戶按鈕,我們創建幾個測試用戶試試:
通過輸入不同的數據,我們看到Email會有地址合法性檢查,性別有個選擇框,非常的人性化。
八、 路由設計
考慮到登錄系統屬於站點的一級功能,為了直觀和更易於接受,這里沒有采用二級路由的方式,而是在根路由下直接編寫路由條目,同樣也沒有使用反向解析名(name參數)。根據上面的策划,打開mysite/urls.py
文件,寫入下面的代碼:
from django.conf.urls import url from django.contrib import admin from login import views urlpatterns = [ url(r'^admin/', admin.site.urls), url(r'^index/', views.index), url(r'^login/', views.login), url(r'^register/', views.register), url(r'^logout/', views.logout), ]
注意要先從login導入views模塊。
九、架構初步視圖
路由寫好了,就進入login/views.py
文件編寫視圖的框架,代碼如下:
from django.shortcuts import render from django.shortcuts import redirect # Create your views here. def index(request): pass return render(request, 'login/index.html') def login(request): pass return render(request, 'login/login.html') def register(request): pass return render(request, 'login/register.html') def logout(request): pass return redirect("/index/")
我們先不着急完成視圖內部的具體細節,而是把框架先搭建起來。
注意:
- 在頂部額外導入了
redirect
,用於logout后,頁面重定向到‘index’首頁; - 四個視圖都返回一個render()調用,render方法接收request作為第一個參數,要渲染的頁面為第二個參數,以及需要傳遞給頁面的數據字典作為第三個參數(可以為空),表示根據請求的部分,以渲染的HTML頁面為主體,使用模板語言將數據字典填入,然后返回給用戶的瀏覽器。
- 渲染的對象為login目錄下的html文件,這是一種安全可靠的文件組織方式。
十、創建HTML頁面文件
在項目根路徑的login目錄中創建一個templates目錄,再在templates目錄里創建一個login目錄。這么做有助於app復用,防止命名沖突,能更有效地組織大型工程。
在login/templates/login
目錄中創建三個文件index.html
、login.html
以及register.html
,並寫入如下的代碼:
index.html
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>首頁</title> </head> <body> <h1>首頁!</h1> </body> </html>
login.html
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>登錄</title> </head> <body> <h1>登錄頁面</h1> </body> </html>
register.html
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>注冊</title> </head> <body> <h1>注冊頁面</h1> </body> </html>
十一、測試路由和視圖
啟動服務器,在瀏覽器訪問http://127.0.0.1:8000/index/
等頁面,如果能正常顯示,說明一切OK