当前位置：首页 > news >正文

Hutool - AOP：JDK 动态代理封装与非 IOC 下的切面支持

news 来源：原创 2025/6/16 7:18:43

1. 什么是 Hutool - AOP

在 Java 开发中，面向切面编程（AOP）是一种强大的编程范式，它允许我们在不修改原有业务逻辑的基础上，对程序进行增强，比如添加日志记录、事务管理等功能。Hutool - AOP 是 Hutool 工具包中的一个模块，它对 JDK 动态代理进行了封装，为我们提供了在非 Spring IOC 环境下使用切面的能力。

2. 引入依赖

如果你使用 Maven 项目，在 pom.xml 中添加以下依赖：

<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.16</version>
</dependency>

3. 基本使用示例

下面通过一个简单的示例来展示如何使用 Hutool - AOP 实现切面功能。

3.1 定义接口和实现类

首先，定义一个接口和它的实现类，这是我们的业务逻辑类。

// 定义接口
interface UserService {
    void saveUser(String username);
}

// 实现接口
class UserServiceImpl implements UserService {
    @Override
    public void saveUser(String username) {
        System.out.println("保存用户: " + username);
    }
}

3.2 定义切面类

接下来，定义一个切面类，该类实现 InvocationHandler 接口，用于在目标方法执行前后添加额外的逻辑。

import cn.hutool.aop.ProxyUtil;
import java.lang.reflect.InvocationHandler;
import java.lang.reflect.Method;

// 切面类
class UserServiceAspect implements InvocationHandler {
    private final Object target;

    public UserServiceAspect(Object target) {
        this.target = target;
    }

    @Override
    public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
        // 在目标方法执行前添加逻辑
        System.out.println("开始保存用户，准备记录日志...");

        // 调用目标方法
        Object result = method.invoke(target, args);

        // 在目标方法执行后添加逻辑
        System.out.println("用户保存成功，日志记录完成。");

        return result;
    }
}

3.3 使用 Hutool - AOP 创建代理对象

最后，使用 Hutool - AOP 的 ProxyUtil 工具类创建代理对象，并调用代理对象的方法。

public class Main {
    public static void main(String[] args) {
        // 创建目标对象
        UserService userService = new UserServiceImpl();

        // 创建切面对象
        UserServiceAspect aspect = new UserServiceAspect(userService);

        // 使用 Hutool - AOP 创建代理对象
        UserService proxyUserService = (UserService) ProxyUtil.newProxyInstance(
                userService.getClass().getClassLoader(),
                userService.getClass().getInterfaces(),
                aspect
        );

        // 调用代理对象的方法
        proxyUserService.saveUser("张三");
    }
}

4. 代码解释

接口和实现类：UserService 接口定义了业务方法 saveUser，UserServiceImpl 类实现了该接口，包含具体的业务逻辑。
切面类：UserServiceAspect 类实现了 InvocationHandler 接口，在 invoke 方法中，我们可以在目标方法执行前后添加额外的逻辑，如日志记录。
创建代理对象：使用 ProxyUtil.newProxyInstance 方法创建代理对象，该方法需要传入类加载器、接口数组和切面对象。
调用代理对象的方法：调用代理对象的方法时，实际上会触发切面类的 invoke 方法，从而实现切面功能。