restful restAPI 的定义方式

今天听了一些rest 的讲解,感谢玖遥老大教导,晚上把整理出来,帮助那些和我一样有过迷茫的人!

我举的例子是经过我的老大讲解,以及观看阮一峰的restful架构的一些整合,和自己的拙劣见解。

首先:每一个URI代表一种资源(路径);

所谓"资源",就是网络上的一个实体,或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务,总之就是一个具体的实在。你可以用一个URI(统一资源定位符)指向它,每种资源对应一个特定的URI。要获取这个资源,访问它的URI就可以,因此URI就成了每一个资源的地址或独一无二的识别符。

 

其次:域名和版本的定义;

;

如图:尽量将域名放入专属的域名下,版本号放入url中;从实用和开发便利上来讲 放URL要方便很多;

 

接着就是HTTP动词:

注解:post 和 put的区别:

1:post是新增;put是修改;

2:在有复杂,含糊不清的逻辑时使用post;

patch:比如修改某个人的某一个或者具体的某几个属性的时候使用patch;put是全部修改(小编至今还没使用过patch);下面的例子方便理解

 

filter:比如分页;返回数据太多,需要有选择的显示,这时候就需要过滤器;

 

 

状态码(Status Codes)

 

  

转载于:https://www.cnblogs.com/StephenJiang/p/4503832.html

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
RESTful API 是一种基于 REST 架构风格设计的 Web API。REST (Representational State Transfer)是一种轻量级的分布式系统架构风格,它强调以资源为中心,通过 URL、HTTP 动词和 HTTP 状态码等标准协议进行通信,支持无状态、可缓存、可伸缩和可扩展等特性。RESTful API 通常基于 HTTP 协议进行通信,通过 URI 指定资源的位置,通过 HTTP 方法操作资源,通过 HTTP 状态码表示请求的处理结果。RESTful API 的资源可以是文本、JSON、XML 或其他格式的数据,客户端可以通过 HTTP 请求头部指定所需的数据格式。 RESTful API 的优点包括: 1. 轻量级:采用标准的 HTTP 协议,无需像 SOAP 那样复杂的通信协议和消息格式。 2. 可伸缩性:通过无状态的设计,支持横向扩展和多个服务器的并行处理。 3. 可缓存性:通过利用 HTTP 协议的缓存机制,提高资源的访问效率。 4. 可读性:使用简洁的 URL 和 HTTP 动词,易于理解和使用。 5. 可扩展性:通过定义不同的资源和操作,满足不同应用的需求。 6. 可编程性:支持不同编程语言和平台的开发和集成。 然而,RESTful API 也存在一些缺点和挑战,包括: 1. 缺乏标准化的错误处理方式,容易出现混乱和不一致的情况。 2. 安全性需要开发者自己设计和实现,容易出现漏洞和攻击。 3. 设计需要遵循一定的规范和约束,否则容易出现不一致和不可预期的问题。 4. RESTful API 的资源只能通过 URI 进行访问,需要使用特定的工具进行查找和发现。 5. 相关设计基于 HTTP 协议,如果网络环境不稳定或存在代理等问题,可能会影响 API 的性能和可用性。

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

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

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值