Bei der Verwendung von JUnit3 ist die Ermittlung des aktuellen Testmethodennamens einfach möglich, da er über die Methode getName direkt an der Instanz der Testklasse ermittelt werden kann. Bei der Erzeugung der checkerberry db-Umgebung ist daher lediglich eine Referenz auf die Testinstanz erforderlich. Folgendes Beispiel zeigt die wesentlichen Aspekte der Erzeugung.

private CheckerberryDbEnvironment environment;

public void setUp() {
  // Die genaue Erstellung der Umgebung ist hier nicht relevant.
  environment = CheckerberryDb.getInstance().getEnvironment(…);

  environment.setUp(this);
}

public void tearDown() {
  environment.tearDown();
  environment = null;
}

Bei dem Setup der Umgebung muss lediglich die Referenz auf die Testinstanz angegeben werden. Den Namen der aktuellen Testmethode ermittelt checkerberry db dann selbständig.

Mit der Einführung von JUnit4 wurde das Feature zur einfachen Ermittlung der aktuellen Testmethode nicht mehr zur Verfügung gestellt. Dieser Fehler wurde mit der JUnit Version 4.7 wieder behoben. Für die Verwendung eines JUnit Version zwischen 4 und 4.7 muss man auf die Hilfe zusätzlicher Frameworks zurückgreifen. Wenn ein Upgrade auf die aktuelle JUnit-Version nicht möglich ist, empfehlen wir die Verwendung von Spring. Folgendes Beispiel zeigt die Konfiguration.

@RunWith(SpringJUnit4ClassRunner.class)
//Spring Konfiguration
@ContextConfiguration(locations = { "/application-context-test.xml" })
//Der erste für DependencyInjection, der zweite um checkerberry db
//mit dem Namen der Testmethode zu versorgen.
@TestExecutionListeners({ DependencyInjectionTestExecutionListener.class,
  TestMethodNameResolvingExecutionListener.class })
public class AbstractJUnit4SpringTest {
  private CheckerberryDbEnvironment environment;

  @Before
  public void setUp() {
    // Die genaue Erstellung der Umgebung ist hier nicht relevant.
    environment = CheckerberryDb.getInstance().getEnvironment(…);

    environment.setUp(this);
  }

  @After
  public void tearDown() {
    environment.tearDown();
    environment = null;
  }
}

Die JUnit-Annotation @RunWith definiert, mit Hilfe welcher Klasse der Test ausgeführt wird. In diesem konkreten Fall wird Spring und JUnit4 verwendet. Über die Spring-Annotation @ContextConfiguration wird der zu verwendende Application-Kontext definiert. Dieser Application-Kontext enthält im Beispiel auch Teile der Bridge-Implementation.

Über die Spring-Annotation @TestExecutionListeners werden zwei Listener registriert, die vor der Testausführung involviert werden. Der Spring-Listener DependencyInjectionTestExecutionListener ist für die Bearbeitung des Application-Kontexts zuständig. Der Listener TestMethodNameResolvingExecutionListener dient der Versorgung von checkerberry mit dem Test-Methodennamen.

Bei dem Setup der Umgebung muss lediglich die Referenz auf die Testinstanz angegeben werden.

Ab der JUnit Version 4.7 wurde die Ermittlung des Namens der aktuellen Testmethode wieder ermöglicht. Das folgende Beispiel zeigt das erforderliche Vorgehen.

@Rule
public MethodNameDeterminationRule rule = new MethodNameDeterminationRule();

private CheckerberryDbEnvironment environment;
@Before
public void setUp() {
  // Die genaue Erstellung der Umgebung ist hier nicht relevant.
  environment = CheckerberryDb.getInstance().getEnvironment(…);

  environment.setUp(this);
}
@After
public void tearDown() {
  environment.tearDown();
  environment = null;
}

Durch die Verwendung der Annotation @Rule wird der Name der aktuellen Testmethode ermittelt. Bei dem Setup der Umgebung muss lediglich die Referenz auf die Testinstanz angegeben werden. Den Namen der aktuellen Testmethode ermittelt checkerberry db dann selbständig.

Anmerkung: die @Rule-Annotation wird von JUnit4 erst ab Version 4.7 bereitgestellt. Sollten Sie eine ältere JUnit4-Version verwenden, so empfehlen wir das Update auf eine aktuelle Version.

Bei der Verwendung von TestNG kann der Name direkt in der Setup-Phase übergeben werden. Folgendes Beispiel zeigt die wesentlichen Aspekte der Erzeugung.

private CheckerberryDbEnvironment environment;

@BeforeMethod
public void setUp(Method testMethod) {
  // Die genaue Erstellung der Umgebung ist hier nicht relevant.
  environment = CheckerberryDb.getInstance().getEnvironment(…);
  environment.setUp(this, testMethod);
}

@AfterMethod
public void tearDown() {
  environment.tearDown();
  environment = null;
}

Die TestNG-Annotation @BeforeMethod ermöglicht die Angabe eines Method-Objekts als Parameter. TestNG sorgt dann zur Ausführungszeit dafür, dass der Parameter mit der aktuellen Testmethode aufgerufen wird. Bei dem Setup der Umgebung muss dann die Referenz auf die Testinstanz und auf die aktuelle Testmethode angegeben werden. Den Namen der aktuellen Testmethode ermittelt checkerberry db dann selbständig.

Selbstverständlich lässt sich checkerberry db auch in anderen Testframeworks als den genannten einsetzen. Die Ermittlung des Namens der aktuellen Testmethode ist von Framework zu Framework unterschiedlich. Das checkerberry test center stellt keine Funktionalität bereit, um den Namen der Testmethoden in anderen Frameworks zu ermitteln.

Wenn der aktuelle Test-Methodenname ermittelt wurde, übergibt man ihn der setUp-Methode als zusätzlichen Parameter, um ihn checkerberry db direkt mitzuteilen: environment.setUp(this, "testMethod");