JUnit 5 中怎么使用 Extension 扩展机制实现自定义拦截器

轻墨姑娘_6254

轻墨姑娘_6254

2026-08-07

877人浏览

原创

JUnit 5 通过 @ExtendWith 和扩展接口实现拦截效果:BeforeEachCallback、AfterEachCallback、AroundTestExecutionCallback 等回调接口可在测试生命周期各阶段插入逻辑,其中 AroundTestExecutionCallback 支持环绕拦截,如耗时统计;可组合多个扩展形成拦截链,并支持自定义注解按需启用,扩展间通过 ExtensionContext.Store 共享状态。

junit 5 中怎么使用 extension 扩展机制实现自定义拦截器

JUnit 5 本身没有“拦截器”这个内置概念,但通过 @ExtendWith + 扩展接口(Extension),可以非常自然地实现类似 AOP 的拦截效果——在测试方法执行前、后或环绕时插入逻辑。

核心思路:用回调接口替代“拦截”

不是靠代理或字节码增强,而是利用 JUnit 5 的生命周期回调机制。你不需要写代理类,只需实现对应接口,在特定时机被自动调用:

  • BeforeEachCallback:每个测试方法执行前调用,适合初始化、清空缓存、开启事务
  • AfterEachCallback:每个测试方法执行后调用,适合回滚、释放资源、断言清理状态
  • AroundTestExecutionCallback:最接近“环绕拦截”,能完全控制测试方法是否执行、何时执行、是否捕获异常,适合耗时统计、异常统一处理、上下文隔离
  • BeforeAllCallback / AfterAllCallback:整个测试类前后各执行一次,适合启动/关闭数据库、加载配置

写一个带耗时统计的环绕拦截扩展

这是最典型的“拦截器式”用法。它会在每个测试方法外层套一层逻辑,就像 try-finally:

public class TimingExtension implements AroundTestExecutionCallback {
    @Override
    public void aroundTestExecution(Executable executable, ExtensionContext context) throws Throwable {
        long start = System.currentTimeMillis();
        try {
            executable.execute(); // 实际执行测试方法
        } finally {
            long cost = System.currentTimeMillis() - start;
            String testName = context.getDisplayName();
            System.out.printf("[Timing] %s took %d ms%n", testName, cost);
        }
    }
}

使用时只需加注解:

@ExtendWith(TimingExtension.class)
class MyTest {
    @Test
    void testSomething() {
        // 会被自动计时
    }
}

组合多个扩展,形成拦截链

JUnit 5 支持同时启用多个扩展,它们按声明顺序依次生效(注意:不是所有扩展都支持叠加,需看具体实现):

Java Maven Code Review
Java Maven Code Review

审查Java Maven项目(ZIP压缩包或GitLab仓库URL),检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载
  • 比如先用 DatabaseCleanExtension 清库,再用 TimingExtension 计时,最后用 LogExtension 打印日志
  • 写法:@ExtendWith({DatabaseCleanExtension.class, TimingExtension.class, LogExtension.class})
  • 每个扩展只关注一件事,职责清晰,也方便复用和开关

让扩展支持参数化(更灵活的“拦截器”)

如果想控制哪些测试才启用某拦截逻辑,可以用自定义注解配合 ExecutionCondition 或直接在扩展中读取测试方法上的注解:

@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface WithTransaction { }
<p>public class TransactionExtension implements AroundTestExecutionCallback {
@Override
public void aroundTestExecution(Executable executable, ExtensionContext context) throws Throwable {
Method method = context.getRequiredTestMethod();
boolean needTx = method.isAnnotationPresent(WithTransaction.class);
if (needTx) {
beginTransaction();
try {
executable.execute();
commitTransaction();
} catch (Throwable t) {
rollbackTransaction();
throw t;
}
} else {
executable.execute();
}
}
}</p>

这样就能按需启用事务拦截,而不是全局强制:

@ExtendWith(TransactionExtension.class)
class UserServiceTest {
    @Test
    @WithTransaction
    void shouldCreateUser() { /* 自动包裹事务 */ }
<pre class="brush:php;toolbar:false;">@Test
void shouldValidateEmail() { /* 不走事务 */ }

}

不复杂但容易忽略:扩展是无状态的,如需跨方法共享数据(比如事务连接),要用 ExtensionContext.Store 存储上下文;另外,AroundTestExecutionCallback 是唯一能真正“拦截并控制执行流程”的接口,其他回调不能阻止测试运行。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
软件测试常用工具
软件测试常用工具

软件测试常用工具有Selenium、JUnit、Appium、JMeter、LoadRunner、Postman、TestNG、LoadUI、SoapUI、Cucumber和Robot Framework等等。测试人员可以根据具体的测试需求和技术栈选择适合的工具,提高测试效率和准确性 。

2023.10.13

4390

8

java测试工具有哪些
java测试工具有哪些

java测试工具有JUnit、TestNG、Mockito、Selenium、Apache JMeter和Cucumber。php还给大家带来了java有关的教程,欢迎大家前来学习阅读,希望对大家能有所帮助。

2023.10.23

2781

10

Java 单元测试
Java 单元测试

本专题聚焦 Java 在软件测试与持续集成流程中的实战应用,系统讲解 JUnit 单元测试框架、Mock 数据、集成测试、代码覆盖率分析、Maven 测试配置、CI/CD 流水线搭建(Jenkins、GitHub Actions)等关键内容。通过实战案例(如企业级项目自动化测试、持续交付流程搭建),帮助学习者掌握 Java 项目质量保障与自动化交付的完整体系。

2025.10.24

1046

26

FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

2026.10.08

40

20

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

140

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

140

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

100

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

100

26

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

2026.09.29

120

15

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习