一個視圖函數(類),簡稱視圖,是一個簡單的Python函數(類),它接受web請求並返回web響應。html
響應能夠是一張網頁的HTML內容,一個重定向,一個404錯誤,一個XML文檔,或者一張圖片。web
不管視圖自己包含什麼邏輯,都要返回響應。代碼寫在哪裏也無所謂,只要它在你當前項目目錄下面。除此以外就沒有更多的要求可——能夠說是沒有什麼神奇的地方。爲了將代碼放在某處,你們約定成俗的將視圖放置在項目(project)或應用程序(app)目錄中的名爲views.py 的文件中。ajax
1、一個簡單的視圖django
下面是一個以HTML文檔的形式返回當前日期和時間的視圖:json
from django.http import HttpResponse import datetime def current_datetime(request): now = dtaetime.datetime.now() html = "<html><body>It is now %s.</body></html>" % now return HttpResponse(html)
讓咱們來逐行解釋下上面的代碼:瀏覽器
注意:視圖函數的名稱並不重要;不須要用一個統一的命名方式來命名,以便讓Django來識別它。咱們將其命名爲current_datetime,是由於這個名稱可以比較準確地反映出它實現的功能。緩存
Django使用請求和響應對象來經過系統傳遞狀態。安全
當瀏覽器向服務端請求一個頁面時,Django建立一個HttpResponse對象,該對象包含關於請求的元數據。而後,Django加載相應的視圖,將這個HttpResponse對象做爲第一個參數傳遞給視圖函數。服務器
每一個視圖負責返回一個HttpResponse對象。cookie
2、CBV和FBV
咱們以前寫過的都是基於函數的view,就叫FBV。還能夠把view寫成基於類的。
# urls.py中 url(r'^login.html$', views.Login.as_view(), name='login'), # views.py 中 from django.views import View class Login(View): def diapatch(self, request, *args, **kwargs): print('before') obj = super(Login, self).dispatch(request, *args, **keargs) print('after') return obj def get(self, request): print(request.POST.get('user')) return HttpResponse('Login.post')
使用 CBV 時要注意,請求過來後會先執行 dispatch() 這個方法,若是須要批量對具體的請求處理方法,如 get, post等作一些操做時候,這裏咱們能夠手動改寫 dispatch 方法,這個 dispatch 方法就和在 FBV上加裝飾器的效果是同樣的。
Request 對象
一、屬性
全部的屬性應該被認爲是隻讀的,除非另有說明。
屬性: Django 將請求報文中的請求行、頭部信息、內容主體封裝成 HttpResponse 類中的屬性。 除特殊說明的以外,其餘均爲只讀的。 ''' 0、HttpRequest.scheme 表示請求方案的字符串(一般爲http 或 https(這是後來加密了的版本)) 一、HttpRequest.body 一個字符串,表明請求報文的主體。在處理非 HTTP 形式的報文時很是有用,例如:二進制圖片、XML、Json等。 可是,若是要處理表單數據的時候,推薦仍是使用 HttpRequest.POST。 另外,咱們還能夠用 Python 的類文件方法來操做它,詳情參考 HttpResponse.read()。 二、HttpRequest.path 一個字符串,表示請求的路徑組件(不含域名)。 例如:"/music/bands/the_beatles" 三、HttpRequest.method 一個字符串,表示請求使用的 HTTP 方法。必須使用大寫。 例如:"GET"、"POST" 四、HttpRequest.encoding 一個字符串,表示提交的數據的編碼方式(若是爲 None 則表示使用 DEFAULT_CHARSET 的設置,默認爲 'utf8')。 這個屬性是可寫的,能夠經過修改它來修改訪問表單數據使用的編碼。接下來對屬性的任何訪問(例如從 GET 或 POST 中讀取數據)將使用新的 encoding 值。 這是在知道表單數據的編碼不是 DEFAULT_CHARSET 的時候使用的。 五、HttpRequest.GET 一個相似於字典的對象,包含 HTTP GET 的全部參數。詳情須要參考QueryDict 對象。 六、HttpRequest.POST 一個相似於字典的對象,若是請求中包含表單 數據,則將這些數據封裝成 QueryDict 對象。 POST 請求能夠帶有空的 POST 字典——若是經過 HTTP POST 方法發送一個表單,可是表單中沒有任何的數據, QueryDict 對象依然會被建立。 所以,不該該使用 if request.POST 來檢查使用的是不是 POST 方法;應該使用 if request.method == "POST" 另外:若是使用 POST 上傳文件的話,文件信息將包含在 FILES 屬性中。 七、HttpRequest.COOKIES 一個標準的 Python 字典,包含全部的 cookie。鍵和值都爲字符串。 八、 HttpRequest.FILES 一個相似於字典的對象,包含全部的上傳文件信息。 FILES 中的每一個鍵爲 <input type="file" name="" />中的 name,值則爲對應的數據。 注意,FILES 只有在請求的方法爲 POST 且提交的 <form> 帶有 enctype="multipart/form-data" 的狀況下才會包含數據。不然,FILES 將爲一個空的相似於字典的對象。 九、 HttpRequest.META 一個標準的 Python 字典,包含全部的 HTTP 首部。具體的頭部信息取決於客戶端和服務器,下面是一些示例: CONTENT_LENGTH ————請求的正文的長度(是一個字符串)。 CONTENT_TYPE ————請求的正文的 MIME 類型。 HTTP_ACCEPT ————響應可接收的 Content-Type。 HTTP_ACCEPT_ENCODING ———— 響應可接收的編碼。 HTTP_ACCEPT_LANGUAGE ———— 響應可接收的語言。 HTTP_HOST ———— 客戶端發送的 HTTP Host 頭部。 HTTP_REFERER ———— Referring 頁面。 HTTP_USER_AGENT ———— 客戶端的 user-agent 字符串 QUERY_STRING ———— 單個字符串形式的查詢字符串(未解析過的形式) REMOTE_ADDR ———— 客戶端的IP地址 REMOTE_HOST ———— 客戶端的主機名。 REMOTE_USER ———— 服務器認證後的用戶 REQUESR_METHOD ———— 一個字符串,例如 "GET" 或 "POST" SERVER_NAME ———— 服務器的主機名 SERBER_PORT ———— 服務器的端口(是一個字符串) 從上面能夠看到,除 CONTENT_LENGTH 和 CONTENT_TYPE 以外,請求中的任何 HTTP 首部轉換爲 META 的鍵時,都會將全部字母大寫並將鏈接符替換爲下劃線最後加上 HTTP_ 前綴。因此,一個叫作 X-Bender 的頭部將轉換成 META 中的 HTTP_X_BENDER 鍵。 十、HttpRequest.user 一個 AUTH_USER_MODEL 類型的對象,表示當前登陸的用戶。 若是用戶當前沒有登陸,user 將設置爲 django.contrib.auth.models.AnonymousUser 的一個實例。你能夠經過 is_authenticated() 區分它們。 例如: if request.user.is_authenticated(): # Do something for logged-in users. else: # Do something for anonymous users. user 只有當Django啓用 AuthenticationMiddleware 中間件事纔可用。 ------------------------------------------------------------------------------------------- 匿名用戶 class models.AnonymousUser django.contrib.auth.models.AnonymousUser 類實現了django.contrib.auth.models.User 接口,但具備下面幾個不一樣點: id 永遠爲None username 永遠爲空字符串 get_username() 永遠返回空字符串 is_staff 和 is_superuser 永遠爲False is_active 永遠爲 False geoups 和 user_permissions 永遠爲空 is_anonymous() 返回 True而不是 False is_authenticated() 返回False 而不是 True set_password()、check_password()、save() 和 delete() 引起 NotImplementedError。 New in Django 1.8: 新增 AnonymousUser.get_username() 以更好地模擬 django.contrib.auth.models.User。 十一、HttpRequest.session 一個既可讀又可寫的相似於字典的對象,表示當前的會話。只有當Django 啓用會話的支持時纔可用。 '''
上傳文件示例
def upload(request): """ 保存上傳文件前,數據須要存放在某個位置。默認當上傳文件小於2.5M時,Django會將上傳文件的所有內容讀進內存。從內存讀取一次,寫磁盤一次。 但當上傳文件很大的時候,Django會把上傳文件寫到臨時文件中,而後存放到系統臨時文件夾中。 : param request: : return: """ if request.method == "POST": # 從請求的FILES中獲取上傳文件的文件名,file 爲頁面上 type = files 類型 input 的 name 屬性值 filename = request.FILES["file"].name # 在項目目錄下新建一個文件 with open(filename, "wb") as f: # 從上傳的文件對象中一點一點讀 for chunk in request.FILES["file"].chunks(): # 寫入本地文件 f.write(chunk) return HttpResponse("上傳OK")
二、方法
''' 1. HttpRequest.get_host() 根據從HTTP_X_FORWARDE_HOST(若是打開 USE_X_FORWARDED_HOST,默認爲False )和 HTTP_HOST 頭部信息返回 請求的原始主機。 若是這兩個頭部沒有提供相應的值,則使用 SERVER_NAME 和 SERVER_PORT,在 PEP 3333 中有詳細描述。 USE_X_FORWARDED_HOST:一個布爾值,用於指定是否優先使用 X-Forwarded-Host 首部,僅在代理設置了該首部的狀況下,才能夠被使用。 例如:"127.0.0.1:8000" 注意:當主機位於多個代理後面時,get_host() 方法將會失敗。除非使用中間件重寫代理的首部。 2.HttpRequest.get_full_path() 返回 path,若是能夠將加上查詢字符串。 例如:"/music/bands/the_beatles/?print=true" 3.HttpRequest.get_singned_cookie(key, default=RAISE_ERROR, salt='',max_age=None) 返回簽名過的Cookie 對應的值,若是簽名再也不合法則返回 django.core/signing.BadSignature。 若是提供 default 參數,將不會引起異常並返回 default 的值。 可選參數 salt 能夠用來對安全密匙強力攻擊提供額外的保護。max_age 參數用於檢查 Cookie 對應的時間戳以確保 Cookie 的時間不會超過 max_age 秒。 複製代碼 >>>> request.get_signed_cookie('name') 'Tony' >>>>> request.get_signed_cookie('name', salt='name-salt') 'Tony' # 假設在設置 cookie 的時候使用的是相同的 salt >>>>> request.get_signed_cookie('non-existing-cookie') .... KeyError:'non-existing-cookie' # 沒有相應的鍵時觸發異常 >>>>> request.get_signed_cookie('non-existing-cookie', False) False >>>>> request.get_signed_cookie('cookie-that-was-tampered-with') ...... BadSignature:...... >>>>> request.get_signed_cookie('name', max_age=60) .... SignatureExpired: Signature age 1677.3839159 > 60 seconds >>>>> request.get_signed_cookie('name', False, max_age = 60) False 複製代碼 4. HttpRequest.is_secure() 若是請求時是安全的,則返回 True;即請求是經過 HTTPS 發起的。 5. HttpRequest.is_ajax() 若是請求是經過 XMLHttpRequest 發起的,則返回 True,方法是檢查 HTTP_X_REQUESTED_WITH 相應的首部是不是字符串 'XMLHttpRequest'。 大部分現代的JavaScript 庫都會發送這個頭部。若是你編寫本身的 XMLHttpRequest 調用(在瀏覽器端),你必須手工設置這個值來讓 is_ajax() 能夠工做。 若是一個響應須要根據請求是不是經過 AJAX 發起的,而且你正在使用某種形式的緩存。例如 Django 的 cache middleware, 你應該使用 vary_on_headers('HTTP_X_REQUESTED_WITH') 裝飾你的視圖以讓響應可以正確地緩存。 '''
注意:鍵值對的值是多個的是多個的時候,好比 checkbox類型的 input 標籤,select 標籤,須要使用:
request.POST.getlist("hobby")
Response對象
與由Django自動建立的 HttpRequest 對象相比,HttpResponse 對象是外面的職責範圍了。咱們寫的每一個視圖都須要實例化,填充和返回一個 HttpResponse。
HttpResponse 類位於django.http 模塊中。
一、使用
傳遞字符串
from django.http import HttpResponse response = HttpResponse("Here's the text of the Web page.") response = HttpResponse("Text only,please.", content_type = "text/plain")
設置或刪除響應頭信息
response = HttpResponse() response['Content-type'] = 'text/html; charset = utf8' del response['Content-Type']
2.屬性
HttpResponse.content: 響應內容
HttpResponse.charset: 響應內容的編碼
HttpResponse.status_code: 響應的狀態碼
JsonResponse對象
JsonResponse 是HttpResponse 的子類,專門用來生成 JSON 編碼的響應。
from django.http import JsonReaponse response = JsonResponse({'foo': 'bar'}) print(response.content) b'{"foo":"bar"}'
默認只能傳遞字典類型,若是要傳遞非字典類型須要設置一下 safe 關鍵字參數。
response = JsonResponse([1, 2, 3], safe = False)
Django shortcut functions
一、render()
render(request, template_name[, context])
結合一個給定的模板和一個給定的上下文字典,並返回一個渲染後的 HttpResponse 對象。
其默認的Content-type 標頭設置爲 application/json。
參數:
request:用於生成響應的請求對象。
Template_name:要使用的模板的完整名稱,是可選的參數。
context:添加到模板上下文的一個字典。默認是一個空字典。若是字典中的某個值是可調用的,視圖將在渲染模板以前調用它。
content_type:生成的文檔要使用的 MIME 類型。默認爲 DEFAULT_CONTENT_TYPE 設置的值。
status:響應的狀態嗎。默認爲 200。
一個簡單的例子:
from django.shortcuts import render def my_view(request): # 視圖的代碼寫在這裏 return render(request, 'myapp/index.html', {'foo':'bar'})
上面的代碼等於:
from django.http import HttpResponse from diango.template import loader def my_view(request): # 視圖代碼寫在這裏 t = loader.get_template('myapp/index.html') c = {'foo':'bar'} return HttpResponse(t.render(c, request))
二、redirect()
參數能夠是:
默認返回一個臨時的重定向;傳遞 permanent=True 能夠返回一個永久的重定向。
示例:
能夠用多種方式使用 redirect() 函數。
傳遞一個對象(ORM相關)
將調用 get_absolute_url() 方法來獲取重定向的 URL:
from django.shortcuts import redirect def my_view(request): ... object = MyModel.object.get(...) return redirect(object)
傳遞一個視圖的名稱
def my_view(request): ... return redirect('some-view-name', foo='bar')
傳遞要重定向到的一個具體的網址
def my_view(request): ... return redirect('/some/url/')
固然也能夠是一個完整的網址
def my_view(request): ... return redirect('http://example.com/')
在默認的狀況下,redirect() 返回一個臨時重定向。以上全部的形式都接收一個permanent 參數;若是設置爲True,將返回一個永久的重定向:
def my_view(request): ... object = MyModel.object.get(.....) return redirect(objct, permanent=True)
擴展閱讀:
臨時重定向(響應狀態碼:302)和永久重定向(響應狀態碼:301)對普通用戶來講是沒有區別的,它主要面向的是搜索引擎的機器人。
A 頁面臨時重定向到 B 頁面,那搜索引擎收錄的就是 A 頁面。
A 頁面永久重定向到 B 頁面, 那搜索引擎收錄的就是 B 頁面。