博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
RESTful接口设计原则和优点
阅读量:6220 次
发布时间:2019-06-21

本文共 1312 字,大约阅读时间需要 4 分钟。

RESTful架构优点:

  1. 前后端分离,减少流量
  2. 安全问题集中在接口上,由于接受json格式,防止了注入型等安全问题
  3. 前端无关化,后端只负责数据处理,前端表现方式可以是任何前端语言(android,ios,html5)
  4. 前端和后端人员更加专注于各自开发,只需接口文档便可完成前后端交互,无需过多相互了解
  5. 服务器性能优化:由于前端是静态页面,通过nginx便可获取,服务器主要压力放在了接口上

RESTful架构设计原则(不同公司具体细节可能不同):

  1. 在接口命名时应该用名词,不应该用动词,因为通过接口操作到是资源。
  2. 在url中加入版本号,利于版本迭代管理更加直观
    https://www.rgc.com/v1/
  3. 对于资源的操作类型应该是通过http动词表示。
    • GET /zoos:列出所有动物园
    • POST /zoos:新建一个动物园
    • GET /zoos/ID:获取某个指定动物园的信息
    • PUT /zoos/ID:更新某个指定动物园的信息(提供该动物园的全部信息)
    • DELETE /zoos/ID:删除某个动物园
    • GET /zoos/ID/animals:列出某个指定动物园的所有动物
    • DELETE /zoos/ID/animals/ID:删除某个指定动物园的指定动物
  4. 排序规则:默认时升序,‘-’为降序;多个排序规则时以逗号间隔组合。使用sort查询参数限制
    GET /tickets?sort=-time,created_at 优先以time倒序显示,其次以created_at正序显示
  5. 限制返回值的字段域:明确指定输出字段列表,用于控制网络带宽和速度。使用fields查询参数来限制。
    GET /tickets?fileds=id,subject,customer_name,time&sort=-time 返回参数列表为id,subject,customer_name,time,并且以time字段倒序显
  6. HTTP Method分别对于资源的CURD操作
    GET(SELECT):从服务器取出资源(一项或多项)。POST(CREATE):在服务器新建一个资源。PUT(UPDATE):在服务器更新资源(客户端提供改变后的完整资源)。PATCH(UPDATE):在服务器更新资源(客户端提供改变的属性)。DELETE(DELETE):从服务器删除资源。

    保证 POST,PUT,DELETE,PATCH,GET 操作。

  7. 使用SSL(Secure Sockets Layer 安全套接层)
  8. 参数和url采用蛇行命名方式。如:updated_time
  9. 服务器请求和返回的数据格式,应该尽量使用JSON,避免使用XML。在 request中的Accept和Response中的Content-Type:application/json

 

总结:优秀的RESTful接口设计,能够根据请求的路径及请求方法就能看出这个接口主要是对具体某个资源进行什么方法的操作以及返回数据的规则等等。

 

参考资料:

转载于:https://www.cnblogs.com/rgcLOVEyaya/p/RGC_LOVE_YAYA_617days.html

你可能感兴趣的文章
Hibernate查询方式汇总
查看>>
hpux filecache问题
查看>>
下一代太阳自适应光学技术让太空“天气预报”更精准
查看>>
气象与情绪有何联系?低温天气比恐袭更容易令人抑郁
查看>>
使用Jmeter对mysql进行性能测试入门
查看>>
用java在图片上写字
查看>>
spring的成功配置样式
查看>>
spring注解之 @profile
查看>>
Linux 重定向以及管道讲解
查看>>
Myeclipse debug 调试模式
查看>>
exchange IE登录提示http 500 内部服务器错误
查看>>
eclipse中怎么找到编译后的class路径
查看>>
linux下配置文件的读写
查看>>
如何配置IP寻址
查看>>
Veeam Backup & Replication 6.0 XX版安装
查看>>
我的友情链接
查看>>
centos更换163源
查看>>
nginx及nginx-rtmp-module安装
查看>>
我的友情链接
查看>>
DIV+CSS 小技巧
查看>>