net.sf.lightair.annotation

Annotation Type Setup

@Target(value={TYPE,METHOD})
 @Retention(value=RUNTIME)
 @Documented
public @interface Setup

Sets up database before test.

Annotate test method with @Setup to setup database before the test method executes. Annotate the whole test class to have all its test methods set up database. For example:

 @Test @Setup
 public void myTestMethod {
 }
 

By default, system locates sequentially the following files in the package of the class, the first file found wins:

1. <test class name>.<test method name>.xml
2. <test method name>.xml
3. <test class name>.xml

Specify the names of files explicitly in the annotation to override the default file name convention. Multiple files may be specified, system uses all of them. The files are located in the package of the class. For example:

 @Test
 @Setup({ "custom-setup-1.xml", "custom-setup-2.xml", "custom-setup-3.xml" })
 public void myTestMethod {
 }
 

The setup files must conform to the DBunit's "flat XML dataset" format, which means there is a root <dataset /> element, which contains one element for each row, where the name of the row element specifies the database table and its elements specify the table columns. So, for example:

 <dataset>
        <person name="Joe" />
 </dataset>
 

System performs "clean insert" database operation with all datasets located, which means all tables in the datasets are deleted in reverse order, then all rows are inserted in the order specified.

Use @Setup.List to define multiple @Setup annotations on the same element.

See http://lightair.sourceforge.net/features/setup.html for more info.

See Also:

Setup.List

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	profile Name of the profile.
String[]	value Names of files with datasets.

Element Detail

value

public abstract String[] value

Names of files with datasets.

Returns:

datasets

Default:

{}

profile

public abstract String profile

Name of the profile.

A profile lets you connect to a different database. A profile must be defined in LightAir properties file and must have its own properties file which defines the connection to the profile database.

Returns:

profile

Default:

""