做平面设计兼职的网站小枫云主机

做平面设计兼职的网站,小枫云主机,物流企业网站模板,做二手房又做网站的当你在本地、测试环境和 CI 中跑同一组测试时#xff0c;是否遇到过这样的困惑#xff1a;同一段业务逻辑在不同配置、不同 Locale 下的表现不尽相同#xff0c;但你又不想为每种场景复制一堆几乎一样的测试类#xff1f;如果把所有分支逻辑都塞进一个测试方法里#xff0…当你在本地、测试环境和 CI 中跑同一组测试时是否遇到过这样的困惑同一段业务逻辑在不同配置、不同 Locale 下的表现不尽相同但你又不想为每种场景复制一堆几乎一样的测试类如果把所有分支逻辑都塞进一个测试方法里又会让测试变得臃肿难以维护。有没有一种方式可以让测试代码保持简洁却能优雅地在多种“环境切面”下重复执行整套测试这正是 JUnit 5 中ClassTemplate想要解决的问题。本文就从这个现实场景出发带你深入理解 Class Template 的执行机制、扩展点设计以及一个实用的多 Locale 示例。1. 引言有些测试需要在不同的环境中运行。ClassTemplate注解可以帮我们做到这一点它会让整个测试类在多种不同配置下被重复执行。在这篇教程中我们会先讨论为什么会有“类模板Class Template”这种机制以及 JUnit 是如何执行它们的接着会看看它在整体执行模型中的位置最后我们会拆解类模板的结构、背后的提供者provider并通过一个示例在不复制任何测试代码的前提下让同一个测试类在多个 Locale 环境下运行。2. 什么是ClassTemplate简单回顾一下ClassTemplate会把一个测试类变成“模板类”让它按照不同的调用上下文invocation context多次执行。提供者负责提供这些上下文每一个上下文都会触发一次独立的执行拥有各自的生命周期和扩展。在实践中这让我们可以在不同环境或配置下多次运行同一个测试类同时保持测试代码本身的简单性。我们可以改变运行时的环境配置而不用复制测试类或者在单个测试方法里加入复杂的分支逻辑。2.1. Class Template 如何执行一个类模板由两部分组成模板类本身以及为其提供调用上下文的提供者。模板类在外观上就像一个普通的 JUnit 测试类但ClassTemplate注解会告诉 JUnit 不要直接运行它而是等待提供者来定义该类的具体执行方式。一旦 JUnit 识别出某个类是类模板提供者就会返回一个或多个上下文每个上下文都定义了一次完整的执行。对于每个上下文JUnit 都会创建一个新的测试实例应用对应的扩展并执行生命周期方法和测试方法。这样测试类可以专注于业务逻辑本身而由提供者来塑造运行时环境。2.2. Class Template 与 Method Template 对比在继续之前值得先对比一下类模板和方法模板method template之间的区别。两者都支持重复执行但关注的层级不同。方法模板会在不同输入下重复执行同一个测试方法而类模板则会重复执行整个测试类包括它的生命周期回调、扩展以及配置。因此当变化点主要体现在整体环境层面——例如 Locale、特性开关或系统级配置——而不是单个方法参数时类模板会更加合适。3. 调用上下文提供者接下来我们看看“调用上下文提供者invocation context provider”。这个扩展负责为类模板提供执行上下文。它需要实现ClassTemplateInvocationContextProvider接口该接口定义了两个核心方法用来决定提供者如何参与测试执行。下面我们分别来看。3.1.supportsClassTemplate()方法在 JUnit 使用某个提供者之前它会先检查该提供者是否适用于当前正在发现的测试类。这个检查就是通过supportsClassTemplate()方法完成的OverridepublicbooleansupportsClassTemplate(ExtensionContextcontext){returncontext.getTestClass().map(aClass-aClass.isAnnotationPresent(ClassTemplate.class)).orElse(false);}JUnit 会对每一个已注册的提供者调用这个方法。只有返回true的提供者才会对当前类模板生效。通过这种机制JUnit 可以避免提供者被意外激活避免在无关测试上运行扩展同时也允许多个提供者并存而互不干扰。3.2.provideClassTemplateInvocationContexts()方法一旦某个提供者被激活JUnit 就会调用provideClassTemplateInvocationContexts()以获取描述模板执行方式的上下文OverridepublicStreamClassTemplateInvocationContextprovideClassTemplateInvocationContexts(ExtensionContextcontext){returnStream.of(invocationContext(A),invocationContext(B));}每一个上下文都代表了一次对测试类的完整执行。单个提供者可以提供一个或多个上下文如果同时有多个提供者处于激活状态JUnit 会把它们提供的流拼接起来。每个上下文都可以添加自己的扩展或配置从而让提供者可以对该次执行的环境进行精细控制。从这里开始JUnit 会为每个上下文创建一个新的测试类实例应用对应的扩展并完整运行生命周期方法和测试方法各一次。4. 实用示例为了更直观地理解这些概念我们来构造一个示例编写一个测试用来验证在多个 JVM Locale 下的日期格式化逻辑。由于 Locale 会影响整个执行环境这类需求非常适合用类模板来实现。我们只保留一个测试类然后让提供者在不同配置下多次执行它。4.1. 日期格式化逻辑首先从一个小工具类开始它使用当前 JVM 默认 Locale 来格式化日期。只要默认 Locale 发生变化它的输出就会随之改变classDateFormatter{publicStringformat(LocalDatedate){DateTimeFormatterformatterDateTimeFormatter.ofLocalizedDate(FormatStyle.LONG).withLocale(Locale.getDefault());returndate.format(formatter);}}有了这个类之后我们就可以在多种不同的配置下验证它的行为而这些配置都由类模板来提供。4.2. 提供者与扩展为了支撑上述需求我们首先需要一个扩展用来在单次执行期间设置默认 LocaleclassLocaleExtensionimplementsBeforeEachCallback,AfterEachCallback{privatefinalLocalelocale;privateLocaleprevious;OverridepublicvoidbeforeEach(ExtensionContextcontext){previousLocale.getDefault();Locale.setDefault(locale);}OverridepublicvoidafterEach(ExtensionContextcontext){Locale.setDefault(previous);}}这个扩展会在每次测试之前暂时替换 JVM 的默认 Locale并在测试结束后恢复原有值。在不同执行之间唯一变化的就是传入该扩展的Locale实例。接下来提供者会通过provideClassTemplateInvocationContexts()方法来提供不同的上下文。每个上下文都由invocationContext()方法创建该方法通过getDisplayName()指定显示名并通过getAdditionalExtensions()安装对应的LocaleExtensionclassDateLocaleClassTemplateProviderimplementsClassTemplateInvocationContextProvider{OverridepublicStreamClassTemplateInvocationContextprovideClassTemplateInvocationContexts(ExtensionContextcontext){returnStream.of(Locale.US,Locale.GERMANY,Locale.ITALY,Locale.JAPAN).map(this::invocationContext);}privateClassTemplateInvocationContextinvocationContext(Localelocale){returnnewClassTemplateInvocationContext(){OverridepublicStringgetDisplayName(intinvocationIndex){returnLocale: locale.getDisplayName();}OverridepublicListExtensiongetAdditionalExtensions(){returnList.of(newLocaleExtension(locale));}};}}通过这样的配置我们就得到了互不相同的执行环境最终会对同一个测试类执行四次测试。4.3. Class Template 测试此时类模板的整体配置已经就位我们就可以专注于编写一个测试方法了。JUnit 会通过前面配置好的提供者为每个上下文执行一次这个方法privatefinalDateFormatterformatternewDateFormatter();TestvoidgivenDefaultLocale_whenFormattingDate_thenMatchesLocalizedOutput(){LocalDatedateLocalDate.of(2025,9,30);DateTimeFormatterexpectedFormatterDateTimeFormatter.ofLocalizedDate(FormatStyle.LONG).withLocale(Locale.getDefault());Stringexpecteddate.format(expectedFormatter);Stringformattedformatter.format(date);LOG.info(Locale: {}, Expected: {}, Formatted: {},Locale.getDefault(),expected,formatted);assertEquals(expected,formatted);}在每次执行中测试都会基于当前默认 Locale 计算预期值并与DateFormatter的输出进行比较。类模板和提供者负责在每次执行之间切换环境设置因此测试代码本身可以保持简单、干净不需要任何分支逻辑。4.4. 测试输出最后当我们运行这组测试时同一个测试类会在每个 Locale 下执行一次而每次的格式化结果都不相同Locale: en_US, Expected: September 30, 2025, Formatted: September 30, 2025 Locale: de_DE, Expected: 30. September 2025, Formatted: 30. September 2025 Locale: it_IT, Expected: 30 settembre 2025, Formatted: 30 settembre 2025 Locale: ja_JP, Expected: 2025年9月30日, Formatted: 2025年9月30日可以看到每一行都对应于一个调用上下文。测试代码在这些运行之间完全没有变化变化的只是由提供者和扩展配置出来的执行环境。5. 总结在本文中我们从基础概念出发进一步深入了ClassTemplate的使用方式重点考察了提供者如何为单个测试类提供多个执行上下文。通过 Locale 示例我们看到提供者和扩展可以在不修改测试代码的前提下灵活地切换测试环境。这使得类模板成为处理全局设置或配置级行为测试的一种干净而优雅的解决方案。感谢阅读如果您对Java内容感兴趣也可以关注我的Java专题内容。