期待已久的插件模块来了,在此模块大家可以发挥自己的想象力,脑洞大开,自定义插件,可根据自己项目喜好自行开发一些好用的插件, 只要有价值,皆可提交PR,评审通过即可成为EE贡献者,该插件即可供全球开发者使用..

注意事项

• 插件模块尽量独立于其它模块,尤其是core模块
• 插件模块不得过度修改其它模块代码,如有修改,需评估影响范围
• 插件模块尽量做到可配置,不配置开启时,不可影响其它模块运行及性能安全等

拦截器插件

本插件由开源团队成员:璐先生贡献,由黄小赢改进

适用场景

需要对一些方法做特殊前置处理,比如:

• 需要在执行删除es数据操作前,需要先验证用户权限,或是记录操作记录等
• 需要在执行查询前,追加一些特殊参数,比如逻辑删除 总之就是对EE提供的各种API的AOP前置拦截增强.

需求背景

需要拦截本框架提供的selectList方法,然后在此方法的查询参数中追加逻辑删除为未删除的状态作为查询条件

使用示例

新增拦截器,通过@Intercepts注解指定拦截的方法列表,通过@Signature注解指定被拦截的类,方法,参数等信息.

@Intercepts(
        {
                @Signature(type = BaseEsMapper.class, method = "selectList", args = {LambdaEsQueryWrapper.class}),
                @Signature(type = BaseEsMapper.class, method = "select.*", args = {LambdaEsQueryWrapper.class}, useRegexp = true),
                @Signature(type = BaseEsMapper.class, method = "search", args = {SearchRequest.class, RequestOptions.class}),
                @Signature(type = BaseEsMapper.class, method = "insert|update", args = {Object.class}, useRegexp = true),
                @Signature(type = BaseEsMapper.class, method = ".*ById", args = {Object.class}, useRegexp = true)
        }
)
@Component
public class QueryInterceptor implements Interceptor {

    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        System.out.println("啊啊啊，我拦截到了查询，统一增加查询条件");
        // 查询条件中统一加入逻辑删除状态为未删除
        Object[] args = invocation.getArgs();
        LambdaEsQueryWrapper<GeneralBean> arg = (LambdaEsQueryWrapper) args[0];
        arg.eq(GeneralBean::getExistStatus, true);
        return invocation.proceed();
    }

}

提示

1. 需要将此拦截器加上@Component注解,将其加入Spring容器,否则此拦截器不生效.
2. 实现的Interceptor全路径为:org.dromara.easyes.extension.context,而非其它同名拦截器.
3. 方法名支持正则通配,@Signature注解中useRegexp属性默认为false,表示使用精确匹配,为true时,表示使用正则匹配.