from django.shortcuts import render --snip-- from .models import Topic, Entry from .forms import TopicForm, EntryForm --snip-- def edit_entry(request, entry_id): """编辑既有条目""" 1 entry = Entry.objects.get(id=entry_id) topic = entry.topic if request.method != 'POST': # 初次请求,使用当前条目填充表单 2 form = EntryForm(instance=entry) else: # POST提交的数据,对数据进行处理 3 form = EntryForm(instance=entry, data=request.POST) if form.is_valid(): 4 form.save() 5 return HttpResponseRedirect(reverse('learning_logs:topic', args=[topic.id])) context = {'entry': entry, 'topic': topic, 'form': form} return render(request, 'learning_logs/edit_entry.html', context)
我们首先需要导入模型Entry。在1处,我们获取用户要修改的条目对象,以及与该条目相 关联的主题。在请求方法为GET时将执行的if代码块中,我们使用实参instance=entry创建一个 EntryForm实例(见2)。这个实参让Django创建一个表单,并使用既有条目对象中的信息填充它。 用户将看到既有的数据,并能够编辑它们。
处理POST请求时,我们传递实参instance=entry和data=request.POST(见3),让Django根 据既有条目对象创建一个表单实例,并根据request.POST中的相关数据对其进行修改。然后,我 们检查表单是否有效,如果有效,就调用save(),且不指定任何实参(见4)。接下来,我们重 定向到显示条目所属主题的页面(见5),用户将在其中看到其编辑的条目的新版本。
3. 模板edit_entry
下面是模板edit_entry.html,它与模板new_entry.html类似:
edit_entry.html
{% extends "learning_logs/base.html" %} {% block content %} <p><a href="{% url 'learning_logs:topic' topic.id %}">{{ topic }}</a></p> <p>Edit entry:</p> 1 <form action="{% url 'learning_logs:edit_entry' entry.id %}" method='post'> {% csrf_token %} {{ form.as_p }} 2 <button name="submit">save changes</button> </form> {% endblock content %}
在1处,实参action将表单发回给函数edit_entry()进行处理。在标签{% url %}中,我们将 条目ID作为一个实参,让视图对象能够修改正确的条目对象。我们将提交按钮命名为save changes,以提醒用户:单击该按钮将保存所做的编辑,而不是创建一个新条目(见2)。
4. 链接到页面edit_entry
现在,在显示特定主题的页面中,需要给每个条目添加到页面edit_entry的链接:
topic.html
--snip-- {% for entry in entries %} <li> <p>{{ entry.date_added|date:'M d, Y H:i' }}</p> <p>{{ entry.text|linebreaks }}</p> <p> <a href="{% url 'learning_logs:edit_entry' entry.id %}">edit entry</a> </p> </li> --snip--
我们将编辑链接放在每个条目的日期和文本后面。在循环中,我们使用模板标签{% url %} 根据URL模式edit_entry和当前条目的ID属性(entry.id)来确定URL。链接文本为"edit entry", 它出现在页面中每个条目的后面。图19-3显示了包含这些链接时,显示特定主题的页面是什么 样的。
至此,“学习笔记”已具备了需要的大部分功能。用户可添加主题和条目,还可根据需要查 看任何一组条目。在下一节,我们将实现一个用户注册系统,让任何人都可向“学习笔记”申请 账户,并创建自己的主题和条目。
19.2 创建用户账户
在这一节,我们将建立一个用户注册和身份验证系统,让用户能够注册账户,进而登录和注销。我们将创建一个新的应用程序,其中包含与处理用户账户相关的所有功能。我们还将对模型 Topic稍做修改,让每个主题都归属于特定用户。
19.2.1 应用程序 users
我们首先使用命令startapp来创建一个名为users的应用程序:
(ll_env)learning_log$ python manage.py startapp users (ll_env)learning_log$ ls 1 db.sqlite3 learning_log learning_logs ll_env manage.py users (ll_env)learning_log$ ls users 2 admin.py __init__.py migrations models.py tests.py views.py
这个命令新建一个名为users的目录(见1),其结构与应用程序learning_logs相同(见2)。
1. 将应用程序users添加到settings.py中
在settings.py中,我们需要将这个新的应用程序添加到INSTALLED_APPS中,如下所示:
settings.py
--snip-- INSTALLED_APPS = ( --snip-- # 我的应用程序 'learning_logs', 'users', ) --snip--
这样,Django将把应用程序users包含到项目中。
2. 包含应用程序users的URL
接下来,我们需要修改项目根目录中的urls.py,使其包含我们将为应用程序users定义的URL:
urls.py
from django.conf.urls import include, url from django.contrib import admin urlpatterns = [ url(r'^admin/', include(admin.site.urls)), url(r'^users/', include('users.urls', namespace='users')), url(r'', include('learning_logs.urls', namespace='learning_logs')), ]
我们添加了一行代码,以包含应用程序users中的文件urls.py。这行代码与任何以单词users 打头的URL(如http://localhost:8000/users/login/)都匹配。我们还创建了命名空间'users',以便 将应用程序learning_logs的URL同应用程序users的URL区分开来。
19.2.2 登录页面
我们首先来实现登录页面的功能。为此,我们将使用Django提供的默认登录视图,因此URL 模式会稍有不同。在目录learning_log/users/中,新建一个名为urls.py的文件,并在其中添加如下 代码:
urls.py
"""为应用程序users定义URL模式""" from django.conf.urls import url 1 from django.contrib.auth.views import login from . import views urlpatterns = [ # 登录页面 2 url(r'^login/$', login, {'template_name': 'users/login.html'}, name='login'), ]
我们首先导入了默认视图login(见1)。登录页面的URL模式与URL http://localhost:8000/ users/login/匹配(见2)。这个URL中的单词users让Django在users/urls.py中查找,而单词login让 它将请求发送给Django默认视图login(请注意,视图实参为login,而不是views.login)。鉴于 我们没有编写自己的视图函数,我们传递了一个字典,告诉Django去哪里查找我们将编写的模板。 这个模板包含在应用程序users而不是learning_logs中。
1. 模板login.html
用户请求登录页面时,Django将使用其默认视图login,但我们依然需要为这个页面提供模 板。为此,在目录learning_log/users/中,创建一个名为templates的目录,并在其中创建一个名为 users的目录。以下是模板login.html,你应将其存储到目录learning_log/users/templates/users/中:
login.html
{% extends "learning_logs/base.html" %} {% block content %} 1 {% if form.errors %} <p>Your username and password didn't match. Please try again.</p> {% endif %} 2 <form method="post" action="{% url 'users:login' %}"> {% csrf_token %} 3 {{ form.as_p }} 4 <button name="submit">log in</button> 5 <input type="hidden" name="next" value="{% url 'learning_logs:index' %}" /> </form> {% endblock content %}
这个模板继承了base.html,旨在确保登录页面的外观与网站的其他页面相同。请注意,一个 应用程序中的模板可继承另一个应用程序中的模板。
如果表单的errors属性被设置,我们就显示一条错误消息(见1),指出输入的用户名—密码 对与数据库中存储的任何用户名—密码对都不匹配。
我们要让登录视图处理表单,因此将实参action设置为登录页面的URL(见2)。登录视图 将一个表单发送给模板,在模板中,我们显示这个表单(见3)并添加一个提交按钮(见4)。 在5处,我们包含了一个隐藏的表单元素——'next',其中的实参value告诉Django在用户成功登 录后将其重定向到什么地方——在这里是主页。
2. 链接到登录页面
下面在base.html中添加到登录页面的链接,让所有页面都包含它。用户已登录时,我们不想 显示这个链接,因此将它嵌套在一个{% if %}标签中:
base.html
<p> <a href="{% url 'learning_logs:index' %}">Learning Log</a> - <a href="{% url 'learning_logs:topics' %}">Topics</a> - 1 {% if user.is_authenticated %} 2 Hello, {{ user.username }}. {% else %} 3 <a href="{% url 'users:login' %}">log in</a> {% endif %} </p> {% block content %}{% endblock content %}
在Django身份验证系统中,每个模板都可使用变量user,这个变量有一个is_authenticated 属性:如果用户已登录,该属性将为True,否则为False。这让你能够向已通过身份验证的用户 显示一条消息,而向未通过身份验证的用户显示另一条消息。
在这里,我们向已登录的用户显示一条问候语(见1)。对于已通过身份验证的用户,还设 置了属性username,我们使用这个属性来个性化问候语,让用户知道他已登录(见2)。在3处, 对于还未通过身份验证的用户,我们再显示一个到登录页面的链接。
3. 使用登录页面
前面建立了一个用户账户,下面来登录一下,看看登录页面是否管用。请访问 http://localhost:8000/admin/,如果你依然是以管理员的身份登录的,请在页眉上找到注销链接并 单击它。
注销后,访问http://localhost:8000/users/login/,你将看到类似于图19-4所示的登录页面。输入 你在前面设置的用户名和密码,将进入页面index。。在这个主页的页眉中,显示了一条个性化问 候语,其中包含你的用户名。