零基础，直接上手 Django

已于 2023-07-10 11:07:04 修改
阅读量89 收藏
点赞数
分类专栏： python 后端 文章标签： django sqlite 数据库 restful
于 2023-07-10 11:06:19 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_41764138/article/details/131634446
版权

Django 基础

一、初始化

  1. 新建目录
mkdir django_demo && cd django_demo
  1. 用 pipenv，创建虚拟环境
pip install pipenv
# 切到虚拟环境
pipenv shell

这时会生成一个 Pipfile 文件，记录了虚拟环境的状态，类似于 package.json

  1. 安装 django
# 虚拟环境下安装时换源，修改 Pipfile 文件中的 [[source]] 为
url = "https://pypi.tuna.tsinghua.edu.cn/simple"

# 在虚拟环境中安装
pipenv install django
# 安装 DFR 和 CORS，用于 api
pipenv install django-rest-framework django-cors-headers

# 原来的安装方式
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple django
# 配置全局清华源
pip install pip -U # 升级 pip
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
  1. 使用脚手架创建项目
django-admin startproject mysite

# 进入项目目录，创建子应用
cd mysite
python manage.py startapp polls
  1. 配置数据库后，进行数据库迁移，并创建管理用户
# 在 mysite/settings.py 中，修改数据库配置，这里默认使用 sqlite3
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

# 有表结构改动时，创建数据库迁移
# python manage.py makemigrations polls
# 执行数据库迁
python manage.py migrate
# 创建管理用户
python manage.py createsuperuser
  1. 启动项目
# 默认127.0.0.1 是一个回环地址，不能通过外部访问，只能自己访问，如果想在docker外访问就要加上0.0.0.0
python manage.py runserver ((0.0.0.0):(port))

访问 localhost:8000/admin 就能看到如下界面了
在这里插入图片描述

二、全局配置

(一). 基础配置

  1. 在 INSTALLED_APPS 中添加应用 rest_framework、corsheaders 和 polls， polls 是刚创建的子应用
INSTALLED_APPS = [
    'rest_framework',
    'corsheaders',
    'polls',
    ...
]
  1. 在 MIDDLEWARE 中添加 corsheaders.middleware.CorsMiddleware，注册跨域请求中间件，放在最前面
MIDDLEWARE = [
    'corsheaders.middleware.CorsMiddleware',
    ...
]
  1. 设置 CORS_ORIGIN_WHITELIST，添加跨域请求白名单
CORS_ORIGIN_WHITELIST = [
    'http://localhost:8080',
    'http://localhost:8081',
]
  1. 设置 LANGUAGE_CODE 为 zh-hans，设置为中文
LANGUAGE_CODE = 'zh-hans'
  1. 设置 MEDIA_URL 和 MEDIA_ROOT，资源文件的访问
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

(二). 修改数据库配置

# 安装驱动
pipenv install mysqlclient

# 在 mysite/settings.py 中，修改数据库配置
DATABASES = {
        # 'default': {
    #     'ENGINE': 'django.db.backends.mysql',
    #     'NAME': 'cool_admin',
    #     'USER': 'root',
    #     'PASSWORD': 'root',
    #     'HOST': 'hostip',
    #     'PORT': '3386'
    # }
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'default',
        'USER': 'default',
        'PASSWORD': 'secret',
        'HOST': 'hostip',
        'PORT': '5432',
    }
}

(三). 使用 simpleui 美化界面

# 安装
pipenv install django-simpleui

# 在 mysite/settings.py 中，INSTALLED_APPS 中添加 'simpleui'
INSTALLED_APPS = [
    'simpleui',
    ...
]

# 在 setting 中添加主题色
SIMPLEUI_DEFAULT_THEME = 'green'

# 设置 logo
SIMPLEUI_LOGO = 'https://avatars.githubusercontent.com/u/28778856?s=200&v=4'

# 关闭广告和分析
SIMPLEUI_HOME_INFO = False
SIMPLEUI_ANALYSIS = False


# 根据教程处理细节
https://zhuanlan.zhihu.com/p/372185998

(四). 使用 Django Filter 过滤

(五). 使用 Django Debug Toolbar 调试

# 安装
pipenv install django-debug-toolbar

# 在 settings.py 中，INSTALLED_APPS 中添加 'debug_toolbar'
INSTALLED_APPS = [
    'debug_toolbar',
    ...
]
# 在 settings.py 中，MIDDLEWARE 中添加 'debug_toolbar.middleware.DebugToolbarMiddleware'
MIDDLEWARE = [
    'debug_toolbar.middleware.DebugToolbarMiddleware',
    ...
]
# 在 settings.py 中，添加配置
DEBUG = True
INTERNAL_IPS = [
    '127.0.0.1',
    'localhost',
]

# 在 mysite/urls.py 中，添加配置
urlpatterns = [
    ...
    path('__debug__/', include('debug_toolbar.urls')),
]

三、实现一个 polls 应用

如果不使用 rest_framework，只需要 1、2、7 步即可

1. 创建模型

在 polls/models.py 中，创建模型

from django.db import models

class Question(models.Model):
    question_text = models.CharField(max_length=200, verbose_name='问题文本')
    pub_data = models.DateTimeField('date published')

    # 定义元素据，用于在后台管理中显示
    class Meta:
        verbose_name = '问题'
        verbose_name_plural = '问题'

    # 定义 __str__ 方法,用于字符串显示
    def __str__(self):
        return self.question_text


class Choice(models.Model):
    # 处理关联关系时，注意处理 related_name
    question = models.ForeignKey(Question, related_name='choices', on_delete=models.CASCADE)
    choice_text = models.CharField(max_length=200)
    votes = models.IntegerField(default=0)

    class Meta:
        verbose_name = '选项'
        verbose_name_plural = '选项'

    def __str__(self):
        return self.choice_text

2. 注册模型

在 polls/admin.py 中，注册模型

from django.contrib import admin
from .models import Question, Choice

admin.site.register(Question)
admin.site.register(Choice)

3. 定义序列化器

定义序列化器 polls/serializers.py, 序列化器是 Django Rest Framework 提供的功能，能够非常方便地将 Django 数据模型序列化成相应的 JSON 数据格式。

from rest_framework import serializers
from .models import Question


class PollSerializer(serializers.ModelSerializer):
    # 在 api 视图中使用关联关系，PrimaryKeyRelatedField 只会返回关联对象的主键
    articles = serializers.PrimaryKeyRelatedField(many=True, queryset=Article.objects.all())
    # 但是如果直接传其他的序列化器，就会返回序列化后的数据
    answer = AnswerSerializer(many=True)
    # 处理关联关系时，还应注意要在model定义时，设置related_name

    class Meta:
        model = Question
        # fields = ['id', 'question_text', 'pub_data', 'articles']
        fields = '__all__'
        depth = 1 # 找查外键的深度，articles 就会加入到返回中

4. 创建视图

在 polls/views.py 中，创建视图,使用 Django Rest Framework 提供的模型视图集，实现了增删改查的功能

from rest_framework import viewsets
from .serializers import PollSerializer
from .models import Question


# Create your views here.
class PollViewSet(viewsets.ModelViewSet):
    serializer_class = PollSerializer
    queryset = Question.objects.all().order_by('pub_data')

5. 创建路由

在 polls/urls.py 中，用 DefaultRouter 自动创建路由

from django.urls import path, include
from rest_framework import routers
from . import views

router = routers.DefaultRouter()
router.register('polls', views.PollViewSet)

urlpatterns = [
    path('', include(router.urls)),
]

6. 注册路由

  1. 在 mysite/urls.py 中，注册应用的路由
from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path('admin/', admin.site.urls),
    path('api/', include('polls.urls')),
]

7. 创建并迁移数据库

创建并迁移数据库

# python manage.py makemigrations 全部应用/指定应用
python manage.py makemigrations polls
python manage.py migrate

8. 启动项目

/api/polls/ 查看 restful api 的页面
/admin/polls/ 查看后台管理页面

9. 添加权限

在 polls/views.py 中，添加权限

from rest_framework import permissions

# 在 ViewSet 中添加 permission_classes 属性
class PollViewSet(viewsets.ModelViewSet):
    serializer_class = PollSerializer
    queryset = Question.objects.all()
    permission_classes = (permissions.IsAuthenticatedOrReadOnly,)

在 mysite/urls.py 中，添加权限

urlpatterns = [
    path('api-auth/', include('rest_framework.urls')),
    ...
]

10. 生成依赖文件

pipenv run pip freeze > requirements.txt

四、部署

使用 wsgi 部署

  1. 安装 WSGI 服务器，gunicorn，uWSGI 等
pipenv install gunicorn
  1. 在 mysite 目录下，创建 wsgi.py 文件。脚手架会自动创建
import os
from django.core.wsgi import get_wsgi_application

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')

application = get_wsgi_application()
  1. 在 mysite 目录下，创建 Procfile 文件，指定启动命令
web: gunicorn mysite.wsgi

或使用 shell 启动，gunicorn myproject.wsgi:application

  1. 在 mysite/settings.py 中配置
# 修改 DEBUG 为 False，设置 ALLOWED_HOSTS
DEBUG = False

ALLOWED_HOSTS = ['*']

# 设置静态文件的访问
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static')

# 设置数据库

# 设置日志
  1. 配置 Nginx 或其他 Web 服务器以反向代理 Gunicorn 服务器。
location / {
    proxy_pass http://127.0.0.1:8000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

使用 asgi 部署

  1. 安装 ASGI 服务器，Daphne、Uvicorn、Hypercorn 等。
pipenv install daphne
  1. 在 mysite 目录下，创建 asgi.py 文件。脚手架会自动创建
import os
from django.core.asgi import get_asgi_application

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')

application = get_asgi_application()
  1. 在 mysite 目录下，创建 Procfile 文件，指定启动命令
web: daphne mysite.asgi:application

或使用 shell 启动，daphne myproject.asgi:application

  1. 在 mysite/settings.py 中配置

  2. 配置 Nginx 或其他 Web 服务器以反向代理 ASGI 服务器。

    location / {
    proxy_pass http://127.0.0.1:8000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

    # WebSocket support
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

五、数据库及迁移

1. 数据库迁移命令

# 创建迁移文件
python manage.py makemigrations
# 查看迁移文件
python manage.py sqlmigrate polls 0001
# 查看迁移状态
python manage.py showmigrations polls
# 回滚迁移
python manage.py migrate polls zero
# 回滚到指定迁移
python manage.py migrate polls 0001
# 执行迁移
python manage.py migrate polls

2. 模型关联关系

文档

一对一 用 OneToOneField
一对多 用 ForeignKey
多对多 用 ManyToManyField

五、DRF 关于数据处理

(一). 序列化器

1. 重写增删查改方法
from rest_framework import serializers
from .models import Question


class PollSerializer(serializers.ModelSerializer):
    # 在 api 视图中使用关联关系，PrimaryKeyRelatedField 只会返回关联对象的主键
    articles = serializers.PrimaryKeyRelatedField(many=True, queryset=Article.objects.all())
    # 但是如果直接传其他的序列化器，就会返回序列化后的数据
    answer = AnswerSerializer(many=True)
    # 处理关联关系时，还应注意要在model定义时，设置related_name

    class Meta:
        model = Question
        # fields = ['id', 'question_text', 'pub_data', 'articles']
        fields = '__all__'
        depth = 1 # 找查外键的深度，articles 就会加入到返回中

    # 重写 create 方法，重写创建逻辑
    def create(self, validated_data):
        articles_data = validated_data.pop('articles')
        question = Question.objects.create(**validated_data)
        for article_data in articles_data:
            Article.objects.create(question=question, **article_data)
        return question

    # 重写 update 方法，重写更新逻辑
    def update(self, instance, validated_data):
        articles_data = validated_data.pop('articles')
        articles = (instance.articles).all()
        articles = list(articles)
        instance.question_text = validated_data.get('question_text', instance.question_text)
        instance.pub_data = validated_data.get('pub_data', instance.pub_data)
        instance.save()
        for article_data in articles_data:
            article = articles.pop(0)
            article.article_text = article_data.get('article_text', article.article_text)
            article.save()
        return instance

    # 重写 to_representation 方法，修改返回的数据
    def to_representation(self, instance):
        ret = super().to_representation(instance)
        ret['articles'] = ArticleSerializer(instance.articles.all(), many=True).data
        res['current_url'] = self.context['request'].build_absolute_uri()
        return ret

    # 重写 to_internal_value 方法，用于处理关联关系
    def to_internal_value(self, data):
        articles_data = data.pop('articles')
        validated_data = super().to_internal_value(data)
        validated_data['articles'] = articles_data
        return validated_data
2. 使用 SerializerMethodField 添加额外的数据
class ModalInfoSerializer(serializers.ModelSerializer):
    # 添加的数据
    external_data = serializers.SerializerMethodField()

    class Meta:
        model = ModalInfo
        fields = '__all__'

    # 请求外部的数据 external_data 为字段名， obj 是上次返回的数据
    def get_external_data(self, obj):
        try:
            # test_url = 'http://10.10.2.201:8336/api/menu/list'
            response = requests.get(obj.data_url)
            return response.json()
        except Exception as e:
            return {'code': 500, 'msg': '获取数据失败', 'data': e.__str__()}

(二). 视图

1. 添加额外的接口
from rest_framework import viewsets
from rest_framework.decorators import action
from rest_framework.response import Response

class MarkInfoViewSet(viewsets.ModelViewSet):
    queryset = MarkInfo.objects.all()
    serializer_class = MarkInfoSerializer

    # 添加额外的接口  /hello_world
    @action(detail=False, methods=['get'])
    def by_workshop(self, request):
        workshop_id = request.query_params.get('workshop_id')
        if not workshop_id:
            return Response({'message': '请传入workshop_id'})

        # return Response(info_list) # 如果处理可以返回数据
        # queryset 转 dict
        markinfos = MarkInfo.objects.filter(workshop=workshop_id)
        info_list = [model_to_dict(info) for info in markinfos]
        return Response(dict_key_to_camel(info_list))

相关参考文章：
官方文档
快速体验
快速体验 api

愿煜愁殇
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Django里的基础
小范的博客
12-18 214
1，一对多 数据库表模型 分类 class Category(models.Model): name = models.CharField(max_length=32) 商品 class Goods(models.Model): name = models.CharField(max_length=32) # 外键 cate = models.ForeignKey(‘Category’,on_delete=models.CASCADE) 查询 1 正向查询 站在商品的角度上查询数据 # goodsobj
Django基础
zongyimin的博客
03-07 406
一.web框架本质 浏览器：socket客户端 服务器：socket服务端 socket基于tcp之上连接，http基于tcp的短连接。web框架的本质就是socket。 1.socket服务端 所有的web应用，本质上就是一个socket服务端，用户的浏览器其实就是一个socket客户端。 nginx，apache，cgi，wsgi基于socket实现。 例子：（傻子） #w
【一文到底】【0基础】【快速上手】Django基本使用
热门推荐
_MoNanGo_
02-26 4万+
django常用点详细讲解笔记；在2部分中，会使用ModelForm带你完成增删改查，还会带你封装分页组件，等等等等功能实践
django零基础学习笔记(一)
说好的
08-07 2037
一、首先djiango是什么：djiango是一个由python编写的开源的web框架，就像Spring和Boot一样，方便我们进行动态网页开发。而Python 加 Django 是快速开发、设计、部署网站的最佳组合。 主要用途有网站、微信公众号、小程序后端开发等，只要是http请求的，都可以用它实现。以及人工智能平台融合，比如翻译用户的需求再去执行用户需求。 二、djiango包含哪些组件： 1.配置文件and路由系统 要写大量的配置项，请求交给谁处理，相应是什么。 2.MTV模型 为了各..
django基础知识一.md
07-09
django基础知识（一），内为django学习笔记整理，以供参考
Django中间件基础用法详解
09-19
主要介绍了Django中间件基础用法详解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
django课件基础篇
03-26
本课件基础篇主要涵盖了Django的基本操作，旨在帮助初学者快速入门并掌握核心概念。在"天天生鲜项目"中，你将有机会实践这些理论知识，了解如何创建一个实际的在线商店平台。 首先，我们要了解Django的安装和环境...
django基础教程
01-14
本教程《Django基础教程》详细涵盖了以上各个主题，通过实际操作和实例讲解，帮助读者从零开始掌握Django的全貌，逐步成为一名熟练的Django开发者。通过阅读和实践，你将能够创建功能完善的Web应用程序，并具备...
python 零基础学习篇python课程django框架12 todolist .mp4
04-21
python 零基础学习篇
【Django】django模板与前端技术(html模板)
最新发布
xzzteach的博客
07-25 185
在前端页面中html代码比python多得多，所以一定是html包python最优！于是引出今天的模板。
Django执行ORM时打印SQL语句
YUE
07-21 275
【代码】Django执行ORM时打印SQL语句。
Django REST Framework(十二)视图集-GenericViewSet
yjjpp2301的专栏
07-22 463
是 Django REST Framework 中的一个类，它结合了和的功能。它的主要目的是简化视图代码，通过将独特的代码作为类属性进行抽象，使代码更加可复用。
Django transaction.atomic()事务处理
人生苦短，何妨一试
07-21 539
在Django中，transaction.atomic()是一个上下文管理器，它会自动开始一个事务，并在代码块执行完毕后提交事务。如果在代码块中抛出异常，事务将被自动回滚，确保数据库的一致性和完整性。在实际应用中，你可能需要根据具体的业务逻辑来决定何时抛出异常，以触发事务回滚。例如，如果某个操作依赖于另一个操作的成功，那么在第一个操作失败时，你可能需要抛出异常，以防止后续操作被执行，从而保持数据的一致性。
Python从0到100（四十三）：数据库与Django ORM 精讲
Hello大家好，我是Dream，如果帮得到你，那我深感荣幸！交流学习、商务合作：https://bbs.csdn.net/topics/614347534
07-22 1039
Django 里面， 数据库表的操作，包括 表的定义、表中数据的增删改查，都可以通过 Model 类型的对象进行的。通常，在Django中：定义一张数据库的表 就是定义一个继承自 django.db.models.Model 的类定义该表中的字段（列）， 就是定义该类里面的一些属性类的方法就是对该表中数据的处理方法，包括 数据的增删改查在Django中，定义数据模型非常简单。我们只需要在models.py文件中创建继承自Model的类，并定义相应的字段即可。
Python之后端Django（三）
Python_Ghost的博客
07-20 1160
创建项目”执行cd ~/Desktop/ 将项目创建在桌面上，方便管理创建虚拟环境查看虚拟环境是否有配置 workon创建虚拟环境 mkvirtualenv -p python3 py3_django_12生成文件 django-admin startproject bookmanger报错的话下载django pip install django==1.11.11检查是否创建成功 tree“创建子应用”
26.8 Django多表操作
清风
07-25 580
1.1 关系分类 1.2 外键字段 1.3 级联设置 2. 模型创建 2.1 子表和主表的概念 2.2 数据库与日志配置 2.4 一对多关系 2.5.1 自动创建关联表 2.5.2 手动动创建关联表 2.6 db_constraint 参数 2.7 db_table参数 3.2 测试模型创建
【Django】在vscode中新建Django应用并新增路由
xzzteach的博客
07-23 382
【代码】【Django】在vscode中新建Django应用并新增路由。
计算机毕业设计django+hadoop+scrapy租房可视化 租房推荐系统 租房大屏可视化 租房爬虫 spark 58同城租房爬虫 房源推荐系统
从业计算机毕业设计10年，打算用一年时间分享10年毕设经验！
07-16 1086
计算机毕业设计django+hadoop+scrapy租房可视化 租房推荐系统 租房大屏可视化 租房爬虫 spark 58同城租房爬虫 房源推荐系统
零基础入门：Python Web开发与Django/Flask框架实战
本课程名为“Python WEB应用程序开发和设计”，是一门针对零基础学习者的入门级课程，旨在教授如何利用Python语言构建高效、易于维护的Web应用程序。课程内容全面且深入，从Python语言基础开始，逐步引导学员掌握...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值