Django REST framework（官方说明文档翻译）（1快速开始 ）
第一部分：快速开始
我们将创建一个简单的api接口，用来给admin用户查看及编辑系统里面的用户和群组
1）新建项目
新建一个名为tutorial的django项目，然后新建一个名为 quickstart的app
1、这里我们打开编辑器pycharm，新建项目
**2、通过脚手架命令新建app **
app创建在项目路径下面可能看起来会有点奇怪，这样做其实是为了防止和外部的命名空间冲突
3、接下来我们第一次来做数据库的同步
用到命令：python manage.py migrate
4、然后我们也需要初始化一个名为 admin ，密码为 password123 的用户。通过如下命令：
python manage.py createsuperuser --email admin@example.com --username admin
当我们创建一个db且初始化用户创建好后，我们就可以打开app的目录开始coding了
2）序列化Serializers
首先我们要定义一些序列化类，我们需要在quickstart路径下新建一个名为serializers.py的文件并加入下面的代码，它将用于数据展示。
# serializers.py
from django.contrib.auth.models import User, Group
from rest_framework import serializers
class UserSerializer(serializers.HyperlinkedModelSerializer):
class Meta:
model = User
fields = ('url', 'username', 'email', 'groups')
class GroupSerializer(serializers.HyperlinkedModelSerializer):
class Meta:
model = Group
fields = ('url', 'name')
注意到了么？我们在上面的例子中用到了超链接关系类：HyperlinkedModelSerializer。当然你可以用基础的key和各种其他的关系，但超链接是一个很不错的RESTful设计
3）视图Views
是的，现在我们最好写一些视图。打开tutorial/quickstart/views.py文件开始敲下面的代码吧 ：
# views.py
from django.contrib.auth.models import User, Group
from rest_framework import viewsets
from tutorial.quickstart.serializers import UserSerializer, GroupSerializer
class UserViewSet(viewsets.ModelViewSet):
"""
API endpoint that allows users to be viewed or edited.
"""
queryset = User.objects.all().order_by('-date_joined')
serializer_class = UserSerializer
class GroupViewSet(viewsets.ModelViewSet):
"""
API endpoint that allows groups to be viewed or edited.
"""
queryset = Group.objects.all()
serializer_class = GroupSerializer
我们将所有常用的功能组织到一个名为：ViewSets 的类中，而不是写很多view。 我们可以轻易的分解到单个view中如果我们需要的话，但是用viewsets 视图集可以保持良好的组织逻辑性和精确性。
4） URLs
好的，现在我们在tutorial/urls.py文件中接通的接口地址：
# urls.py
from django.conf.urls import url, include
from rest_framework import routers
from tutorial.quickstart import views
router = routers.DefaultRouter()
router.register(r'users', views.UserViewSet)
router.register(r'groups', views.GroupViewSet)
# Wire up our API using automatic URL routing.
# Additionally, we include login URLs for the browsable API.
urlpatterns = [
url(r'^', include(router.urls)),
url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework'))
]
- 因为我们正在用viewsets视图集类而不是视图views类，所以我们可以给我们的接口自动生成url配置，只需要通过一个router类简单的注册下viewsets视图集类；
- 再说一遍，如果我们需要更所的对API URLs的控制，我们仅仅只需要选择用常规的基于类的视图（class-based views），及显示的写URL conf。
- 最后，我们这里还可以在浏览器上用默认的登录和登出视图接口。当然，这是可以选择的，但是如果你的api需要授权认证或者你想用浏览器接口，它就会变得很有用了。
5） 配置Settings
在tutorial/settings.py配置文件的INSTALLED_APPS块中加上'rest_framework':
INSTALLED_APPS = (
...
'rest_framework',
)
ok，这样我们就都搞定了！
6) 测试我们的web接口
我们现在准备测试我们创建的接口了，当然我们需要先在命令行启动我们的服务： python manage.py runserver
然后直接在浏览器中请求我们的接口服务吧，请求地址 http://127.0.0.1:8000/users/
如果你是通过浏览器调用接口的，确认下是不是登录了哈。
是的，先在看来DRF这个真的很棒，也很简单。
如果你想要更深入的理解如何使用DRF，请看下一章或英文官方接口文档
最新文章
- 微信JSApi支付~订单号和微信交易号
- Perst常用命令
- 【GoLang】golang context channel 详解
- ios 开源代码
- 利用Nginx+Mono+Fastcgi代替IIS对Asp.Net进行反向代理
- Eclipse4.4安装旧版本插件报错 Failed to prepare partial IU
- javascript 读取内联之外的样式(style、currentStyle、getComputedStyle区别介绍) (转载)
- Android应用程序与SurfaceFlinger服务的连接过程分析
- JQUERY省、市、县城市联动选择
- jquery中DOM的操作方法
- EF - Code First 开发方式
- js原型链的深度理解!
- 微服务架构的服务与发现-Spring Cloud
- socket 总结
- C# SetParent将其他程序嵌入自己的程序
- 解决以showModalDialog打开的页面在提交表单时弹出新窗口的问题
- python 之datetime库学习
- ce+od无法同时附加进程的问题
- JavaScript数据结构-10.字典
- 大数据系列之分布式数据库HBase-1.2.4+Zookeeper 安装及增删改查实践