目录
- 配置环境
- [创建 Django 项目和 APP](#创建 Django 项目和 APP)
- 项目组成
- [配置 settings.py](#配置 settings.py)
- 数据表创建
- [Django-admin 引入admin后台和管理员](#Django-admin 引入admin后台和管理员)
- 外键
- QuerySet
- Instance功能
- [APIView 的概念](#APIView 的概念)
- 序列化器serializers
- 测试
- [Django-DRF 路由组件](#Django-DRF 路由组件)
- [Django-DRF 自定义函数](#Django-DRF 自定义函数)
- 参考
配置环境
创建虚拟环境
shell
conda create -n erp-env python=3.9
激活虚拟环境
shell
conda activate erp-env
requirements.txt文件
py
decorator==5.1.1
Django==4.2.3
django-debug-toolbar==4.1.0
django-extensions==3.2.3
django-filter==23.2
django-rest-framework==0.1.0
djangorestframework==3.14.0
drf-spectacular==0.26.3
- Django 是一个 Python web 框架,提供许多功能,如 ORM、认证、表单、模板等,它可以帮助你更快、更轻松地开发 web 应用程序。
- DRF(django-rest-framework) 是一个基于 Django 的强大而灵活的 RESTful 框架,它提供了许多工具和库,可帮助你快速开发基于 RESTful API 的 web 应用程序。
- Django-Filter 是一个基于 Django 的库,它提供了一种简单、灵活的方式来过滤 Django 模型的查询集。Django-Filter 的 API 允许开发者使用简单的查询表达式,构建和应用复杂的过滤器,从而在查询集中选择和排除数据。
- DRF Spectacular 是 DRF 的 OpenAPI 规范工具。它可以自动构建和生成 OpenAPI 规范文档,并提供方便的 API 测试工具,使你能够更加轻松地创建、测试和维护 RESTful API。同时,它也支持集成 Django Filter,允许你通过 URL 参数过滤查询数据。
进入requirements.txt文件所在目录
shell
cd C:\Users\gxx\Desktop\djangolearning
安装python库
pip install -r requirements.txt
或者
py
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
创建 Django 项目和 APP
创建项目文件夹
shell
django-admin startproject erp
(1)
进入manage.py所在路径
shell
cd C:\Users\gxx\Desktop\djangolearning\erp
创建 APP
shell
python manage.py startapp test1
(2)
或者
进入指定路径
shell
cd C:\Users\gxx\Desktop\djangolearning\erp\apps
创建 APP
shell
django-admin startapp test2
项目组成
- 项目名文件夹
- 子目录下同名子文件夹
- manage.py文件
manage.py提供了一种命令行工具,允许你以多种方式与该Django项目进行交互。如:python manage.py help,能列出它所能做的事情。注意,此文件一般情况下不需要改动。 - 应用文件夹
子目录文件组成
- init.py: 是一个空文件,作用是所在的这个目录可以被当作包使用。
- settings.py:该Django项目整体配置文件。(该文件非常重要,建议认真理解这个文件中可用的设置类型及其默认值。)
- urls.py:Django项目的URL设置。可视其为你的django网站的目录。
- asgi.py与wsgi.py:常见的网关接口协议:CGI,FastCGI,WSGI,ASGI。asgi.py是异步服务器网关接口项目配置文件。ASGI描述了Python Web应用程序和Web服务器之间的通用接口。与WSGI不同的是,ASGI允许每个应用程序有多个异步事件。另外,ASGI支持同步和异步应用程序。开发人员可以将原有的同步WSGI Web应用程序迁移到ASGI,也可以使用ASGI构建新的异步Web应用程序。
应用文件组成
-
init.py 是一个空文件,作用同前。
-
admin.py 文件跟网站的后台管理相关。
-
models.py 文件跟数据库操作相关。主要用一个 Python 类来描述数据表。运用这个类,你可以通过简单的 Python 的代码来创建、检索、更新、删除 数据库中的记录而无需写一条又一条的SQL语句。
-
views.py 包含了页面的业务逻辑,接收浏览器请求,进行处理,返回页面操作相关。
-
tests.py 文件用于开发测试用例,在实际开发中会有专门的测试人员使用。
-
apps.py 文件夹是django1.10之后增加的,通常里面包含对应用的配置。
-
migrations:django 1.8之后推出的migrations机制使django数据模式管理更容易。migrations机制有两个指令,makemigrations和migrate。makemigrations指令是用models里面的model和当前的migrations代码里面的model做对比,如果有新的修改,就生成新migrations代码。migrate指令是用migrations目录中代码文件和django数据库django_migrations表中的代码文件做对比,如果表中没有,那就对没有的文件按顺序及依赖关系做migrate apply,然后再把代码文件名加进migrations表中。
-
migrations文件夹 里面自动生成了_init_.py文件
配置 settings.py
加入安装的库和新增的APP
py
'test1',
'rest_framework',
'django_filters',
'drf_spectacular',
启动项目
启动Django服务
py
python manage.py runserver
数据表创建
模块功能
如前所述,models.py文件主要用一个 Python 类来描述数据表。运用这个类,可以通过简单的 Python 代码来创建、检索、更新、删除
数据库中的记录而无需写一条又一条的SQL语句。在model.py中创建两个表:产品分类表和产品信息表。
models.py
产品分类表和产品信息表
py
from django.db.models import *
# Create your models here.
## 产品分类表
class GoodsCategory(Model):
"""产品分类"""
name = CharField(max_length=64, verbose_name='分类名称')
remark = CharField(max_length=64, null=True, verbose_name='备注', blank=True)
## 产品表
class Goods(Model):
"""产品"""
# 外键
category = ForeignKey(GoodsCategory, on_delete=SET_NULL, related_name='goods_set', null=True, verbose_name='产品分类',
blank=True, )
# on_delete
number = CharField(max_length=32, verbose_name='产品编号')
name = CharField(max_length=64, verbose_name='产品名称')
barcode = CharField(max_length=32, null=True, blank=True, verbose_name='条码')
spec = CharField(max_length=64, null=True, blank=True, verbose_name='规格')
shelf_life_days = IntegerField(null=True, verbose_name='保质期天数')
purchase_price = FloatField(default=0, verbose_name='采购价')
retail_price = FloatField(default=0, verbose_name='零售价')
remark = CharField(max_length=128, null=True, blank=True, verbose_name='备注')
合并数据库
这两个命令是Django框架中的关键命令,用于进行数据库迁移。当你修改了Django模型后,你需要运行这两个命令,以将这些更改应用到数据库中。
shell
python manage.py makemigrations
这个命令用于生成迁移脚本。当你更新了模型文件之后,需要运行该命令,Django会检测模型的改变,然后自动生成相应的迁移脚本,存储在 migrations/
目录下。通常来说,你需要针对每个应用运行一次该命令。
shell
python manage.py migrate
这个命令用于将迁移脚本应用到数据库中。当你在模型文件中进行更改之后,需要先通过 makemigrations
命令生成迁移脚本,然后运行该命令将这些脚本应用到数据库中。对于新的迁移脚本,Django会逐个执行它们,从而更新数据库结构。对于已经执行过的脚本,Django会跳过它们,避免重复执行。
这两个命令是Django框架中非常重要的命令,在修改数据库相关内容时必须时刻清醒地记住使用它们。
在终端运行命令
Django-models的常用字段和常用配置
常用字段
CharField
用于存储字符串类型,有最大长度限制
IntegerField
用于存储整数类型
FloatField
用于存储浮点数类型
BooleanField
用于存储布尔类型
DateField
用于存储日期类型
DateTimeField
用于存储日期和时间类型
ImageField
用于存储图片类型
FileField
用于存储文件类型
ForeignKey
外键 用于表示数据库表之间的关联关系
OneToOneField
一对一 用于表示一对一的关联关系
ManyToManyField
多对多 用于表示多对多的关联关系
常用配置
max_length
字段的最大长度限制,可以应用于多种不同的字段类型。
verbose_name
字段的友好名称,便于在管理员后台可视化操作时使用。
default
指定字段的默认值。
null
指定字段是否可以为空。
null=True
设置允许该字段为 NULL 值
blank
指定在表单中输入时是否可以为空白。
choices
用于指定字段的可选值枚举列表,在最上面定义
字段定义
python
class DeliveryMaterial(Model):
class Status(TextChoices):
QUALIFIED = ('qualified', '良品')
UNQUALIFIED = ('unqualified', '不良品')
status = CharField(max_length=32, choices=Status.choices, default=Status.QUALIFIED, verbose_name='状态')
TextChoices
是 Django 3.0 引入的一个枚举类,用于在模型字段中创建可选择的、文本值的选项。
related_name
指定在多对多等关系中反向使用的名称。
on_delete
指定如果外键关联的对象被删除时应该采取什么操作。
Django-admin 引入admin后台和管理员
创建后台 admin 管理员
在终端运行命令
shell
python manage.py createsuperuser
py
python manage.py runserver
打开网址 http://127.0.0.1:8000/admin
配置
在admin.py文件中注册你的模型:
python
from django.contrib import admin
from .models import *
# Register your models here.
admin.site.register(Goods)
admin.site.register(GoodsCategory)
外键
category = ForeignKey(GoodsCategory,on_delete=SET_NULL,related_name='goods_set',null=True,verbose_name='产品分类')
on_delete
设置当外键对应的数据被删除时的反应
null=True
概念
外键是一种用于建立表之间关联关系的约束,通常指的是一个模型中的一个或多个字段的值必须符合另一个模型中对应字段的值。
views.py
py
# Create your views here.
from django.shortcuts import render
from rest_framework.response import Response
from .models import *
from rest_framework.decorators import api_view
from django.shortcuts import get_object_or_404
# Create your views here.
# GET
# POST
# 函数式编程
@api_view(['POST', 'GET'])
def InsertGoodsCategory(request):
category_name = request.data.get('分类名字')
# 获取分类对象或创建新的分类对象
category, created = GoodsCategory.objects.get_or_create(name=category_name)
# 判断是否已存在分类
if not created:
return Response({"status": "已存在", "goods_category": category_name}, status=200)
else:
return Response({"message": f"Successfully inserted category '{category_name}'."})
@api_view(['POST', 'GET'])
def FilterGoodsCategory(request):
data = request.data.get('分类名字')
goods = GoodsCategory.objects.filter(name=data)
if goods.exists():
return Response({"status": "已存在", "goods_category": data}, status=200)
else:
return Response({"status": "不存在", "goods_category": data}, status=404)
urls.py
- 放入路由
py
import os
import sys
os.chdir(os.path.dirname(__file__))
sys.path.append("..")
from django.contrib import admin
from django.urls import path
from test1.views import *
from django.urls import include
from rest_framework import routers
urlpatterns = [
path('admin/', admin.site.urls),
path('filtergoodscategory/', FilterGoodsCategory),
path('insertgoodscategory/', InsertGoodsCategory),
# path('filtergoodscategoryapi/', FilterGoodsCategoryAPI.as_view()),
# path('getgoods/', GetGoods.as_view()),
]
运行项目
shell
python manage.py runserver
postman接口测试
- 使用postman针对
insertGoodsCategory/
和filtergoodscategory/
API接口进行测试,测试结果如下
shell
http://127.0.0.1:8000/insertgoodscategory/
shell
http://127.0.0.1:8000/filtergoodscategory/
QuerySet
从数据库中查询结果存放的集合称为 QuerySet。 Django ORM用到三个类:Manager、QuerySet、Model。每个Model都有一个默认的
manager实例,名为objects。Django的ORM通过Model的objects属性提供各种数据操作的接口(API),并通过 Model.objects 方法返回QuerySet,生产符合查询条件的列表,列表中包含多个 Instance。
class QuerySet(model=None, query=None, using=None)[source]
其具有两大特色
(1) 惰性:若这个对象中包含了需要的数据且需要使用时,它会去DB中获取数据,否则不会获取。 比如说在内部,创建、过滤、切片和传递一个QuerySet,而没有进行真正的数据执行,不会真实操作数据库,被称为惰性。
(2)缓存使用同一个查询集,第一次使用时会发生数据库的查询,然后Django会把结果缓存下来,再次使用这个查询集时会使用缓存的数据,减少了数据库的查询次数。
操作说明
设定:已存在数据表定义如下:
py
class Goods(DjangoPeople):
{
number = CharField(max_length=32, verbose_name='编号')
name = CharField(max_length=64, verbose_name='名称')
unit = CharField(max_length=64, verbose_name='单位')
remark = CharField(max_length=256, verbose_name='备注')
}
all()
:返回模型的所有对象,它的效果等价于不带任何条件的 filter()
方法。
如:
py
DjangoPeople.objects.all() # 查询所有 语句。
filter()(**kwargs)
用于返回符合条件的所有数据。
如:
py
DjangoPeople.objects.filter(name="abc") #取出name="abc"的DjangoPeople成员
又如:
py
DjangoPeople.objects.filter(name="x").filter(unit="y") #取出name="x"且unit="y"的DjangoPeople成员
get()
方法与 filter()
的作用类似,用于返回符合条件的单个对象但是可能会返回多个值
delete()
:可以删除符合条件的所有对象
如:
py
catagories_to_delete=DjangoPeople.objects.filter(name="abc")
py
deleted_count= categories_to_delete.delete()
update()
:将符合条件的所有对象的某个字段值进行更新
create()
是 save()
方法的快捷方式,用于创建并保存一个新的对象。
如:
py
created_category = DjangoPeople.objects.create(name="abc")
count()
:返回符合条件的对象数量
order_by()
:对返回的对象进行排序,默认为升序。降序则在字段名前面加负号。
QuerySet其他的其接口定义,用法类似,这里不再一一赘述,需要运用,可查阅Django官网。
Instance功能
Instance指的是一个 Django 模型的单个实例,也就是数据库中的一行数据。相比于 QuerySet(查询集合),它是针对单个对象的操作,用于创建、更新或者删除单个模型实例。
创建一个对象:
py
Obj = Model(attr1=val1, attr2=val2),Obj.save()
更新一个对象:
py
Obj = Model.objects.get(id=xxx),Obj.attr1 = val1,Obj.save()
删除一个对象:
py
Obj = Model.objects.get(id=xxx),Obj.delete()
QuerySet 适用于需要查找多个对象或进行聚合操作的场景,而 Instance 适用于单独对象的创建、修改和删除操作。
APIView 的概念
APIview 是 Django REST Framework 提供的一个视图类。它和 Django 中的 view 类有些相似,但是又有一些不同之处。APIview 可以处理基于 HTTP 协议的请求,并返回基于内容协商的响应,它旨在提供一个易于使用且灵活的方式来构建 API 视图。
views.py
首先,self 表示当前实例对象,这里指的是视图类的实例对象。
request 表示当前的请求对象,包含了客户端发送的信息,例如请求头、请求体等。
pk 是 path 参数 int:pk,用于获取请求中的产品 ID。
format 表示客户端请求的响应格式,例如 JSON、XML 等。这个参数通常不需要指定,会根据客户端发送的 Accept 请求头来自动选择响应格式。如果客户端指定了响应格式,那么我们可以从请求中获取到这个参数并且做出相应的处理。
在这个方法中,我们需要通过 pk 参数获取到对应的产品数据,并将其序列化成 JSON 格式并返回给客户端。具体的实现方式可以参考序列化器文档和 Django ORM 文档。
py
from django.shortcuts import render
from rest_framework.response import Response
from .models import *
from rest_framework.decorators import api_view
from django.shortcuts import get_object_or_404
from rest_framework.views import APIView
from .serializer import *
from rest_framework.decorators import action
from django.db.models import Q
from rest_framework.viewsets import ModelViewSet
#### modelviewset
class GoodsCategoryViewSet(ModelViewSet):
# 指定查询集(用到的数据)
queryset = GoodsCategory.objects.all()
# 指定查询集用到的序列化容器
serializer_class = GoodsCategorySerilizer
@action(detail=False, methods=['get'])
def latest(self, request):
latest_obj = GoodsCategory.objects.latest('id')
print(latest_obj)
return Response("helllo 你调用了自定义的函数")
@action(detail=False, methods=['get', 'post'])
def delete_example(self, request):
name = request.data.get('name')
# 删除名称为 'name' 的商品
categories_to_delete = GoodsCategory.objects.filter(name=name)
# 使用delete()方法删除对象
deleted_count = categories_to_delete.delete()
print(f"Deleted {deleted_count} categories.")
@action(detail=False, methods=['get', 'post'])
def create_example(self, request):
name = request.data.get('name')
# 使用create()方法创建新的商品分类对象
created_category = GoodsCategory.objects.create(name)
print("Created category:", created_category)
# Create your views here.
# GET
# POST
#### 函数式编程
@api_view(['POST', 'GET'])
def FilterGoodsCategory(request):
if request.method == 'GET':
print(request.method)
if request.method == 'POST':
print(request.method)
data = request.data.get('分类名字')
goods_category = get_object_or_404(GoodsCategory, name=data)
print(goods_category)
# ans = Goods.objects.filter(category=goods_category).all().values()
# print(ans)
goods = Goods.objects.filter(category=goods_category)
serializer = GoodsSerializer(goods, many=True) # 请确保导入合适的序列化器
# 输出对象 和 数据类型
print("object type:", type(Goods.objects))
print("object.all() type:", type(Goods.objects.all()))
print("object.all().values type:", type(Goods.objects.all().values()))
# Instance
print("object.get(id=1) type:", type(Goods.objects.get(id=1)))
return Response(serializer.data)
# return Response(ans)
@api_view(['POST', 'GET'])
def InsertGoodsCategory(request):
category_name = request.data.get('分类名字')
# 获取分类对象或创建新的分类对象
category, created = GoodsCategory.objects.get_or_create(name=category_name)
# 判断是否已存在分类
if not created:
return Response({"status": "已存在", "goods_category": category_name}, status=200)
else:
return Response({"message": f"Successfully inserted category '{category_name}'."})
@api_view(['POST', 'GET'])
def FilterGoodsCategory(request):
data = request.data.get('分类名字')
goods = GoodsCategory.objects.filter(name=data)
if goods.exists():
return Response({"status": "已存在", "goods_category": data}, status=200)
else:
return Response({"status": "不存在", "goods_category": data}, status=404)
#### APIView
class GetGoods(APIView):
def get(self, request):
data = Goods.objects.all()
serializer = GoodsSerializer(instance=data, many=True)
print(serializer.data)
return Response(serializer.data)
def post(self, request):
# 从请求数据中提取字段
request_data = {
"category": request.data.get("Goodscategory"),
"number": request.data.get("number"),
"name": request.data.get("name"),
"barcode": request.data.get("barcode"),
"spec": request.data.get("spec"),
"shelf_life_days": request.data.get("shelf_life_days"),
"purchase_price": request.data.get("purchase_price"),
"retail_price": request.data.get("retail_price"),
"remark": request.data.get("remark"),
}
# 使用 create() 方法创建新的商品对象
new_goods = Goods.objects.create(**request_data)
# 对创建的对象进行序列化,并作为响应返回
serializer = GoodsSerializer(instance=new_goods)
return Response(serializer.data)
# 面向对象编程
class FilterGoodsCategoryAPI(APIView):
# request 表示当前的请求对象
# self 表示当前实例对象
def get(self, request, format=None):
print(request.method)
return Response('ok')
def post(self, request, format=None):
print(request.method)
return Response('ok')
def put(self, request, format=None):
print(request.method)
return Response('ok')
url.py
py
import os
import sys
os.chdir(os.path.dirname(__file__))
sys.path.append("..")
from django.contrib import admin
from django.urls import path
from test1.views import *
from django.urls import include
from rest_framework import routers
# 创建DefaultRouter对象,用于生成路由
router = routers.DefaultRouter()
# 将视图集注册到路由器上,字符串里的是URL路径的前缀
router.register('GoodsCategory', GoodsCategoryViewSet)
urlpatterns = [
path('admin/', admin.site.urls),
path('filtergoodscategory/', FilterGoodsCategory),
path('insertgoodscategory/', InsertGoodsCategory),
path('filtergoodscategoryapi/', FilterGoodsCategoryAPI.as_view()),
path('getgoods/', GetGoods.as_view()),
]
# 把生成的url 添加到项目的url配置中
urlpatterns += router.urls
序列化器serializers
序列化器的作用
序列化将 queryset
和 instance
转换为 json/xml/yaml
返回给前端
反序列化与序列化则相反
定义序列化器
定义类,继承自 Serializer
通常新建一个 serializers.py
文件 撰写序列化内容
suah as
目前只支持
read_only
只读
label
字段说明信息
max_length
最大长度
serializer.py
在应用文件夹(test1)下新建serializer.py文件
py
from rest_framework.serializers import *
from .models import *
class GoodsCategorySerilizer(ModelSerializer):
class Meta:
model = GoodsCategory
fields = '__all__'
# 构建产品序列化器
class GoodsSerializer(ModelSerializer):
# 外键字段相关的数据 需要单独写
category = GoodsCategorySerilizer()
class Meta:
# 指定需要序列化的表
model = Goods
# 指定我们需要序列化的字段
fields = '__all__'
a. 序列化单个对象
-
获取对象
data = Goods.objects.get(id=1)
-
创建序列化器
sberializer = GoodsSerializer(instance=data)
-
转换数据
print(serializer.data)
-
注意点:
instance
是一个参数,用于指定要序列化或反序列化的 Python 对象。具体来说,它是一个类实例(Class Instance),通常是指一个从数据库或其他数据源中检索出来的模型实例(Model Instance)。当我们需要将一个模型实例转换为 JSON 或其他格式时,可以使用 Django 的序列化器(Serializer)来实现。
-
输出:
json
{'id': 1, 'number': '1', 'name': '第一个产品', 'purchase_price': 100.0, 'retail_price': 150.0, 'remark': '测试产品'}
b. 序列化多个对象
python
data = Goods.objects.all() # 获取对象
# 创建序列化器,many表示序列化多个对象,默认为单个
serializer = GoodsSerializer(instance=data,many=True)
print(serializer.data) # 转换数据
# 输出:
[OrderedDict([('id', 1), ('number', '1'), ('name', '第一个产品'), ('purchase_price', 100.0), ('retail_price', 150.0), ('remark', '测试产品')]), OrderedDict([('id', 2), ('number', '123'), ('name', '产品2'), ('purchase_price', 123.0), ('retail_price', 4123.0), ('remark', '测试产品2')])]
测试
py
python manage.py runserver
打开网页http://127.0.0.1:8000/admin/
http://127.0.0.1:8000/getgoods/
Django-DRF 路由组件
DefaultRouter
是Django REST framework中提供的一个路由器类,用于自动生成URL路由。
路由器是将URL与视图函数或视图集关联起来的一种机制。Django REST framework的路由器通过简单的配置可以自动生成标准的URL路由,从而减少了手动编写URL路由的工作量。
DefaultRouter的使用方法
使用 routers.DefaultRouter()
创建了一个默认的路由器对象,并使用 router.register()
方法注册了一个视图集,GoodsCategoryViewSet
。这样可以自动为这个视图集生成对应的URL路由,并将其添加到 urlpatterns
中。
http://127.0.0.1:8000/GoodsCategory/
Django-DRF 自定义函数
自定义函数是什么?
from rest_framework.decorators import action
@action
是 Django REST framework 中的一个装饰器,用于将自定义函数转换为视图集的一个动作。@action
装饰器提供了一种定义自定义函数的方式,这些函数并不直接对应于标准的 CRUD 操作(Create-Read-Update-Delete),而是实现一些其他的自定义行为或业务逻辑。
"@action 装饰器"用于在 ViewSet 中创建自定义动作(custom action),为 ViewSet 提供了更灵活应用且 @action
只在ViewSet视图集中生效。视图集中附加action装饰器可接收两个参数:
(1)methods: 声明该action对应的请求方式.
(2)detail: True/False声明该action的路径是否是action对应的请求方式。
其中,detail=False
表示该动作不需要处理单个对象,而是处理整个集合;
被 @action
装饰的函数需要作为方法定义在视图集类中,并且在使用 router.register()
注册视图集时,需要指定 basename
参数,以确保该动作的 URL 能够正确映射到视图集。