django入門 -- 簡單流程

這裏簡單的演示完成一個 django 大概流程，後面會有詳細解釋

搭建開發環境

以下使用的是 ubuntu 系統

在生產環境中，有的時候，我們開發的項目可能用的是幾個不同的 環境，所以通常我們會創建虛擬環境，在虛擬環境中安裝我們需要的 配置，這裏從配置虛擬環境開始

創建虛擬環境

• 創建：mkvirtualenv [虛擬環境名稱]
• 刪除：rmvirtualenv [虛擬環境名稱]
• 進入：workon [虛擬環境名稱]
• 退出：deactivate
• 所有的虛擬環境，都位於/home/.virtualenvs目錄下
• 進入虛擬環境前的提示：

• 進入虛擬環境後的提示：

• 查看當前的所有虛擬環境：workon [兩次tab鍵]
• 查看虛擬環境中已經安裝的包

pip list
pip freeze

安裝django

• 建議安裝1.8.2版本，這是一個穩定性高、使用廣、文檔多的版本

pip install django==1.8.2

• 查看版本：進入python shell，運行如下代碼

import django
django.get_version()

• 說明：使用pip install django命令進行安裝時，會自動刪除舊版本，再安裝新版本

創建項目

• 命令django-admin startproject test1
• 進入test1目錄，目錄結構如下圖：

目錄說明

• manage.py：一個命令行工具，可以使你用多種方式對Django項目進行交互
• 內層的目錄：項目的真正的Python包
• _init _.py：一個空文件，它告訴Python這個目錄應該被看做一個Python包
• settings.py：項目的配置
• urls.py：項目的URL聲明
• wsgi.py：項目與WSGI兼容的Web服務器入口

設計模型

表格需求：略

• 本示例完成“圖書-英雄”信息的維護，需要存儲兩種數據：圖書、英雄
• 圖書表結構設計：
  • 表名：BookInfo
  • 圖書名稱：btitle
  • 圖書發布時間：bpub_date
• 英雄表結構設計：
  • 表名：HeroInfo
  • 英雄姓名：hname
  • 英雄性別：hgender
  • 英雄簡介：hcontent
  • 所屬圖書：hbook
• 圖書-英雄的關系為一對多

數據庫配置

• 在settings.py文件中，通過DATABASES項進行數據庫設置
• django支持的數據庫包括：sqlite、mysql等主流數據庫
• Django默認使用SQLite數據庫

python manage.py startapp booktest

• 應用的目錄結構如下圖

定義模型類

• 有一個數據表，就有一個模型類與之對應
• 打開models.py文件，定義模型類
• 引入包from django.db import models
• 模型類繼承自models.Model類
• 說明：不需要定義主鍵列，在生成時會自動添加，並且值為自動增長
• 當輸出對象時，會調用對象的str方法(也就是說，你可以定義一個 str 方法，在裏面寫入自己想要輸出的內容)

from django.db import models

class BookInfo(models.Model):
    btitle = models.CharField(max_length=20)
    bpub_date = models.DateTimeField()
    def _ _str_ _(self):
        return "%d" % self.pk

class HeroInfo(models.Model):
    hname = models.CharField(max_length=20)
    hgender = models.BooleanField()
    hcontent = models.CharField(max_length=100)
    hBook = models.ForeignKey(‘BookInfo‘)
# 上面創建了管理，外鍵 默認為對方的 主鍵
    def _ _str_ _(self):
        return "%d" % self.pk

# 這裏創建了兩個類，分別繼承了 django.db 中的 models.Model 類，表示需要生成表頭
# 定義 str 方法，表示默認輸出

生成數據表

• 激活模型：編輯settings.py文件，將booktest應用加入到installed_apps中

• 生成遷移文件：根據模型類生成sql語句

python manage.py makemigrations
# 表的字段(表頭)無論是增加刪除還是類型改變後，都應該重新遷移

• 遷移文件被生成到應用的migrations目錄

• 執行遷移：執行sql語句生成數據表

python manage.py migrate

測試數據操作

• 引入需要的包：

from booktest.models import BookInfo,HeroInfo
from django.utils import timezone
from datetime import *

• 查詢所有圖書信息：

BookInfo.objects.all()

• 新建圖書信息：

b = BookInfo()
b.btitle="射雕英雄傳"
b.bpub_date=datetime(year=1990,month=1,day=10)
b.save()
# 其它方式後面介紹

• 查找圖書信息：

b=BookInfo.objects.get(pk=1)
# pk 代表的是 主鍵 的意思，這裏代指 id

• 修改圖書信息：

b.btitle=u"天龍八部"
b.save()

• 刪除圖書信息：

b.delete()

關聯對象的操作

• 對於HeroInfo可以按照上面的操作方式進行
• 添加，註意添加關聯對象

h=HeroInfo()
h.htitle=u‘郭靖‘
h.hgender=True
h.hcontent=u‘降龍十八掌‘
h.hBook=b
h.save()

管理站點

服務器

• 運行如下命令可以開啟服務器

python manage.py runserver ip:port

• 可以不寫ip，默認端口為8000
• 這是一個純python編寫的輕量級web服務器，僅在開發階段使用
• 服務器成功啟動後，提示如下信息

• 默認端口是8000，可以修改端口

python manage.py runserver 8080

• 打開瀏覽器，輸入網址“127.0.0.1:8000”可以打開默認頁面
• 如果修改文件不需要重啟服務器，如果增刪文件需要重啟服務器
• 通過ctrl+c停止服務器

管理操作

• 站點分為“內容發布”和“公共訪問”兩部分
• “內容發布”的部分負責添加、修改、刪除內容，開發這些重復的功能是一件單調乏味、缺乏創造力的工作。為此，Django會根據定義的模型類完全自動地生成管理模塊

使用django的管理

• 創建一個管理員用戶

python manage.py createsuperuser，按提示輸入用戶名、郵箱、密碼

• 啟動服務器，通過“127.0.0.1:8000/admin”訪問，輸入上面創建的用戶名、密碼完成登錄
• 進入管理站點，默認可以對groups、users進行管理

管理界面本地化

• 編輯settings.py文件，設置編碼、時區

LANGUAGE_CODE = ‘zh-Hans‘
TIME_ZONE = ‘Asia/Shanghai‘

向admin註冊booktest的模型

• 打開booktest/admin.py文件，註冊模型

from django.contrib import admin
from models import BookInfo
admin.site.register(BookInfo)

• 刷新管理頁面，可以對BookInfo的數據進行增刪改查操作
• 問題：如果在str方法中返回中文，在修改和添加時會報ascii的錯誤
• 解決：在str()方法中，將字符串末尾添加“.encode(‘utf-8‘)”

自定義管理頁面

• Django提供了admin.ModelAdmin類
• 通過定義ModelAdmin的子類，來定義模型在Admin界面的顯示方式

class QuestionAdmin(admin.ModelAdmin):
    ...
admin.site.register(Question, QuestionAdmin)

列表頁屬性

• list_display：顯示字段，可以點擊列頭進行排序

list_display = [‘pk‘, ‘btitle‘, ‘bpub_date‘]

• list_filter：過濾字段，過濾框會出現在右側

list_filter = [‘btitle‘]

• search_fields：搜索字段，搜索框會出現在上側

search_fields = [‘btitle‘]

• list_per_page：分頁，分頁框會出現在下側

list_per_page = 10

添加、修改頁屬性

• fields：屬性的先後順序

fields = [‘bpub_date‘, ‘btitle‘]

• fieldsets：屬性分組

fieldsets = [
    (‘basic‘,{‘fields‘: [‘btitle‘]}),
    (‘more‘, {‘fields‘: [‘bpub_date‘]}),
]

關聯對象

• 對於HeroInfo模型類，有兩種註冊方式

  • 方式一：與BookInfo模型類相同
  • 方式二：關聯註冊

• 按照BookInfor的註冊方式完成HeroInfo的註冊

• 接下來實現關聯註冊

from django.contrib import admin
from models import BookInfo,HeroInfo

class HeroInfoInline(admin.StackedInline):
    model = HeroInfo
    extra = 2

class BookInfoAdmin(admin.ModelAdmin):
    inlines = [HeroInfoInline]

admin.site.register(BookInfo, BookInfoAdmin)

• 可以將內嵌的方式改為表格

class HeroInfoInline(admin.TabularInline)

布爾值的顯示

• 發布性別的顯示不是一個直觀的結果，可以使用方法進行封裝

def gender(self):
    if self.hgender:
        return ‘男‘
    else:
        return ‘女‘
gender.short_description = ‘性別‘

• 在admin註冊中使用gender代替hgender

class HeroInfoAdmin(admin.ModelAdmin):
    list_display = [‘id‘, ‘hname‘, ‘gender‘, ‘hcontent‘]

視圖

• 在django中，視圖對WEB請求進行回應
• 視圖接收reqeust對象作為第一個參數，包含了請求的信息
• 視圖就是一個Python函數，被定義在views.py中

#coding:utf-8
from django.http import HttpResponse

def index(request):
    return HttpResponse("index")
def detail(request,id):
    return HttpResponse("detail %s" % id)

• 定義完成視圖後，需要配置urlconf，否則無法處理請求

URLconf

• 在Django中，定義URLconf包括正則表達式、視圖兩部分
• Django使用正則表達式匹配請求的URL，一旦匹配成功，則調用應用的視圖
• 註意：只匹配路徑部分，即除去域名、參數後的字符串
• 在test1/urls.py插入booktest，使主urlconf連接到booktest.urls模塊

url(r‘^‘, include(‘booktest.urls‘)),

• 在booktest中的urls.py中添加urlconf

from django.conf.urls import url
from . import views
urlpatterns = [
    url(r‘^$‘, views.index),
    url(r‘^([0-9]+)/$‘, views.detail),
]

模板

• 模板是html頁面，可以根據視圖中傳遞的數據填充值
• 創建模板的目錄如下圖：

• 修改settings.py文件，設置TEMPLATES的DIRS值

‘DIRS‘: [os.path.join(BASE_DIR, ‘templates‘)],

• 在模板中訪問視圖傳遞的數據

{{輸出值，可以是變量，也可以是對象.屬性}}
{%執行代碼段%}

定義index.html模板

<!DOCTYPE html>
<html>
<head>
  <title>首頁</title>
</head>
<body>
<h1>圖書列表</h1>
<ul>
{%for book in booklist%}
<li>
  <a href="{{book.id}}">
    {{book.btitle}}
  </a>
</li>
{%endfor%}
</ul>
</body>
</html>

定義detail.html模板

• 在模板中訪問對象成員時，都以屬性的方式訪問，即方法也不能加括號

<!DOCTYPE html>
<html>
<head>
  <title>詳細頁</title>
</head>
<body>
<h1>{{book.btitle}}</h1>
<ul>
  {%for hero in book.heroinfo_set.all%}
  <li>{{hero.hname}}---{{hero.hcontent}}</li>
  {%endfor%}
</ul>
</body>
</html>

使用模板

• 編輯views.py文件，在方法中調用模板

from django.http import HttpResponse
from django.template import RequestContext, loader
from models import BookInfo

def index(request):
    booklist = BookInfo.objects.all()
    template = loader.get_template(‘booktest/index.html‘)
    context = RequestContext(request, {‘booklist‘: booklist})
    return HttpResponse(template.render(context))


def detail(reqeust, id):
    book = BookInfo.objects.get(pk=id)
    template = loader.get_template(‘booktest/detail.html‘)
    context = RequestContext(reqeust, {‘book‘: book})
    return HttpResponse(template.render(context))

去除模板的硬編碼

• 在index.html模板中，超鏈接是硬編碼的，此時的請求地址為“127.0.0.1/1/”

<a href="{{book.id}}">

• 看如下情況：將urlconf中詳細頁改為如下，鏈接就找不到了

url(r‘^book/([0-9]+)/$‘, views.detail),

• 此時的請求地址應該為“127.0.0.1/book/1/”
• 問題總結：如果在模板中地址硬編碼，將來urlconf修改後，地址將失效
• 解決：使用命名的url設置超鏈接
• 修改test1/urls.py文件，在include中設置namespace

url(r‘^admin/‘, include(admin.site.urls, namespace=‘booktest‘)),

• 修改booktest/urls.py文件，設置name

url(r‘^book/([0-9]+)/$‘, views.detail, name="detail"),

• 修改index.html模板中的鏈接

<a href="{%url ‘booktest:detail‘ book.id%}">

Render簡寫

• Django提供了函數Render()簡化視圖調用模板、構造上下文

from django.shortcuts import render
from models import BookInfo

def index(reqeust):
    booklist = BookInfo.objects.all()
    return render(reqeust, ‘booktest/index.html‘, {‘booklist‘: booklist})


def detail(reqeust, id):
    book = BookInfo.objects.get(pk=id)
    return render(reqeust, ‘booktest/detail.html‘, {‘book‘: book})

總結

1. 安裝配置django運行的環境
2. 編寫模型，使用簡單API與數據庫交互
3. 使用django的後臺管理中維護數據
4. 通過視圖接收請求，通過模型獲取數據，展示出來
5. 調用模板完成展示

django入門 -- 簡單流程