Python编程从入门到实践:Web应用程序 - 用户账户

开发系统和开发IDE

开发系统: Ubuntu 16.0.4 LTS
开发IDE: Visual Studio Code 版本: 1.32.3
Python版本: Python3
依赖: Django 2.2

资料《Python编程从入门到实践》书籍

链接:https://pan.baidu.com/s/1USkqvL2dLU3Q9XplVaGQJg
提取码:zoyc

GitHub:

https://github.com/lichangke/Python3_Project/tree/master/learning_log

Web应用程序 - Django入门

https://www.jianshu.com/p/b3267d16c245

2. 用户账户

Web应用程序的核心是让任何用户都能够注册账户并能够使用它。将创建一些表单, 让用户能够添加主题和条目, 以及编辑既有的条目。

然后, 将实现一个用户身份验证系统。 你将创建一个注册页面, 供用户创建账户, 并让有些页面只能供已登录的用户访问。 接下来, 将修改一些视图函数,使得用户只能看到自己的数据。

2.1 让用户能够输入数据

阶段代码:GitHub learning_log_2.1_让用户能够输入数据

不包括虚拟环境ll_env文件夹下文件

建立用于创建用户账户的身份验证系统之前, 先来添加几个页面, 让用户能够输入数据。 将让用户能够添加新主题、 添加新条目以及编辑既有条目。

2.1.1 添加新主题

urls -> views -> html

首先来让用户能够添加新主题。 创建基于表单的页面的方法几乎与前面创建网页一样: 定义一个URL, 编写一个视图函数并编写一个模板。 一个主要差别是, 需要导入包含表单的模块forms.py。

1. 用于添加主题的表单
让用户输入并提交信息的页面都是表单, 那怕它看起来不像表单。 用户输入信息时, 需要进行验证, 确认提供的信息是正确的数据类型。然后, 再对这些有效信息进行处理, 并将其保存到数据库的合适地方。 这些工作很多都是由Django自动完成的。

创建一个名为forms.py的文件, 将其存储到models.py所在的目录中

models.py

from django import forms
from .models import Topic

# 让用户输入并提交信息的页面都是表单, 那怕它看起来不像表单。
# 创建表单的最简单方式是使用ModelForm, 它根据在模型中的信息自动创建表单。
class TopicForm(forms.ModelForm): # 定义了一个名为TopicForm 的类, 它继承了forms.ModelForm 。
    class Meta:
        model = Topic # 根据模型Topic 创建一个表单
        fields = ['text'] # 该表单只包含字段text 
        labels = {'text': ''} # 让Django不要为字段text 生成标签。

2. URL模式new_topic
这个新网页的URL应简短而具有描述性, 因此当用户要添加新主题时, 将切换到http://localhost:8000/new_topic/。 下面是网页new_topic 的URL模式, 将其添加到learning_logs/urls.py中:

urls.py

--snip--
urlpatterns = [
    --snip--
    # 用于添加新主题的网页
    url(r'^new_topic/$', views.new_topic, name='new_topic'),
]

这个URL模式将请求交给视图函数new_topic() , 接下来将编写这个函数。

3. 视图函数new_topic()
函数new_topic() 需要处理两种情形: 刚进入new_topic 网页(在这种情况下, 它应显示一个空表单) ; 对提交的表单数据进行处理, 并将用户重定向到网页topics

views.py

from django.shortcuts import render
from django.http import HttpResponseRedirect
from .models import Topic
from .forms import TopicForm
from django.urls import reverse
# from django.core.urlresolvers import reverse
'''
https://stackoverflow.com/questions/43139081/importerror-no-module-named-django-core-urlresolvers
Django 2.0 removes the django.core.urlresolvers module, which was moved to django.urls in version 1.10.
You should change any import to use django.urls instead, like this:
from django.urls import reverse
'''
--snip--
# 函数new_topic() 需要处理两种情形: 刚进入new_topic 网页(在这种情况下, 它应显示一个空表单) ; 对提交的表单数据进行处理, 并将用户重定向到网页topics
def new_topic(request):
    """添加新主题"""
    if request.method != 'POST':
        # 未提交数据: 创建一个新表单
        form = TopicForm()  # 如果请求方法不是POST, 请求就可能是GET, 因此我们需要返回一个空表单
    else:
        if form.is_valid(): # 必须先通过检查确定它们是有效的
            form.save() # 表单中的数据写入数据库
            # 函数reverse() 根据指定的URL模型确定URL, 这意味着Django将在页面被请求时生成URL。 
            # 调用HttpResponseRedirect() 将用户重定向到显示新增条目所属主题的页面
            return HttpResponseRedirect(reverse('learning_logs:topics'))
    context = {'form': form}
    return render(request, 'learning_logs/new_topic.html', context)
    '''
    创建Web应用程序时, 将用到的两种主要请求类型是GET请求和POST请求。 对于只是从服务器读取数据的页面, 使用GET请求; 在用户需要通过表单提交信息时, 通常使用POST
    请求。 处理所有表单时, 我们都将指定使用POST方法。 还有一些其他类型的请求, 但这个项目没有使用。
    函数new_topic() 将请求对象作为参数。 用户初次请求该网页时, 其浏览器将发送GET请求; 用户填写并提交表单时, 其浏览器将发送POST请求。 根据请求的类型, 我们可以
    确定用户请求的是空表单(GET请求) 还是要求对填写好的表单进行处理(POST请求) 。
    '''

4. 模板new_topic
创建新模板new_topic.html, 用于显示刚创建的表单

new_topic.html

{% extends "learning_logs/base.html" %}
{% block content %}

Add a new topic:

{% csrf_token %} {{ form.as_p }}
{% endblock content %}

5. 链接到页面new_topic
在页面topics 中添加一个到页面new_topic 的链接:
topics.html

{% extends "learning_logs/base.html" %}
{% block content %}

Topics

    {% for topic in topics %}
  • {{ topic }}
  • {% empty %}
  • No topics have been added yet.
  • {% endfor %}
Add a new topic: {% endblock content %}

链接放在了既有主题列表的后面。 下图显示了生成的表单。

Python编程从入门到实践:Web应用程序 - 用户账户_第1张图片
2.1.1 add new topic.png

2.1.2 添加新条目

urls -> views -> html 添加网页步骤

用户可以添加新主题了, 但他们还想添加新条目。 将再次定义URL, 编写视图函数和模板, 并链接到添加新条目的网页。 但在此之前, 需要在forms.py中再添加一个类。

1. 用于添加新条目的表单
创建一个与模型Entry 相关联的表单

forms.py

from django import forms
from .models import Topic, Entry
class TopicForm(forms.ModelForm):
--snip--
class EntryForm(forms.ModelForm):
    class Meta:
        model = Entry
        fields = ['text']
        labels = {'text': ''}
        widgets = {'text': forms.Textarea(attrs={'cols': 80})}
        '''
        定义了属性widgets 。 小部件 (widget) 是一个HTML表单元素, 如单行文本框、 多行文本区域或下拉列表。 通过设置属性widgets , 可覆盖Django选择的默认小
        部件。 通过让Django使用forms.Textarea , 我们定制了字段'text' 的输入小部件, 将文本区域的宽度设置为80列, 而不是默认的40列。 这给用户提供了足够的空间, 可以
        编写有意义的条目。
        '''

2. URL模式new_entry
添加新条目的页面的URL模式中, 需要包含实参topic_id , 因为条目必须与特定的主题相关联。 该URL模式如下, 将它添加到了learning_logs/urls.py中

urls.py

--snip--
urlpatterns = [
    --snip--
    # 用于添加新条目的页面
    re_path(r'^new_entry/(?P\d+)/$', views.new_entry, name='new_entry'),
]

3. 视图函数new_entry()

views.py

--snip--
from .models import Topic
from .forms import TopicForm,EntryForm
from django.urls import reverse
--snip--

def new_entry(request, topic_id):
    """在特定的主题中添加新条目"""
    topic = Topic.objects.get(id=topic_id)
    if request.method != 'POST':
        # 未提交数据,创建一个空表单
        form = EntryForm()
    else:
        # POST提交的数据,对数据进行处理
        form = EntryForm(data=request.POST)
        if form.is_valid(): 
            # 调用save() 时, 传递了实参commit=False , 让Django创建一个新的条目对象, 并将其存储到new_entry 中, 但不将它保存到数据库中。
            new_entry = form.save(commit=False)
            new_entry.topic = topic # 将new_entry的属性topic 设置为在这个函数开头从数据库中获取的主题
            new_entry.save()    # 调用save() , 且不指定任何实参。 这将把条目保存到数据库, 并将其与正确的主题相关联。
            return HttpResponseRedirect(reverse('learning_logs:topic',args=[topic_id]))
    context = {'topic': topic, 'form': form}
    return render(request, 'learning_logs/new_entry.html', context)

4. 模板new_entry

new_entry.html

{% extends "learning_logs/base.html" %}
{% block content %}

{{ topic }}

Add a new entry:

{% csrf_token %} {{ form.as_p }}
{% endblock content %}

5. 链接到页面new_entry
在显示特定主题的页面中添加到页面new_entry 的链接

topic.html

{% extends 'learning_logs/base.html' %}
{% block content %}

Topic: {{ topic }}

Entries:

add new entry

    --snip—
{% endblock content %}

下图显示了页面new_entry

Python编程从入门到实践:Web应用程序 - 用户账户_第2张图片
2.1.2 new_entry.png

2.1.3 编辑条目

urls -> views -> html 添加网页步骤

创建一个页面, 让用户能够编辑既有的条目。
1. URL模式edit_entry
这个页面的URL需要传递要编辑的条目的ID。 修改后的learning_logs/urls.py如下

urls.py

--snip--
# https://docs.djangoproject.com/en/2.2/ref/urls/#module-django.urls.conf
urlpatterns = [
    # 主页
    path('', views.index, name='index'),    # Django将在文件views.py中查找函数index()

    # 显示所有的主题
    path('topics/',views.topics,name = 'topics'),

    # 特定主题的详细页面
    # use a regular expression, you can use re_path(). https://stackoverflow.com/questions/47661536/django-2-0-path-error-2-0-w001-has-a-route-that-contains-p-begins-wit
    re_path(r'^topics/(?P\d+)/$', views.topic, name='topic'), # ?P 将匹配的值存储到topic_id 中; 而表达式\d+ 与包含在两个斜杆内的任何数字都匹配, 不管这个数字为多少位。

    # 用于添加新主题的网页    
    path('new_topic/', views.new_topic, name = 'new_topic'),

    # 用于添加新条目的页面
    re_path(r'^new_entry/(?P\d+)/$', views.new_entry, name='new_entry'),

    # 用于编辑条目的页面
    re_path(r'^edit_entry/(?P\d+)/$',views.edit_entry,name='edit_entry')
]

在URL(如http://localhost:8000/edit_entry/1/) 中传递的ID存储在形参entry_id 中。 这个URL模式将预期匹配的请求发送给视图函数edit_entry()

2. 视图函数edit_entry()

页面edit_entry 收到GET请求时, edit_entry() 将返回一个表单, 让用户能够对条目进行编辑。 该页面收到POST请求(条目文本经过修订) 时, 它将修改后的文本保存到数据库中:

views.py

--snip--
from .models import Topic, Entry
from .forms import TopicForm, EntryForm
--snip--
def edit_entry(request, entry_id):
    """编辑既有条目"""
    entry = Entry.objects.get(id=entry_id)
    topic = entry.topic

    if request.method != 'POST':
        # 初次请求, 使用当前条目填充表单
        form = EntryForm(instance=entry)
    else:
        # POST提交的数据, 对数据进行处理
        # 让Django根据既有条目对象创建一个表单实例, 并根据request.POST 中的相关数据对其进行修改
        form = EntryForm(instance=entry, data=request.POST)
        if form.is_valid():
            form.save()
            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)

3. 模板edit_entry
edit_entry.html

{% extends "learning_logs/base.html" %}
{% block content %}

{{ topic }}

Edit entry:

{% csrf_token %} {{ form.as_p }}
{% endblock content %}

4. 链接到页面edit_entry

在显示特定主题的页面中, 需要给每个条目添加到页面edit_entry 的链接:

topic.html

--snip--
{% for entry in entries %}
    
  • {{ entry.date_added|date:'M d, Y H:i' }}

    {{ entry.text|linebreaks }}

    edit entry

  • --snip--

    下图显示了包含这些链接时, 显示特定主题的页面是什么样的


    Python编程从入门到实践:Web应用程序 - 用户账户_第3张图片
    2.1.3 edit entry.png

    2.2 创建用户账户

    阶段代码:GitHub learning_log_2.2_创建用户账户

    不包括虚拟环境ll_env文件夹下文件

    将建立一个用户注册和身份验证系统, 让用户能够注册账户, 进而登录和注销。 将创建一个新的应用程序, 其中包含与处理用户账户相关的所有功能。 还将对模型Topic 稍做修改, 让每个主题都归属于特定用户。

    2.2.1 应用程序users

    步骤:

    startapp创建应用程序 -> 将应用程序添加到settings.py -> 包含应用程序users 的URL

    先使用命令startapp 来创建一个名为users 的应用程序

    python manage.py startapp users

    Python编程从入门到实践:Web应用程序 - 用户账户_第4张图片
    2.2.1 startapp.png

    1. 将应用程序users 添加到settings.py中

    在settings.py中, 我们需要将这个新的应用程序添加到INSTALLED_APPS 中

    settings.py

    --snip--
    INSTALLED_APPS = (
    --snip--
    # 我的应用程序
    'learning_logs',
    'users',
    )-
    -snip
    

    2. 包含应用程序users 的URL

    需要修改项目根目录中的urls.py, 使其包含为应用程序users 定义的URL:

    urls.py

    from django.contrib import admin
    from django.urls import path, include
    
    urlpatterns = [
        path('admin/', admin.site.urls),# 该模块定义了可在管理网站中请求的所有URL
        path('', include('learning_logs.urls', namespace='learning_logs')), 
        # 代码包含实参namespace , 让我们能够将learning_logs 的URL同项目中的其他URL区分开来
        path('users/',include('users.urls', namespace='users')), # 这行代码与任何以单词users打头的URL(如http://localhost:8000/users/login/) 都匹配
    ]
    

    2.2.2 登录页面

    首先来实现登录页面的功能。 为此, 将使用Django提供的默认登录视图, 因此URL模式会稍有不同。 在目录learning_log/users/中, 新建一个名为urls.py的文件, 并在其中添加如下代码:

    urls.py

    """为应用程序users定义URL模式"""
    
    # 非 from django.conf.urls import url
    from django.urls import path,re_path
    from django.contrib.auth.views import LoginView
    # from django.contrib.auth.views import login  In django-2.1, the old function-based views have been removed,
    
    from . import views
    
    app_name= 'users'# 不能少
    
    urlpatterns = [
        # 登录页面
        # re_path(r'^login/$', login, {'template_name': 'users/login.html'},name='login'),
        re_path(r'^login/$',LoginView.as_view(template_name='users/login.html'),name='login')
    ]
    

    注意 注释部分为原书中代码,Django版本不同需使用新的方式。app_name= 'users'# 不能少

    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 %}
    
    {% if form.errors %}
    

    Your username and password didn't match. Please try again.

    {% endif %}
    {% csrf_token %} {{ form.as_p }}
    {% endblock content %}

    2. 链接到登录页面

    在base.html中添加到登录页面的链接, 让所有页面都包含它。 用户已登录时, 我们不想显示这个链接, 因此将它嵌套在一个{% if %} 标签中

    base.html

    Learning Log - Topics {% if user.is_authenticated %} Hello, {{ user.username }}. {% else %} log in {% endif %}

    {% block content %}{% endblock content %}

    3. 使用登录页面
    前面建立了一个用户账户, 下面来登录一下, 看看登录页面是否管用。 请访问http://localhost:8000/admin/, 如果你依然是以管理员的身份登录的, 请在页眉上找到注销链接并单击它。

    访问http://localhost:8000/users/login/, 你将看到类似于下图所示的登录页面。

    Python编程从入门到实践:Web应用程序 - 用户账户_第5张图片
    2.2.2 login.png

    2.2.3 注销

    需要提供一个让用户注销的途径。 我们不创建用于注销的页面, 而让用户只需单击一个链接就能注销并返回到主页。 为此, 将为注销链接定义一个URL模式, 编写一个视图函数, 并在base.html中添加一个注销链接

    1. 注销URL
    下面的代码为注销定义了URL模式, 该模式与URL http://locallwst:8000/users/logout/匹配。 修改后的users/urls.py如下

    urls.py

    --snip--
    urlpatterns = [
        # 登录页面
        # re_path(r'^login/$', login, {'template_name': 'users/login.html'},name='login'),
        re_path(r'^login/$',LoginView.as_view(template_name='users/login.html'),name='login'),
        # 注销
        re_path(r'^logout/$', views.logout_view, name='logout'),
    ]
    


    个URL模式将请求发送给函数logout_view() 。 这样给这个函数命名, 旨在将其与我们将在其中调用的函数logout() 区分开来(请确保你修改的是users/urls.py, 而不是learning_log/ urls.py) 。

    2. 视图函数logout_view()

    函数logout_view() 很简单: 只是导入Django函数logout() , 并调用它, 再重定向到主页。 请打开users/views.py, 并输入下面的代码

    views.py

    from django.shortcuts import render
    from django.http import HttpResponseRedirect
    from django.urls import reverse
    from django.contrib.auth import logout
    
    # Create your views here.
    def logout_view(request):
        """注销用户"""
        logout(request)
        return HttpResponseRedirect(reverse('learning_logs:index'))
    

    3. 链接到注销视图

    需要添加一个注销链接。 我们在base.html中添加这种链接, 让每个页面都包含它; 将它放在标签{% if user.is_authenticated %} 中, 使得仅当用户登录后才能看到它:

    base.html

    --snip--
        {% if user.is_authenticated %}
        Hello, {{ user.username }}.
        log out
        {% else %}
        log in
        {% endif %}
    --snip--
    

    下图显示了用户登录后看到的主页

    Python编程从入门到实践:Web应用程序 - 用户账户_第6张图片
    2.2.3 logout.png

    2.2.4 注册页面

    下面来创建一个让新用户能够注册的页面。 将使用Django提供的表单UserCreationForm , 但编写自己的视图函数和模板。

    1. 注册页面的URL模式

    下面的代码定义了注册页面的URL模式, 它也包含在users/urls.py中

    urls.py

    --snip--
    urlpatterns = [
        # 登录页面
        --snip--
        # 注册页面
        re_path(r'^register/$', views.register, name='register'), # 与URL http://localhost:8000/users/register/匹配, 并将请求发送给我们即将编写的函数register()
    ]
    

    这个模式与URL http://localhost:8000/users/register/匹配, 并将请求发送给我们即将编写的函数register() 。

    2. 视图函数register()

    在注册页面首次被请求时, 视图函数register() 需要显示一个空的注册表单, 并在用户提交填写好的注册表单时对其进行处理。 如果注册成功, 这个函数还需让用户自动登录。 请在users/views.py中添加如下代码

    views.py

    from django.shortcuts import render
    from django.http import HttpResponseRedirect
    from django.urls import reverse
    from django.contrib.auth import login,logout,authenticate
    from django.contrib.auth.forms import UserCreationForm
    
    
    # Create your views here.
    def logout_view(request):
        --snip--
    def register(request):
        """注册新用户"""
        if request.method != 'POST':
            # 显示空的注册表单
            form = UserCreationForm()
        else:
            # 处理填写好的表单   
            form = UserCreationForm(data=request.POST)
            if form.is_valid():
                new_user = form.save()
                # 让用户自动登录, 再重定向到主页
                authenticated_user = authenticate(username=new_user.username,password=request.POST['password1'])
                login(request, authenticated_user)
                return HttpResponseRedirect(reverse('learning_logs:index'))
    
        context = {'form': form} 
        return render(request, 'users/register.html', context)   
    

    3. 注册模板

    注册页面的模板与登录页面的模板类似, 请务必将其保存到login.html所在的目录中

    register.html

    {% extends "learning_logs/base.html" %}
    {% block content %}
    
    {% csrf_token %} {{ form.as_p }}
    {% endblock content %}

    使用了方法as_p , 让Django在表单中正确地显示所有的字段, 包括错误消息——如果用户没有正确地填写表单。

    4. 链接到注册页面

    添加这样的代码, 即在用户没有登录时显示到注册页面的链接

    base.html

    --snip--
        {% if user.is_authenticated %}
        Hello, {{ user.username }}.
        log out
        {% else %}
        register -
        log in
        {% endif %}
    --snip--
    

    如下图所示


    Python编程从入门到实践:Web应用程序 - 用户账户_第7张图片
    2.2.4 register.png

    2.3 让用户拥有自己的数据

    阶段代码:GitHub learning_log_2.3_让用户拥有自己的数据

    不包括虚拟环境ll_env文件夹下文件

    用户应该能够输入其专有的数据, 因此将创建一个系统, 确定各项数据所属的用户, 再限制对页面的访问, 让用户只能使用自己的数据

    将修改模型Topic , 让每个主题都归属于特定用户。 这也将影响条目, 因为每个条目都属于特定的主题。 先来限制对一些页面的访问。

    2.3.1 使用@login_required 限制访问

    Django提供了装饰器@login_required , 让你能够轻松地实现这样的目标: 对于某些页面, 只允许已登录的用户访问它们。 装饰器 (decorator) 是放在函数定义前面的指令, Python在函数运行前, 根据它来修改函数代码的行为。

    1. 限制对topics 页面的访问

    每个主题都归特定用户所有, 因此应只允许已登录的用户请求topics 页面。 为此, 在learning_logs/views.py中添加如下代码

    views.py

    --snip--
    from django.contrib.auth.decorators import login_required
    --snip--
    #Django提供了装饰器@login_required , 让你能够轻松地实现这样的目标: 对于某些页面, 只允许已登录的用户访问它们
    @login_required  
    def topics(request):
        """显示所有的主题"""
    --snip--
    

    导入了函数login_required() 。 我们将login_required() 作为装饰器用于视图函数topics() ——在它前面加上符号@ 和login_required , 让Python在运行topics() 的代码前先运行login_required() 的代码。

    login_required() 的代码检查用户是否已登录, 仅当用户已登录时, Django才运行topics() 的代码。 如果用户未登录, 就重定向到登录页面。

    为实现这种重定向, 需要修改settings.py, 让Django知道到哪里去查找登录页面。 请在settings.py末尾添加如下代码

    settings.py

    
    --snip--
    # 我的设置
    LOGIN_URL = '/users/login/'
    

    如果未登录的用户请求装饰器@login_required 的保护页面, Django将重定向到settings.py中的LOGIN_URL 指定的URL

    2. 全面限制对项目“学习笔记”的访问

    Django让你能够轻松地限制对页面的访问, 但你必须针对要保护哪些页面做出决定。 最好先确定项目的哪些页面不需要保护, 再限制对其他所有页面的访问。 可以轻松地修改过于严格的访问限制, 其风险比不限制对敏感页面的访问更低。

    在项目“学习笔记”中, 将不限制对主页、 注册页面和注销页面的访问, 并限制对其他所有页面的访问。

    在下面的learning_logs/views.py中, 对除index() 外的每个视图都应用了装饰器@login_required

    views.py

    --snip--
    @login_required
    def topics(request):
    --snip--
    @login_required
    def topic(request, topic_id):
    --snip--
    @login_required
    def new_topic(request):
    --snip--
    @login_required
    def new_entry(request, topic_id):
    --snip--
    @login_required
    def edit_entry(request, entry_id):
    --snip
    

    2.3.2 将数据关联到用户

    需要将数据关联到提交它们的用户。 我们只需将最高层的数据关联到用户, 这样更低层的数据将自动关联到用户。 例如, 在项目“学习笔记”中, 应用程序的最高层数据是主题, 而所有条目都与特定主题相关联。 只要每个主题都归属于特定用户, 我们就能确定数据库中每个条目的所有者。

    修改模型Topic , 在其中添加一个关联到用户的外键。 这样做后, 我们必须对数据库进行迁移。 最后, 我们必须对有些视图进行修改, 使其只显示与当前登录的用户相关
    联的数据

    1. 修改模型Topic

    对models.py的修改只涉及两行代码:

    models.py

    from django.db import models
    from django.contrib.auth.models import User
    class Topic(models.Model):
        ''' 用户学习的主题'''
        # https://docs.djangoproject.com/en/2.2/ref/models/fields/#charfield
        text = models.CharField(max_length = 200) # 属性text是一个CharField——由字符或文本组成的数据
        # https://docs.djangoproject.com/en/2.2/ref/models/fields/#datetimefield
        date_added = models.DateTimeField(auto_now_add=True) # 实参auto_add_now=True 让Django将这个属性自动设置成当前日期和时间。
        owner = models.ForeignKey(User,on_delete=models.CASCADE) # 
        def __str__(self):
            """返回模型的字符串表示"""
            return self.text
    
    class Entry(models.Model):
        --snip--
    

    2. 确定当前有哪些用户
    迁移数据库时, Django将对数据库进行修改, 使其能够存储主题和用户之间的关联。 为执行迁移, Django需要知道该将各个既有主题关联到哪个用户。 最简单的办法是, 将既有主题都关联到同一个用户, 如超级用户。 为此, 我们需要知道该用户的ID。

    查看已创建的所有用户的ID。 为此, 启动一个Django shell会话, 并执行如下命令:

    python manage.py shell

    Python编程从入门到实践:Web应用程序 - 用户账户_第8张图片
    2.3.2 shell.png

    3. 迁移数据库
    知道用户ID后, 就可以迁移数据库了

    python manage.py makemigrations learning_logs

    Python编程从入门到实践:Web应用程序 - 用户账户_第9张图片
    2.3.2 makemigrations .png

    为将所有既有主题都关联到管理用户ll_admin, 我输入了用户ID值2。并非必须使用超级用户, 而可使用已创建的任何用户的ID。 接下来, Django使用这个值来迁移数据库, 并生成了迁移文件0003_topic_owner.py, 它在模型Topic 中添加字段owner 。

    现在可以执行迁移了。 为此, 在活动的虚拟环境中执行下面的命令

    python manage.py migrate

    Python编程从入门到实践:Web应用程序 - 用户账户_第10张图片
    2.3.2 migrate.png

    为验证迁移符合预期, 可在shell会话中像下面这样做:

    Python编程从入门到实践:Web应用程序 - 用户账户_第11张图片
    2.3.2 shell.png

    2.3.3 只允许用户访问自己的主题

    当前, 不管你以哪个用户的身份登录, 都能够看到所有的主题。 改变这种情况, 只向用户显示属于自己的主题

    在views.py中, 对函数topics() 做如下修改

    views.py

    --snip--
     # Django提供了装饰器@login_required , 让你能够轻松地实现这样的目标: 对于某些页面, 只允许已登录的用户访问它们
    @login_required
    def topics(request):
        """显示所有的主题"""
        # topics = Topic.objects.order_by('date_added') # 查询数据库——请求提供Topic 对象, 并按属性date_added 对它们进行排序
        topics = Topic.objects.filter(owner=request.user).order_by('date_added')
        context = {'topics': topics} # 一个将要发送给模板的上下文。 上下文是一个字典, 其中的键是我们将在模板中用来访问数据的名称, 而值是我们要发送给模板的数据。 
        return render(request, 'learning_logs/topics.html', context)
    --snip--
    

    要查看结果, 以所有既有主题关联到的用户的身份登录, 并访问topics页面, 你将看到所有的主题。 然后, 注销并以另一个用户的身份登录, topics页面将不会列出任何主题。

    2.3.4 保护用户的主题

    还没有限制对显示单个主题的页面的访问, 因此任何已登录的用户都可输入类似于http://localhost:8000/topics/1/的URL, 来访问显示相应主题的页面

    为修复这种问题, 我们在视图函数topic() 获取请求的条目前执行检查:

    views.py

    --snip--
    from django.http import HttpResponseRedirect, Http404
    --snip--
    @login_required
    def topic(request, topic_id):
        """显示单个主题及其所有的条目"""
        topic = Topic.objects.get(id=topic_id)
        # 确认请求的主题属于当前用户
        if topic.owner != request.user:
            raise Http404
        entries = topic.entry_set.order_by('-date_added')
        context = {'topic': topic, 'entries': entries}
        return render(request, 'learning_logs/topic.html', context)
    --snip--
    

    导入了异常Http404,并在用户请求它不能查看的主题时引发这个异常

    Python编程从入门到实践:Web应用程序 - 用户账户_第12张图片
    2.3.4 Http404.png

    2.3.5 保护页面edit_entry

    页面edit_entry 的URL为http://localhost:8000/edit_entry/entry_id / , 其中 entry_id 是一个数字。 下面来保护这个页面, 禁止用户通过输入类似于前面的URL来访问其他用户的条目

    views.py

    --snip--
    @login_required
    def edit_entry(request, entry_id):
        """编辑既有条目"""
        entry = Entry.objects.get(id=entry_id)
        topic = entry.topic
    
        if topic.owner != request.user: # 保护页面edit_entry
            raise Http404
    
        if request.method != 'POST':
            # 初次请求, 使用当前条目填充表单
            form = EntryForm(instance=entry)
        else:
            # POST提交的数据, 对数据进行处理
            # 让Django根据既有条目对象创建一个表单实例, 并根据request.POST 中的相关数据对其进行修改
            form = EntryForm(instance=entry, data=request.POST)
            if form.is_valid():
                form.save()
                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)
    

    获取指定的条目以及与之相关联的主题, 然后检查主题的所有者是否是当前登录的用户, 如果不是, 就引发Http404 异常

    2.3.6 将新主题关联到当前用户

    当前, 用于添加新主题的页面存在问题, 因此它没有将新主题关联到特定用户。 如果你尝试添加新主题, 将看到错误消息IntegrityError , 指出learning_logs_topic.user_id 不能为NULL 。 Django的意思是说, 创建新主题时, 你必须指定其owner 字段的值。

    可以通过request 对象获悉当前用户, 因此存在一个修复这种问题的简单方案。 请添加下面的代码, 将新主题关联到当前用户:

    views.py

    --snip--
    @login_required
    def new_topic(request):
        """添加新主题"""
        if request.method != 'POST':
            # 未提交数据: 创建一个新表单
            form = TopicForm()  # 如果请求方法不是POST, 请求就可能是GET, 因此我们需要返回一个空表单
        else:
            '''
            if form.is_valid(): # 必须先通过检查确定它们是有效的
                form.save() # 表单中的数据写入数据库
                # 函数reverse() 根据指定的URL模型确定URL, 这意味着Django将在页面被请求时生成URL。 
                # 调用HttpResponseRedirect() 将用户重定向到显示新增条目所属主题的页面
                return HttpResponseRedirect(reverse('learning_logs:topics'))
            '''
            if form.is_valid(): # 将新主题关联到当前用户
                new_topic = form.save(commit=False)
                new_topic.owner = request.user
                new_topic.save()
                return HttpResponseRedirect(reverse('learning_logs:topics'))
        context = {'form': form}
        return render(request, 'learning_logs/new_topic.html', context)
    --snip--
    

    现在, 这个项目允许任何用户注册, 而每个用户想添加多少新主题都可以。 每个用户都只能访问自己的数据, 无论是查看数据、 输入新数据还是修改旧数据时都如此。


    GitHub链接:
    https://github.com/lichangke/LeetCode
    知乎个人首页:
    https://www.zhihu.com/people/lichangke/
    个人首页:
    https://www.jianshu.com/u/3e95c7555dc7
    个人Blog:
    https://lichangke.github.io/
    欢迎大家来一起交流学习

    你可能感兴趣的:(Python编程从入门到实践:Web应用程序 - 用户账户)