0

0

标题:使用 AspectJ 实现基于字段注解的读写访问拦截教程

心靈之曲

心靈之曲

发布时间:2026-01-15 16:06:02

|

231人浏览过

|

来源于php中文网

原创

标题:使用 AspectJ 实现基于字段注解的读写访问拦截教程

本文介绍如何通过自定义注解(如 `@monitor`)结合 aspectj 的 `get()` 和 `set()` 切点表达式,精准拦截被标注字段的读写操作,并在环绕通知中执行自定义逻辑。

在面向切面编程(AOP)实践中,有时需要对特定字段的访问行为进行统一监控或增强——例如审计赋值来源、记录访问时间、校验数据合法性等。与拦截 getter/setter 方法不同,直接拦截字段读写(field access 能覆盖所有访问路径(包括反射、内部直接访问、甚至第三方库调用),更具底层控制力。AspectJ 提供了 get() 和 set() 这两个专用于字段访问的原生切点(primitive pointcut),配合运行时注解(@Retention(RUNTIME)),即可实现“注解即切点”的声明式 AOP。

✅ 前置准备

首先定义一个保留策略为 RUNTIME 的注解:

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

@Retention(RetentionPolicy.RUNTIME)
public @interface Monitor {}

然后在目标类中对字段使用该注解:

public class Point {
    @Monitor
    private int x;

    public int getX() { return x; }
    public void setX(int v) { x = v; }

    public static void main(String[] args) {
        Point p = new Point();
        // 1. 通过 getter/setter 访问
        p.setX(11);
        System.out.println(p.getX());

        // 2. 直接字段访问(非 public,但同一类内合法)
        p.x = 22;
        System.out.println(p.x);
    }
}
⚠️ 注意:get() 和 set() 切点仅对 编译期可见的字段访问 生效(即源码中明确出现 obj.field 或 obj.field = value)。它不适用于 Field.set() 等反射调用(需配合 call() 或 execution() + @Before("call(* java.lang.reflect.Field.set*(..))") 单独处理)。

✅ 编写 Aspect 实现字段级拦截

使用 @Around 通知分别匹配带 @Monitor 注解的字段读取与写入:

Open Voice OS
Open Voice OS

OpenVoiceOS是一个社区驱动的开源语音AI平台

下载
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;

@Aspect
public class MonitorAspect {

    @Around("get(@Monitor * *)")
    public Object onFieldRead(ProceedingJoinPoint jp) throws Throwable {
        System.out.printf("[READ] %s%n", jp.getSignature());
        return jp.proceed();
    }

    @Around("set(@Monitor * *)")
    public Object onFieldWrite(ProceedingJoinPoint jp) throws Throwable {
        System.out.printf("[WRITE] %s%n", jp.getSignature());
        return jp.proceed();
    }
}
  • get(@Monitor * *):匹配任意被 @Monitor 注解的字段的 读取操作(返回类型 *,声明类型 *);
  • set(@Monitor * *):匹配任意被 @Monitor 注解的字段的 写入操作
  • jp.getSignature() 返回类似 get(int Point.x) 的字符串,清晰标识被拦截的字段及所属类。

运行上述 main 方法,输出如下:

[WRITE] set(int Point.x)
[READ] get(int Point.x)
11
[WRITE] set(int Point.x)
[READ] get(int Point.x)
22

可见:无论通过 setter/getter 还是直接字段赋值,只要源码中发生了对 @Monitor 字段的读写,均被成功捕获。

? 补充说明与最佳实践

  • 区分 getter/setter 执行 vs 字段访问:若你只想拦截 getX()/setX() 方法本身(而非所有字段访问),应改用 execution(public int Point.getX()) 或更通用的 execution(* *(..)) && @annotation(Monitor) 配合方法参数解析,但此时需确保注解加在方法上而非字段。
  • 获取字段值与上下文:在 onFieldRead 中,jp.proceed() 返回字段当前值;在 onFieldWrite 中,可通过 jp.getArgs()[0] 获取待写入的新值(set() 切点的唯一参数即新值)。
  • 性能与范围控制:get()/set() 是编译期织入的底层切点,开销极小,但会匹配所有符合条件的访问。如需限定作用域(如仅拦截某包下类的字段),可增强切点表达式:
    @Around("get(@Monitor * *) && within(com.example..*)")
  • 兼容性提示:确保项目已正确引入 AspectJ Weaver(如 Spring Boot 项目添加 spring-boot-starter-aop 并启用 @EnableAspectJAutoProxy),或使用 ajc 编译器进行编译时织入(CTW)。

通过本方案,你无需修改业务逻辑代码,仅靠注解 + Aspect 即可实现细粒度的字段访问治理,是构建可观测性、安全审计与数据合规能力的重要基础设施。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

832

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

738

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

734

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

397

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

398

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

446

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

430

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16925

2023.08.03

Golang gRPC 服务开发与Protobuf实战
Golang gRPC 服务开发与Protobuf实战

本专题系统讲解 Golang 在 gRPC 服务开发中的完整实践,涵盖 Protobuf 定义与代码生成、gRPC 服务端与客户端实现、流式 RPC(Unary/Server/Client/Bidirectional)、错误处理、拦截器、中间件以及与 HTTP/REST 的对接方案。通过实际案例,帮助学习者掌握 使用 Go 构建高性能、强类型、可扩展的 RPC 服务体系,适用于微服务与内部系统通信场景。

6

2026.01.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 2.5万人学习

C# 教程
C# 教程

共94课时 | 6.8万人学习

Java 教程
Java 教程

共578课时 | 46.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号