zoukankan      html  css  js  c++  java
  • RestFul

    理解Rest

           如果我们想要理解restful,就要理解Representational State Transfer这个词组的意思,表征性状态转移。

      这里所说的表征性,其实指的就是资源。通常我们称为资源状态转移。

    什么是资源

      任何事物,只要有被引用到的必要,它就是一个资源。

      我们在浏览器中看到的文本,视频,图片等等都是资源。这些都是实实在在存在的实体。

      资源可以是一个实体,也可以是抽象概念。

      比如说吧:

        -- Alex的个人信息

        -- 沛齐的手机号

        -- Alex跟沛齐的潜在关系

      这些都是资源,可以是实体比如个人信息,手机号。也可以是抽象的概念,比如两个人的关系......

      那么在我们的网络中,我们要引用资源,资源一定要有一个标识,在web中的唯一标识就是URI,

      URI我们不常听说,我们经常用URL,那么两者区别是什么呢~

    什么是URI,URL

      URI 统一资源标志符。

      URL 统一资源定位符。

      URI是给我们的资源进行标识的,URL是描述我们资源地址的。

      比如说我们每个人都有名字和身份证,名字可能重名,但是身份证是唯一的,

      那么身份证号就可以是我们的URI,标识我们每个人,也可以说标识我们每个资源。

      我们可以通过身份证号找到Alex,也可以通过下面这种方式找到他.....

      Alex的住址协议://地球/中国/屌丝省/屌丝市/寡妇村/250号街道/250号/Alex

      这个就是我们的URL,我们通过这两种方式都可以找到我们的资源,

      其实我们的URL可以说是URI的子集,通过定位的方式实现的URI。

      这是我们资源的定位~~有了资源的地址后,我们要去访问资源,那么我们要通过什么方式去访问呢~~

    统一资源接口

      现在我们可以通过URL去访问到资源,那么我们对资源会有很多不同的操作,增删改查,

      以前我们可能会为了这个增加新设计一个URL,然后这个URL就是对数据进行增加的,

      还会为了更新和删除分别设计一个URL,现在我们不用了,我们只有一个URL,

      然后根据HTTP请求方式的不同,对资源进行不同的操作,这个就是是统一资源接口。

      我们一定要遵循HTTP请求方法的语义,也就是说POST请求就在新增数据等....

    资源的表述

      

      资源的表述其实就是资源的展现形式,我们客户端和服务端传输的都是资源的表述,而不是资源本身。

      例如文本资源可以采用html、xml、json等格式,图片可以使用PNG或JPG展现出来。

      那么客户端如何知道服务端提供哪种表述形式呢?

      可以通过HTTP内容协商,客户端可以通过Accept头请求一种特定格式的表述,服务端则通过Content-Type告诉客户端资源的表述形式。

      这些资源的表述呈现在页面上,就是我们说的资源状态。

     

    状态转移

      我们在看页面的时候,从当前资源的表述(也可以说状态或者表现层)会跳转到其他的资源状态。

      服务端通过超媒体告诉客户端当前状态有哪些后续状态可以进入。

      这些类似"下一页"之类的链接起的就是这种推进状态的作用——指引你如何从当前状态进入下一个可能的状态。

    总结 

      可以得知REST风格的特点如下:

      (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

    七  响应时设置状态码

      1**   信息,服务器收到请求,需要请求者继续执行操作

      2**  成功,操作被成功接收并处理

      3**  重定向,需要进一步的操作以完成请求

      4**  客户端错误,请求包含语法错误或无法完成请求

      5**  服务器错误,服务器在处理请求的过程中发生了错误

    八  返回值

      GET请求 返回查到所有或单条数据

      POST请求  返回新增的数据

      PUT请求  返回更新数据

      PATCH请求  局部更新  返回更新整条数据

      DELETE请求  返回值为空

    九  返回错误信息

      返回值携带错误信息

    十  Hypermedia API

      如果遇到需要跳转的情况 携带调转接口的URL

      ret = {
                    code: 1000,
                    data:{
                        id:1,
                        name:'小强',
                        depart_id:http://www.luffycity.com/api/v1/depart/8/
                    }
                }

     

                                                                                                                                                                                                                                                                                                                           

  • 相关阅读:
    自考新教材-p240_2
    自考新教材-p243_5_(1)
    自考新教材-p242_4
    自考新教材-p233
    自考新教材-p230
    Spring入门(9)-AOP初探
    MongoDB的备份与恢复
    JVM基础知识(1)-JVM内存区域与内存溢出
    Spring入门(8)-基于Java配置而不是XML
    Spring入门(7)-自动检测Bean
  • 原文地址:https://www.cnblogs.com/beihan/p/9985347.html
Copyright © 2011-2022 走看看