首页 > 编程知识 正文

javarestfulapi实例,restful服务api

时间:2023-05-04 04:15:58 阅读:131589 作者:4586

要弄清楚什么是REST风格的API,首先需要知道什么是REST。

REST,表示性状态转移。 简单地说,用URI表示资源,用HTTP方法GET、POST、PUT、DELETE表示对这些资源的操作。

Resource:资源(即数据)具有互联网上可访问的实体

re presentation :数据的某种表示形式,如html、JSON等。

State Transfer :状态变化,实现HTTP方法

rest风格的API是rest风格的API。 目前,终端平台多种多样,移动、平板电脑、PC等多种媒体向服务端发送请求后,如果不应用rest风格的API,将会对每个平台的数据请求进行适当的回复,以适应前端的显示但是,rest风格的API要求前端以预定义的语法格式发送请求,因此服务端只需要定义统一的响应接口,而不需要像以前那样解决各种请求。

rest风格是典型的基于HTTP的协议。 有哪些设计原则和规范呢?

资源。 首先,必须明确资源是网络上的实体,是文本、图像、音频和视频。 资源总是以一定的格式表达自己。 文本为txt、html; 图像使用JPG、JPEG等。 JSON是rest风格的API中最常用的资源表示形式。

统一接口。 对于业务数据的CRUD,rest风格通过HTTP方法支持。

网址。 统一资源标识符,唯一标识一个资源。 请注意,统一资源定位器(URL )是URI,因为它可以唯一标记资源。 但是网址!=URI。 应该说URL是URI的子集。 这只是唯一标识资源的方法之一,因为URL使用路径来唯一标识资源。 也可以使用唯一的编号标识资源,例如example.html.fuce2da23。 但是,这种方式没有被广泛使用。 总之,必须在概念上区分网址和网址。

无状态。 无状态意味着可以通过URI定位所有资源。 此外,这一定位与其他资源无关,不会随其他资源的变动而变化。 这里引入了幂等性概念,即无论一个操作执行还是多次执行,执行后的效果都相同。 例如,向某个资源发送GET请求,如果一次访问和十次访问获得的数据相同,则称该请求具有幂等性。

网址上只有名词。 动词没有出现。 这自然无需将操作方法暴露于URL中,因为REST中对资源的操作是由HTTP方法提供的,而方法是由HTTP请求报头提供的。

还有一些业务决策型规则,例如应该将版本添加到URL中,并对返回的记录进行限制筛选。 虽然不是强制的,但我建议你这么做。

作者:小码弟弟

链接: https://www.Jian Shu.com/p/dbee 5199 cf 23

资料来源:简本

版权归作者所有。 商业转载请联系作者取得许可。 非商业转载请注明出处。

版权声明:该文观点仅代表作者本人。处理文章:请发送邮件至 三1五14八八95#扣扣.com 举报,一经查实,本站将立刻删除。