什么是REST

  • REST与技术无关,代表的是一种软件架构风格.REST全称是Representational State Tranfer, 表征性状态转移.
  • REST从资源的角度类审视整个网络,它将分布在网络中某个节点的资源通过URL进行标识,客户端应用通过URL来获取资源的表征,获得这些表征致使这些应用的转变装态
  • 所有的数据,不管是通过网络获取还是增删改查的数据都是资源, 将一切数据视为资源是REST区别其他架构风格的最本质属性
  • 对于REST这种面向资源的架构风格,有人提出一种全新的结构理念,即:面向资源架构(ROA:Resource Oriented Architecture)

RESTful API设计规范

  • API与用户的通信协议,总是使用HTTPS协议

  • 域名

  • 版本

  • method

    • GET :从服务器取出资源(一项或多项)
      • 安全且幂等

      • 获取表示

      • 变更时获取表示(缓存)

      • 200(OK) - 表示已在响应中发出

      • 204(无内容) - 资源有空表示

      • 301(Moved Permanently) - 资源的URI已被更新

      • 303(See Other) - 其他(如,负载均衡)

      • 304(not modified)- 资源未更改(缓存)

      • 400 (bad request)- 指代坏请求(如,参数错误)

      • 404 (not found)- 资源不存在

      • 406 (not acceptable)- 服务端不支持所需表示

      • 500 (internal server error)- 通用错误响应

      • 503 (Service Unavailable)- 服务端当前无法处理请求

    • POST :在服务器新建一个资源
      • 不安全且不幂等

      • 使用服务端管理的(自动产生)的实例号创建资源

      • 创建子资源

      • 部分更新资源

      • 如果没有被修改,则不过更新资源(乐观锁)

      • 200(OK)- 如果现有资源已被更改

      • 201(created)- 如果新资源被创建

      • 202(accepted)- 已接受处理请求但尚未完成(异步处理)

      • 301(Moved Permanently)- 资源的URI被更新

      • 303(See Other)- 其他(如,负载均衡)

      • 400(bad request)- 指代坏请求

      • 404 (not found)- 资源不存在

      • 406 (not acceptable)- 服务端不支持所需表示

      • 409 (conflict)- 通用冲突

      • 412 (Precondition Failed)- 前置条件失败(如执行条件更新时的冲突)

      • 415 (unsupported media type)- 接受到的表示不受支持

      • 500 (internal server error)- 通用错误响应

      • 503 (Service Unavailable)- 服务当前无法处理请求

    • PUT :在服务器更新资源(客户端提供改变后的完整资源)
      • 不安全但幂等

      • 用客户端管理的实例号创建一个资源

      • 通过替换的方式更新资源

      • 如果未被修改,则更新资源(乐观锁)

      • 200 (OK)- 如果已存在资源被更改

      • 201 (created)- 如果新资源被创建

      • 301(Moved Permanently)- 资源的URI已更改

      • 303 (See Other)- 其他(如,负载均衡)

      • 400 (bad request)- 指代坏请求

      • 404 (not found)- 资源不存在

      • 406 (not acceptable)- 服务端不支持所需表示

      • 409 (conflict)- 通用冲突

      • 412 (Precondition Failed)- 前置条件失败(如执行条件更新时的冲突)

      • 415 (unsupported media type)- 接受到的表示不受支持

      • 500 (internal server error)- 通用错误响应

      • 503 (Service Unavailable)- 服务当前无法处理请求

    • PATCH :在服务器更新资源(客户端提供改变的属性)
    • DELETE :从服务器删除资源
      • 不安全但幂等

      • 删除资源

      • 200 (OK)- 资源已被删除

      • 301 (Moved Permanently)- 资源的URI已更改

      • 303 (See Other)- 其他,如负载均衡

      • 400 (bad request)- 指代坏请求

      • 404 (not found)- 资源不存在

      • 409 (conflict)- 通用冲突

      • 500 (internal server error)- 通用错误响应

      • 503 (Service Unavailable)- 服务端当前无法处理请求

  • 路径,一切都是资源, 均用名词表示(可以复数)

  • 过滤, 通过在url上传参的形式传递搜索条件

状态码

  • 1 开头: 服务器正在处理

  • 2 开头: 服务器处理成功

  • 3 开头: 重定向

  • 4 开头: 客户端错误

  • 5开头 : 服务器错误

    在返回的数据中携带状态码

URl设计上的技巧

  • 使用 _或者 - 让URL可读性更好

  • 使用/表示资源层级关系

  • 使用?过滤资源

  • 使用,或者;表示同级资源关系

    GitHub使用来表示同级关系

基于Django实现

路由

urlpatterns = [
url(r'^users/$', views.Users.as_view()),
url(r'^users2/$', views.user2),
]

视图

import json

def  user2(request):
if request.method=='GET':
dic = {'status':200,'name': 'lqz2', 'age': 18}
return HttpResponse(json.dumps(dic))
elif request.method=='POST':
dic = {'status': 200, 'msg': '修改成功'}
return JsonResponse(dic) class Users(View):
def get(self, request):
dic = {'status':200,'name': 'lqz', 'age': 18}
return HttpResponse(json.dumps(dic)) def post(self, request):
dic = {'status': 200, 'msg': '修改成功'}
return JsonResponse(dic)

常见问题:

POST和PUT用于创建资源时有什么区别?

POST和PUT在创建资源的区别在于,所创建的资源的名称(URI)是否由客户端决定。 例如为我的博文增加一个java的分类,生成的路径就是分类名/categories/java,那么就可以采用PUT方法。不过很多人直接把POST、GET、PUT、DELETE直接对应上CRUD,例如在一个典型的rails实现的RESTful应用中就是这么做的。

我认为,这是因为rails默认使用服务端生成的ID作为URI的缘故,而不少人就是通过rails实践REST的,所以很容易造成这种误解。

客户端不一定都支持这些HTTP方法吧?

的确有这种情况,特别是一些比较古老的基于浏览器的客户端,只能支持GET和POST两种方法。

在实践上,客户端和服务端都可能需要做一些妥协。例如rails框架就支持通过隐藏参数_method=DELETE来传递真实的请求方法, 而像Backbone这样的客户端MVC框架则允许传递_method传输和设置X-HTTP-Method-Override头来规避这个问题。

APIView源码分析的更多相关文章

  1. CBV源码分析+APIVIew源码分析

    {drf,resful,apiview,序列化组件,视图组件,认证组件,权限组件,频率组件,解析器,分页器,响应器,URL控制器,版本控制} 一.CBV源码分析准备工作: 新建一个Django项目 写 ...

  2. $Django cbv源码分析 djangorestframework框架之APIView源码分析

    1 CBV的源码分析 #视图 class login (View): pass #路由 url(r'^books/$', views.login.as_view()) #阅读源码: #左侧工程栏--- ...

  3. Django rest framework框架——APIview源码分析

    一.什么是rest REST其实是一种组织Web服务的架构,而并不是我们想象的那样是实现Web服务的一种新的技术,更没有要求一定要使用HTTP.其目标是为了创建具有良好扩展性的分布式系统. 可用一句话 ...

  4. Restful规范-APIView源码分析

    目录 一.Restful规范 十条规范 二.drf的简单使用 三.APIView源码分析 CBV源码分析 APIView源码分析 一.Restful规范 Restful规范是一种web API接口的设 ...

  5. django Rest Framework----APIView 执行流程 APIView 源码分析

    在django—CBV源码分析中,我们是分析的from django.views import View下的执行流程,这篇博客我们介绍django Rest Framework下的APIView的源码 ...

  6. cbv+resful+APIView源码分析

    CBV源码分析 1概念:什么是cbv和fbv 已经什么是API class bass View ---基于类的视图 function bass View ---基于函数的视图 API(Applicat ...

  7. 探索drf执行流程之APIView源码分析

    Django REST framework 简介 现在新一代web应用都开始采用前后端分离的方式来进行,淘汰了以前的服务器端渲染的方式.而实现前后端分离是通过Django REST framework ...

  8. drf的基本使用、APIView源码分析和CBV源码拓展

    cbv源码拓展 扩展,如果我在Book视图类中重写dispatch方法 -可以实现,在get,post方法执行之前或者之后执行代码,完成类似装饰器的效果 def dispatch(self, requ ...

  9. CBV和APIView源码分析

    CBV源码分析 查看源码的方式,先查看自身,没有去找父类,父类没有就去找父父类... 自己定义的类 class Author(View): def get(self,request): back_di ...

  10. DRF中的APIView源码分析

    首先写一个简单的drf接口 from rest_framework.views import APIView from rest_framework.response import Response ...

随机推荐

  1. Servlet 线程安全

    普通类的静态属性,当被多个线程访问时,就有线程安全问题: Servlet 也一样 当多个客户端并发访问同一个Servlet时,web服务器会为每一个客户端的访问请求创建一个线程,并在这个线程上调用Se ...

  2. T5557 读写卡详解

    T5557的基本信息就不在这里详细介绍,不了解的可以去看T5557的收据手册. 一上来直接开始讲操作 存在七种操作,我们重点介绍四种,Standard Write,Protected Write,Di ...

  3. [PDFBox]后台操作pdf的工具类

    PDFBox是Apache下的一个操作pdf的类库.其也提供了一个命令行的工具,也提供了java调用的第三方类库. 下载地址:https://pdfbox.apache.org/ 下面的实验基于JDK ...

  4. 2.Python list_常用方法总结

    一.创建列表 只要把逗号分隔的不同数据项,使用方括号[],括起来即可, 下标(角标索引)从0开始,最后一个一个元素下标可以写-1 list = ['1' , '2' , '3'] list = []  ...

  5. Linux内存分配小结--malloc、brk、mmap【转】

    转自:https://blog.csdn.net/gfgdsg/article/details/42709943 http://blog.163.com/xychenbaihu@yeah/blog/s ...

  6. VC常用小知识

    (1) 如何通过代码获得应用程序主窗口的 指针?主窗口的 指针保存在CWinThread::m_pMainWnd中,调用AfxGetMainWnd实现.AfxGetMainWnd() ->Sho ...

  7. CentOS(Linux)中解决MySQL乱码

    环境:CentOS 6.3.mysql5.1 Centos 6.3在上安装mysql client和server之后,出现乱码,不得不修改编码. 注意: 关于utf8和gbk的区别详细见:linux中 ...

  8. 【转】C++标准转换运算符reinterpret_cast

    reinterpret_cast<new_type> (expression) reinterpret_cast运算符是用来处理无关类型之间的转换:它会产生一个新的值,这个值会有与原始参数 ...

  9. HDU - 2665 Kth number 主席树/可持久化权值线段树

    题意 给一个数列,一些询问,问$[l,r]$中第$K$大的元素是哪一个 题解: 写法很多,主席树是最常用的一种之一 除此之外有:划分树,莫队分块,平衡树等 主席树的定义其实挺模糊, 一般认为就是可持久 ...

  10. 使用python脚本批量删除阿里云oss中的mp4文件

    #encoding:utf-8 ''' oss中有一些mp4文件需要删除,首先定位出这些文件放在txt文本中 然后通过python操作oss进行批量删除 ''' import oss2 auth = ...