Django在檢視中使用表單並和資料庫進行資料互動的實現

2022-07-26 14:00:53

寫在前面

博主近期有時間的話，一直在抽空看Django相關的專案，苦於沒有web開發基礎，對JavaScript也不熟悉，一直在從入門到放棄的邊緣徘徊（其實已經放棄過幾次了，如下圖，一年前的筆記）。總體感受web開發要比其他技術棧難，前後端技術都有涉及。如果沒有實體專案支撐的話，很難學下去。但不管怎樣，學習都是一件痛苦的事情，堅持下去總會有收穫。

本部落格記錄的是《Django web 應用開發實戰》這本書第八章表單與模型中的相關內容，主要內容是表單與資料庫的互動。編譯環境如下：

Python3.7
pycharm2020.1專業版（社群版應該是不支援Django專案偵錯的）項

目結構及程式碼

專案結構

在pycharm中建立Django專案後，會自動生成一些基礎的檔案，如settings.py，urls.py等等，這些基礎的東西，不再記錄，直接上我的專案結構圖。

上圖中左側為專案結構，1為專案應用，也叫APP，2是Django的專案設定，3是專案的模板，主要是放網頁的。

路由設定

路由設定是Django專案必須的，在新建專案是，在index目錄、MyDjango目錄下面生成了urls.py檔案，裡面預設有專案的路由地址，可以根據專案情況更改，我這裡上一下我的路由設定。

# MyDjango/urls.py
"""MyDjango URL Configuration

The `urlpatterns` list routes URLs to views. For more information please see:
    https://docs.djangoproject.com/en/3.0/topics/http/urls/
Examples:
Function views
    1. Add an import:  from my_app import views
    2. Add a URL to urlpatterns:  path('', views.home, name='home')
Class-based views
    1. Add an import:  from other_app.views import Home
    2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
Including another URLconf
    1. Import the include() function: from django.urls import include, path
    2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
"""
from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include(('index.urls', 'index'), namespace='index'))
]


# index/urls.py
#!/usr/bin/env python
#-*- coding:utf-8 -*-
# author:HP
# datetime:2021/6/15 15:35
from django.urls import path, re_path
from .views import *
urlpatterns = [
    path('', index, name='index'),
]

資料庫設定

資料庫的設定，以及模板的設定等內容都在settings.py檔案中，在專案生成的時候，自動生成。
資料庫設定在DATABASE字典中進行設定，預設的是sqlite3，我也沒改。這裡可以同時設定多個資料庫，具體不再記錄。
看程式碼：

"""
Django settings for MyDjango project.

Generated by 'django-admin startproject' using Django 3.0.8.

For more information on this file, see
https://docs.djangoproject.com/en/3.0/topics/settings/

For the full list of settings and their values, see
https://docs.djangoproject.com/en/3.0/ref/settings/
"""

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/3.0/howto/deployment/checklist/

# SECURITY WARNING: keep the secret key used in production secret!
SECRET_KEY = '6##c(097i%=eyr-uy!&m7yk)+ar+_ayjghl(p#&(xb%$u6*32s'

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

ALLOWED_HOSTS = []


# Application definition

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # add a new app index
    'index',
    'mydefined'
]

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 = 'MyDjango.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',
            ],
        },
    },

]
'''
    {
        'BACKEND': 'django.template.backends.jinja2.Jinja2',
        'DIRS': [
            os.path.join(BASE_DIR, 'templates'),
        ],
        'APP_DIRS': True,
        'OPTIONS': {
            'environment': 'MyDjango.jinja2.environment'
        },
    },
    '''

WSGI_APPLICATION = 'MyDjango.wsgi.application'


# Database
# https://docs.djangoproject.com/en/3.0/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/3.0/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/3.0/topics/i18n/

LANGUAGE_CODE = 'en-us'

TIME_ZONE = 'UTC'

USE_I18N = True

USE_L10N = True

USE_TZ = True


# Static files (CSS, JavaScript, Images)
# https://docs.djangoproject.com/en/3.0/howto/static-files/

STATIC_URL = '/static/'

STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'static')
]

定義模型

怎麼來解釋“模型”這個東西，我感覺挺難解釋清楚，首先得解釋ORM框架，它是一種程式技術，用來實現物件導向程式語言中不同型別系統的資料之間的轉換。這篇部落格涉及到前端和後端的資料互動，那麼首先你得有個資料表，資料表是通過模型來建立的。怎麼建立呢，就是在專案應用裡面建立models.py這個檔案，然後在這個檔案中寫幾個類，用這個類來生成資料表，先看看這個專案的models.py程式碼。

from django.db import models


class PersonInfo(models.Model):
    id = models.AutoField(primary_key=True)
    name = models.CharField(max_length=20)
    age = models.IntegerField()
    # hireDate = models.DateField()

    def __str__(self):
        return self.name

    class Meta:
        verbose_name = '人員資訊'


class Vocation(models.Model):
    id = models.AutoField(primary_key=True)
    job = models.CharField(max_length=20)
    title = models.CharField(max_length=20)
    payment = models.IntegerField(null=True, blank=True)
    person = models.ForeignKey(PersonInfo, on_delete=models.CASCADE)

    def __str__(self):
        return str(self.id)

    class Meta:
        verbose_name = '職業資訊'

簡單解釋一下，這段程式碼中定義了兩個類，一個是PersonInfo，一個是Vocation，也就是人員和職業，這兩個表通過外來鍵連線，也就是說，我的資料庫中，主要的資料就是這兩個資料表。
在建立模型後，在終端輸入以下兩行程式碼：

python manage.py makemigrations
python manage.py migrate

這樣就可以完成資料表的建立，資料遷移也是這兩行程式碼。同時，還會在專案應用下生成一個migrations資料夾，記錄你的各種資料遷移指令。
看看生成的資料庫表：

上面圖中，生成了personinfo和vocation兩張表，可以自行在表中新增資料。

定義表單

表單是個啥玩意兒，我不想解釋，因為我自己也是一知半解。這個就是你的前端介面要顯示的東西，通過這個表單，可以在瀏覽器上生成網頁表單。怎麼建立呢，同樣是在index目錄（專案應用）下新建一個form.py檔案，在該檔案中新增以下程式碼：

#!/usr/bin/env python
#-*- coding:utf-8 -*-
# author:HP
# datetime:2021/6/24 14:55

from django import forms
from .models import *
from django.core.exceptions import ValidationError


def payment_validate(value):
    if value > 30000:
        raise ValidationError('請輸入合理的薪資')


class VocationForm(forms.Form):
    job = forms.CharField(max_length=20, label='職位')
    title = forms.CharField(max_length=20, label='職稱',
                            widget=forms.widgets.TextInput(attrs={'class': 'cl'}),
                            error_messages={'required': '職稱不能為空'})
    payment = forms.IntegerField(label='薪資',
                                 validators=[payment_validate])

    value = PersonInfo.objects.values('name')
    choices = [(i+1, v['name']) for i, v in enumerate(value)]
    person = forms.ChoiceField(choices=choices, label='姓名')

    def clean_title(self):
        data = self.cleaned_data['title']
        return '初級' + data

簡單解釋一下，就是說我待會兒生成的網頁上，要顯示job、title、payment還有一個人名下拉框，這些欄位以表單形式呈現在網頁上。

修改模板

模板實際上就是網頁上要顯示的資訊，為啥叫模板呢，因為你可以自定義修改，在index.html中修改，如下：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
{% if v.errors %}
    <p>
        資料出錯了，錯誤資訊：{{ v.errors }}
    </p>
{% else %}
    <form action="" method="post">
        {% csrf_token %}
        <table>
            {{ v.as_table }}
        </table>
        <input type="submit" value="submit">
    </form>
{% endif %}
</body>
</html>

檢視函數

檢視函數其實就是views.py檔案中的函數，這個函數非常重要，在專案建立的時候自動生成，它是你的前後端連線的樞紐，不管是FBV檢視還是CBV檢視，都需要它。
先來看看這個專案中檢視函數的程式碼：

from django.shortcuts import render
from django.http import HttpResponse
from index.form import VocationForm
from .models import *


def index(request):
    # GET請求
    if request.method == 'GET':
        id = request.GET.get('id', '')
        if id:
            d = Vocation.objects.filter(id=id).values()
            d = list(d)[0]
            d['person'] = d['person_id']
            i = dict(initial=d, label_suffix='*', prefix='vv')
            # 將引數i傳入表單VocationForm執行範例化
            v = VocationForm(**i)
        else:
            v = VocationForm(prefix='vv')
        return render(request, 'index.html', locals())
    # POST請求
    else:
        # 由於在GET請求設定了引數prefix
        # 範例化時必須設定引數prefix，否則無法獲取POST的資料
        v = VocationForm(data=request.POST, prefix='vv')
        if v.is_valid():
            # 獲取網頁控制元件name的資料
            # 方法一
            title = v['title']
            # 方法二
            # cleaned_data將控制元件name的資料進行清洗
            ctitle = v.cleaned_data['title']
            print(ctitle)
            # 將資料更新到模型Vocation
            id = request.GET.get('id', '')
            d = v.cleaned_data
            d['person_id'] = int(d['person'])
            Vocation.objects.filter(id=id).update(**d)
            return HttpResponse('提交成功')
        else:
            # 獲取錯誤資訊，並以json格式輸出
            error_msg = v.errors.as_json()
            print(error_msg)
            return render(request, 'index.html', locals())

其實就一個index函數，不同請求方式的時候，顯示不同的內容。這裡要區分get和post請求，get是向特定資源發出請求，也就是輸入網址存取網頁，post是向指定資源提交資料處理請求，比如提交表單，上傳檔案這些。
好吧，這樣就已經完成了專案所有的設定。
啟動專案，並在瀏覽器中輸入以下地址：http://127.0.0.1:8000/?id=1

這是個get請求，顯示內容如下：