接口的幂等性怎么设计_接口的幂等性怎么设计

接口的幂等性怎么设计_接口的幂等性怎么设计接口幂等的四种解决方案什么是幂等性?幂等是一个数学与计算机学概念,在数学中某一运算为幂等时,其作用在任一素两次后会和其作用一次的结果相同。“在计算机中编程中,一个幂等操作的特点是其任意多

接口幂等的四种解决方案   什么是幂等性?   幂等是一个数学与计算机学概念,在数学中某一运算为幂等时,其作用在任一素两次后会和其作用一次的结果相同。   “   在计算机中编程中,一个幂等操作的特点是其任意多次执行所产生的影响均与一次执行的影响相同。   幂等函数或幂等方法是指可以使用相同参数重复执行,并能获得相同结果的函数。这些函数不会影响系统状态,也不用担心重复执行会对系统造成改变。   什么是接口幂等性?   在中,对幂等性进行了定义。它描述了一次和多次请求某一个资源对于资源本身应该具有同样的结果(网络超时等问题除外),即第一次请求的时候对资源产生了副作用,但是以后的多次请求都不会再对资源产生副作用。   这里的副作用是不会对结果产生破坏或者产生不可预料的结果。也就是说,其任意多次执行对资源本身所产生的影响均与一次执行的影响相同。   为什么需要实现幂等性?   在接口调用时一般情况下都能正常返回信息不会重复提交,不过在遇见以下情况时可以就会出现问题,如: 前端重复提交表单:在填写一些表格时候,用户填写完成提交,很多时候会因网络波动没有及时对用户做出提交成功响应,致使用户认为没有成功提交,然后一直点提交按钮,这时就会发生重复提交表单请求。用户恶意进行刷单:例如在实现用户投票这种功能时,如果用户针对一个用户进行重复提交投票,这样会导致接口接收到用户重复提交的投票信息,这样会使投票结果与事实严重不符。接口超时重复提交:很多时候 HTTP 客户端工具都默认开启超时重试的机制,尤其是第三方调用接口时候,为了防止网络波动超时等造成的请求失败,都会添加重试机制,导致一个请求提交多次。消息进行重复消费:当使用 MQ 消息中间件时候,如果发生消息中间件出现错误未及时提交消费信息,导致发生重复消费。   “   使用幂等性最大的优势在于使接口保证任何幂等性操作,免去因重试等造成系统产生的未知的问题。   引入幂等性后对系统有什么影响?   幂等性是为了简化客户端逻辑处理,能放置重复提交等操作,但却增加了服务端的逻辑复杂性和成本,其主要是: 把并行执行的功能改为串行执行,降低了执行效率。增加了额外控制幂等的业务逻辑,复杂化了业务功能;   所以在使用时候需要考虑是否引入幂等性的必要性,根据实际业务场景具体分析,除了业务上的特殊要求外,一般情况下不需要引入的接口幂等性。   Restful API 接口幂等性如何?   现在流行的 Restful 推荐的几种 HTTP 接口方法中,分别存在幂等行与不能保证幂等的方法,如下: 满足幂等不满足幂等可能满足也可能不满足幂等,根据实际业务逻辑有关   
在这里插入图片描述   方案一:数据库唯一主键实现幂等性   数据库唯一主键的实现主要是利用数据库中主键唯一约束的特性,一般来说唯一主键比较适用于“插入”时的幂等性,其能保证一张表中只能存在一条带该唯一主键的记录。   使用数据库唯一主键完成幂等性时需要注意的是,该主键一般来说并不是使用数据库中自增主键,而是使用分布式 ID 充当主键,这样才能能保证在分布式环境下 ID 的全局唯一性。 适用操作 插入操作删除操作 使用限制 需要生成全局唯一主键 ID; 主要流程   
在这里插入图片描述   主要流程如下: 客户端执行创建请求,调用服务端接口。服务端执行业务逻辑,生成一个分布式,将该 ID 充当待插入数据的主键,然 后执数据插入操作,运行对应的语句。服务端将该条数据插入数据库中,如果插入成功则表示没有重复调用接口。如果抛出主键重复异常,则表示数据库中已经存在该条记录,返回错误信息到客户端。   方案二:数据库乐观锁实现幂等性   数据库乐观锁方案一般只能适用于执行更新操作的过程,我们可以提前在对应的数据表中多添加一个字段,充当当前数据的版本标识。   这样每次对该数据库该表的这条数据执行更新时,都会将该版本标识作为一个条件,值为上次待更新数据中的版本标识的值。 适用操作 更新操作 使用限制 需要数据库对应业务表中添加额外字段 描述示例   
在这里插入图片描述   例如,存在如下的数据表中:   
在这里插入图片描述   为了每次执行更新时防止重复更新,确定更新的一定是要更新的内容,我们通常都会添加一个字段记录当前的记录版本,这样在更新时候将该值带上,那么只要执行更新操作就能确定一定更新的是某个对应版本下的信息。   
在这里插入图片描述   这样每次执行更新时候,都要指定要更新的版本号,如下操作就能准确更新的信息:   上面后面跟着条件被执行后,的被更新为,所以如果重复执行该条 SQL 语句将不生效,因为的数据已经不存在,这样就能保住更新的幂等,多次更新对结果不会产生影响。   方案三:防重 Token 令牌实现幂等性   针对客户端连续或者调用方的超时重试等情况,例如提交订单,此种操作就可以用的机制实现防止重复提交。   简单的说就是调用方在调用接口的时候先向后端请求一个全局,请求的时候携带这个全局一起请求(最好将其放到中),后端需要对这个作为,用户信息作为到中进行键值内容校验,如果存在且匹配就执行删除命令,然后正常执行后面的业务逻辑。如果不存在对应的或不匹配就返回重复执行的错误信息,这样来保证幂等操作。 适用操作 插入操作更新操作删除操作 使用限制 需要生成全局唯一串需要使用第三方组件进行数据效验 主要流程:   
在这里插入图片描述 服务端提供 Token 的接口,该 Token 可以是一个序列号,也可以是一个分布式或者串。客户端调用接口 Token,这时候服务端会生成一个 Token 串。然后将该串存入 Redis 数据库中,以该 Token 作为 Redis 的键(注意设置过期时间)。将 Token 返回到客户端,客户端拿到后应存到表单隐藏域中。客户端在执行提交表单时,把 Token 存入到中,执行业务请求带上该。服务端接收到请求后从中拿到 Token,然后根据 Token 到 Redis 中查找该是否存在。服务端根据 Redis 中是否存该进行判断,如果存在就将该删除,然后正常执行业务逻辑。如果不存在就抛异常,返回重复提交的错误信息。   “   注意,在并发情况下,执行 Redis 查找数据与删除需要保证原子性,否则很可能在并发下无法保证幂等性。其实现方法可以使用分布式锁或者使用表达式来注销查询与删除操作。   方案四: 下游传递唯一序列号实现幂等性   所谓请求序列号,其实就是每次向服务端请求时候附带一个短时间内唯一不重复的序列号,该序列号可以是一个有序,也可以是一个订单号,一般由下游生成,在调用上游服务端接口时附加该序列号和用于认证的。   当上游服务器收到请求信息后拿取该序列号和下游认证ID进行组合,形成用于操作 Redis 的,然后到 Redis 中查询是否存在对应的的键值对,根据其结果: 如果存在,就说明已经对该下游的该序列号的请求进行了业务处理,这时可以直接响应重复请求的错误信息。如果不存在,就以该作为 Redis 的键,以下游关键信息作为存储的值(例如下游商传递的一些业务逻辑信息),将该键值对存储到 Redis 中 ,然后再正常执行对应的业务逻辑即可。 适用操作 插入操作更新操作删除操作 使用限制 要求第三方传递唯一序列号;需要使用第三方组件 Redis 进行数据效验; 主要流程   
在这里插入图片描述 下游服务生成分布式作为序列号,然后执行请求调用上游接口,并附带唯一序列号与请求的认证凭据ID。上游服务进行安全效验,检测下游传递的参数中是否存在序列号和凭据ID。上游服务到 Redis 中检测是否存在对应的序列号与认证ID组成的,如果存在就抛出重复执行的异常信息,然后响应下游对应的错误信息。如果不存在就以该序列号和认证ID组合作为,以下游关键信息作为,进而存储到 Redis 中,然后正常执行接来来的业务逻辑。   “   上面步骤中插入数据到 Redis 一定要设置过期时间。这样能保证在这个时间范围内,如果重复调用接口,则能够进行判断识别。如果不设置过期时间,很可能导致数据无限量的存入 Redis,致使 Redis 不能正常工作。   实现接口幂等示例   这里使用防重 Token 令牌方案,该方案能保证在不同请求动作下的幂等性,实现逻辑可以看上面写的”防重 Token 令牌”方案,接下来写下实现这个逻辑的代码。 1. Maven 引入相关依赖   这里使用工具管理依赖,这里在中引入、、相关依赖。   2. 配置连接 Redis 的参数   在配置文件中配置连接的参数,如下:   3. 创建与验证 Token 工具类   创建用于操作 Token 相关的 Service 类,里面存在 Token 创建与验证方法,其中: 创建方法:使用工具创建串,设置以作为,以用户信息当成,将信息存入 Redis 中。验证方法:接收 Token 串参数,加上 Key 前缀形成,再传入值,执行表达式(表达式能保证命令执行的原子性)进行查找对应与删除操作。执行完成后验证命令的返回结果,如果结果不为空且非0,则验证成功,否则失败。   4、创建测试的 Controller 类   创建用于测试的类,里面有与测试接口幂等性的接口,内容如下:   最后总结   幂等性是开发当中很常见也很重要的一个需求,尤其是支付、订单等与金钱挂钩的服务,保证接口幂等性尤其重要。在实际开发中,我们需要针对不同的业务场景我们需要灵活的选择幂等性的实现方式: 对于下单等存在唯一主键的,可以使用“唯一主键方案”的方式实现。对于更新订单状态等相关的更新场景操作,使用“乐观锁方案”实现更为简单。对于上下游这种,下游请求上游,上游服务可以使用“下游传递唯一序列号方案”更为合理。类似于前端重复提交、重复下单、没有唯一ID号的场景,可以通过与配合的“防重 Token 方案”实现更为快捷。   上面只是给与一些建议,再次强调一下,实现幂等性需要先理解自身业务需求,根据业务逻辑来实现这样才合理,处理好其中的每一个结点细节,完善整体的业务流程设计,才能更好的保证系统的正常运行。最后做一个简单总结,然后本博文到此结束,如下:   
在这里插入图片描述

2024最新激活全家桶教程,稳定运行到2099年,请移步至置顶文章:https://sigusoft.com/99576.html

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。 文章由激活谷谷主-小谷整理,转载请注明出处:https://sigusoft.com/35317.html

(0)
上一篇 2024年 9月 9日 下午11:24
下一篇 2024年 9月 9日 下午11:28

相关推荐

关注微信