Django REST Framework使用案例和教程

创建Django项目

• 创建项目，项目名为 mysite

django-admin.py startproject mysite

• 在项目内创建应用，应用名为 api

python manage.py startapp api

• 在项目内注册应用

在 项目根目录/mysite/ 下的setting.py 里的 INSTALLED_APPS 列表下添加应用

INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
 
'api', #这行添加你的应用
]

• 创建管理员用户

django的模板里带有用户表，所以可以不用自己写用户权限相关的内容了。这里创建一个管理员

python manage.py createsuperuser

按照提示输入用户名和密码，这个账号密码作为进入django后台的凭证

• 创建测试的模型

模型对应表结构，django提供了一套api来非常方便对接数据库，这里建立一个Student模型。注意Python代码复制粘贴后的格式问题。

# 底下的代码是在干什么？应该可以猜到吧？就是用python代码建立了一个数据库表
class Student(models.Model):
    name = models.CharField(u'姓名', max_length=100, default='no_name')
    sex = models.CharField(u'性别',max_length=50,default='male')
    sid = models.CharField(u'学号',max_length=100,default='0')

    def __unicode__(self):
        return '%d: %s' % (self.pk, self.name)

搞定了代码，配置好数据库就可以了。Django自带的数据库为sqlite，如果要转换成其他数据库请看django官方文档或者我的其他教程。

接下来我们执行两行命令将代码转换为数据库表，进行迁移

python manage.py makemigrations
python manage.py migrate

• 配置管理员后台的路由

我们需要路由将我们的代码配置到对应的url路径上。在mysite文件夹下的urls.py文件，添加代码：

from django.contrib import admin
from django.urls import path,include
 
urlpatterns = [
    path('admin/', admin.site.urls),
]

• 测试Django项目是否搭建正常

在admin后台注册这个Student模型，或者说是数据库表。找到api文件夹下的admin.py，填入以下代码：

from .models import Student # 导入模型包里的Student模型

@admin.register(Student)
class BlogTypeAdmin(admin.ModelAdmin):
    list_display = ('pk', 'name')    #在后台列表下显示的字段

然后我们运行项目，如果使用Pycharm直接按绿色的run就可以了，本质上还是执行了以下的命令：

python manage.py runserver

如果显示以下信息，代表成功

System check identified no issues (0 silenced).
December 25, 2019 - 09:59:46
Django version 2.2.5, using settings 'mysite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CTRL-BREAK.

打开浏览器进入 http://127.0.0.1:8000/admin 或者 http://localhost:8000/admin 访问