西北海之外，大荒之隅，有山而不合，名曰不周负子，有两黄兽守之。有水曰寒署之水。水西有湿山，水东有幕山。

—— 《山海经》海经·大荒西经

BuzhouKit 是一款专为确保幂等性设计的组件库。简单添加一个注解@Idempotent即可解决幂等问题！此库适用于需要保证操作重复性和一致性的应用场景，为开发者提供一个可靠、稳定的基础设施。

1，将代码克隆/下载到本地
2，进入到BuZhouKit\BuZhouKit-Idempotent>目录下运行mvn clean install 使得代码保存在本地maven库中，再通过pom坐标即可引用；

  <dependency>
      <groupId>com.lctking</groupId>
      <artifactId>BuZhouKit-Idempotent</artifactId>
      <version>0.0.1-SNAPSHOT</version>
  </dependency>

1，将代码克隆/下载到本地
2，将代码copy到项目某模块中

  @PostMapping("/redisCache-test")
  @Idempotent(
          uniquePrefix = "user:insert",
          spEL = "#userDO.hashCode()",
          expireTime = -1L,
          cacheType = CacheTypeEnum.REDIS,
          message = "添加用户请求重复,[BY_REDIS]",
          exceptionClass = CustomizeException.class
  )
  public void testIdempotentRelyOnDistributedCache(@RequestBody UserDO userDO){
      userService.insertUser(userDO);
  }

• uniquePrefix：锁前缀，用于表明该位置@Idempotent注解所修饰的方法有着什么样的业务特性。例如上例方法体逻辑为user信息的插入，那么uniquePrefix 设为 "user:insert" 是合适的；

• spEL：spel语句，实现动态定义加锁键。例如上例中"#userDO.hashCode()"即为key逻辑式中的spEl.value。spEL语法学习-官方参考

• expireTime：顾名思义，是key的过期时间。建议根据业务特性来设置expireTime， 例如上例为添加用户场景，将键设置为永不过期来去重是合适的。如果是消息队列消费业务场景，设为10-30分钟是合适的；

• cacheType：缓存类型选择，按照缓存位置划分目前可分为两类，分别是：1，基于caffeine组件的本地缓存(对应枚举为 CacheTypeEnum.LOCAL 或 CacheTypeEnum.CAFFEINE)；2，基于redis的分布式缓存(CacheTypeEnum.REDIS)；

• message：幂等奏效抛出异常时的提示信息，建议根据业务场景来填写。

• exceptionClass：可由注解使用者自由设定的报错时抛出的异常类型，例如上例中的CustomizeException.class即为在测试项目中所配置的自定义异常类（该异常类不在幂等组件库中，可自由设定）。

在application.yml中配置好你的本地redis服务后启动Test服务，进行功能测试：
路径：http://127.0.0.1:8089/Idempotent-test/redisCache-test
请求体[json] :

  {
    "id": 1,
    "username": "testUser0",
    "password": "testPassworwd123",
    "phone": "123-456-7890"
  }

第一次请求，控制台打印：
第二次请求，控制台打印（成功限流）： 如图所示，不仅抛出了注解使用者自定义的异常类型，还附加了自定义的提示信息。

• 如果你发现幂等注解在某些位置不奏效，请考虑AOP代理失效问题，如：同类内部的直接方法调用，这种调用不经过AOP代理对象，造成幂等注解失效。推荐的解决方法：将被调用方法抽取到合适的服务类接口及其实现类中。
• ...

• 引入更详细的日志记录功能；
• 增加mysql相关功能支持；
• 针对永久性幂等场景引入布隆过滤器 （已完成！）
• ...