美文网首页
[编程理解] RESTful风格接口的理解

[编程理解] RESTful风格接口的理解

作者: 霸哥终结者 | 来源:发表于2019-08-09 15:27 被阅读0次

RESTful风格接口并不适合所有情况

有时候,RESTful风格接口的确简化了资源定位以及资源CRUD的问题,但是当我们想做一些特殊操作时 ,该风格显然不适合。

RESTful风格接口组成

  • 请求方法(GET.POST,PUT,DELETE等)
  • 请求路径 http://ip:port/伪资源目录/资源ID

问题

  1. 比如,我们在添加数据时,想对数据的某些特征值做唯一性判断,这时,想创建一个RESTful风格的接口就发现很不适合
    • 首先需要验证的数据没有资源ID,就无法定位服务器资源
    • 该行为显然是一种验证操作,RESTful风格没有相应的具体的请求方法
    • 若请求方法为POST,如果伪资源目录后加入操作名,那就和资源ID冲突,感觉很不RESTful
  2. 当我们做多资源操作时,全拼在伪资源目录后面,要操作资源过多时,会造成url过长的问题,这种时候,把多个资源id放在body里面更为合适

解决方案

自定义接口标准

  • 请求方法(GET,POST
  • 请求路径http://ip:port/伪资源目录/操作/资源ID/资源属性

梨子

  • 域名:www.baidu.com
  • 伪资源目录:user
  • 操作:
    • 分页查询列表:list
    • 添加:add
    • 删除:delete,remove
    • 修改:update,edit
    • 查询详情:detail
    • 删除多个:remove-multiple,delete-multiple
    • 检查唯一性:check-unique
  • 资源ID:
    • 用户名:liuqi
  • 资源属性:
    • 用户名:username
    • 密码:password
    • 邮件地址:email
    • 电话:phone

例如

  • 获取用户信息详情:GET + http://www.baidu.com/user/detail/liuqi
  • 检查用户名唯一:POST + http://www.baidu.com/user/check-unique
  • 只修改邮件地址:POST + http://www.baidu.com/user/update/liuqi/email
  • 删除多个用户:POST + http://www.baidu.com/user/update/liuqi/email

缺点

  • 请求路径比RESTful风格的要长
  • 只使用了GET,POST方法

初次学习,多有不足,若有错误或者疑问,还请多多指教

相关文章

  • [编程理解] RESTful风格接口的理解

    RESTful风格接口并不适合所有情况 有时候,RESTful风格接口的确简化了资源定位以及资源CRUD的问题,但...

  • RESTful架构和API设计

    理解RESTful风格 - 阮一峰RESTful设计风格指南 - 阮一峰RESTful 风格api 优点: 将接口...

  • RESTful风格理解

    RESTful网上有很多解释,现在看来其实挺简单的。它本身就是一种风格,不遵守也没啥,但这么多人都愿意遵守这种风格...

  • 理解并设计rest/restful风格接口

    网络应用程序,分为前端和后端两个部分。当前的发展趋势,就是前端设备层出不穷(手机、平板、桌面电脑、其他专用设备.....

  • Kubernetes核心资源对象

    Kubernete API Server提供了RESTful风格的编程接口,其管理的资源是Kubernetes A...

  • 理解 RESTful 风格的 API

    学习完整课程请移步 互联网 Java 全栈工程师 本节视频 【视频】解决模块间的通信问题-RESTful 风格的 ...

  • 关于REST(笔记)

    我的理解,REST是一种设计风格,用 RESTful实现接口,设计清晰,目的明确,且有利于前后端分离。你好,我好,...

  • 基于springboot创建RESTful风格接口

    基于springboot创建RESTful风格接口 RESTful API风格 特点: URL描述资源 使用HTT...

  • restful API 架构风格理解

    API 主要从3方面来定义 1、资源版本兼容定义2、资源模块定义(允许多层模块)3、动作定义(delete/upd...

  • Restful风格的验证码

    Restful风格的验证码 Restful风格的验证码 接口生成验证码接口信息前端显示校验接口信息前端校验 移动端...

网友评论

      本文标题:[编程理解] RESTful风格接口的理解

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