🔥 邂逅Django - 目录
✅ Part 1:【邂逅Django】—— (一)创建项目
✅ Part 2:【邂逅Django】—— (二)数据库配置
🛠️ Part 3:【邂逅Django】—— (三)视图
🛠️ Part 4:【邂逅Django】—— (四)表单和通用视图
🛠️ Part 5:【邂逅Django】—— (五)完善界面(自定义界面和样式)
🛠️ Part 6:【邂逅Django】—— (六)自定义管理界面
🛠️ Part 7:【邂逅Django】—— (七)自动化测试
🎈 前言
本系列文章,在Django
官方文档教程的基础模板下,进行了一定的改进和删除,添加了一些自己的见解。
希望大家看完该系列文章后,对Django
能够有一个清晰的认识。
路漫漫兮其修远兮,吾将上下而求索!
Django
官方文档:https://www.djangoproject.com/
❗ ❗ ❗ 学习过程中,多看官方文档,可以解决很多问题 ❗ ❗ ❗
本教程使用
poetry
对项目环境进行管理。
相关poetry
的安装与使用,请参考【Python - 虚拟环境】项目的启动,从隔离开发环境开始 - CoderChaos - 博客园 (cnblogs.com)
项目地址:https://github.com/CoderBerryRabbit/MeetDjango
一、视图概述
Django
中的视图概念是【一类具有相同功能和模板的网页集合】。比如,在一个博客应用中,可能会创建如下视图:
- 博客首页 —— 展示最近的几项内容
- 内容详情页 —— 详细展示某项内容
- 以年为单位的归档页 —— 展示选中的年份里各个月份创建的内容
- 以月为单位的归档页 —— 展示选中的月份里各天创建的内容
- 以天为单位的归档页 —— 展示选中天里创建的所有内容
- 评论处理器 —— 用于响应内容添加评论的操作
而在投票应用中,需要以下几个视图:
- 问题索引页 —— 展示最近的几个投票问题
- 问题详情页 —— 展示某个投票的问题和不带结果的选项列表
- 问题结果页 —— 展示某个投票的结果
- 投票处理器 —— 用于响应用户为某个问题投票的操作
在Django
中,网页和其他内容都是从视图派生而来的。每一个视图表现为一个Python
函数(对于基于类的视图来说,表现为一个方法)。Django
会根据用户请求的URL
来选择使用哪个视图。
为了将URL
和视图关联起来,Django
使用URLconfs
来配置。URLconf
将URL
映射到视图。
二、编写视图
# polls/views.py
from django.shortcuts import render
from django.http import HttpResponse
def index(request):
return HttpResponse(\"Hello, world. You\'re at the polls index.\")
def detail(request, question_id):
return HttpResponse(f\"You\'re looking at question {question_id}\")
def results(request, question_id):
response = \"You\'re looking at the results of question {}\"
return HttpResponse(response.format(question_id))
def vote(request, question_id):
return HttpResponse(\"You\'re voting on question %s.\" % question_id)
三、添加url
# polls/urls.py
from django.urls import path
from . import views
urlpatterns = [
path(\"\", views.index, name=\"index\"),
path(\"<int:question_id>/\", views.detail, name=\"detail\"),
path(\"<int:question_id>/results/\", views.results, name=\"results\"),
path(\"<int:question_id>/vote/\", views.vote, name=\"vote\"),
]
启动Django
开发服务器,可以在浏览器输入以下URL
进行查看:
index
- http://127.0.0.1:8000/polls/detail
- http://127.0.0.1:8000/polls/1/results
- http://127.0.0.1:8000/polls/1/results/vote
- http://127.0.0.1:8000/polls/1/vote/
四、写一个真正有用的视图
每个视图要做两件事:返回一个包含被请求页面内容的HttpResponse
对象,或者抛出一个异常。
视图可以从数据库里读取记录,可以使用一个模板引擎,或者其他能用Python
完成的事。
# pools/views.py
from django.shortcuts import render
from django.http import HttpResponse
from .models import Question
def index(request):
latest_question_list = Question.objects.order_by(\"-pub_date\")[:5]
output = \", \".join([q.question_text for q in latest_question_list])
return HttpResponse(output)
def detail(request, question_id):
return HttpResponse(f\"You\'re looking at question {question_id}\")
def results(request, question_id):
response = \"You\'re looking at the results of question {}\"
return HttpResponse(response.format(question_id))
def vote(request, question_id):
return HttpResponse(f\"You\'re voting on question {question_id}\")
在查看之前,可以创建一些Question
的数据。
启动Django
服务器,在浏览器输入http://127.0.0.1:8000/polls/
进行查看。
五、自定义模板
🌊 5.1 模板目录说明
首先,在polls
目录下创建一个templates
目录。Django
会在这个目录里查找模板文件。
在settings.py
配置文件中,TEMPLATES
配置项描述了Django
如何载入和渲染模板。默认设置了DjangoTemplates
后端,并将APP_DIRS
设置为True
。这一选项将会让DjangoTemplates
在每个INSTALLED_APPS
文件夹下寻找templates
子目录。
这就是为什么没有进行DIRS
的设置,Django
也能正确找到polls
的模板位置的原因。
说明:虽然可以将模板文件直接放在polls/templates
文件夹中(而不是再建立一个polls
子文件夹),但是这样做不太好。Django
会选择第一个匹配的模板文件,如果有一个模板文件和另一个应用中的目标文件重名,Django
没有办法区分它们。我们需要Django
选择正确的模板,最好的方法就是把它们放入各自的命名空间中,也就是把这些模板放入一个和自身应用重名的子文件夹里。
🌊 5.2 创建模板文件
// polls/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>
{% endif %}
# polls/templates/polls/detail.html
<h1>{{ question.question_text }}</h1>
<ul>
{% for choice in question.choice_set.all %}
<li>{{ choice.choice_text }}</li>
{% endfor %}
</ul>
🌊 5.3 使用模板
# polls/views.py
from django.shortcuts import render
from django.http import HttpResponse
from django.template import loader
from .models import Question
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))
开启Django
服务器,输入http://127.0.0.1:8000/polls/进行查看。
🌊 5.4 使用模板(一个快捷函数):render()
from django.http import HttpResponse
from django.shortcuts import render
from django.template import loader
from .models import Question
def index(request):
latest_question_list = Question.objects.order_by(\"-pub_date\")[:5]
context = {\"latest_question_list\": latest_question_list}
return render(request, \"polls/index.html\", context)
使用render
,不再需要导入loader
和HttpResponse
。不过如果还有其他函数(比如detail
、results
和vote
)需要用到的话,就需要保持HttpResponse
的导入。
🌊 5.5 抛出404错误
# polls/views.py
from django.http import HttpResponse, Http404
from django.shortcuts import render
from django.template import loader
from .models import Question
def detail(request, question_id):
try:
question = Question.objects.get(pk=question_id)
except Question.DoesNotExist:
raise Http404(\"Question does not exist\")
return render(request, \"polls/detail.html\", {\"question\": question})
开启Django
服务器,输入http://127.0.0.1:8000/polls/1/或http://127.0.0.1:8000/polls/100/进行查看。
一个快捷函数:get_object_or_404()
# polls/views.py
from django.http import HttpResponse, Http404
from django.shortcuts import render, get_object_or_404
from django.template import loader
from .models import Question
def detail(request, question_id):
question = get_object_or_404(Question, pk=question_id)
return render(request, \"polls/detail.html\", {\"question\": question})
六、取出模板中的硬编码URL
在polls/index.html
中,链接硬编码:
<li><a href=\"/polls/{{ question.id }}\">{{ question.question_text }}</a></li>
问题在于,硬编码和强耦合的链接,对于一个包含很多应用的项目来说,修改起来十分困难。然而,在polls.urls
的url()
函数中,通过name
参数为URL
定义了命名,可以使用{% url %}
标签代替它:
<li><a href=\"{% url \"detail\" question.id %}\">{{ question.question_text }}</a></li>
这个标签的工作方式是,在polls.urls
模块的URL
定义中寻找具有指定名字的条目。
如果想改变投票详情视图的URL
,比如想改成polls/specifics/12/
,不用在模板里修改任何东西(包括其他模板),只要在polls/urls.py
里稍微修改以下就可以:
path(\"specifics/<int:question_id>/\", views.detail, name=\"detail\")
七、为URL
添加命名空间
在一个真实的Django
项目中,可能会有五个、十个、二十个,甚至更多应用。Django
如何分辨重命名的URL
呢?
在根URLconf
中添加命名空间。在polls/urls.py
文件中稍作修改,加上app_name
设置命名空间:
# polls/urls.py
from django.urls import path
from . import views
app_name = \"polls\"
urlpatterns = [
path(\"\", views.index, name=\"index\"),
path(\"<int:question_id>/\", views.detail, name=\"detail\"),
path(\"<int:question_id>/results/\", views.results, name=\"results\"),
path(\"<int:question_id>/vote/\", views.vote, name=\"vote\"),
]
现在编辑polls/index.html
,修改:
<li><a href=\"{% url \'detail\' question.id %}\">{{ question.question_text }}</a></li>
修改为指向具有命名空间的详细视图:
<li><a href=\"{% url \'polls:detail\' question.id %}\">{{ question.question_text }}</a></li>
总结
本文简单介绍了Django
模板、自定义模板,以及模板和URL
之间的映射关系。
来源:https://www.cnblogs.com/CoderChaos/p/16444750.html
本站部分图文来源于网络,如有侵权请联系删除。