Difference between revisions of "Database Testing"
(Created page with "== Overview == This section covers a JUnit-based testing framework for making tests, which use the Simantics Database. The framework handles two separate cases *POJO JUnit tes...") |
|||
| (8 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
== Overview == | == Overview == | ||
| + | |||
| + | The testing framework is contained in the plug-in '''org.simantics.db.testing''' | ||
This section covers a JUnit-based testing framework for making tests, which use the Simantics Database. The framework handles two separate cases | This section covers a JUnit-based testing framework for making tests, which use the Simantics Database. The framework handles two separate cases | ||
| Line 5: | Line 7: | ||
*POJO JUnit tests, where tests are executed without OSGi and with some configuration restrictions | *POJO JUnit tests, where tests are executed without OSGi and with some configuration restrictions | ||
*OSGi JUnit tests, where tests are executed in OSGi based on the current workspace | *OSGi JUnit tests, where tests are executed in OSGi based on the current workspace | ||
| + | |||
| + | The framework contains | ||
| + | |||
| + | * Test case templates for extending in org.simantics.db.testing.base | ||
| + | * Generic test cases in org.simantics.db.testing.cases | ||
== General == | == General == | ||
| Line 13: | Line 20: | ||
public class Tests { | public class Tests { | ||
| − | + | public static Test suite() throws Exception { | |
| − | + | ||
| − | + | TestSuite suite = new TestSuite("My suite"); | |
| − | + | //$JUnit-BEGIN$ | |
suite.addTestSuite(FreshDatabaseTest.class); | suite.addTestSuite(FreshDatabaseTest.class); | ||
suite.addTestSuite(MyTest.class); | suite.addTestSuite(MyTest.class); | ||
| − | + | //$JUnit-END$ | |
| − | + | return suite; | |
| − | + | ||
| + | } | ||
} | } | ||
| Line 30: | Line 38: | ||
The first test is used to set up the initial database and upon which the other tests operate. In POJO mode the first test also needs to give some configuration settings as described below. | The first test is used to set up the initial database and upon which the other tests operate. In POJO mode the first test also needs to give some configuration settings as described below. | ||
| − | + | == Templates == | |
| − | + | === FreshDatabaseTest === | |
| − | + | ||
| + | This test can be used to initialize a database with only selected ontologies installed. The test can be run as is or it can be extended to perform tests upon the initialized database. Use getSession() for obtaining the session. | ||
| + | |||
| + | === ExistingDatabaseTest === | ||
| + | |||
| + | This test can be used to run tests upon an existing database (created e.g. with FreshDatabaseTest). Use getSession() for obtaining the session. | ||
| + | |||
| + | === WriteReadTest === | ||
| + | |||
| + | This test can be used to run simple write-first-then-read tests upon an existing database. Override methods write and read to perform testing. | ||
== Running the tests == | == Running the tests == | ||
| Line 46: | Line 63: | ||
Note that the launchers can be configured using .launch - files. | Note that the launchers can be configured using .launch - files. | ||
| − | == POJO | + | == POJO details == |
The POJO testing framework can be set up by running a customized org.simantics.db.testing.cases.FreshDatabaseTest e.g. | The POJO testing framework can be set up by running a customized org.simantics.db.testing.cases.FreshDatabaseTest e.g. | ||
| + | <pre style="white-space:pre-wrap"> | ||
public class InitializationTest extends FreshDatabaseTest { | public class InitializationTest extends FreshDatabaseTest { | ||
| − | + | @Override | |
| − | + | public void configure(TestSettings settings) { | |
| − | + | settings.setAdapters(new String[] { | |
| − | + | "org.simantics.db.layer0/adapters.xml", | |
| − | + | "org.simantics.spreadsheet.graph/adapters.xml" | |
| − | + | }); | |
| − | + | settings.setOntologies(new String[] { | |
| − | + | "/org.simantics.spreadsheet.ontology/graph.tg", | |
| − | + | }); | |
| − | + | settings.setWorkspace(new File("..")); | |
| − | + | settings.setInitialized(); | |
| − | + | } | |
} | } | ||
| + | </pre> | ||
| − | == OSGi | + | == OSGi details == |
The Plug-in testing framework applies all adapters found from the workspace. | The Plug-in testing framework applies all adapters found from the workspace. | ||
Latest revision as of 08:51, 11 July 2011
Contents
Overview
The testing framework is contained in the plug-in org.simantics.db.testing
This section covers a JUnit-based testing framework for making tests, which use the Simantics Database. The framework handles two separate cases
- POJO JUnit tests, where tests are executed without OSGi and with some configuration restrictions
- OSGi JUnit tests, where tests are executed in OSGi based on the current workspace
The framework contains
- Test case templates for extending in org.simantics.db.testing.base
- Generic test cases in org.simantics.db.testing.cases
General
Both testing approaches use similar test suites. Below is an example
public class Tests {
public static Test suite() throws Exception {
TestSuite suite = new TestSuite("My suite");
//$JUnit-BEGIN$
suite.addTestSuite(FreshDatabaseTest.class);
suite.addTestSuite(MyTest.class);
//$JUnit-END$
return suite;
}
}
The first test is used to set up the initial database and upon which the other tests operate. In POJO mode the first test also needs to give some configuration settings as described below.
Templates
FreshDatabaseTest
This test can be used to initialize a database with only selected ontologies installed. The test can be run as is or it can be extended to perform tests upon the initialized database. Use getSession() for obtaining the session.
ExistingDatabaseTest
This test can be used to run tests upon an existing database (created e.g. with FreshDatabaseTest). Use getSession() for obtaining the session.
WriteReadTest
This test can be used to run simple write-first-then-read tests upon an existing database. Override methods write and read to perform testing.
Running the tests
To run the tests open a context menu for the suite class (see example above) and
- To run in POJO, select Run As .. JUnit Test
- To run in OSGi, select Run As .. JUnit Plug-in Test
The Plug-in tests need to be run as 'all workspace and enabled target plug.ins' and as application '[No Application] - Headless Mode]'
Note that the launchers can be configured using .launch - files.
POJO details
The POJO testing framework can be set up by running a customized org.simantics.db.testing.cases.FreshDatabaseTest e.g.
public class InitializationTest extends FreshDatabaseTest {
@Override
public void configure(TestSettings settings) {
settings.setAdapters(new String[] {
"org.simantics.db.layer0/adapters.xml",
"org.simantics.spreadsheet.graph/adapters.xml"
});
settings.setOntologies(new String[] {
"/org.simantics.spreadsheet.ontology/graph.tg",
});
settings.setWorkspace(new File(".."));
settings.setInitialized();
}
}
OSGi details
The Plug-in testing framework applies all adapters found from the workspace.
org.simantics.db.testing.cases.FreshDatabaseTest can be used to install all available ontologies from the workspace.
