文档章节

Django快速开发实践:Drf框架和xadmin配置指北

o
 osc_qo2uprmb
发布于 07/05 07:53
字数 2190
阅读 55
收藏 0

行业解决方案、产品招募中!想赚钱就来传!>>>

步骤

既然是快速开发,那废话不多说,直接说步骤:

  • 安装Djagno
  • 安装Django Rest Framework
  • 定义models
  • 定义Rest framework的serializers
  • 定义Rest framework的viewsets
  • 配置Rest framework的router
  • 配置管理后台admin
  • 根据需要写template和对应的view

经过这些步骤就能得到一个具备完整的后端接口和后台管理界面的网站了,如果写了template的话还能把前端的工作也做了。

接下来按照上面提到的顺序记录一下我的开发实践。

定义models

好像没啥好说的,Django3多了几个新的特性,可以用class来定义choices,这个比以前的元组定义方便一些,其他的好像没什么了,对了,定义ManyToMany最好设置一个related_name,方便以后在代码里做反向查询。

定义serializers

这个很简单,只要告诉框架你需要序列化model的哪个字段就好了。
官方文档:https://www.django-rest-framework.org/tutorial/1-serialization/

代码例子如下:

from .models import *
from rest_framework import serializers

class StudentSerializer(serializers.ModelSerializer):
    class Meta:
        model = Student
        fields = ['name', 'gender', 'number', 'faculty', 'major', 'year']

附上这个Student的model代码:

class Student(models.Model):
    name = models.CharField('姓名', max_length=10)
    gender = models.IntegerField('性别', default=1, choices=GenderChoices)
    number = models.CharField('学号', max_length=20, blank=True)
    faculty = models.CharField('学院', max_length=20, blank=True)
    major = models.CharField('专业', max_length=20, blank=True)
    year = models.CharField('届别', max_length=4)

    def __str__(self):
        return self.name

定义viewsets

就是把queryset和serializers关联起来。

贴一下代码,对应上面的student的serializers。

from rest_framework import viewsets
from .models import *
from .serializers import *

class StudentViewSet(viewsets.ModelViewSet):
    queryset = Student.objects.all()
    serializer_class = StudentSerializer

配置router

可以理解为Rest Framework的urls配置。

代码:

from rest_framework import routers
from core import views

router = routers.DefaultRouter()
router.register('user', views.UserViewSet)

然后再加入Django的urls配置中:

urlpatterns = [
    path('admin/', admin.site.urls),
    path('api/', include(router.urls)),  # 这里
    path('api-auth/', include('rest_framework.urls')),  # 和这里
]

干净利索,这个router应该和urls一样能嵌套的,不过我没有深入学Rest Framework,所以没有了解到,以后有需要再查一下文档。

关于drf的简单参考文档:

配置管理后台admin

其实这一步也可以放在前面,就是刚定义完models的时候就配置,这样方便管理数据。

Django自带的这个admin可以说很强大了,可以省去很多中小型网站的管理后台开发工作,不过默认的界面是比较丑的,这个用过的人都懂,但是又想用,怎么办?所以要进行美化啊,以前我只知道xadmin这个库,国人开发的,基于bootstrap3界面,重写了整套admin代码,界面好看了不少,无奈有很多bug,文档又几乎是没有的,很多功能实现都只能去看代码,体验极差,严重影响开发效率……(但是为了界面好看我一开始还是只能用这个了)
关于Django配置详情可以看刘江大大的博客,很详细,在我下面的第一个参考链接里面~

界面效果大概这样:

然后我又发现了一个新的xadmin替代品,叫simpleui,号称vue+element ui写的,界面也不错,实际体验嘛,emmm……和xadmin互有千秋。不过这货搞了个pro版本,也就是付费版,所以开源免费版这个能用就偷着乐了,你懂的。

界面如下,还可以换主题。

有兴趣请看看官方github:https://github.com/newpanjing/simpleui

安装xadmin

现在Django-xadmin好像已经不维护了,至少在github上看到是作者去写纯前端的xadmin框架了,然后安装起来也是一波三折,你直接在pip安装也不行,因为那个是xadmin的0.x版本,支持的是Django1.x的,要安装xadmin的django2分支,才能支持Django2.x,然后我一开始用上Django3,貌似这货还和Django3有兼容问题……

那到底怎么安装才好啊?简单点的方法就是官方github说的:

pip install git+git://github.com/sshwsfc/xadmin.git@django2

不过这个方法我有时候可以有时候不行,好像是github被屏蔽了吧,唉,所以还有别的方法,就是安装打包好的wheel文件,从xadmin官方仓库把代码下载下来,然后checkout到django2分支,再运行命令打包成wheel文件,接着就可以拿去pip安装了,有空我上传到pypi,方便一下有需要的同学。

安装完运行可能还会报错:TypeError: render() got an unexpected keyword argument 'renderer',原因是集成DjangoUeditor时出错,需要需要修改虚拟环境下的boundfield.py文件,位置在venv/lib/python3.6/site-packages/django/forms/boundfield.py,修改内容:

89        return widget.render(
90            name=self.html_initial_name if only_initial else self.html_name,
91            value=self.value(),
92            attrs=attrs,
93            # renderer=self.form.renderer,(93行处注释掉,就能正常运行了)
94        )

xadmin配置

xadmin的配置和Django的差不多,但是也有一点小区别,不过还好它支持Django的messages框架,simpleui好像不支持……有毒

Django admin的配置是写在每个app下面的admin.py文件的,xadmin得写在adminx.py里,然后好像也没法像Django一样用装饰器注册admin类,下面的代码展示了注册admin方法:

xadmin.site.register(model类, admin类)

注意xadmin的admin类还不能像Django一样继承ModelAdmin类,只能继承BaseAdminObject或干脆不写,我看xadmin的源码是继承自object的(跟不写一样)

下面这个例子就很全了,各种属性的配置。

class CourseAdmin(object):
    '''课程'''
    list_display = [ 'name','desc','detail','degree','learn_times','students']   #显示的字段
    search_fields = ['name', 'desc', 'detail', 'degree', 'students']             #搜索字段
    list_filter = [ 'name','desc','detail','degree','learn_times','students']    #过滤字段
    model_icon = 'fa fa-book'            #自定义图标
    ordering = ['-click_nums']           #排序功能
    readonly_fields = ['click_nums']     #只读字段,不能编辑
    exclude = ['fav_nums']               #不显示的字段
    inlines = [LessonInline,CourseResourceInline]    #增加章节和课程资源
    list_editable = ['degree','desc'] #在列表页可以直接编辑的
    list_display = ['get_zj_nums']  #直接使用函数名作为字段显示
    list_display = ['go_to']  # 跳转到上面定义的地址
    refresh_times = [3,5]           #自动刷新(里面是秒数)可选3或5秒

admin类的属性详情

  • model_icon:图标用的是font awesome图标,不过这个网站国内好像访问不了,所以我们用国内版的网站替代,http://www.fontawesome.com.cn/icons-ui/
  • inlines的配置和Django的差不多,不过不能像Django一样集成xxxinline的父类……要定义的话参考下面的代码:
class LessonInline(object):
    model = Lesson
    extra = 0

class CourseResourceInline(object):
    model = CourseResource
    extra = 0
  • 还有一个图表功能,不过我觉得没啥用,主要是x坐标换成char字段就显示不出来了,很恶心,例子:
data_charts = {
        "user_count": {'title': u"course_num", "x-field": "addtime", "y-field": ("course_num"),
                       "order": ('addtime',)
        }
}

效果这样:
image.png

admin类的一些方法覆盖

为啥要覆盖?当然是要自定义一些操作啊,比如你要保存用户信息的时候验证某些字段,通过才给保存,不通过就给出提示,咋搞,覆盖父类函数呀!

代码例子:

class ExamineAdmin(BaseAdminObject):
    .......

    def save_models(self):
        # 获取保存的新对象
        obj = self.new_obj
        # 获取原来的对象,如果是创建新对象,则org_obj为空
        org_obj = self.org_obj

        if 不满足条件:
            self.message_user(message="不满足xxx条件", level='error')
        else:
            return super().save_models()

大概就这样,显示信息的话基本能满足,不过就算显示了“不满足xxx条件”的信息,不保存这个model对象,也还会出来一个保存成功信息,xadmin似乎没有提供api关掉,文档啥也没写,要解决这个问题还是自己啃xadmin代码吧,不然靠搜索和文档完全就是黑箱操作……无力吐槽

参考:

写在最后

不得不说,使用Python Django开发网站效率太高了,很方便就做出一套可以用的API+后台管理系统,拿来应付各种课程设计、需求简单的外包都是绰绰有余,而且相关资料也很多,有心学习的话花点时间掌握开发商业网站项目完全不在话下!至于有人质疑Python的性能,人家Instagram的后台就是全套Django开发的,这亿级的用户量可不是闹着玩的,了解一门技术之后好好深入学习提高比整天跟风搞些花里胡哨的有用得多了……

不过最近看了很多net core的博客和知乎问题,我还是看好这个net core5的未来,接下来花点时间继续学我的C#,虽然工作可能用C++比较多……(逃

欢迎交流

交流问题请在微信公众号后台留言,每一条信息我都会回复哈~

o
粉丝 0
博文 79
码字总数 0
作品 0
私信 提问
加载中
请先登录后再评论。
记一次失败的Perl + Nginx + FastCGI 配置过程

这两天心血来潮,不知道为什么和 Perl + Nginx + FastCGI 配置 耗上了。但是失败了,记录如下: 1)安装Nginx 1.4.3 ,我的是WINDOWS 7 系统,修改配置文件如下: location ~ .(pl|cgi|perl)?...

通吃岛-低手哥
2013/10/27
1.6K
7
CDH5: 使用parcels配置lzo

一、Parcel 部署步骤 1 下载: 首先需要下载 Parcel。下载完成后,Parcel 将驻留在 Cloudera Manager 主机的本地目录中。 2 分配: Parcel 下载后,将分配到群集中的所有主机上并解压缩。 3 激...

cloud-coder
2014/07/01
6.8K
1
beego API开发以及自动化文档

beego API开发以及自动化文档 beego1.3版本已经在上个星期发布了,但是还是有很多人不了解如何来进行开发,也是在一步一步的测试中开发,期间QQ群里面很多人都问我如何开发,我的业余时间实在...

astaxie
2014/06/25
2.7W
22
5分钟 maven3 快速入门指南

前提条件 你首先需要了解如何在电脑上安装软件。如果你不知道如何做到这一点,请询问你办公室,学校里的人,或花钱找人来解释这个给你。 不建议给Maven的服务邮箱来发邮件寻求支持。 安装Mav...

fanl1982
2014/01/23
1.2W
6
TDD的测试框架--Machine.Specification

Machine.Specification 是一个 TDD 测试驱动开发的测试框架,简化了测试,无需关心语言本身特性。 Machine.Specifications 带来的好处是不需要在代码里有注释,但同时阅读代码的人可以一目了...

匿名
2013/01/22
1K
0

没有更多内容

加载失败,请刷新页面

加载更多

MySql大表分页(附独门秘技)

问题背景 MySql(InnoDB)中的订单表需要按时间顺序分页查询,且主键不是时间维度递增,订单表在百万以上规模,此时如何高效地实现该需求? 注:本文并非主要讲解如何建立索引,以下的分析均建...

osc_8kei32r9
13分钟前
0
0
css中使用变量

2017年3月,微软宣布 Edge 浏览器将支持 CSS 变量。 这个重要的 CSS 新功能,所有主要浏览器已经都支持了。 声明css变量的时候,变量名前面要加两根连词线(--)。 变量名大小写敏感,--hea...

osc_mpdswsal
14分钟前
0
0
WAS 忘记密码

一、重置密码 1.首先关闭was,ps –ef|grep java 查看java进程号,然后kill -9 XXXX杀掉进程即可。或者使用命令./stopServer.sh server1 2.取消控制台安全验证 方法一:/opt/IBM/WebSphere/...

osc_1i3ltp99
15分钟前
0
0
npm install的--save选项是什么? - What is the --save option for npm install?

问题: I saw some tutorial where the command was: 我看到了一些命令所在的教程: npm install --save What does the --save option mean? --save选项是什么意思? Not able to find the......

fyin1314
15分钟前
0
0
C#使用读写锁三行代码简单解决多线程并发写入文件时线程同步的问题

在开发程序的过程中,难免少不了写入错误日志这个关键功能。实现这个功能,可以选择使用第三方日志插件,也可以选择使用数据库,还可以自己写个简单的方法把错误信息记录到日志文件。 选择最...

osc_7cws6vmd
16分钟前
0
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部