ninja-django优缺点 # ninja的优点可替代DRF(django有jsonrespons vs ninja)
摘抄：https://www.cnblogs.com/fnng/p/16084825.html
学习ninja https://blog.csdn.net/qq_43373298/article/details/121384656
django优点
通过脚手架创建项目/应用：不用考虑项目架构怎么设计。自带Admin后台：在没有前端的情况下，可以比较方便通过Admin对数据进行操作。自带常用模块：一个命令就能生成 group、user、session ...表，一般个系统都需要user表吧！你还在考虑user表设计，我已经把登录/注册功能写完了。自带ORM：对于建表和操作数据库可太方便了。自带单元测试模块：虽然不是必用，但写单元测试很方便的，尤其是运行测试数据隔离，不依赖数据库去构造测试数据。
缺点
模板语言：在前后端分离的架构下，不用Django做页面了，这个东西可以抛弃了。Form 组件：以后端的方式渲染页面上的表单， 这个东西也可以抛弃了。只有get/post方法：这就很不符合 RESTful 风格了。没有参数校验：这就会导致开发接口效率不高，要写不少代码来判断是否为空，类型对不对。性能差：反正各种性能对比中都是被吊打的那位。异步支持的不好：如果你很在意异步，还是不要用django了。
以上算是我对django的浅薄的见解吧！现在的当红web框架，那当然是fastapi了，我之前的文章也有做介绍。django的大部分缺点，刚好是fastapi的优势，有没有二者相结合的产物？
django-ninja: https://django-ninja.rest-framework.com/
Django Ninja is a web framework for building APIs with Django and Python 3.6+ type hints.
django-ninja不像django-rest-framework学习成本那么高，有着和fastapi非常类似的用法。
django-ninja 体验
- 安装
> pip install django
> pip install django-ninja
- 创建项目
> django-admin startproject apidemo
- 修改
urls.py
from django.contrib import admin
from django.urls import path
from ninja import NinjaAPI
api = NinjaAPI()
@api.get("/add")
def add(request, a: int, b: int):
return {"result": a + b}
urlpatterns = [
path("admin/", admin.site.urls),
path("api/", api.urls),
]
- 启动项目
> python manage.py runserver
- 自动带api文档
实现登录接口
当然，只是对比实现一个简单的接口，django-ninja 确实没有比fastapi简单。我们就做一个实际的功能，实现用户登录接口。
一般框架实现过程:
- 需要准备一个数据库。
- 创建一个库和一张用户表。
- 框架需要与数据库连接。
- 通过接口实现用户登录。
django-ninja 有django加持，会把这个过程变得极其简单。
- 执行数据库迁移
> python manage.py migrate
这一个命令相关表已经建好了，django默认使用sqlite3，不需要考虑数据库连接。
- 创建一个管理员账号
> python manage.py createsuperuser
Username (leave blank to use 'user'): admin # 用户名
Email address: admin@mail.com # 邮箱
Password: # 密码
Password (again): # 确认密码
Superuser created successfully.
我们需要一个可以登录成功的账号。
- 实现登录接口
修改ursl.py文件
from django.contrib import admin
from django.urls import path
from django.contrib import auth
from ninja import NinjaAPI
from ninja import Schema
api = NinjaAPI()
class LoginIn(Schema):
# 登录参数类型校验
username: str
password: str
@api.post("/login")
def user_login(request, payload: LoginIn):
"""
用户登录
"""
user = auth.authenticate(username=payload.username, password=payload.password)
if user is not None:
return {"success": True, "msg": "login success"}
else:
return {"success": False, "msg": "login fail"}
urlpatterns = [
path('admin/', admin.site.urls),
path("api/", api.urls),
]
注意：这是个真实可用的登录接口，有参数类型校验，有查询数据库校验。只有传入的是第2步创建的帐号才可以返回login success。
总结
-
fastapi的示例虽然非常简单，真的拿来做项目仍需要补充额外一些东西，反观django似乎更简单。
-
本文应该适合有django使用经验的同学，如果你没有，这绝对不是一篇安利你学习django的文章。
-
djano-ninja几月前就注意到这个项目了，虽然，每周都在分享测试技术，但其实我的大部分工作是web前后端开发，所以，也会更关注这方面技术。
-
flask也有类似的REST框架哦~！apiflask。
JsonResponse vs HttpResponse
首先JsonResponse 是 HttpResponse 的子类，与父类的区别在于：
- JsonResponse 默认
Content-Type类型为application/json - HttpResponse 默认为
application/text
class JsonResponse(HttpResponse):
def __init__(self, data, encoder=DjangoJSONEncoder, safe=True,
json_dumps_params=None, **kwargs):
HttpResponse
HttpResponse 每次将数据返回给前端需要用 json 模块序列化，且前端也要反序列化：
# views.py
import json
def index(request):
message = '请求成功'
# ret = {'message': '请求成功'}
return HttpResponse(json.dumps(message)) # 序列化
# index.html
$.ajax({
url: '/accounts/ajax/',
type: 'post',
data: {
'p': 123,
csrfmiddlewaretoken: '{{ csrf_token }}'
},
# 反序列化，或使用 json.parse(arg)
dataType: "JSON",
success: function (arg) {
console.log(arg.message);
}
})
JsonResponse
JsonResponse 只能序列化字典格式，不能序列化字符串，且前端不用反序列化：
from django.http import JsonResponse
def index(request):
ret = {'message': '请求成功'}
return JsonResponse(ret) # 序列化
# index.html
$.ajax({
url: '/accounts/ajax/',
type: 'post',
data: {
'p': 123,
csrfmiddlewaretoken: '{{ csrf_token }}'
},
# 不需要反序列化
# dataType: "JSON",
success: function (arg) {
console.log(arg.message); # 请求成功
}
})总结
- HTTPResponse 后端要用 json 模块序列化，前端也要反序列化。
- JSonResponse 前端不用反序列化，只能传输字典，不能传输字符串。
