一: 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风格的由来 |
Rest(Representational State Transfer)全称是表述性状态转移,它是由Roy Thomas Fielding博士在2000年提出的,它表示的是一种新的架构风格,一种轻量级,跨平台,跨语言的架构设计。
API(Application Programming Interface): 既我们熟知的接口,是一组编程接口规范、客户端与服务端通过请求响应进行数据通信。
RestfulAPI: 它不是一种新的技术,而是基于Rest架构思想的API设计风格。
三: Restful API风格的优点 |
(一) 优点:
(二) 优点解释:
(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的问题,其实,它并不是我们想象中的那么高深莫测,它只是一种设置API架构风格,而不是一种新的技术,遵循这种风格设计的API就被称为Restful API。
相信,看完这篇文章,你已经对Restful API有了一个新的认识,如果还有什么问题需要反馈的,可以在下方留言或者私信我,我看到会第一时间回复,如果你觉得文字对你有帮助,麻烦给我一个点赞和关注,后面会给大家分享更多技术知识,最后,感谢你的阅读,如果能够帮助到你,那是我最大的收获。
------- 关注我的公众号,里面有JAVA架构师的学习材料和IDEA插件,所有你需要的,都可以给我留言,我负责帮你找! ----------
往期文章推荐:
1、Docker方式启动tomcat,访问首页出现404错误
2、Docker方式启动tomcat,访问首页出现404错误(第二篇 – 将修改过的容器映射成镜像)
3、你真的懂for update?(面试必备)
4、操作Excel,除了使用POI你还会其他的?
5、SpringBoot中使用Transaction注解遇到的坑
本文地址:https://blog.csdn.net/qq_40891009/article/details/107573270
如对本文有疑问, 点击进行留言回复!!
网友评论