Django rest framework
缘由:
现在前后端分离的架构设计越来越流行,业界甚至出现了API优先的趋势。作为一个it程序猿,我们不得不用流行的技术来武装自己,如果我们要做后端接口开发,那么我们就要学会这样一门技术。
DRF是基于restful开发的一个强大而灵活的开发框架
其优点如下:
- 提供了定义序列化器Serializer的方法,可以快速根据 Django ORM或者其它库自动序列化/反序列化;
- 提供了丰富的类视图、Mixin扩展类,简化视图的编写;
- 多种身份认证,权限,限流,分页,;
- 丰富的定制层级:函数视图、类视图、视图集合到自动生成 API;
- 直观的 API web 界面;
- 可扩展性,插件丰富
restful简介:
restful是一种开发理念。设计风格而不是标准。REST描述的是在网格中client和server的一种交互形式,REST本身不实用,实用的是如何设计RESTful API(REST风格的网络接口),一种万维网软件架构风格。
为什么要前后端分离:
- pc,app,pad多端适应
- SPA(single page)开发模式开始流行
- 前后端开发职责不清
- 开发效率问题,前后端互相等待
- 前端一直配合着后端,能力受限
- 后端开发语言和模块高度耦合,导致开发语言严重依赖
前后端分离的缺点:
- 前后端学习门槛增加
- 数据依赖导致文档重要性增加
- 前端工作量大
- SEO的难度加大
- 后端开发模式迁移成本增加
配置环境:
python3.6
django1.11.6(较稳定)
IDE:pycharm专业版
使用 Django Rest Framework 3.8 自动生成 API 文档
pip install djangorestframework
pip install markdown
pip install django-filter
pip install django-rest-swagger
django-admin startproject project(项目名称)
cd project
python manage.py startapp demo(应用名称)
在settings.py中
# 在配置文件中修改两项设置
INSTALLED_APPS = [
# [django core apps]
... # 保留之前的apps
'rest_framework',
'rest_framework_swagger',
]
...
REST_FRAMEWORK = {
# Use Django's standard `django.contrib.auth` permissions,
# or allow read-only access for unauthenticated users.
'DEFAULT_PERMISSION_CLASSES': [
'rest_framework.permissions.DjangoModelPermissionsOrAnonReadOnly'
]
}
在models.py中
from django.db import models
class Book(models.Model):
book_name = models.CharField(max_length=64)
add_time = models.DateTimeField(auto_now_add=True)
def __str__(self):
return self.book_name
执行迁移 创建超级用户
python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
from django.shortcuts import render
from django.views.decorators.http import require_http_methods
from django.core import serializers
from django.http import JsonResponse
import json
from .models import Book
@require_http_methods(["GET"])
def add_book(request):
response = {}
try:
book = Book(book_name=request.GET.get('book_name'))
book.save()
response['msg'] = 'success'
response['error_num'] = 0
except Exception as e:
response['msg'] = str(e)
response['error_num'] = 1
return JsonResponse(response)
@require_http_methods(['GET'])
def show_books(request):
response = {}
try:
books = Book.objects.filter()
response['list'] = json.loads(serializers.serialize("json",books))
response['msg'] = "success"
response['error_num'] = 0
except Exception as e:
response['msg'] = str(e)
response['error_num'] = 1
return JsonResponse(response)
在dmeo下创建子路由urls.py中:
from django.conf.urls import url
from . import views
urlpatterns = [
url(r'^add_book$',views.add_book),
url(r'^show_books$',views.show_books),
]
python manage.py runserver