初识REST

作者: 窗外有个蓝蓝天 | 来源:发表于2015-11-19 09:57 被阅读176次

    REST(表述性状态传递)由Roy Fileding于2000年在他的博士论文中引入。REST是一种分布式系统的设计风格。它不是一个标准而是一系列约束的集合,例如无状态,客户单/服务器关系,以及统一接口等。REST并不一定要和HTTP严格相关,只是大部分的时候和HTTP联系在一起。

    REST的原则

    • Resources 暴露在容易理解的目录结构的URI中。
    • Representations 是使用JSON或者是XML来描述数据对象和属性。
    • Messages 显示地使用HTTP方法(例如,GET,POST,PUT和DELETE)。
    • Stateless 和请求交互的服务器不储存客户端的上下文。状态依赖限制和约束伸缩性。客户端持有会话状态。

    HTTP方法

    使用HTTP方法在请求中映射CRUD(创建,查询,更新,删除)操作。

    GET

    检索信息。GET请求必须是安全和幂等的,这就意味着无论使用相同的参数重复多少次,请求的结果都是相同的。它们可能会有副作用,但是用户不希望那样,因此他们不能是对系统至关重要的操作。请求也可以是部分的或者是有条件的。

    检索ID为1的地址:

    GET / addresses/1

    POST

    使用提供的实体对URI上的资源做一些事情。POST经常被用来创建一个新的实体,但是也可以用来更新一个实体。

    创建一个地址:

    POST /addresses

    PUT

    在一个URI上存储一个实体。PUT能够创建一个实体或者是更新一个已经存在的实体。一个PUT请求也是幂等的。幂等性是POST和PUT请求的主要区别。

    修改ID为1的地址:

    PUT /addresses/1
    注意:PUT只替换已经存在的实体。如果只有一个数据元素的子集被提供,那么剩下的部分将会替换成空或者null。

    PATCH

    只更新URI上实体的指定字段。一个PATCH请求也是幂等的。幂等性是POST和PATCH请求的主要区别。

    DELETE

    被请求的资源将被移除。然而,资源不必被立刻移除。因此请求可以是异步的或者是长连接的。

    删除ID为1的地址:

    DELETE /addresses/1

    HTTP状态码

    状态码决定HTTP请求的结果.

    • 1XX - 信息类
    • 2XX - 成功
    • 3XX - 跳转
    • 4XX - 客户端错误
    • 5XX - 服务器错误

    媒体类型

    在HTTP请求中HTTP头AcceptContent-Type可以用来描述被发送的或者是被请求的内容。客户端可以设置Acceptapplication/json如果当前请求的响应为JSON格式的话。相反的,设置Content-Typeapplication/xml则告知客户端发送数据的请求是XML格式。

    相关文章

      网友评论

        本文标题:初识REST

        本文链接:https://www.haomeiwen.com/subject/pgqlhttx.html