django基础学习

django框架

• URLs: 虽然可以通过单个功能来处理来自每个 URL 的请求，但是编写单独的视图函数来处理每个资源是更加可维护的。URL 映射器用于根据请求 URL 将 HTTP 请求重定向到相应的视图。URL 映射器还可以匹配出现在 URL 中的字符串或数字的特定模式，并将其作为数据传递给视图功能。
• View: 视图 是一个请求处理函数，它接收 HTTP 请求并返回 HTTP 响应。视图通过模型访问满足请求所需的数据，并将响应的格式委托给 模板。
• Models: 模型 是定义应用程序数据结构的 Python 对象，并提供在数据库中管理（添加，修改，删除）和查询记录的机制。
• Templates: 模板 是定义文件（例如 HTML 页面）的结构或布局的文本文件，用于表示实际内容的占位符。一个视图可以使用 HTML 模板，从数据填充它动态地创建一个 HTML 页面模型。可以使用模板来定义任何类型的文件的结构; 它不一定是 HTML！

urls.py将请求发送到正确的视图

URL 映射器通常存储在名为 urls.py 的文件中。在下面的示例中，mapper（urlpatterns）定义了特定 URL 模式 和相应视图函数之间的映射列表。如果接收到具有与指定模式匹配的 URL（例如 r’^$'，下面）的 HTTP 请求，则将调用 相关联的视图功能（例如 views.index）并传递请求。

from django.urls import path
urlpatterns = [
    path(r'^$', views.index),
    path(r'^([0-9]+)/$', views.best),
]

在Django中，捕获 URL 中的特定部分（也称为路径参数或标记）是通过在 URL 模式中使用尖括号<>来完成的。常见的捕获标记有：

• <int:pk>: 匹配一个整数，并将其作为pk参数传递给视图函数。
• <slug:slug_text>: 匹配一个字母、数字、连字符或下划线组成的字符串，并将其作为slug_text参数传递给视图函数。
• <str:my_string>: 匹配一个字符串，并将其作为my_string参数传递给视图函数。
• <path:my_path>: 匹配一个路径（包含多个部分的字符串），并将其作为my_path参数传递给视图函数。

from django.urls import path
from . import views

urlpatterns = [
    path('books/<int:pk>/', views.book_detail, name='book-detail'),
    path('authors/<slug:author_slug>/', views.author_detail, name='author-detail'),
]

在这个例子中，<int:pk>和<slug:author_slug>是捕获标记，分别匹配一个整数和一个slug格式的字符串，并将其作为pk和author_slug参数传递给相应的视图函数。

views.py处理请求

在Django中，views.py文件包含了处理请求的视图函数。这些视图函数负责接收请求，处理数据并返回HTTP响应。

一个基本的视图函数通常会接收一个HttpRequest对象作为参数，并返回一个HttpResponse对象作为响应。例如：

from django.http import HttpResponse

def my_view(request):
    # 处理请求的逻辑
    return HttpResponse("Hello, this is the response!")

在views.py中的视图函数可能包含以下逻辑：

1. 接收请求参数： 从request对象（Django中，request对象是通过框架自动提供的）中获取GET或POST参数、路径参数（如果有的话）等。
2. 处理业务逻辑： 执行与应用程序逻辑相关的操作，可能包括数据库查询、计算、验证等。
3. 生成响应： 创建一个HttpResponse对象或其他适当的响应类型，将结果返回给用户。
4. 返回响应： 将生成的响应返回给用户，响应可以是HTML页面、JSON数据、重定向或其他HTTP响应类型。

常用的方法

render()和HttpResponse都用于构建HTTP响应，但它们有一些不同之处：

• render(): 这是Django的一个辅助函数，它用于渲染模板并返回一个HTTP响应。render()接受request作为第一个参数，指定要渲染的模板名称作为第二个参数，还可以选择性地传递上下文参数。它会将模板和上下文数据合并，然后返回一个完整的HTTP响应对象。例如，你可以在视图中使用render()来渲染一个HTML模板：

  from django.shortcuts import render
  
  def my_view(request):
      # 一些数据处理...
      context = {'key': 'value'}
      return render(request, 'template_name.html', context)
  
  

• HttpResponse: 这是Django的HTTP响应类。你可以使用HttpResponse手动创建HTTP响应，为其指定内容、状态码和其他HTTP头。当你想要直接返回文本、JSON数据或其他非HTML响应时，可以使用HttpResponse。例如：

  from django.http import HttpResponse
  import json
  
  def my_json_view(request):
      data = {'key': 'value'}
      json_data = json.dumps(data)
      return HttpResponse(json_data, content_type='application/json')
  
  

models.py定义数据模型

Django Web 应用程序通过被称为模型的 Python 对象来管理和查询数据。模型定义存储数据的结构，包括字段类型 以及字段可能的最大值，默认值，选择列表选项，文档帮助文本，表单的标签文本等。模型的定义与底层数据库无关 -你可以选择其中一个作为项目设置的一部分。一旦你选择了要使用的数据库，你就不需要直接与之交谈 - 只需编写模型结构和其他代码，Django 可以处理与数据库通信的所有辛苦的工作。

创建 Django 中的模型涉及以下步骤：

1. 定义模型类： 在你的应用程序的 models.py 文件中定义模型类。每个模型类都是一个继承自 django.db.models.Model 的 Python 类。

2. 定义字段： 在模型类中定义字段，这些字段将成为数据库表中的列。Django 提供了许多不同类型的字段，例如 CharField、IntegerField、DateField 等，用于存储不同类型的数据。

3. 定义元数据（可选）： 你可以在模型类中定义一些元数据，例如数据库表名、排序方式等。

4. 创建迁移： 使用 Django 的管理工具创建迁移文件。迁移文件包含了数据库模式的变更，通过执行迁移文件，可以将这些变更应用到数据库中。

5. 应用迁移： 执行应用程序的迁移命令，将模型更改应用到数据库中。

   # 生成迁移文件
   python manage.py makemigrations
   # 应用迁移
   python manage.py migrate
   

根据models查询数据

在 Django 中，当你使用模型管理器方法进行查询时，Django 会根据你的查询转换为相应的 SQL 语句来执行数据库操作。以下是一些常见的查询方法以及对应的 SQL 查询：

1. 获取所有对象：

   all_books = Book.objects.all() # SELECT * FROM yourapp_book;
   

2. 根据条件过滤对象：

   filtered_books = Book.objects.filter(author='Author Name')
   # SELECT * FROM yourapp_book WHERE author = 'Author Name';
   

3. 获取单个对象：

   book = Book.objects.get(author='Author Name')
   # SELECT * FROM yourapp_book WHERE author = 'Author Name' LIMIT 1;
   book = Book.objects.get(pk=1)
   # SELECT * FROM yourapp_book WHERE id = 1 LIMIT 1;
   

4. 其他查询方法

   books = Book.objects.exclude(author='Author Name')
   # SELECT * FROM yourapp_book WHERE NOT (author = 'Author Name');
   
   books = Book.objects.order_by('title')
   # SELECT * FROM yourapp_book ORDER BY title ASC;
   

最后查询到的是对象实例

HTML模板呈现数据

HTML模板在Django中使用了特殊的模板语言，这些语言元素可以嵌入HTML中，实现动态的、基于数据的渲染。以下是HTML模板中常用的几个特殊语法：

1. 模板标签：使用 {% %} 包裹起来的代码块，用于执行逻辑操作，如循环、条件判断等。

   {% if condition %}
       ... some HTML code ...
   {% endif %}
   

2. 变量：使用 {{ }} 包裹起来的变量名，用于在模板中显示动态数据。

   <p>Book Title: {{ book.title }}</p>
   

3. 模板注释：使用 {# #} 包裹起来的注释，不会在最终的渲染结果中显示。

   {# This is a comment #}
   

4. 模板过滤器：使用 | 可以对变量进行过滤或操作。

   djangoCopy code
   {{ value|filter }}
   

5. 模板继承：使用 {% extends %} 和 {% block %} 可以实现模板之间的继承和覆盖。

   {% extends 'base.html' %}
   
   {% block content %}
       ... content specific to this template ...
   {% endblock %}
   

6. 模板标签库：使用 {% load %} 加载自定义的模板标签或过滤器库。

   djangoCopy code
   {% load custom_tags %}
   

这些特殊的模板语法允许在HTML模板中嵌入逻辑、变量和控制结构，使得Django的模板可以根据数据动态生成页面内容。

数据由视图传递到模板，模板提取数据进行渲染

Django项目结构

创建虚拟环境下载django

mkdir myproject
cd myproject
# 创建虚拟环境
python3 -m venv myenv
# Linux下激活虚拟环境
source myenv/bin/activate
# 退出虚拟环境
deactivate
# 安装django
pip3 install django -i https://pypi.tuna.tsinghua.edu.cn/simple

创建站点

# 创建新项目
django-admin startproject locallibrary

此时会创建如下文件夹结构

locallibrary/
    manage.py
    locallibrary/
        settings.py
        urls.py
        wsgi.py

manage.py 是 Django 项目的命令行工具，用于执行多种任务，包括但不限于：

1. 运行开发服务器：启动 Django 开发服务器以在本地运行项目。python3 manage.py runserver

2. 创建应用程序：通过 python manage.py startapp app_name 创建一个新的应用程序。

3. 执行数据库迁移：管理数据库模型变更并将其应用到数据库中。

   python3 manage.py makemigrations
   python3 manage.py migrate
   

4. 创建超级用户：创建可以登录 Django 后台管理界面的管理员账号。python manage.py createsuperuser

5. 收集静态文件：将静态文件（如 CSS、JavaScript 文件等）收集到一个位置，以便部署。python3 manage.py collectstatic

6. 运行单元测试：执行项目中定义的单元测试。python manage.py test

7. 查看 Django 命令列表：通过 python manage.py help 或 python manage.py 查看所有可用的 Django 命令列表。

locallibrary 项目的子文件夹是整个网站的进入点：

• settings.py 包含所有的网站设置。这是可以注册所有创建的应用的地方，也是静态文件，数据库配置的地方，等等。
• urls.py 定义了网站 url 到 view 的映射。虽然这里可以包含所有的 url，但是更常见的做法是把应用相关的 url 包含在相关应用中.
• wsgi.py 帮助 Django 应用和网络服务器间的通讯。你可以把这个当作模板。

创建应用

python3 manage.py startapp catalog

在此之后的文件夹结构如下：

locallibrary/
    manage.py
    locallibrary/
    catalog/
        admin.py
        apps.py
        models.py
        tests.py
        views.py
        __init__.py
        migrations/

其他一些说明：

• admin.py 文件中，你可以注册模型以便在 Django 自带的管理界面中对这些模型进行管理和操作。这个文件用于配置管理员后台可以访问和管理的模型。
• apps.py 文件的主要作用是提供关于应用程序的元数据信息，方便 Django 框架使用和展示。
• tests.py 是 Django 应用程序中用于编写测试的文件。在这个文件中，你可以编写各种测试来验证你的应用程序的不同部分，确保它们按预期运行。
• 一个migration文件夹，用来存储“migrations”——当你修改你的数据模型时，这个文件会自动升级你的数据库。
• _init_.py — 一个空文件，Django/Python 会将这个文件作为Python 包并允许你在项目的其他部分使用它。

settings.py项目设置

1. 注册应用

   INSTALLED_APPS = [
       'django.contrib.admin',
       'django.contrib.auth',
       'django.contrib.contenttypes',
       'django.contrib.sessions',
       'django.contrib.messages',
       'django.contrib.staticfiles',
       'your_app.apps.Your_appConfig',
   ]
   
   

2. 配置数据库

   默认使用SQLite

   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.sqlite3',
           'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
       }
   }
   

   使用Mysql

   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.mysql',
           'NAME': 'your_db_name',
           'USER': 'your_username',
           'PASSWORD': 'your_password',
           'HOST': 'localhost',
           'PORT': '',
       }
   }
   

   数据库之前的数据迁移

   python manage.py dumpdata > data.json # 导出SQLite数据
   python manage.py loaddata data.json # 导入数据到MySQL
   

3. 静态文件配置

   STATIC_URL = '/static/' #  定义静态文件的URL前缀。
   STATICFILES_DIRS = [BASE_DIR / "static"] # 指定了额外的静态文件目录
   STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles') #  在collectstatic命令运行后，用于收集所有静态文件的文件夹路径。
   STATICFILES_FINDERS # 定义了查找静态文件的方式
   

4. 模板配置

   TEMPLATES = [
       {
           'BACKEND': 'django.template.backends.django.DjangoTemplates',
           'DIRS': [
               '/path/to/your/templates',  # 指定额外的模板目录
           ],
           'APP_DIRS': True,  # 在应用程序的 templates 目录中查找模板
           # 其他设置...
       },
   ]
   

5. 其他配置

   TIME_ZONE = 'Asia/Shanghai' # 时区配置
   DEBUG = True # 这个会在 debug 日志里输出错误信息，而不是输入 HTTP 的返回码。在生产环境中，它应设置为 false，因为输出的错误信息会帮助想要攻击网站的人。
   

通用类别视图

Django提供了通用类视图来简化开发常见的 Web 功能，其中之一是通用类别视图。这些类别视图可用于快速构建常见的应用程序组件，如列表、详情页等。常见的通用类别视图包括：

1. ListView： 显示对象列表的视图，例如显示所有书籍或文章的列表。
2. DetailView： 展示单个对象详细信息的视图，例如书籍的详细信息或文章的内容。
3. CreateView： 用于创建新对象的视图，例如创建新书籍或新文章。
4. UpdateView： 用于更新现有对象的视图，例如编辑现有书籍或文章的视图。
5. DeleteView： 用于删除对象的视图，例如删除书籍或文章。

这些类别视图旨在减少代码量，通过约定俗成的命名和配置，提供了内置的处理逻辑。通过组合这些视图类和提供一些配置参数，你可以快速创建功能完善的视图。

常用参数

1. model： 指定视图所使用的模型类。
2. template_name： 指定用于渲染视图的模板名称。
3. context_object_name： 指定传递给模板的上下文变量的名称。
4. queryset： 自定义视图使用的查询集。
5. paginate_by： 对于 ListView，指定每页显示的对象数量。
6. get_context_data()： 可用于自定义向模板发送的上下文数据。

常用方法

1. get_queryset()： 可用于覆盖查询集以自定义视图的数据。
2. get_context_data()： 用于添加额外的上下文数据到模板渲染中。
3. get_object()： 用于获取单个对象实例。
4. form_valid()： 用于在表单提交成功后执行自定义逻辑。
5. get_success_url()： 用于在视图成功后重定向到的 URL。

from django.views.generic import ListView, DetailView
from .models import YourModel

class YourModelListView(ListView):
    model = YourModel
    template_name = 'your_template.html'

class YourModelDetailView(DetailView):
    model = YourModel
    template_name = 'your_template.html'

会话框架

会话是 Django（以及大多数 Internet）用于跟踪站点和特定浏览器之间“状态”的机制。

启动会话

INSTALLED_APPS = [
    ...
    'django.contrib.sessions',
    ....

MIDDLEWARE = [
    ...
    'django.contrib.sessions.middleware.SessionMiddleware',
    ....

使用会话

# Get a session value by its key (e.g. 'my_car'), raising a KeyError if the key is not present
my_car = request.session['my_car']

# Get a session value, setting a default if it is not present ('mini')
my_car = request.session.get('my_car', 'mini')

# Set a session value
request.session['my_car'] = 'mini'

# Delete a session value
del request.session['my_car']

# 假设你修改了会话数据中的一些内容
request.session['my_car']['wheels'] = 'new_wheels'

# 将会话标记为已修改
request.session.modified = True

如果你对会话数据做了更改，并希望这些更改被保存，你可以使用 modified 标志来手动告知 Django 会话已被修改。

身份验证视图

可以使用 Django 内置的身份验证视图类来实现这些功能。下面是示例代码：

from django.urls import path
from django.contrib.auth.views import (
    LoginView, LogoutView, PasswordChangeView, PasswordChangeDoneView,
    PasswordResetView, PasswordResetDoneView, PasswordResetConfirmView,
    PasswordResetCompleteView
)

urlpatterns = [
    path('accounts/login/', LoginView.as_view(), name='login'),
    path('accounts/logout/', LogoutView.as_view(), name='logout'),
    path('accounts/password_change/', PasswordChangeView.as_view(), name='password_change'),
    path('accounts/password_change/done/', PasswordChangeDoneView.as_view(), name='password_change_done'),
    path('accounts/password_reset/', PasswordResetView.as_view(), name='password_reset'),
    path('accounts/password_reset/done/', PasswordResetDoneView.as_view(), name='password_reset_done'),
    path('accounts/reset/<uidb64>/<token>/', PasswordResetConfirmView.as_view(), name='password_reset_confirm'),
    path('accounts/reset/done/', PasswordResetCompleteView.as_view(), name='password_reset_complete'),
    # 其他 URL 配置...
]

这些路径配置了与 Django 内置的身份验证视图相关的 URL，并将每个视图与其对应的名称关联起来。使用这些视图类，你可以快速地设置登录、注销、密码更改和密码重置等功能。

这些身份验证视图使用 Django 的模板引擎渲染模板。默认情况下，它们使用以下模板：

• registration/login.html 用于登录页面
• registration/logged_out.html 用于注销确认页面
• registration/password_change_form.html 用于密码更改表单页面
• registration/password_change_done.html 用于密码更改完成页面
• registration/password_reset_form.html 用于密码重置表单页面
• registration/password_reset_done.html 用于密码重置确认页面
• registration/password_reset_confirm.html 用于密码重置确认页面
• registration/password_reset_complete.html 用于密码重置完成页面

你可以自定义这些模板，或者通过指定额外的参数template_name来使用不同的模板文件：

# 例如，更改登录视图的模板：
path('accounts/login/', LoginView.as_view(template_name='myapp/custom_login.html'), name='login'),

这将告诉 Django 使用myapp/custom_login.html作为登录页面的模板。同样的方法可以应用于其他身份验证视图，以便你可以为每个视图选择不同的模板。

使用表单

ne.html` 用于密码更改完成页面

• registration/password_reset_form.html 用于密码重置表单页面
• registration/password_reset_done.html 用于密码重置确认页面
• registration/password_reset_confirm.html 用于密码重置确认页面
• registration/password_reset_complete.html 用于密码重置完成页面

你可以自定义这些模板，或者通过指定额外的参数template_name来使用不同的模板文件：

# 例如，更改登录视图的模板：
path('accounts/login/', LoginView.as_view(template_name='myapp/custom_login.html'), name='login'),

这将告诉 Django 使用myapp/custom_login.html作为登录页面的模板。同样的方法可以应用于其他身份验证视图，以便你可以为每个视图选择不同的模板。

使用表单

测试