6. django 博客首頁視圖

本教程內容已過時,更新版教程請訪問: Django 博客開發入門教程

這是 Django 博客教程的第 6 篇,在閱讀此篇教程以前,請確保你已閱讀 Django 博客教程的前 5 篇:
1. Django 博客教程:前言
2. 搭建開發環境
3. 建立我們的 django 博客應用
4. 創建 django 博客的數據庫模型
5. 讓 django 完成翻譯——遷移數據庫模型

django 是如何處理 http 請求的

Web 應用的交互過程其實就是 http 請求與響應的過程。無論是在 PC 端還是移動端,我們通常使用瀏覽器來上網,我們的上網流程大致來說是這樣的:

  1. 我們打開瀏覽器,在地址欄輸入我們想訪問的網址,比如 www.djangoproject.com(當然你也可能從收藏夾里直接打開網站,但本質上都是一樣的。)
  2. 瀏覽器知道我們想要訪問那個網址后,它在后臺幫我們做了很多事情,主要就是把我們的訪問意圖包裝成一個 http 請求,發給我們想要訪問的網址所對應的服務器。通俗點說就是瀏覽器幫我們通知網站的服務器,說有人來訪問你啦,訪問的請求都寫在 http 里了,你按照要求處理后告訴我,我再幫你回應他!
  3. 網站服務器處理了 http 請求,然后生成一段 http 響應給瀏覽器,瀏覽器解讀這個響應,把相關的內容在瀏覽器里顯示出來,于是我們就看到了網站的內容。比如你訪問了社區主頁 www.pythonzh.cn,服務器接收到這個請求后他就知道用戶訪問的是首頁,首頁顯示的是全部帖子列表,于是它從數據庫里把帖子數據取出來,生成一個寫著這些數據的 html 文檔,包裝到 http 響應里發給瀏覽器,瀏覽器解讀這個響應,把 html 文檔顯示出來,我們就看到了帖子列表的內容。

因此,django 作為一個 web 框架,它的使命就是處理流程中的第二步,接收瀏覽器發來的 http 請求,返回相應的 http 響應。于是引出這么幾個問題:

  1. django 如何接收 http 請求?
  2. django 如何處理這個 http 請求?
  3. django 如何生成 http 響應?

對于如何處理這些問題,django 有其自身的一套規定的機制。我們按照 django 的規定,就能開發出我們所需的功能。我們先以一個最簡單的 hello world 為例來看看 django 處理上述問題的機制是怎么樣的。

首先 django 需要知道當用戶訪問不同的網址時,應該如何處理不同的網址。django 的做法是把不同的網址對應的處理函數寫在一個 urls.py 文件里,當用戶訪問某個網址時,django 就去會這個文件里找,如果找到這個網址,就會調用和它綁定在一起的處理函數(叫做視圖函數),下面是具體的做法,首先在 blog 應用的目錄下創建一個 urls.py 文件,這時你的目錄看起來是這樣:

blog/
    __init__.py
    admin.py
    apps.py
    migrations/
        0001_initial.py
        __init__.py
    models.py
    tests.py
    views.py
    urls.py # 新建的文件

在 urls.py 中寫入這些代碼:

from django.conf.urls import url

from . import views

urlpatterns = [
    url(r'^$', views.index, name='index'),
]

我們首先從 django.conf.urls 導入了 url 函數,又從當前目錄下導入了 views 模塊。然后我們把網址和處理函數的關系寫在了 urlpatterns 列表里。綁定關系的寫法是把網址和對應的處理函數作為參數傳給 url 函數(第一個參數是網址,第二個參數是處理函數),另外我們還傳遞了另外一個參數 name,這個參數的值將作為處理函數 index 的別名,這在以后會用到。

注意這里我們的網址是用正則表達式寫的,django 會用這個正則表達式去匹配用戶實際輸入的網址,如果匹配成功,就會調用其后面的視圖函數做相應的處理。比如說我們本地開發服務器的域名是 127.0.0.1:8000,那么當用戶輸入網址:127.0.0.1:8000 后,django 首先會把域名(即 127.0.0.1)和端口號(8000)去掉,此時只剩下一個空字符串,而 r'^$' 的模式正是匹配一個空字符串(這個正則表達式的意思是以空字符串開頭且以空字符串結尾),于是二者匹配,django 便會調用其對應的 views.index 函數。

第二步就是要實際編寫我們的 views.index 視圖函數了,按照慣例視圖函數定義在 views.py 文件里:

blog/views.py

from django.http import HttpResponse

def index(request):
    return HttpResponse("歡迎訪問我的博客首頁!")

我們前面說過,Web 服務器的作用就是接收來自用戶的 http 請求,根據請求內容作出相應的處理,并把處理結果包裝成 http 響應返回給用戶。這個兩行的函數體現了這個過程。它首先接受了一個名為 request 的參數,這個 request 就是 django 為我們封裝好的 http 請求,它是類 HttpResponse 的一個實例。然后我們便直接返回了一個 http 響應給用戶,這個 http 響應也是 django 幫我們封裝好的,它是類 HttpResponse 的一個實例,只是我們給它傳了一個自定義的字符串,用戶接受到這個響應后就會在瀏覽器顯示出我們傳遞的內容:“歡迎訪問我的博客首頁!”

還差最后一步了,我們前面建立了一個 urls.py 文件,并且綁定了 URL 和視圖函數 index,但是 django 并不知道。django 匹配 url 是在 blogproject 的 urls.py 下的,所以我們要把我們自己寫的 urls.py 文件包含到這個文件里去,打開這個文件看到如下內容:

"""
一大段注釋
"""

from django.conf.urls import url
from django.contrib import admin

urlpatterns = [
    url(r'^admin/', admin.site.urls),
]

修改成如下的形式:

- from django.conf.urls import url
+ from django.conf.urls import url, include
from django.contrib import admin

urlpatterns = [
    url(r'^admin/', admin.site.urls),
+   url(r'', include('blog.urls')),
]

這里 - 表示刪掉這一行,+ 表示添加這一行。我們這里導入了一個 include 函數,然后利用這個函數把 blog 應用下的 urls.py 包含了進來。此外 include 前還有一個 r'',這是一個空字符串,這里也可以寫其他字符串,django 會把這個字符串和后面 include 的 urls.py 文件中的 url 拼接。假如我們這里把 r'' 改成 r'blog/',而我們在 blog.urls 中寫的url 是 r'^$',一個空字符串,那么 django 最終匹配的就是 blog/ 加上一個空字符串,即 blog/。

運行 python manage.py runserver 打開開發服務器,在瀏覽器輸入開發服務器的地址 http://127.0.0.1:8000/,可以看到我們返回的內容了:歡迎訪問我的博客首頁!

這基本上就上 django 的開發流程了,寫好處理 http 請求和返回 http 響應的視圖函數,然后把視圖函數綁定到相應的 URL 上。但是等一等!我們看到在我們的視圖函數里返回的是一個 HttpResponse 類的實例,我們給他傳入了一個我們希望顯示在用戶瀏覽器上的字符串。但是我們的博客不可能只顯示這么一句話,它有可能會顯示很長很長的內容,比如我們發布的博客文章列表,或者一大段的博客文章,我們不能每次都把這些大段大段的內容傳給 HttpResponse 。于是 django 對這個問題給我們提供了一個好的方法,叫做模板系統。django 要我們把大段的文本寫到一個文件里,然后 django 自己會去讀取這個文件,django 再把讀取到的內容傳給 HttpResponse。我們用模板系統來改造一下上面的例子。首先在我們的項目根目錄下建立一個名為 templates 的文件夾,用來存放我們的模板。然后再建立一個名為 blog 的文件夾,用來存放和 blog 應用相關的模板。當然模板存放在哪里是無關緊要的,只要 django 能夠找到的就好。但是我們建立這樣的文件夾結構的目的是把不同應用用到的模板隔離開來,這樣方便以后維護,養成良好的習慣。然后我們在 blog 目錄下建立一個名為 index.html 的文件,寫上下面的代碼:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{{ title }}</title>
</head>
<body>
<h1>{{ welcome }}</h1>
</body>
</html>

這是一個標準的 html 文檔了,只是里面有兩個比較奇怪的地方:{{ title }},{{ welcome }},這是 django 規定的語法。用 {{ }} 包起來的叫做模板變量。django 在讀取這個模板的時候回根據我們傳來值替換這些變量。最終在模板中顯示的將會是我們傳遞的值。

模板寫好了,還得告訴 django 去哪里找模板,在 settings.py 文件里設置一下模板文件所在的路徑。在 settings.py 找到 TEMPLATES 選項,它的內容是這樣的:

blogproject/settings.py

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

其中 DIRS 就是設置模板的路徑,在 [] 中寫入 os.path.join(BASE_DIR, 'templates'),變成這樣:

blogproject/settings.py

TEMPLATES = [
    {
        ...
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        ...
    },
]

這里 BASE_DIR 是 settings.py 前面定義的變量,記錄的是工程根目錄 blogproject 的值,在這個目錄下有我們的模板目錄 templates,于是利用os.path.join 把這兩個路徑連起來,構成完整的模板路徑,django 就知道去這個路徑下面找我們的模板了。

視圖函數可以改一下了:

blog/views.py

from django.http import HttpResponse
from django.shortcuts import render

def index(request):
    return render(request, 'blog/index.html', context={
                      'title': '我的博客首頁', 
                      'welcome': '歡迎訪問我的博客首頁'
                  })

這里我們在是直接把字符串傳給 HttpResponse 了,而是調用 django 提供了 render 函數,這個函數根據我們傳入的參數來構造 HttpResponse。我們首先把 http 請求傳了進去,然后它根據第二個參數的值 blog/index.html 找到我們的模板,然后讀取模板中的內容,并且根據我們傳入的 context 把模板中的變量替換為我們傳遞的值,{{ title }} 被替換成了 context 字典中 title 對應的值,同理 {{ welcome }} 也被替換成相應的值。最終,我們的 html 模板中的內容字符串被傳遞給 HttpResponse 對象并返回給瀏覽器,這樣用戶的瀏覽器上便顯示出了我們寫的 html 模板的內容。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,578評論 6 544
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,701評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,691評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,974評論 1 318
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,694評論 6 413
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 56,026評論 1 329
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 44,015評論 3 450
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,193評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,719評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,442評論 3 360
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,668評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,151評論 5 365
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,846評論 3 351
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,255評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,592評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,394評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,635評論 2 380

推薦閱讀更多精彩內容