RESTful 架构介绍

RESTful介绍

REST全称是Representational State Transfer,中文意思是表述(编者注:通常译为表征)性状态转移。
RESTful是一个针对URI的架构,使用RESTful风格的URI可以使URI更具可读性。代码更加整洁且富有逻辑性。
首先要明白,RESTful架构是面向资源的。
每一个URI可以确定一个资源。而用户或程序员使用RUI其实就是在操作资源。
因此至始至终都应该围绕资源来设计URI。

使用RESTful架构作用

1)使URI更具可读性,避免无意义的URI。URI的作用就是指向一个确定的资源。通过URI就可以知道操作的是什么资源。

2)使用一个合理的URI架构可以简化开发,避免走入误区,减少犯错成本。

3)构建起程序员之间的约定。像SpringBoot的理念一样约定大于配置。大家保持同一个约定,那么你就可以更加高效的读懂其他人的代码。可以大幅节约开发时间,减少不必要的误解。

RESTful架构的原则

知道了RESTful架构的作用,那么接下来就进入正题吧。真正学习如何使用RESTful架构。

1.明确URI在操作什么资源

假设现在要做一个登录模块,那么登录时操作的资源就是用户(user)
那么你的URI就应该使用/user/users
这个单词用单数形式还是复数形式都可以,这里建议使用复数形式。
比如你的服务器网址是http://api.example.com
那么操作user的URI就可以是http://api.example.com/users

2.明确URI在做什么操作。

RESTful架构要求统一使用标准的HTTP方法。如GETPOSTPUT等。

GET

安全且幂等
获取表示
变更时获取表示(缓存)
使用GET不应该对服务器状态产生影响。例如增加session之类。

POST

不安全且不幂等
使用服务端管理的(自动产生)的实例号创建资源
创建子资源
部分更新资源

PUT

不安全但幂等
用客户端管理的实例号创建一个资源
通过替换的方式更新资源

DELETE

不安全但幂等
删除资源

3.可以在URI里带上资源的主键

如果要使用主键来获得资源可以在URI里加上主键。如:
http://api.example.com/users/1
要获取资源集合的话,可以用,;来分割主键。如:
http://api.example.com/users/1,2,3,4
http://api.example.com/users/1;2;3;4

4.在URI里边带上版本号

有些API在URI里边带上版本号,例如:
http://api.example.com/1.0/users
http://api.example.com/2.0/users
http://api.example.com/3.0/users

用来区分不同版本的URI接口。

5.使用/来区分资源的层级关系

例如上述
/git/git/commit/e3af72cdafab5993d18fae056f87e1d675913d08
就表示了一个多级的资源, 指的是git用户的git项目的某次提交记录,
又例如/orders/2012/10可以用来表示2012年10月的订单记录。

6.使用?用来过滤资源

很多人只是把?简单的当做是参数的传递,很容易造成URI过于复杂、难以理解。
可以把?用于对资源的过滤,
例如/git/git/pulls用来表示git项目的所有推入请求,
/pulls?state=closed用来表示git项目中已经关闭的推入请求,
这种URL通常对应的是一些特定条件的查询结果或算法运算结果。

参考资料

RESTful 架构详解

  • 1
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

笑我归无处

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值