一种非侵入式的接口幂等性实现方案,非常优雅!(非侵入式终端)

您所在的位置:网站首页 照相机无法启动怎么办 一种非侵入式的接口幂等性实现方案,非常优雅!(非侵入式终端)

一种非侵入式的接口幂等性实现方案,非常优雅!(非侵入式终端)

2024-07-12 09:32:35| 来源: 网络整理| 查看: 265

点击关注公众号,实用技术文章及时了解一种非侵入式的接口幂等性实现方案,非常优雅!

幂等性

今天我们来谈谈什么是幂等性?

引用百度百科的解析如下:

幂等(idempotent、idempotence)是一个数学与计算机学概念,常见于抽象代数中。

在编程中一个幂等操作的特点是其任意多次执行所产生的影响均与一次执行的影响相同。幂等函数,或幂等方法,是指可以使用相同参数重复执行,并能获得相同结果的函数。这些函数不会影响系统状态,也不用担心重复执行会对系统造成改变。例如,“setTrue()”函数就是一个幂等函数,无论多次执行,其结果都是一样的.更复杂的操作幂等保证是利用唯一交易号(流水号)实现。

这解析,确实有点长了,大家话看看就行了!!!(●’◡’●)

那对于我们程序员来说,我们关心的更多是下面这些问题:

什么地方,什么场景下需要用到幂等? 幂等,我们需要怎么做,如何实现幂等呢? 一种非侵入式的接口幂等性实现方案,非常优雅!

什么场景下需要用到幂等

前端表单重复提交问题 用户订单支付问题 银行业务办理取号问题 用户恶意进行调接口问题 接口超时重复提交问题 MQ消息进行重复消费 …

当然了,还有很多场景会用到幂等,这里咱们就不一一列举出来了。

那我们要如何设计一个幂等功能呢,而且还是代码非侵入式?

代码非侵入式的意思,就是,我们的业务逻辑代码,不需要处理幂等校验的逻辑。

业务功能不处理?那交给谁处理呢?别着急,听哥们一一道来。^_^

一种非侵入式的接口幂等性实现方案,非常优雅!

这里,要实现代码非侵入式的幂等校验,我们就要使用到切面编程了(@Aspect)

幂等的实现原理

在系统中一些接口需要增加幂等处理,幂等的概念是一个业务请求只能执行一次。类似银行业务办理,首先需要取一个号,然后用户使用这个号去柜台办理业务。这个号只能使用一次,如果过期或者已办理这个号就无效了。

我们的幂等也是使用这种原理。

首先客户端调用通过我们的系统获取一个号,我们称之为幂等号,这个号已经存在我们的系统中。 客户端使用这个号,调用我们的接口。 我们系统判断这个号在我们的系统中已经存在,如果存在则允许业务办理,如果不存在,则表示这是一个非法的号,我们直接抛出异常。 当业务处理完成,我们会将这个号从我们的系统中删除掉。

好了,这实现步骤,也是十分清晰了呀!!!^_^

那么我们下面就来看代码如何实现了

幂等的代码实现

定义一个幂等处理接口

public interface Idempotence {    /**     * 检查是否存在幂等号     * @param idempotenceId 幂等号     * @return 是否存在     */    boolean check(String idempotenceId);    /**     * 记录幂等号     * @param idempotenceId 幂等号     */    void record(String idempotenceId);    /**     * 记录幂等号     * @param idempotenceId 幂等号     * @param time 过期时间     */    void record(String idempotenceId, Integer time);    /**     * 删除幂等号     * @param idempotenceId 幂等号     */    void delete(String idempotenceId);}

定义一个幂等处理接口实现类

@Componentpublic class RedisIdempotence implements Idempotence {    @Autowired    private RedisRepository redisRepository;    @Override    public boolean check(String idempotenceId) {        return redisRepository.exists(idempotenceId);    }    @Override    public void record(String idempotenceId) {        redisRepository.set(idempotenceId,"1");    }    @Override    public void record(String idempotenceId,Integer time) {        redisRepository.setExpire(idempotenceId,"1",time);    }    @Override    public void delete(String idempotenceId) {        redisRepository.del(idempotenceId);    }}

这个实现类,咱们就用redis存储这个幂等号 实现4个方法:

检查是否存在幂等号 记录幂等号 记录幂等号(带过期时间) 删除幂等号

幂等工具类

@Componentpublic class IdempotenceUtil {    @Autowired    private RedisRepository redisRepository;    /**     * 生成幂等号     * @return     */    public String generateId() {        String uuid = UUID.randomUUID().toString();        String uId=Base64Util.encode(uuid).toLowerCase();        redisRepository.setExpire(uId,"1",1800);        return uId;    }    /**     * 从Header里面获取幂等号     * @return     */    public String getHeaderIdempotenceId(){        ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();        HttpServletRequest request = attributes.getRequest();        String idempotenceId=request.getHeader("idempotenceId");        return idempotenceId;    }}

这个工具类,提供两个方法。

生成一个幂等号,咱们就用uuid 从Header里面获取幂等号

定义一个注解

/** * 接口增加幂等性 */@Target({ElementType.METHOD})@Retention(RetentionPolicy.RUNTIME)@Documentedpublic @interface IdempotenceRequired {}

切面

@Aspect@Slf4j@Componentpublic class IdempotenceSupportAdvice {    @Autowired    private Idempotence idempotence;    @Autowired    IdempotenceUtil idempotenceUtil;    /**     * 拦截有@IdempotenceRequired 注解 的方法。     */    @Pointcut("@annotation(xxx.xxx.IdempotenceRequired)")    public void idempotenceMethod(){}    @AfterThrowing(value = "idempotenceMethod()()",throwing = "e")    public void afterThrowing(Throwable e){        if(!(e instanceof IdempotencyException)) {            // 从HTTP header中获取幂等号idempotenceId            String idempotenceId = idempotenceUtil.getHeaderIdempotenceId();            idempotence.record(idempotenceId, 1800);        }    }    @Around(value = "idempotenceMethod()")    public Object around(ProceedingJoinPoint  joinPoint) throws Throwable {        // 从HTTP header中获取幂等号idempotenceId        String idempotenceId = idempotenceUtil.getHeaderIdempotenceId();        if(StringUtils.isEmpty(idempotenceId)){            //不存在幂等号则不进行额外操作            return joinPoint.proceed();        }        // 前置操作 幂等号是否存在        boolean existed = idempotence.check(idempotenceId);        if (!existed) {            throw new IdempotencyException("{success:false,message:"操作重复,请重新输入幂等号重试!",data:-2}");        }        //删除幂等号        idempotence.delete(idempotenceId);        Object result = joinPoint.proceed();        return result;    }}

定义个controller

@RequestMapping("/idempotence")public class IdempotenceController {    /**     * 生成幂等号     * @return     */    @GetMapping("/generateId")    public JsonResult generateId(){        IdempotenceUtil idempotenceUtil=springUtil.getBean(IdempotenceUtil.class);        String uId=idempotenceUtil.generateId();        return JsonResult.success("成功生成!").setData(uId);    }}

好了,实现的代码,就是这些了,理解起来也是比较简单,没有过多复杂的逻辑。

接下来,就是如何使用的问题了

幂等的使用 服务端:

不是所有的方法都需要切面拦截 ,只有 IdempotenceRequired 注解的方法才会被拦截。

例如下面接口:

@IdempotenceRequired@PostMapping("/getUsers")public JsonResult getUsers(){    //执行正常业务逻辑    ...}

在开发幂等接口时,只需要在方法上简单增加一个 IdempotenceRequired 注解即可。

这基本上就是代码非侵入式了呀!!!

客户端:

服务端处理好后,在客户端访问接口的时候需要执行以下步骤:

需要先获取幂等号 然后将幂等号添加到请求头中

1.获取幂等号 http://服务地址/idempotence/generateId

一种非侵入式的接口幂等性实现方案,非常优雅!

2.请求调用

往header中添加幂等号

一种非侵入式的接口幂等性实现方案,非常优雅!

好了,到这里幂等的实现,就已经完成了!!!^_^

那我们就可以愉快的编写代码了!!!^_^

感谢阅读,希望对你有所帮助 :) 

来源:juejin.cn/post/7085944825085689864

推荐

java面试题宝典

技术内卷群,一起来学习!!

一种非侵入式的接口幂等性实现方案,非常优雅!

PS:因为公众号平台更改了推送规则,如果不想错过内容,记得读完点一下“在看”,加个“星标”,这样每次新文章推送才会第一时间出现在你的订阅列表里。点“在看”支持我们吧!

原文始发于微信公众号(Java知音):一种非侵入式的接口幂等性实现方案,非常优雅!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

文章由半码博客整理,本文链接:https://www.bmabk.com/index.php/post/65285.html



【本文地址】

公司简介

联系我们

今日新闻


点击排行

实验室常用的仪器、试剂和
说到实验室常用到的东西,主要就分为仪器、试剂和耗
不用再找了,全球10大实验
01、赛默飞世尔科技(热电)Thermo Fisher Scientif
三代水柜的量产巅峰T-72坦
作者:寞寒最近,西边闹腾挺大,本来小寞以为忙完这
通风柜跟实验室通风系统有
说到通风柜跟实验室通风,不少人都纠结二者到底是不
集消毒杀菌、烘干收纳为一
厨房是家里细菌较多的地方,潮湿的环境、没有完全密
实验室设备之全钢实验台如
全钢实验台是实验室家具中较为重要的家具之一,很多

推荐新闻


图片新闻

实验室药品柜的特性有哪些
实验室药品柜是实验室家具的重要组成部分之一,主要
小学科学实验中有哪些教学
计算机 计算器 一般 打孔器 打气筒 仪器车 显微镜
实验室各种仪器原理动图讲
1.紫外分光光谱UV分析原理:吸收紫外光能量,引起分
高中化学常见仪器及实验装
1、可加热仪器:2、计量仪器:(1)仪器A的名称:量
微生物操作主要设备和器具
今天盘点一下微生物操作主要设备和器具,别嫌我啰嗦
浅谈通风柜使用基本常识
 众所周知,通风柜功能中最主要的就是排气功能。在

专题文章

    CopyRight 2018-2019 实验室设备网 版权所有 win10的实时保护怎么永久关闭