Part 4:表單和類視圖--Django從入門到精通系列教程

来源:https://www.cnblogs.com/feixuelove1009/archive/2018/02/04/8404040.html
-Advertisement-
Play Games

該系列教程系個人原創,並完整發佈在個人官網 "劉江的博客和教程" 所有轉載本文者,需在頂部顯著位置註明原作者及www.liujiangblog.com官網地址。 Python及Django學習QQ群:453131687 一、表單form 為了接收用戶的投票選擇,我們需要在前端頁面顯示一個投票界面。讓 ...



該系列教程系個人原創,並完整發佈在個人官網劉江的博客和教程

所有轉載本文者,需在頂部顯著位置註明原作者及www.liujiangblog.com官網地址。

Python及Django學習QQ群:453131687


一、表單form

為了接收用戶的投票選擇,我們需要在前端頁面顯示一個投票界面。讓我們重寫先前的polls/detail.html文件,代碼如下:

<h1>{{ question.question_text }}</h1>

{% if error_message %}<p><strong>{{ error_message }}</strong></p>{% endif %}

<form action="{% url 'polls:vote' question.id %}" method="post">
{% csrf_token %}
{% for choice in question.choice_set.all %}
    <input type="radio" name="choice" id="choice{{ forloop.counter }}" value="{{ choice.id }}" />
    <label for="choice{{ forloop.counter }}">{{ choice.choice_text }}</label><br />
{% endfor %}
<input type="submit" value="Vote" />
</form>

簡要說明:

  • 上面的模板顯示一系列單選按鈕,按鈕的值是選項的ID,按鈕的名字是字元串"choice"。這意味著,當你選擇了其中某個按鈕,並提交表單,一個包含數據choice=#的POST請求將被髮送到指定的url,#是被選擇的選項的ID。這就是HTML表單的基本概念。
  • 如果你有一定的前端開發基礎,那麼form標簽的action屬性和method屬性你應該很清楚它們的含義,action表示你要發送的目的url,method表示提交數據的方式,一般分POST和GET。
  • forloop.counter是DJango模板系統專門提供的一個變數,用來表示你當前迴圈的次數,一般用來給迴圈項目添加有序數標。
  • 由於我們發送了一個POST請求,就必須考慮一個跨站請求偽造的安全問題,簡稱CSRF(具體含義請百度)。Django為你提供了一個簡單的方法來避免這個困擾,那就是在form表單內添加一條{% csrf_token %}標簽,標簽名不可更改,固定格式,位置任意,只要是在form表單內。這個方法對form表單的提交方式方便好使,但如果是用ajax的方式提交數據,那麼就不能用這個方法了。

現在,讓我們創建一個處理提交過來的數據的視圖。前面我們已經寫了一個“占坑”的vote視圖的url(polls/urls.py):

url(r'^(?P<question_id>[0-9]+)/vote/$', views.vote, name='vote'),

以及“占坑”的vote視圖函數(polls/views.py),我們把坑填起來:

from django.shortcuts import get_object_or_404, render
from django.http import HttpResponseRedirect, HttpResponse
from django.urls import reverse
from .models import Choice, Question
# ...

def vote(request, question_id):
    question = get_object_or_404(Question, pk=question_id)
    try:
        selected_choice = question.choice_set.get(pk=request.POST['choice'])
    except (KeyError, Choice.DoesNotExist):
        # 發生choice未找到異常時,重新返回表單頁面,並給出提示信息
        return render(request, 'polls/detail.html', {
        'question': question,
        'error_message': "You didn't select a choice.",
        })
    else:
        selected_choice.votes += 1
        selected_choice.save()
        # 成功處理數據後,自動跳轉到結果頁面,防止用戶連續多次提交。
        return HttpResponseRedirect(reverse('polls:results', args=(question.id,)))

有些新的東西,我們要解釋一下:

  • request.POST是一個類似字典的對象,允許你通過鍵名訪問提交的數據。本例中,request.POST[’choice’]返回被選擇選項的ID,並且值的類型永遠是string字元串,那怕它看起來像數字!同樣的,你也可以用類似的手段獲取GET請求發送過來的數據,一個道理。
  • request.POST[’choice’]有可能觸發一個KeyError異常,如果你的POST數據里沒有提供choice鍵值,在這種情況下,上面的代碼會返回表單頁面並給出錯誤提示。PS:通常我們會給個預設值,防止這種異常的產生,例如request.POST[’choice’,None],一個None解決所有問題。
  • 在選擇計數器加一後,返回的是一個HttpResponseRedirect而不是先前我們常用的HttpResponse。HttpResponseRedirect需要一個參數:重定向的URL。這裡有一個建議,當你成功處理POST數據後,應當保持一個良好的習慣,始終返回一個HttpResponseRedirect。這不僅僅是對Django而言,它是一個良好的WEB開發習慣。
  • 我們在上面HttpResponseRedirect的構造器中使用了一個reverse()函數。它能幫助我們避免在視圖函數中硬編碼URL。它首先需要一個我們在URLconf中指定的name,然後是傳遞的數據。例如'/polls/3/results/',其中的3是某個question.id的值。重定向後將進入polls:results對應的視圖,並將question.id傳遞給它。白話來講,就是把活扔給另外一個路由對應的視圖去乾。

當有人對某個問題投票後,vote()視圖重定向到了問卷的結果顯示頁面。下麵我們來寫這個處理結果頁面的視圖(polls/views.py):

from django.shortcuts import get_object_or_404, render

def results(request, question_id):
    question = get_object_or_404(Question, pk=question_id)
    return render(request, 'polls/results.html', {'question': question})

同樣,還需要寫個模板polls/templates/polls/results.html。(路由、視圖、模板、模型!都是這個套路....)

<h1>{{ question.question_text }}</h1>
<ul>
{% for choice in question.choice_set.all %}
    <li>{{ choice.choice_text }} -- {{ choice.votes }} vote{{ choice.votes|pluralize }}</li>
{% endfor %}
</ul>
<a href="{% url 'polls:detail' question.id %}">Vote again?</a>

現在你可以到瀏覽器中訪問/polls/1/了,投票吧。你會看到一個結果頁面,每投一次,它的內容就更新一次。如果你提交的時候沒有選擇項目,則會得到一個錯誤提示。

如果你在前面漏掉了一部分操作沒做,比如沒有創建choice選項對象,那麼可以按下麵的操作,補充一下:

F:\Django_course\mysite>python manage.py shell
Python 3.6.1 (v3.6.1:69c0db5, Mar 21 2017, 18:41:36) [MSC v.1900 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
>>> from polls.models import Question
>>> q = Question.objects.get(pk=1)
>>> q.choice_set.create(choice_text='Not much', votes=0)
<Choice: Choice object>
>>> q.choice_set.create(choice_text='The sky', votes=0)
<Choice: Choice object>
>>> q.choice_set.create(choice_text='Just hacking again', votes=0)
<Choice: Choice object>

為了方便大家,我將當前狀態下的各主要文件內容一併貼出,供大家對照參考!

1--完整的mysite/urls.py文件如下:

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

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

2--完整的mysite/settings.py文件如下:

import os

# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))


# Quick-start development settings - unsuitable for production
# See https://docs.djangoproject.com/en/1.11/howto/deployment/checklist/

# SECURITY WARNING: keep the secret key used in production secret!
SECRET_KEY = '85vvuta(p05ow!4pz2b0qbduu0%pq6x5q66-ei*pg+-lbdr#m^'

# SECURITY WARNING: don't run with debug turned on in production!
DEBUG = True

ALLOWED_HOSTS = []


# Application definition

INSTALLED_APPS = [
    'polls',
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
]

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

ROOT_URLCONF = 'mysite.urls'

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'templates')]
        ,
        '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',
            ],
        },
    },
]

WSGI_APPLICATION = 'mysite.wsgi.application'


# Database
# https://docs.djangoproject.com/en/1.11/ref/settings/#databases

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}


# Password validation
# https://docs.djangoproject.com/en/1.11/ref/settings/#auth-password-validators

AUTH_PASSWORD_VALIDATORS = [
    {
        'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
    },
    {
        'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
    },
    {
        'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
    },
    {
        'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
    },
]


# Internationalization
# https://docs.djangoproject.com/en/1.11/topics/i18n/

LANGUAGE_CODE = 'en-us'

TIME_ZONE = 'Asia/Shanghai'

USE_I18N = True

USE_L10N = True

USE_TZ = True

3--完整的polls/views.py應該如下所示:

from django.shortcuts import reverse
from django.shortcuts import HttpResponseRedirect
from django.shortcuts import get_object_or_404
from django.shortcuts import HttpResponse
from django.shortcuts import render
from .models import Choice
from .models import Question
from django.template import loader
# Create your views here.


def index(request):
    latest_question_list = Question.objects.order_by('-pub_date')[:5]
    template = loader.get_template('polls/index.html')
    context = {
        'latest_question_list': latest_question_list,
    }
    return HttpResponse(template.render(context, request))


def detail(request, question_id):
    question = get_object_or_404(Question, pk=question_id)
    return render(request, 'polls/detail.html', {'question': question})


def results(request, question_id):
    question = get_object_or_404(Question, pk=question_id)
    return render(request, 'polls/results.html', {'question': question})


def vote(request, question_id):
    question = get_object_or_404(Question, pk=question_id)
    try:
        selected_choice = question.choice_set.get(pk=request.POST['choice'])
    except (KeyError, Choice.DoesNotExist):
        return render(request, 'polls/detail.html', {
            'question': question,
            'error_message': "You didn't select a choice.",
        })
    else:
        selected_choice.votes += 1
        selected_choice.save()
        return HttpResponseRedirect(reverse('polls:results', args=(question.id,)))

4--完整的polls/urls.py應該如下所示:

from django.conf.urls import url
from . import views

app_name = 'polls'

urlpatterns = [
    # ex: /polls/
    url(r'^$', views.index, name='index'),
    # ex: /polls/5/
    url(r'^(?P<question_id>[0-9]+)/$', views.detail, name='detail'),
    # ex: /polls/5/results/
    url(r'^(?P<question_id>[0-9]+)/results/$', views.results, name='results'),
    # ex: /polls/5/vote/
    url(r'^(?P<question_id>[0-9]+)/vote/$', views.vote, name='vote'),
]

5--完整的polls/model.py文件如下:

from django.db import models
import datetime
from django.utils import timezone
# Create your models here.

class Question(models.Model):
    question_text = models.CharField(max_length=200)
    pub_date = models.DateTimeField('date published')

    def was_published_recently(self):
        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)

    def __str__(self):
        return self.question_text



class Choice(models.Model):
    question = models.ForeignKey(Question, on_delete=models.CASCADE)
    choice_text = models.CharField(max_length=200)
    votes = models.IntegerField(default=0)

    def __str__(self):
        return self.choice_text

6--完整的polls/admin.py文件如下:

from django.contrib import admin

# Register your models here.

from .models import Question

admin.site.register(Question)

7--完整的templates/polls/index.html文件如下:

{% if latest_question_list %}
    <ul>
    {% for question in latest_question_list %}
        <li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>
    {% endfor %}
    </ul>
{% else %}
    <p>No polls are available.</p>
{% endif %}

8--完整的templates/polls/detail.html文件如下:

<h1>{{ question.question_text }}</h1>

{% if error_message %}<p><strong>{{ error_message }}</strong></p>{% endif %}

<form action="{% url 'polls:vote' question.id %}" method="post">
{% csrf_token %}
{% for choice in question.choice_set.all %}
    <input type="radio" name="choice" id="choice{{ forloop.counter }}" value="{{ choice.id }}" />
    <label for="choice{{ forloop.counter }}">{{ choice.choice_text }}</label><br />
{% endfor %}
<input type="submit" value="Vote" />
</form>

9--完整的templates/polls/results.html文件如下:

<h1>{{ question.question_text }}</h1>
<ul>
{% for choice in question.choice_set.all %}
    <li>{{ choice.choice_text }} -- {{ choice.votes }} vote{{ choice.votes|pluralize }}</li>
{% endfor %}
</ul>
<a href="{% url 'polls:detail' question.id %}">Vote again?</a>

vote()視圖沒有對應的html模板,它直接跳轉到results視圖去了。

運行伺服器,測試各功能:

這是問卷列表頁面:

image.png-13kB

這是“what's up”問卷選項頁面:

image.png-23.9kB

這是選擇結果頁面:

image.png-26.2kB

這是沒有選擇選項時,提示錯誤信息的頁面:

image.png-28.4kB

請大家對比參考上面的內容,看看你自己的結果是否一樣。

二、 使用類視圖:減少重覆代碼

上面的detail、index和results視圖的代碼非常相似,有點冗餘,這是一個程式猿不能忍受的。他們都具有類似的業務邏輯,實現類似的功能:通過從URL傳遞過來的參數去資料庫查詢數據,載入一個模板,利用剛纔的數據渲染模板,返回這個模板。由於這個過程是如此的常見,Django很善解人意的幫你想辦法偷懶,於是它提供了一種快捷方式,名為“類視圖”。

現在,讓我們來試試看將原來的代碼改為使用類視圖的方式,整個過程分三步走:

  • 修改URLconf設置
  • 刪除一些舊的無用的視圖
  • 採用基於類視圖的新視圖

PS:為什麼本教程的代碼來回改動這麼頻繁?

答:通常在寫一個Django的app時,我們一開始就要決定使用類視圖還是不用,而不是等到代碼寫到一半了才重構你的代碼成類視圖。但是本教程為了讓你清晰的理解視圖的內涵,“故意”走了一條比較曲折的路,因為我們的哲學是在你使用計算器之前你得先知道基本的數學公式

1.改良URLconf

打開polls/urls.py文件,將其修改成下麵的樣子:

from django.conf.urls import url
from . import views

app_name = 'polls'
urlpatterns = [
    url(r'^$', views.IndexView.as_view(), name='index'),
    url(r'^(?P<pk>[0-9]+)/$', views.DetailView.as_view(), name='detail'),
    url(r'^(?P<pk>[0-9]+)/results/$', views.ResultsView.as_view(), name='results'),
    url(r'^(?P<question_id>[0-9]+)/vote/$', views.vote, name='vote'),
]

請註意:在上面的的第2,3條目中將原來的<question_id>修改成了<pk>.

2.修改視圖

接下來,打開polls/views.py文件,刪掉index、detail和results視圖,替換成Django的類視圖,如下所示:

from django.shortcuts import get_object_or_404, render
from django.http import HttpResponseRedirect
from django.urls import reverse
from django.views import generic
from .models import Choice, Question


class IndexView(generic.ListView):
    template_name = 'polls/index.html'
    context_object_name = 'latest_question_list'
    def get_queryset(self):
    """返回最近發佈的5個問卷."""
        return Question.objects.order_by('-pub_date')[:5]
    
    
class DetailView(generic.DetailView):
    model = Question
    template_name = 'polls/detail.html'
    
    
class ResultsView(generic.DetailView):
    model = Question
    template_name ='polls/results.html'
    
    
def vote(request, question_id):
... # 這個視圖未改變!!!

在這裡,我們使用了兩種類視圖ListViewDetailView(它們是作為父類被繼承的)。這兩者分別代表“顯示一個對象的列表”和“顯示特定類型對象的詳細頁面”的抽象概念。

  • 每一種類視圖都需要知道它要作用在哪個模型上,這通過model屬性提供。

  • DetailView類視圖需要從url捕獲到的稱為"pk"的主鍵值,因此我們在url文件中將2和3條目的<question_id>修改成了<pk>

預設情況下,DetailView類視圖使用一個稱作<app name>/<model name>_detail.html的模板。在本例中,實際使用的是polls/detail.htmltemplate_name屬性就是用來指定這個模板名的,用於代替自動生成的預設模板名。(一定要仔細觀察上面的代碼,對號入座,註意細節。)同樣的,在resutls列表視圖中,指定template_name'polls/results.html',這樣就確保了雖然resulst視圖和detail視圖同樣繼承了DetailView類,使用了同樣的model:Qeustion,但它們依然會顯示不同的頁面。(模板不同嘛!so easy!)

類似的,ListView類視圖使用一個預設模板稱為<app name>/<model name>_list.html。我們也使用template_name這個變數來告訴ListView使用我們已經存在的
"polls/index.html"模板,而不是使用它自己預設的那個。

在教程的前面部分,我們給模板提供了一個包含questionlatest_question_list的上下文變數。而對於DetailView,question變數會被自動提供,因為我們使用了Django的模型(Question),Django會智能的選擇合適的上下文變數。然而,對於ListView,自動生成的上下文變數是question_list。為了覆蓋它,我們提供了context_object_name屬性,指定說我們希望使用latest_question_list而不是question_list

現在可以運行開發伺服器,然後試試基於類視圖的應用程式了。類視圖是Django比較高級的一種用法,初學可能不太好理解,沒關係,我們先有個印象。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 今天遇到一個十分蛋疼的問題,花了我一個多小時才解決,其實十分簡單,但我是新手,好了,事情是這樣的: 我想讓滑鼠停留在某個元素一定時間再顯示它隱藏的內容(不然你滑鼠快速滑上滑下,反反覆復,如果碰上slideDown(),會讓電腦反應不過來的),剛開始代碼如下: var tid = 0; $( ".he ...
  • 看JavaScript文檔的時候註意到了這種用法 var n1 = Number(123); , 冒出的第一個疑問就是和 var n2 = new Number(123); 有什麼區別呢? 首先用typeof做下探測, n1是number而n2是object, 他們的本質區別就是type不同. 那麼 ...
  • Chrome會對頁面緩存,web頁面調試的時候,後端修改頁面、js之後,刷新頁面經常不生效,非常不方便。 有一些小技巧可以解決該問題。 技巧一: 開發者工具 setting/設置,可以關閉緩存。 開發者工具 network,也可以直接勾選“Disable cache”。 技巧二: 長按導航欄刷新按鈕 ...
  • 方式一:每個標簽加一個屬性法 <div style="background-color:red;color:green;"></div> 方式二:head中加style標簽(不好,需要修改html文件) <style type="text/css"> div{ background-color:re ...
  • 字體標簽 <font size="1~7" color="red|#ff0000"></font> 標題標簽<h1></h1>到<h6></h6> 水平線標簽 <hr size="1~7" color="green|#00ff00" /> 換行標簽 <br/> 特殊字元 : &lt; 表示 < &g ...
  • layout: post title: 2018 02 03 jekyll框架下的post如何顯示圖片 key: 20180203 tags: blog post modify_date: 2018 02 03 jekyll框架下的post如何顯示圖片 說明: 本文發佈於: "gitee" , "g ...
  • //分頁載入器 function pagingLoad(options) { //分頁載入 if (!document.getElementById('load_txt')) { this.loadTxt = document.createElement('div'); loadTxt.id = " ...
  • 今天分享一個3d翻轉動畫效果,js+css3+h5實現,沒有框架。 先看下html部分: 1 <div class="box"> 2 <ul> 3 <li></li> 4 <li></li> 5 <li></li> 6 <li></li> 7 </ul> 8 <span class="arrow-l ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...