restful风格_什么是RESTful风格的API设计?

28d9735bd248829984e412c1606120fe.png

随着移动互联网的兴起,RESTful风格的API设计也随之流行起来,但我们说了那么多RESTful设计,它到底是什么?本篇文章带大家来了解一下它的真实面目。

RESTful概念

首先,我们需要明确的是RESTful,它是一个理念,是一个设计规范,而并不是什么协议等。

REST,全称Representational State Transfer,直接翻译就是:表现层状态转化。而该翻译之所以晦涩是因为缺少了主语,准确来说应该是“Resource Representational State Transfer”。

通俗来讲,就是“资源在网络中以某种表现形式进行状态转化”。

REST概念是Roy Thomas Fielding在他2000年的博士论文中提出的,他是HTTP协议(1.0版和1.1版)的主要设计者。

有了对RESTful基础概念的了解,我们分别来看看其相关概念的解释。

资源

“资源”是RESTful中最核心的概念之一。在RESTful概念中,互联网中的每一样信息都可以定义为资源,比如文本、图片、音频、视频等。而这些资源又都可以对应一个特定的URI(统一资源定位符),URI为每一个资源的地址或独一无二的识别符。

表现层

针对上面的“资源”,我们要进行相应的呈现,而且可以采用多种的呈现形式,而这些呈现形式就叫做“表现层”。

就拿文本为例,我们可以呈现为JSON格式、XML格式、HTML格式,甚至二进制格式等。这就是表现层所做的事情。

状态转化

资源通常放在服务器端,而客户端对服务器资源的增、删、改、查等操作,便涉及到资源状态的转化。这个过程便是“ 状态转化”。

我们以HTTP协议为例(RESTful不仅仅适用HTTP协议,只不过经常以HTTP协议为衬托),客户端可通过一些操作让服务器端的资源发生变化。

而这整个过程,便是“表现层状态转化”。

在HTTP中,提供了四种常见的操作方式:GET、POST、PUT、DELETE。

这四种操作方式分别对应四种基本操作:GET用来获取资源,POST用来新建资源(也可以用于更新资源),PUT用来更新资源,DELETE用来删除资源。

为什么要使用RESTful风格呢

这是因为RESTful风格的设计拥有以下特点:结构清晰、符合标准、易于理解、扩展方便。

试想一下,如果采用传统的JSP模式,页面内容和代码混合在一起,而此时项目功能需新增移动端、微信小程序等其他客户端,是否需要重新定义接口?

而采用RESTful的定义,不仅结构清晰,更重要的是易于扩展、适用性更广泛。

RESTful风格示例

以用户(User)的增删改查为例,我们可以设计出一下接口形式:每列分别对应,(请求类型:请求地址:功能描述)

  • get : /user/list :获取所有用户信息
  • post:/user:创建用户信息
  • put:/user:更新用户信息
  • get:/user/1:获取资源标识(id)为1的用户信息
  • delete:/user/1:删除资源标识(id)为1的用户信息

看起来是不是简洁、清晰、方便很多?

如果再和SpringBoot结合起来,那就更加方便。下面展示部分通过SpringBoot来实现Controller层的代码。

@RestController@RequestMapping("/user")public class RestfulController {    @Resource    private UserService userService;    /**     * 创建用户操作     */    @PostMapping    public User addUser(User user) {        return userService.addUser(user);    }    /**     * 获取所需用户操作     */    @GetMapping("/list")    public List listUser() {        return userService.findAll();    }    /**     * 更新用户     */    @PutMapping    public User update(User user) {        return userService.update(user);    }    /**     * 修改用户名     */    @PatchMapping    public User updateUsername(User user) {        return userService.updateUsername(user);    }    /**     * 获取用户     */    @GetMapping("{id}")    public User get(@PathVariable("id") Long id) {        return userService.findById(id);    }    /**     * 删除用户     */    @DeleteMapping("{id}")    public void delete(@PathVariable("id") Long id) {        userService.delete(id);    }}

精品SpringBoot 2.x视频教程

https://edu.csdn.net/course/detail/20369,精品Spring Boot 2.x视频教程,打造一套最全的Spring Boot 2.x视频教程。

本文首发来自微信公众号:程序新视界。一个软实力、硬技术同步学习的平台。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/533947.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

java jdbc 增删改封装_JAVA JDBC 常规增删改查简单封装

JAVA JDBC 常规增删改查简单封装,可满足大多基本要求作用:1, 查询列表是直接返回List对象,不必再遍历;2, 单条查询直接返回对象;3, 执行sql仅需一个方法搞定;package com.Main.Tools…

python wget安装_Macbook系统环境安装wget的2个方法 - 传统包及Homebrew安装

考虑到自身项目的拓展需要,朋友建议学习Python爬虫这样对于做大数据采集有较大的帮助,老蒋虽然每天也都接触一些脚本和程序的修改,但是并没有专业和系统的学习某一项编程。所以还是准备陆续的学习Python语言,无论有没有基础&#…

java 程序找错_java代码找错

展开全部你试一下这个行不行,输入的时候是数字e69da5e6ba903231313335323631343130323136353331333335313138,数字,数字;数字,数字。。。。。的格式,你把我注释的那个输入行(String stInput input.next();)的注释去掉,把我字符串写死的那行(…

zookeeper 分布式锁_关于redis分布式锁,zookeeper分布式锁原理的一些学习与思考

编辑:业余草来源:https://www.xttblog.com/?p4946首先分布式锁和我们平常讲到的锁原理基本一样,目的就是确保,在多个线程并发时,只有一个线程在同一刻操作这个业务或者说方法、变量。在一个进程中,也就是一…

Java线程怎么发送消息_Java客户端Socket如何能在阻塞线程下收到服务端发送来的消息?...

最近在写Socket客户端的时候遇到点问题客户端在创建时创建了2个线程一个监听键盘输入事件,使用的是buffered,当检测到输入完成时写入流发送给服务端。String content "";while (!(content bufferedReader.readLine()).equals("exit&quo…

python函数参数传递机制_Python 学习笔记(一) 理解Python的函数传参机制

对于刚接触Python不久的新手,Python的函数传参机制往往会让人迷惑。学过C的同学都知道函数参数可以传值或者传地址。比如下面这段代码点击(此处)折叠或打开void func(int input) {input 100;}int a 0;func(a);printf("%d", a);结果应该是打印0&#xff…

网页无法调用java9_JAVA 9 (内部类,异常,包)

内部类:将一个类定义在另一个类里面,称里面那个类为内部类。举例:class Zx{public static void main(String []arr){Outer o new Outer();o.method();}}class Outer{class Inner //内部类,可以定义多个内部类{void function(){S…

python renamer模块_Python - 批量文件重命名

两个目标两个:1. 输入一组文件名,进行批量重命名;2. 输入一组目录名,批量重命名各个目录下的文件。附加功能:1. 可根据文件的创建日期对文件重新排序;2. 重命名方式为递增数列,可带前后缀&#…

spark算子_Spark篇之持久化算子

一、前述Spark中控制算子也是懒执行的,需要Action算子触发才能执行,主要是为了对数据进行缓存。控制算子有三种,cache,persist,checkpoint,以上算子都可以将RDD持久化,持久化的单位是partition。cache和persist都是懒执…

java g1 gc ref proc_深入理解垃圾收集器的G1及日志分析

尽管Hotspot 最新的垃圾回收器G1是在2006年推出的。但是G1从推行至今的市场反响来看,但现在足以证明这款垃圾收集器是经得起考验的,从java9开始,就默认为G1垃圾收集器。G1是一款面向服务端应用的垃圾收集器。HotSpot开发团队赋予它的使命是(在…

python爬取哔哩哔哩视频_Python实现视频爬取下载

注:源内容来自公众号【python学习开发】一般情况下我们使用爬虫更多的是对数据或者图片进行爬取,今天在这里和大家分享一下关于使用爬虫技术来进行视频下载的方法,不仅可以方便的下载一些体积小的视频,针对大容量的视频下载同样试用。接下来我们来介绍此次爬取视频过…

java约瑟夫环pta上_cdoj525-猴子选大王 (约瑟夫环)

约瑟夫斯问题问题有时候也被描述成猴子选大王问题,题目如下.(最后会贴上约瑟夫问题的来历) 一群猴子排成一圈,按1,2,…,n依次编号. 然后从第1只开始数,数到第m只,把它踢出圈,从它后面再开始数,再数到第m只,在把它踢出去…,如此不停的进行下去,直到最后只剩下一只猴子为止,那只猴…

java++记录+运行_记录java+testng运行selenium(三)---xml、ini、excel、日志等配置

一: ini文件ini目前只用处存储浏览类型及需要打开的url,ini文件放在configs文件夹下面。读取ini代码如下:1 packagetoolskit.documents;23 import java.io.*;4 import java.util.*;56 /**7 * ClassName: ReadIni8 * Author: DingDong9 * D…

python字符串前面加f什么意思_Python 字符串前面加u,r,b,f的含义

1、字符串前加 u例:u"我是含有中文字符组成的字符串。"作用:后面字符串以 Unicode 格式 进行编码,一般用在中文字符串前面,防止因为源码储存格式问题,导致再次使用时出现乱码。2、字符串前加 r例&#xff1a…

mysql居左查询abcd_MySql速查手册

索引定义索引用来快速地寻找那些具有特定值的记录,所有MySQL索引都以B树的形式保存。就像是数据的目录。索引类型唯一索引主键索引B-Tree普通索引R-Tree联合索引Hash全文索引FullText在mysql中fulltext索引只针对myisam生效。符合索引对于创建的多列索引(复合索引)&…

和python哪个容易胖_为什么有些人特别容易胖?

7种人,最容易被肥胖盯上,其中有你吗?胖,总是来得猝不及防,肥肉也总是不知不觉地长出来……许多胖友对自己的身材老摸不着脑,其实,长胖都是有迹可循的!正如下面这7类人,就…

loadrunner 错误: 无法找到 java.exe_LoadRunner错误及解决方法总结

1. error:missing newline in d:\loadrunner\name.dat场景执行时报error:missing newline in d:\loadrunner\name.dat第二次执行不报两个解决办法:第一:如果参数不是很多的话,不要打开记事本去编辑参数,就直接在LR提供的参数的表格…

gif透明背景动画_【超实用干货! 】iPad上的动画App大推荐

作者/立夏编辑/彼方大家好,我是立夏。大概在两年前吧我为大家写过几款动画APP的评测,这一次我也想给大家推荐一些我的新宠,供大家参考。我在这里就不过多提及如Animation Desk、Procreate或是Callipeg之类知名度相对更高一些的动画App了&…

python框架是干什么的_django框架是干什么的

django(Python Web 框架)Django是一个开放源代码的Web应用框架,由Python写成。采用了MTV的框架模式,即模型M,视图V和模版T。它最初是被开发来用于管理劳伦斯出版集团旗下的一些以新闻内容为主的网站的,即是CMS(内容管理系统)软件。…

iphone如何信任软件_【手机软件】千禾影院:全新观影神器,支持安卓+iOS,最新、最全、高清、免费!...

Hello,大家好,我是春哥!每天记得打卡哦!感谢每一位小伙伴们的关注和支持!免责声明大部分资源来源于网络,仅供学习和交流使用,如有侵权请联系我们删除。每期文章末尾都会有关键词,在公众号发消息…