1.AOP

Aspect ：表示切面，给业务方法增加的功能，叫做切面。切面一般都是非业务功能，而且切面功能一般都是可以复用的。例如日志功能，事务功能，权限检查，参数检查，统计信息等等
Orient ：面向，对着
ruoyi使用的是使用注解方式为切入点
package com.ruoyi.common.annotation;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
 * 数据权限过滤注解
 * @author ruoyi
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface DataScope
     * 部门表的别名
    public String deptAlias() default "";
     * 用户表的别名
    public String userAlias() default "";
此注解可传入两个参数 分别为用户表别名 及部门表别名
在查看完自定义注解后，再来看一下切面业务类
package com.ruoyi.framework.aspectj;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.springframework.stereotype.Component;
import com.ruoyi.common.annotation.DataScope;
import com.ruoyi.common.core.domain.BaseEntity;
import com.ruoyi.common.core.domain.entity.SysRole;
import com.ruoyi.common.core.domain.entity.SysUser;
import com.ruoyi.common.core.domain.model.LoginUser;
import com.ruoyi.common.utils.StringUtils;
import com.ruoyi.common.utils.SecurityUtils;
 * 数据过滤处理
 * @author ruoyi
@Aspect
@Component
public class DataScopeAspect {
     * 全部数据权限
    public static final String DATA_SCOPE_ALL = "1";
     * 自定数据权限
    public static final String DATA_SCOPE_CUSTOM = "2";
     * 部门数据权限
    public static final String DATA_SCOPE_DEPT = "3";
     * 部门及以下数据权限
    public static final String DATA_SCOPE_DEPT_AND_CHILD = "4";
     * 仅本人数据权限
    public static final String DATA_SCOPE_SELF = "5";
     * 数据权限过滤关键字
    public static final String DATA_SCOPE = "dataScope";
    @Before("@annotation(controllerDataScope)")
    public void doBefore(JoinPoint point, DataScope controllerDataScope) throws Throwable {
        clearDataScope(point);
        handleDataScope(point, controllerDataScope);
    protected void handleDataScope(final JoinPoint joinPoint, DataScope controllerDataScope) {
        // 获取当前的用户
        LoginUser loginUser = SecurityUtils.getLoginUser();
        if (StringUtils.isNotNull(loginUser)) {
            SysUser currentUser = loginUser.getUser();
            // 如果是超级管理员，则不过滤数据
            if (StringUtils.isNotNull(currentUser) && !currentUser.isAdmin()) {
                dataScopeFilter(joinPoint, currentUser, controllerDataScope.deptAlias(),
                        controllerDataScope.userAlias());
     * 数据范围过滤
     * @param joinPoint 切点
     * @param user      用户
     * @param userAlias 别名
    public static void dataScopeFilter(JoinPoint joinPoint, SysUser user, String deptAlias, String userAlias) {
        StringBuilder sqlString = new StringBuilder();
        for (SysRole role : user.getRoles()) {
            String dataScope = role.getDataScope();
            if (DATA_SCOPE_ALL.equals(dataScope)) {
                sqlString = new StringBuilder();
                break;
            } else if (DATA_SCOPE_CUSTOM.equals(dataScope)) {
                sqlString.append(StringUtils.format(" OR {}.dept_id IN ( SELECT dept_id FROM sys_role_dept WHERE role_id = {} ) ", deptAlias,role.getRoleId()));
            } else if (DATA_SCOPE_DEPT.equals(dataScope)) {
                sqlString.append(StringUtils.format(" OR {}.dept_id = {} ", deptAlias, user.getDeptId()));
            } else if (DATA_SCOPE_DEPT_AND_CHILD.equals(dataScope)) {
                sqlString.append(StringUtils.format(" OR {}.dept_id IN ( SELECT dept_id FROM sys_dept WHERE dept_id = {} or find_in_set( {} , ancestors ) )", deptAlias, user.getDeptId(), user.getDeptId()));
            } else if (DATA_SCOPE_SELF.equals(dataScope)) {
                if (StringUtils.isNotBlank(userAlias)) {
                    sqlString.append(StringUtils.format(" OR {}.user_id = {} ", userAlias, user.getUserId()));
                } else {
                    // 数据权限为仅本人且没有userAlias别名不查询任何数据
                    sqlString.append(StringUtils.format(" OR {}.dept_id = 0 ", deptAlias));
        if (StringUtils.isNotBlank(sqlString.toString())) {
            Object params = joinPoint.getArgs()[0];
            if (StringUtils.isNotNull(params) && params instanceof BaseEntity) {
                BaseEntity baseEntity = (BaseEntity) params;
                baseEntity.getParams().put(DATA_SCOPE, " AND (" + sqlString.substring(4) + ")");
     * 拼接权限sql前先清空params.dataScope参数防止注入
    private void clearDataScope(final JoinPoint joinPoint) {
        Object params = joinPoint.getArgs()[0];
        if (StringUtils.isNotNull(params) && params instanceof BaseEntity) {
            BaseEntity baseEntity = (BaseEntity) params;
            baseEntity.getParams().put(DATA_SCOPE, "");
定义切入点

@annotation 即使用注解方式切入
@Before("@annotation(controllerDataScope)")
    public void doBefore(JoinPoint point, DataScope controllerDataScope) throws Throwable {
        clearDataScope(point); //防止sql注入 先清空
        handleDataScope(point, controllerDataScope); 业务方法
JoinPoint 当前切入点对象
java.lang.Object[] getArgs()：获取连接点方法运行时的入参列表
Signature getSignature() ：获取连接点的方法签名对象
java.lang.Object getTarget() ：获取连接点所在的目标对象
java.lang.Object getThis() ：获取代理对象本身
handleDataScope 方法执行业务代码，即动态拼接sql来拼接权限sql代码
其中 java.lang.Object[] getArgs()：获取连接点方法运行时的入参列表
        if (StringUtils.isNotBlank(sqlString.toString())) {
            Object params = joinPoint.getArgs()[0];
            if (StringUtils.isNotNull(params) && params instanceof BaseEntity) {
                BaseEntity baseEntity = (BaseEntity) params;
                baseEntity.getParams().put(DATA_SCOPE, " AND (" + sqlString.substring(4) + ")");
在获取到当前参数后进行比较而后判断是否为 BaseEntity或其子类的类型
而后 AND + 拼接sql 在查询时会拼接上此sql
注意： d u 为表别名

例如此处的表别名
select u.*, d.*from sys_user u
left join sys_dept d on u.dept_id = d.dept_id
where u.del_flag = '0'
复制代码