restful api和普通api有什么特点_轻松写出优雅的Restful风格API
搬运篇
温馨提示: 本文总共1365字,阅读完大概需要1-3分钟,希望您能耐心看完,倘若你对该知识点已经比较熟悉,你可以直接通过目录跳转到你感兴趣的地方,希望阅读本文能够对您有所帮助,如果阅读过程中有什么好的建议、看法,欢迎在文章下方留言或者私信我,您的意见对我非常宝贵,再次感谢你阅读本文。
| 一: Restful API展示 |
一: Restful API展示
废话不多说、先展示Restful 风格的API
1、// 新增一篇文章@RequestMapping(value = "/articles",method = RequestMethod.POST)2、// 删除一篇文章@RequestMapping(value = "/articles",method = RequestMethod.DELETE)3、// 删除某一类文章下的一篇文章@RequestMapping(value = "/types/{id}/articles",method = RequestMethod.DELETE)4、 // 查询一篇文章@RequestMapping(value = "/articles/{id}",method = RequestMethod.GET)5、// 查询某一类文章中的所有文章@RequestMapping(value = "/types/{id}/articles",method = RequestMethod.GET)6、// 修改一篇文章(全部属性)@RequestMapping(value = "/articles/{id}",method = RequestMethod.PUT)7、// 修改一篇文章(某些属性)@RequestMapping(value = "/articles/{id}",method = RequestMethod.PATCH)| 二: Restful风格的由来 |
二: Restful API风格的由来
Rest(Representational State Transfer)全称是表述性状态转移,它是由Roy Thomas Fielding博士在2000年提出的,它表示的是一种新的架构风格，一种轻量级,跨平台,跨语言的架构设计。
API(Application Programming Interface): 既我们熟知的接口,是一组编程接口规范、客户端与服务端通过请求响应进行数据通信。
RestfulAPI: 它不是一种新的技术,而是基于Rest架构思想的API设计风格。
| 三: Restful API风格的优点 |
三: Restful API风格的优点
(一) 优点:
- 它是面向资源的(名词)
- 通过URL就知道需要什么资源
- 通过Http Method(get/post...)就知道针对资源干什么
- 通过Http Status Code就知道结果如何
(二) 优点解释:
(1)通过URL就知道需要什么资源：表示Restful风格的API可以直接通过URL就可以看到需要操作的是什么资源,有语义化。
(2)Restful风格的API是面向资源(名称)的,既URL中不会带相应的动词,针对资源的操作是通过Http Method(既:post-增、delete-删、put-改(一般是提供实体的全部信息)、patch-改(修改实体的某些属性)、get-查)来实现的。
(3)通过Http Status Code就知道结果如何: 如常见的200(成功)、400(错误的请求参数)、500(服务器错误)等。
| 四: Restful API风格的注意事项 |
四: Restful API风格的注意事项
- 请求资源应该使用复数而不是单数,因为Restful API风格是是面向资源的(名词)
- 强制性添加API版本声明，不要发布无版本的API,如: api.v1/blogs(开闭原则)，对拓展开发、对修改关闭,如果后面需要添加新的功能，可以直接新开接口加上版本号就可。
| 五: 总结 |
五: 总结
无论是面试或者工作中,总会听到别人问到关于Restful风格API的问题,其实,它并不是我们想象中的那么高深莫测,它只是一种设置API架构风格,而不是一种新的技术,遵循这种风格设计的API就被称为Restful API。
