基于DRF的图书增删改查

功能演示

信息展示

添加功能

编辑功能

删除功能

DRF构建后台数据

本例的Model如下

from django.db import models

class Publish(models.Model):
    name = models.CharField(max_length=32)

class Author(models.Model):
    name = models.CharField(max_length=32,verbose_name='姓名')

class Book(models.Model):
    title = models.CharField(verbose_name='书名',max_length=56)
    price = models.DecimalField(verbose_name='价格',max_digits=8,decimal_places=2)
    pub_date = models.DateField(verbose_name='出版日期')

    publish = models.ForeignKey(to=Publish,on_delete=models.CASCADE)
    authors = models.ManyToManyField(to=Author)

注册DRF

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'book.apps.BookConfig',
    'rest_framework',
]

路由分发如下

# 查看与新增—— GET与POST
url(r'^books/$',views.BookListView.as_view(),name='book_get_post'),
# 修改与删除—— PUT与DELETE
url(r'^book/(?P<pk>\d+)/$',views.BookView.as_view(),name='book_put_delete'),

视图函数如下

from rest_framework.views import APIView
from rest_framework.response import Response

from book import models
from book.my_serializer import BookSerializer

class BookListView(APIView):

    def get(self, request, *args, **kwargs):
        """ 获取书籍信息 """
        # 用自定义的序列化器去实现~~~
        all_books = models.Book.objects.all()
        # 第一个参数是instance~是一个对象
        # 但是all()方法查出来的是一个“对象列表”——所以需要加many=True
        ser_obj = BookSerializer(all_books, many=True)
        # 返回自定义序列化器的data
        return Response(ser_obj.data)

    def post(self, request, *args, **kwargs):
        """新增数据 返回新建的书籍的数据 json格式 """
        # 用序列化器进行校验！！！
        # 注意：这里用的是request.data去取新增的值！！！
        print('>>>>>>',request.data)

        ser_book = BookSerializer(data=request.data)
        if ser_book.is_valid():
            ser_book.save()
            # 校验成功并且成功保存的话~返回新增的数据！
            return render(request,'book_list.html')
        else:
            print(ser_book.errors)
            return Response(ser_book.errors)

class BookView(APIView):

    def get(self,request,pk,*args,**kwargs):
        # 找Model对象
        book_obj = models.Book.objects.filter(pk=pk).first()
        # 序列化器对象——此时instance只有一个book_obj，不用加many=True了！
        ser_obj = BookSerializer(instance=book_obj)
        # 用Response方法返回序列化器对象的data
        return Response(ser_obj.data)

    def put(self,request,pk,*args,**kwargs):

        book_obj = models.Book.objects.filter(pk=pk).first()
        # partial=True —— 表示支持“部分提交/局部更新”
        ser_obj = BookSerializer(instance=book_obj,data=request.data,partial=True)
        if ser_obj.is_valid():
            ser_obj.save()
            return Response(ser_obj.data)
        else:
            return Response(ser_obj.errors)

    # 删除方法不需要用序列化器了
    def delete(self,request,pk,*args,**kwargs):
        obj = models.Book.objects.filter(pk=pk).first()
        if obj:
            obj.delete()
            return Response({'msg':'删除成功！'})
        else:
            return Response({"error":'数据不存在！'})

自定义的序列化器代码如下

# -*- coding:utf-8 -*-
from rest_framework import serializers

from book import models

class PublishSerializer(serializers.Serializer):
    id = serializers.IntegerField(read_only=True)
    name = serializers.CharField()

class AuthorSerializer(serializers.Serializer):
    id = serializers.IntegerField()
    name = serializers.CharField()

class BookSerializer(serializers.Serializer):
    # 与Book中的属性对应上
    # id 也需要～后面编辑与删除用得到~~设置read_only，添加的时候不必填
    id = serializers.IntegerField(read_only=True)
    title = serializers.CharField()
    price = serializers.DecimalField(max_digits=8,decimal_places=2)
    pub_date = serializers.DateField()

    # 外键的~这个字段其实存的是id~~注意这里是publish_id——数据库中存储的字段~~但是这种方式只能拿到id值
    # publish_id = serializers.IntegerField()

    # 多对一 外键关联~
    # 如果我们想拿publish的name的话，就需要交给上一个序列化器PublishSerializer去处理
    # 提交的时候~~不用填这个，所以设置required=False
    # 只有get请求要他而post请求不用它~所以设置 read_only=True
    publish = PublishSerializer(required=False,read_only=True)
    # 多对多~
    # 只有get请求要他而post请求不用它：read_only=True
    # 下面必须有一个 get_字段名 的方法对应！
    authors = serializers.SerializerMethodField(read_only=True)

    # post提交用这个字段~是int类型的
    # get请求不要他~~设置 write_only=True
    post_publish = serializers.IntegerField(write_only=True)
    # post提交用这个字段~是一个ListField~列表里是数字
    # get请求不要他~~设置 write_only=True
    post_authors = serializers.ListField(write_only=True)

    # 多对多关系查找authors用到的方法——与上面的SerializerMethodField对应
    def get_authors(self,obj):
        # 注意~obj是Book对象！！
        # print(obj)
        # 基于对象的跨表查询~注意是多个对象了~many应该设置为True
        ser_obj = AuthorSerializer(obj.authors.all(),many=True)
        return ser_obj.data

    # POST方式增加数据需要
    def create(self, validated_data):
        # post提交的时候~~重写create方法
        # post提交给的数据应该是这种格式的
        # 注意后面那两个是post_publish、post_authors~专门用于提交的字段
        """
         {
            "title": "西游记",
            "price": 12.20,
            "pub_date": "2019-12-22T10:10:11Z",
            "post_publish": 1,
            "post_authors": [1,2]
        }
        """
        print('validated_data>>>',validated_data)
        book_obj = models.Book.objects.create(
            title=validated_data.get('title'),
            price=validated_data.get('price'),
            pub_date=validated_data.get('pub_date'),
            publish_id=validated_data.get('post_publish'),
        )
        # 多对多插入数据~~基于对象的跨表查询
        # 注意用set方法存多对多关系的数据
        book_obj.authors.set(validated_data.get('post_authors'))
        return book_obj

    # PUT请求修改数据需要写的方法
    def update(self, instance, validated_data):
        # 如果取到了就用修改的~~如果没有就用原来的数据
        instance.title = validated_data.get('title',instance.title)
        instance.prince = validated_data.get('price',instance.price)
        instance.pub_date = validated_data.get('pub_date',instance.pub_date)
        # 上面设置了post_publish为write_only了~所以修改要用post_publish
        instance.publish_id = validated_data.get('post_publish',instance.publish_id)
        # 先save~然后再处理一下多对多关系的数据
        instance.save()
        # 基于对象的跨表查询~~注意用set方法存多对多关系的数据
        # 如果没有的话需要用all方法取出所有对象~~
        # # 上面设置了post_authors为write_only了~所以修改要用post_authors
        instance.authors.set(validated_data.get('post_authors',instance.authors.all()))
        # 最后记得把instance 返回
        return instance

在DRF自带的页面进行数据的增删改查测试

至此DRF就写好了，我们可以根据路由去访问对应的页面进行数据的增删改查操作（需要注意，必须先在settings中注册了rest_framework后才能访问DRF自带的页面）

DRF自带的页面是这样的：

当然，我们不能让用户看这样的页面，这就需要前端请求DRF构建好的数据进行标签的构建了。

前端请求DRF构建好的数据并构建页面效果

测试路由如下

# 书籍展示的页面
url(r'^book_list/$',views.book_list,name='book_list'),
# 添加书籍的页面
url(r'^add_book_view/$',views.add_book,name='add_book_view'),# 编辑书籍的展示页面~~
url(r'edit_book_view/(?P<pk>\d+)/$',views.edit_book,name='edit_book'),

视图函数如下

视图函数非常简单，再加上是进行数据测试，所以这里的视图函数只负责返回页面。

数据的操作全部是用ajax与js做的。

# 展示 书籍列表
def book_list(request):
    return render(request,'book_list.html')

# 展示 添加书籍页面
def add_book(request):
    return render(request,'add_book.html')

# 编辑书籍的展示页面
def edit_book(request,pk):
    return render(request,'edit_book.html')

所有页面的母版

{% load static %}
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{% block title %} {% endblock title %}</title>
    <link rel="stylesheet" href="{% static 'bootstrap-3.3.7/css/bootstrap.css' %}">
    <style>
        {# th中的文字剧中 bootstrap设置的是left #}
        th {
            text-align: center;
        }
    </style>
</head>

<body style="padding-top:52px;">
<!--导航 独立于页面，不包含在盒子里面。不要放在container里面  -->
<nav class="navbar navbar-default navbar-fixed-top navbar-inverse">
    <div class="container-fluid">
        <!-- Brand and toggle get grouped for better mobile display -->
        <div class="navbar-header">
            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse"
                    data-target="#bs-example-navbar-collapse-1" aria-expanded="false">
                <span class="sr-only">Toggle navigation</span>
                <span class="icon-bar"></span>
                <span class="icon-bar"></span>
                <span class="icon-bar"></span>
            </button>
            <a class="navbar-brand" href="#">火之国</a>
        </div>

        <!-- Collect the nav links, forms, and other content for toggling -->
        <div class="collapse navbar-collapse pull-right" id="bs-example-navbar-collapse-1">
            <ul class="nav navbar-nav">

                <li><a href="#">Link</a></li>
                <li><a href="#">Link</a></li>

            </ul>
        </div><!-- /.navbar-collapse -->
    </div><!-- /.container-fluid -->
</nav>

<div class="container">
    <div class="row">
        <div class="col-md-12">
            <div class="pannel panel-danger">
                <!--panel-heading-->
                <div class="panel-heading">
                    <!--panel-title-->
                    <h3 class="panel-title">火之国图书管理系统</h3>
                </div>
                <!--panel-body-->
                <div class="panel-body">
                    <!--把其他的组件放到panel-body里面-->
                    <!--block -->
                    {% block pannel-body %}

                    {% endblock pannel-body %}
                </div>
            </div>
        </div>
    </div>
</div>

<script src="{% static 'jquery-3.4.1.js' %}"></script>
<script src="{% static 'bootstrap-3.3.7/js/bootstrap.js' %}"></script>
{% block script %}

{% endblock script %}
</body>
</html>

base.html

书籍展示页面及删除书籍的功能

书籍展示发送的是get请求。

删除书籍发送的是delete请求。

{% extends 'base.html' %}

{% block title %}
    主页
{% endblock title %}

{% block pannel-body %}

    {% csrf_token %}
    <a id="add_book" href="{% url 'add_book_view' %}" class="btn btn-success pull-right">添加书籍</a>
    <br><br>
    <div id="div_table" class="table-responsive" style="text-align: center">
        <table id="table" class="table table-striped table-bordered table-hover table-condensed">
            <thead>
            <tr class="success">
                <th>编号</th>
                <th>书籍名称</th>
                <th>价格</th>
                <th>出版日期</th>
                <th>出版社</th>
                <th>作者</th>
                <th>操作</th>
            </tr>
            </thead>
            {# 委托的父级标签用tbody #}
            <tbody id="tbody">

            </tbody>
        </table>
    </div>

{% endblock pannel-body %}

{% block script %}
    <script>

        // 格式化时间的函数
        function formatDate(time) {
            var date = new Date(time);

            var year = date.getFullYear(),
                month = date.getMonth() + 1,//月份是从0开始的
                day = date.getDate(),
                hour = date.getHours(),
                min = date.getMinutes(),
                sec = date.getSeconds();
            var newTime = year + '-' +
                month + '-' +
                day + ' ' +
                hour + ':' +
                min + ':' +
                sec;
            return newTime;
        }

        // 页面加载自动触发ajax请求～向DRF获取所有数据并在前端渲染
        $(document).ready(function () {
            $.ajax({
                url: '/books/',
                type: 'get',
                success: function (data) {
                    console.log(data, typeof (data));
                    // data是一个object
                    for (var i = 0; i < data.length; i++) {
                        // data[i]是一个个自定义对象
                        //console.log(data[i],typeof(data[i]));

                        var tr = document.createElement('tr');
                        var td_num = document.createElement('td');
                        // 提前把编号写进tr中去 注意同时将id也加进去
                        td_num.innerHTML = (i + 1) + '<span class="book_pk" style="display: none">' + data[i].id + '</span> </td>';
                        //这时tr的第一个元素就是一个个的编号——并且里面的span标签带着每个数据的id
                        tr.append(td_num);

                        for (var j in data[i]) {
                            //console.log(j);
                            // 不用填id字段
                            if (j === 'id') {
                                continue;
                            }
                            // 新建一个td标签，把遍历的数据加进去
                            var td = document.createElement('td');

                            //格式化一下出版日期的格式
                            if (j === 'pub_date') {
                                data[i][j] = formatDate(data[i][j]);
                            }

                            //展示出版社的名字
                            if (j === 'publish') {
                                data[i][j] = data[i][j]['name'];
                            }
                            //展示作者的名字
                            if (j === 'authors') {
                                //console.log(data[i][j]);
                                var authors = '';
                                for (var k in data[i][j]) {
                                    authors += data[i][j][k]['name'] + ' ';
                                }
                                data[i][j] = authors;
                            }

                            td.append(data[i][j]);
                            tr.append(td);

                        }

                        //循环完，最后把编辑与删除按钮添加进去
                        var tdd = document.createElement('td');
                        tdd.innerHTML = '<td><a class="btn btn-primary edit_book"><span class="glyphicon glyphicon-pencil" aria-hidden="true"></span><span>编辑</span>\n' +
                            '</a><a class="btn btn-danger del_book"><span class="glyphicon glyphicon-remove" aria-hidden="true"></span><span>删除</span></a></td>';

                        tr.append(tdd);

                        // 最后将tr加到tbody中
                        $('#tbody').append(tr);

                    }
                }
            })
        });

        // 删除按钮的点击事件
        // 用委托实现
        // 这里也可以加一个"模态对话框"～给用户一个确认删除删除的提示
        $('#tbody').on('click', '.del_book', function () {
            // 找到这本书对应的id～
            // console.log($(this).parent().parent().find('.book_pk').text());
            var book_id = $(this).parent().parent().find('.book_pk').text();
            $.ajax({
                url: '/book/' + book_id + '/',
                type: 'delete',
                success: function (data) {
                    location.href = '/book_list/';
                }
            })
        });

        // 编辑按钮的点击事件
        // 用委托实现
        $('#tbody').on('click', '.edit_book', function () {
            // 找到这本书对应的id～
            var book_id = $(this).parent().parent().find('.book_pk').text();
            $.ajax({
              url:'/book/'+book_id+'/',
              type:'put',
              success:function (data) {
                  // data是待编辑书籍的数据
                  console.log(data,typeof(data));
                  // 序列化数据
                  data_json = JSON.stringify(data);
                  // 将数据存到session中
                  sessionStorage.edit_book_data = data_json;
                  // 跳转到编辑书籍页面
                  location.href = '/edit_book_view/' + book_id +'/';
              }
            })
        })

    </script>

{% endblock script %}

添加书籍页面

添加书籍发送的是post请求。

{% extends 'base.html' %}

{% block title %}
    主页
{% endblock title %}

{% block pannel-body %}

    <div class="col-md-8 col-md-offset-2">
        <h2 class="text-center">添加书籍</h2>
        <div>
            <div class="form-group">
                <label for="book_name">书籍名称</label>
                <input type="text" id="book_name" class="form-control" placeholder="书籍名称"
                       autocomplete="off">
                <span class="help-block"></span>
            </div>
            <div class="form-group">
                <label for="price">价格</label>
                <input type="number" id="price" class="form-control" placeholder="价格"
                       autocomplete="off">
                <span class="help-block"></span>
            </div>
            <div class="form-group">
                <label for="pub_date">出版日期</label>
                <input type="date" id="pub_date" class="form-control" placeholder="出版日期">
                <span class="help-block"></span>
            </div>
            <div class="form-group">
                <label for="">出版社</label>
                <select id="publish" class="form-control">
                    <option value="1">苹果出版社</option>
                    <option value="2">西瓜出版社</option>
                </select>
            </div>
            <div class="form-group">
                <label for="">作者</label>
                <select name="authors" id="authors" class="form-control" multiple>
                    <option value="1">whw</option>
                    <option value="2">naruto</option>
                    <option value="3">sasuke</option>
                </select>
            </div>
            <div class="form-group">
                <h4 id="add_error" class="pull-left" style="color:red;margin-top: 0"></h4>
                <input id="confirm_add" type="button" class="btn btn-success pull-right" value="确认添加">

            </div>
        </div>
    </div>

{% endblock pannel-body %}

{% block script %}
    <script>
        {# 确认按钮 #}
        $('#confirm_add').click(function () {
            {#console.log(123123);#}
            var title = $('#book_name').val();
            var price = $('#price').val();
            var pub_date = $('#pub_date').val();
            // 下拉列表被选中的这样选取
            var publish = $('#publish option:selected').val();

            //ajax操作
            $.ajax({
                url: '{% url "book_get_post" %}',
                type: 'post',

                data: {
                    title: title,
                    price: price,
                    pub_date: pub_date,
                    //pub_date: "2019-08-02T09:35:13.064532Z",
                    post_publish: publish,
                    //post_authors: authors,
                    post_authors: $('#authors').val(),
                },
                // 传数组
                traditional: true,

                success: function (data) {
                    console.log(data);
                    //alert('添加成功！');
                    location.href = '{% url "book_list" %}';
                }
            })

        });

    </script>

{% endblock script %}

编辑书籍页面

编辑书籍这里需要说一下过程：

（1）首先我在书籍展示那里点击“编辑”的时候，先把当前点击的书籍的信息取出来，然后序列化，最后将序列化的数据存在session中。

（2）然后在编辑页面从session中获取当前需要编辑的书籍的信息并把这些信息显示在前端的input框中。

（3）最后根据用户输入的数据保存书籍信息。

{% extends 'base.html' %}

{% block title %}
    主页
{% endblock title %}

{% block pannel-body %}

    <div class="col-md-8 col-md-offset-2">
        <h2 class="text-center">编辑书籍</h2>
        <div>
            <div class="form-group">
                <label for="book_name">书籍名称</label>
                <input type="text" id="book_name" class="form-control" placeholder="书籍名称"
                       autocomplete="off">
                <span class="help-block"></span>
            </div>
            <div class="form-group">
                <label for="price">价格</label>
                <input type="number" id="price" class="form-control" placeholder="价格"
                       autocomplete="off">
                <span class="help-block"></span>
            </div>
            <div class="form-group">
                <label for="pub_date">出版日期</label>
                <input type="date" id="pub_date" class="form-control" placeholder="出版日期">
                <span class="help-block"></span>
            </div>
            <div class="form-group">
                <label for="">出版社</label>
                <select id="publish" class="form-control">
                    <option value="1">苹果出版社</option>
                    <option value="2">西瓜出版社</option>
                </select>
            </div>
            <div class="form-group">
                <label for="">作者</label>
                <select name="authors" id="authors" class="form-control" multiple>
                    <option value="1">whw</option>
                    <option value="2">naruto</option>
                    <option value="3">sasuke</option>
                </select>
            </div>
            <div class="form-group">
                <h4 id="add_error" class="pull-left" style="color:red;margin-top: 0"></h4>
                <input id="confirm_add" type="button" class="btn btn-success pull-right" value="确认编辑">

            </div>
        </div>
    </div>

{% endblock pannel-body %}

{% block script %}
    <script>

        // 页面加载后将session中的数据写到上面的标签中
        $(document).ready(function () {

            // 获取session中的数据
            var data_session = sessionStorage['edit_book_data'];
            // 记得反序列化一下
            var data = JSON.parse(data_session);
            console.log(data, typeof (data));
            // 取出edit_book_id 把它设置为全局的变量！后面ajax提交的时候会用到
            edit_book_id = data['id'];

            // 将数据填在上面的input框中~注意是val方法！
            $('#book_name').val(data['title']);
            $('#price').val(data['price']);
            $('#pub_date').val(data['pub_date']);
            $('#publish').val(data['publish']['id']);
            // 让之前的作者名被选中
            var arr_val = [];
            for(var i in data['authors']){
                //console.log(data['authors'][i]['id']);
                arr_val.push(data['authors'][i]['id'])
            }
            // console.log(arr_val); [1,2]
            // 把数组传给复选框的val～让之前的作者被选中
            $('#authors').val(arr_val);

        });

        // 确认编辑按钮
        $('#confirm_add').click(function () {
            var title = $('#book_name').val();
            var price = $('#price').val();
            var pub_date = $('#pub_date').val();
            // 下拉列表被选中的这样选取
            var publish = $('#publish option:selected').val();

            //ajax操作
            $.ajax({
                url: '/book/'+edit_book_id+'/',
                type: 'put',
                data: {
                    title: title,
                    price: price,
                    pub_date: pub_date,
                    //pub_date: "2019-08-02T09:35:13.064532Z",
                    post_publish: publish,
                    //post_authors: authors,
                    post_authors: $('#authors').val(),
                },
                // 传数组～
                traditional: true,

                success: function (data) {
                    console.log(data);
                    //alert('添加成功！');
                    location.href = '{% url "book_list" %}';
                }
            })

        });

    </script>

{% endblock script %}