JUnit4注解

jopen 12年前

用来指定加载的Spring配置文件的位置,会加载默认配置文件

例如下例会加载:classpath:/com/example/MyTest-context.xml文件 

package com.example;     @ContextConfiguration  public class MyTest {  // class body...  }
<p>@ContextConfiguration 注解有以下两个常用的属性： </p>
  • locations：可以通过该属性手工指定 Spring 配置文件所在的位置，可以指定一个或多个 Spring 配置文件。如下所示：
    @ContextConfiguration(locations={“xx/yy/beans1.xml”,” xx/yy/beans2.xml”})
  • inheritLocations：是否要继承父测试用例类中的 Spring 配置文件，默认为 true。如下面的例子：
<pre>@ContextConfiguration(locations={"base-context.xml"}) public class BaseTest { // ... } @ContextConfiguration(locations={"extended-context.xml"}) public class ExtendedTest extends BaseTest { // ... }</pre>

如果 inheritLocations 设置为 false，则 ExtendedTest 仅会使用 extended-context.xml 配置文件，否则将使用 base-context.xml 和 extended-context.xml 这两个配置文件。

在使用所有注释前必须使用@RunWith(SpringJUnit4ClassRunner.class),让测试运行于Spring测试环境

Spring框架在org.springframework.test.annotation 包中提供了常用的Spring特定的 注解集，如果你在Java5或以上版本开发，可以在测试中使用它。

@IfProfileValue

提示一下，注解测试只针对特定的测试环境。 如果配置的ProfileValueSource类返回对应的提供者的名称值，这个测试就可以启动。这个注解可以应用到一个类或者单独的方法。

<p>@IfProfileValue(name=”java.vendor”, value=”Sun Microsystems Inc.”)
public void testProcessWhichRunsOnlyOnSunJvm() {
// some logic that should run only on Java VMs from Sun Microsystems
}
同时@IfProfileValue可配置一个值列表 (使用OR 语义) 来在JUnit环境中获得TestNG的测试组支持。看下面的例子： </p> <p>@IfProfileValue(name=”test-groups”, values={”unit-tests”, “integration-tests”})
public void testProcessWhichRunsForUnitOrIntegrationTestGroups() {
// some logic that should run only for unit and integration test groups
} </p>


@ProfileValueSourceConfiguration

类级别注解用来指定当通过@IfProfileValue注解获取已配置的profile值时使用何种ProfileValueSource。如果 @ProfileValueSourceConfiguration没有在测试中声明，将默认使用 SystemProfileValueSource。

<p>@ProfileValueSourceConfiguration(CustomProfileValueSource.class)
public class CustomProfileValueSourceTests {
// class body…
} </p>


@DirtiesContext

在测试方法上出现这个注解时，表明底层Spring容器在该方法的执行中被“污染”，从而必须在方法执行结束后重新创建（无论该测试是否通过）。

<p>@DirtiesContext
public void testProcessWhichDirtiesAppCtx() {
// some logic that results in the Spring container being dirtied
} </p>


@ExpectedException

表明被注解方法预期在执行中抛出一个异常。预期异常的类型在注解中给定。如果该异常的实例在测试方法执行中被抛出，则测试通过。同样的如果该异常实例没有在测试方法执行时抛出，则测试失败。

<p>@ExpectedException(SomeBusinessException.class)
public void testProcessRainyDayScenario() {
// some logic that should result in an Exception being thrown
} </p>


@Timed

表明被注解的测试方法必须在规定的时间区间内执行完成（以毫秒记）。如果测试执行时间超过了规定的时间区间，测试就失败了。

注意该时间区间包括测试方法本身的执行，任何重复测试（参见 @Repeat），还有任何测试fixture的set up或tear down时间。

Spring的@Timed 注解与JUnit 4的@Test(timeout=...) 支持具有不同的语义。特别地，鉴于JUnit 4处理测试执行超时（如通过在一个单独的线程 中执行测试方法）的方式，我们不可能在一个事务上下文中的测试方法上使用JUnit的 @Test(timeout=...) 配置。因此，如果你想将一个测试方法配置成计时 且具事务性 的，你就必须联合使用Spring的@Timed 及@Transactional 注解。还值得注意的是@Test(timeout=...) 只管测试方法本身执行的次数，如果超出的话立刻就会失败；然而，@Timed 关注的是测试执行的总时间（包括建立和销毁操作以及重复），并且不会令测试失败。

<p>@Timed(millis=1000)
public void testProcessWithOneSecondTimeout() {
// some logic that should not take longer than 1 second to execute
} </p>


@Repeat

表明被注解的测试方法必须重复执行。执行的次数在注解中声明。

注意重复执行范围包括包括测试方法本身的执行，以及任何测试fixture的set up或tear down。

<p>@Repeat(10)
public void testProcessRepeatedly() {
// …
} </p>


@Rollback

表明被注解方法的事务在完成后是否需要被回滚。 如果true，事务将被回滚，否则事务将被提交。使用@Rollback接口来在类级别覆写配置的默认回滚标志。

<p>@Rollback(false)
public void testProcessWithoutRollback() {
// …
} </p>


@NotTransactional

出现该注解表明测试方法必须不在事务中执行。

<p>@NotTransactional
public void testProcessWithoutTransaction() {
// …
} </p>

Spring TestContext Framework还支持下面这些非特定于测试的注解，并且保持其语义不变。

  • @Autowired
  • @Qualifier
  • @Resource (javax.annotation)如果JSR-250可用
  • @PersistenceContext (javax.persistence)如果JPA可用
  • @PersistenceUnit (javax.persistence)如果JPA可用
  • @Required
  • @Transactional

@TestExecutionListeners

定义类级别的元数据，TestExecutionListener s会使用TestContextManager 进行注册。通常，@TestExecutionListeners 与@ContextConfiguration 会搭配使用。

<pre>@ContextConfiguration @TestExecutionListeners({CustomTestExecutionListener.class, AnotherTestExecutionListener.class}) public class CustomTestExecutionListenerTests { // class body... }</pre>

@TransactionConfiguration

为配置事务性测试定义了类级别的元数据。特别地，如果需要的PlatformTransactionManager不是 “transactionManager”的话，那么可以显式配置驱动事务的PlatformTransactionManager 的bean名字。此外，可以将defaultRollback 标志改为false 。通常， @TransactionConfiguration 与 @ContextConfiguration 搭配使用。

<pre>@ContextConfiguration @TransactionConfiguration(transactionManager="txMgr", defaultRollback=false) public class CustomConfiguredTransactionalTests { // class body... }</pre>

@BeforeTransaction 
表明被注解的public void 方法应该在测试方法的事务开始之前 执行，该事务是通过@Transactional 注解来配置的。

<pre>@BeforeTransaction public void beforeTransaction() { // logic to be executed before a transaction is started  }</pre>

@AfterTransaction

表明被注解的public void 方法应该在测试方法的事务结束之后 执行，该事务是通过@Transactional 注解来配置的。

<pre>@AfterTransaction public void afterTransaction() { // logic to be executed after a transaction has ended  }</pre>