SpringBoot关于自定义注解实现接口幂等性方式

对于SpringBoot自定义注解实现接口幂等性，一般可以通过以下几个步骤来完成：

1. 创建幂等性注解

幂等性注解一般包含以下内容：

• 注解名称：一般用 @Idempotent 表示。
• 作用范围：一般有方法级别和参数级别两种。
• 验证方式：一般有请求参数和请求头两种。

具体实现示例：

@Target({ElementType.METHOD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
public @interface Idempotent {
    /**
     * 是否使用参数验证方式
     */
    boolean useParams() default true;

    /**
     * 是否使用请求头验证方式
     */
    boolean useHeader() default false;
}

2. 创建幂等性拦截器

幂等性拦截器的实现包含以下内容：

• 实现接口：HandlerInterceptor。
• 在拦截器中获取幂等性注解，并根据注解中的参数进行验证。

具体实现示例：

public class IdempotentInterceptor implements HandlerInterceptor {
    @Autowired
    private RedisTemplate<String, Object> redisTemplate;

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        Method method = ((HandlerMethod) handler).getMethod();
        Idempotent idempotent = method.getAnnotation(Idempotent.class);
        if (idempotent != null) {
            boolean useParams = idempotent.useParams();
            boolean useHeader = idempotent.useHeader();
            String key = getKey(request, useParams, useHeader);
            if (redisTemplate.opsForValue().get(key) != null) {
                throw new RuntimeException("请勿重复提交！");
            }
            redisTemplate.opsForValue().set(key, 0, 5, TimeUnit.SECONDS);
        }
        return true;
    }

    private String getKey(HttpServletRequest request, boolean useParams, boolean useHeader) {
        String key = request.getRequestURI() + "-" + request.getMethod() + "-";
        if (useParams) {
            key += JSON.toJSONString(request.getParameterMap());
        }
        if (useHeader) {
            Enumeration<String> headerNames = request.getHeaderNames();
            JSONObject headersObj = new JSONObject();
            while (headerNames.hasMoreElements()) {
                String headerName = headerNames.nextElement();
                headersObj.put(headerName, request.getHeader(headerName));
            }
            key += headersObj.toJSONString();
        }
        return DigestUtils.sha256Hex(key);
    }
}

3. 注册拦截器

在SpringBoot的Java配置类文件中，实现WebMvcConfigurer接口，并在addInterceptors方法中注册幂等性拦截器。

具体实现示例：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Autowired
    private IdempotentInterceptor idempotentInterceptor;

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(idempotentInterceptor).addPathPatterns("/**");
    }
}

示例代码

这里给出两个基于SpringBoot自定义注解实现接口幂等性的示例代码：

示例一：使用请求参数验证

@RestController
@RequestMapping("/demo")
public class DemoController {
    @PostMapping("/test")
    @Idempotent
    public String test(@RequestParam("arg1") String arg1, @RequestParam("arg2") String arg2) {
        return "test-" + arg1 + "-" + arg2;
    }
}

示例二：使用请求头验证

@RestController
@RequestMapping("/demo")
public class DemoController {
    @PostMapping("/test")
    @Idempotent(useParams = false, useHeader = true)
    public String test(@RequestHeader("sign") String sign) {
        return "test-" + sign;
    }
}

以上就是SpringBoot自定义注解实现接口幂等性的完整攻略。