zoukankan      html  css  js  c++  java
  • REST规范和RESTful框架简介

    Rest:表征性状态转移,也叫资源状态转移
    只要有被引用的必要,都是资源,
    可以是实体,例如个人信息,手机号,也可以是抽象的概念,例如两个人的关系
    URI:统一资源标识符
    URL:统一资源定位符
    例如每个人的身份证号就是URI
    '地球/中国/xx省/xx市/xx县/xx村/张三'就是URL
    URL是URI的子集,通过定位的方式实现URI

    统一资源接口:
    可以通过URL去访问不同的资源,会有很多不同的操作,增删改查
    之前是增删改查各一个URL,现在不用了,只有一个URL
    根据HTTP请求方式的不同,对资源进行不同的操作。这个就是统一资源接口


    资源的表述:
    就是资源的展现形式,客户端和服务端传输的是资源的表述(格式),而不是资源本身。
    例如文本资源可以用html、xml、json等格式,图片可以用png、jpg等
    可以通过HTTP内容协商,客户端可以通过Accept头请求一种特定格式的表述,服务端则通过Content-Type告诉
    客户端资源的表述形式
    这些资源的表述呈现在页面上,就是我们所说的资源状态
    “传输的是资源的表述,呈现的是资源的状态”

    状态转移:
    我们在看页面的时候,从当前资源的表述(也可以说是状态或者表现层)
    会跳转到其他的资源状态。
    服务端通过超媒体告诉客户端当前状态有哪些后续状态可以进入
    这些类似“下一页”之类的链接起的就是这种推进状态的作用--指引你如何从当前状态进入下一个可能的状态

    总结:
    1)在web中,只要有被引用的必要都叫资源。
    2)每个URI代表一个资源,独一无二的。
    3)客户端通过HTTP的方法,对服务器端资源进行操作。
    4)客户端和服务器之间,传递这种资源的某种表现层。
    5)通过超链接的指引,实现“表现层状态转移”

    RESTful
    如果一个架构符合REST的约束条件和原则,我们就称它为RESTful架构。
    一种软件的架构风格,设计风格,为客户端和服务端的交互提供一组设计原则和约束条件。
    restful规范
    一 面向资源编程
    每个URL代表一种资源,URL中尽量不要用动词,要用名词。
    二 根据method不同,进行不同的操作
    GET/POST/PUT/DELETE/PATCH
    三 在URL中体现版本
    https://www.bootcss.com/v1/mycss
    https://v1.bootcss.com/mycss
    四 在URL中体现是否是API
    https://www.bootcss.com/api/mycss
    https://api.bootcss.com/mycss
    五 在URL中的过滤条件
    https://www.bootcss.com/v1/mycss?page=3
    六 尽量使用HTTPS
    https://www.bootcss.com/v1/mycss
    七 响应时设置状态码
    1** 信息
    2** 成功
    3** 重定向
    4** 客户端错误
    5** 服务端错误
    八 返回值
    GET:返回查到的所有或单条数据
    POST:返回新增的数据
    PUT:返回更新数据
    PATCH:局部更新,返回更新整条数据
    DELETE:返回值为空
    九 返回错误信息
    返回值携带错误信息
    十 HypermediaAPI
    如果遇到需要跳转的情况 携带跳转接口的URL
    ret={code:100, data{id:1,name:'张三',depart_id:http://www.luff.com/depart/8}}

  • 相关阅读:
    django channels 模型图
    React-Router 非Route监管组件如何监听location变化?
    djoser
    Integration of hot-load django dev sever and hot-load reactjs dev server
    type annotation / static checker / dynamic checker of python
    Prototype of Draw and Guess Game
    Django Channels -- more than HTTP
    DRF Views Inheritance Relationships
    Django REST framework -- ViewSets & Routers
    Django REST framework -- Relationships & Hyperlinked APIs
  • 原文地址:https://www.cnblogs.com/staff/p/12555093.html
Copyright © 2011-2022 走看看