Twoja klasa testów jednostkowych zwykle potrzebuje kilku rzeczy do zarządzania współdzielonym zasobem dla grupy metod testowych. A w Kotlinie możesz używać @BeforeClass
i @AfterClass
nie w klasie testowej, ale raczej w jej obiekcie towarzyszącym wraz z @JvmStatic
adnotacją .
Struktura klasy testowej wyglądałaby następująco:
class MyTestClass {
companion object {
init {
}
val someClassVar = initializer()
lateinit var someClassLateVar: SomeResource
@BeforeClass @JvmStatic fun setup() {
}
@AfterClass @JvmStatic fun teardown() {
}
}
val someInstanceVar = initializer()
var lateinit someInstanceLateZVar: MyType
@Before fun prepareTest() {
}
@After fun cleanupTest() {
}
@Test fun testSomething() {
}
@Test fun testSomethingElse() {
}
}
Biorąc pod uwagę powyższe, warto przeczytać o:
- obiekty towarzyszące - podobne do obiektu Class w Javie, ale pojedynczy obiekt na klasę, który nie jest statyczny
@JvmStatic
- adnotacja, która zamienia metodę obiektu towarzyszącego w metodę statyczną w klasie zewnętrznej na potrzeby współpracy języka Java
lateinit
- umożliwia var
późniejszą inicjalizację właściwości, gdy masz dobrze zdefiniowany cykl życia
Delegates.notNull()
- można użyć zamiast lateinit
dla właściwości, która powinna być ustawiona przynajmniej raz przed odczytaniem.
Oto pełniejsze przykłady klas testowych dla Kotlin, które zarządzają zasobami osadzonymi.
Pierwsza jest kopiowana i modyfikowana z testów Solr-Undertow , a przed uruchomieniem przypadków testowych konfiguruje i uruchamia serwer Solr-Undertow. Po uruchomieniu testów czyści wszystkie pliki tymczasowe utworzone przez testy. Zapewnia również poprawność zmiennych środowiskowych i właściwości systemu przed uruchomieniem testów. Pomiędzy testami zwalnia wszelkie tymczasowo obciążone rdzenie Solr. Test:
class TestServerWithPlugin {
companion object {
val workingDir = Paths.get("test-data/solr-standalone").toAbsolutePath()
val coreWithPluginDir = workingDir.resolve("plugin-test/collection1")
lateinit var server: Server
@BeforeClass @JvmStatic fun setup() {
assertTrue(coreWithPluginDir.exists(), "test core w/plugin does not exist $coreWithPluginDir")
resetEnvProxy()
cleanSysProps()
routeJbossLoggingToSlf4j()
cleanFiles()
val config = mapOf(...)
val configLoader = ServerConfigFromOverridesAndReference(workingDir, config) verifiedBy { loader ->
...
}
assertNotNull(System.getProperty("solr.solr.home"))
server = Server(configLoader)
val (serverStarted, message) = server.run()
if (!serverStarted) {
fail("Server not started: '$message'")
}
}
@AfterClass @JvmStatic fun teardown() {
server.shutdown()
cleanFiles()
resetEnvProxy()
cleanSysProps()
}
private fun cleanSysProps() { ... }
private fun cleanFiles() {
coreWithPluginDir.resolve("data").deleteRecursively()
Files.deleteIfExists(coreWithPluginDir.resolve("core.properties"))
Files.deleteIfExists(coreWithPluginDir.resolve("core.properties.unloaded"))
}
}
val adminClient: SolrClient = HttpSolrClient("http://localhost:8983/solr/")
@Before fun prepareTest() {
}
@After fun cleanupTest() {
unloadCoreIfExists("tempCollection1")
unloadCoreIfExists("tempCollection2")
unloadCoreIfExists("tempCollection3")
}
private fun unloadCoreIfExists(name: String) { ... }
@Test
fun testServerLoadsPlugin() {
println("Loading core 'withplugin' from dir ${coreWithPluginDir.toString()}")
val response = CoreAdminRequest.createCore("tempCollection1", coreWithPluginDir.toString(), adminClient)
assertEquals(0, response.status)
}
}
I kolejny startowy AWS DynamoDB lokalnie jako osadzona baza danych (skopiowana i nieznacznie zmodyfikowana z wbudowanego Uruchamiania AWS DynamoDB-local ). Ten test musi java.library.path
zhakować, zanim cokolwiek się stanie, w przeciwnym razie lokalny DynamoDB (używając sqlite z bibliotekami binarnymi) nie zostanie uruchomiony. Następnie uruchamia serwer do współdzielenia dla wszystkich klas testowych i czyści tymczasowe dane między testami. Test:
class TestAccountManager {
companion object {
init {
val dynLibPath = File("./src/test/dynlib/").absoluteFile
System.setProperty("java.library.path", dynLibPath.toString());
val fieldSysPath = ClassLoader::class.java.getDeclaredField("sys_paths")
fieldSysPath.setAccessible(true)
fieldSysPath.set(null, null)
System.setProperty("org.eclipse.jetty.util.log.class", "org.eclipse.jetty.util.log.Slf4jLog")
}
private val localDbPort = 19444
private lateinit var localDb: DynamoDBProxyServer
private lateinit var dbClient: AmazonDynamoDBClient
private lateinit var dynamo: DynamoDB
@BeforeClass @JvmStatic fun setup() {
localDb = DynamoDBProxyServer(localDbPort, LocalDynamoDBServerHandler(
LocalDynamoDBRequestHandler(0, true, null, true, true), null)
)
localDb.start()
val auth = BasicAWSCredentials("fakeKey", "fakeSecret")
dbClient = AmazonDynamoDBClient(auth) initializedWith {
signerRegionOverride = "us-east-1"
setEndpoint("http://localhost:$localDbPort")
}
dynamo = DynamoDB(dbClient)
AccountManagerSchema.createTables(dbClient)
dynamo.listTables().forEach { table ->
println(table.tableName)
}
}
@AfterClass @JvmStatic fun teardown() {
dbClient.shutdown()
localDb.stop()
}
}
val jsonMapper = jacksonObjectMapper()
val dynamoMapper: DynamoDBMapper = DynamoDBMapper(dbClient)
@Before fun prepareTest() {
setupStaticBillingData(dbClient)
}
@After fun cleanupTest() {
deleteAllInTable<Account>()
deleteAllInTable<Organization>()
deleteAllInTable<Billing>()
}
private inline fun <reified T: Any> deleteAllInTable() { ... }
@Test fun testAccountJsonRoundTrip() {
val acct = Account("123", ...)
dynamoMapper.save(acct)
val item = dynamo.getTable("Accounts").getItem("id", "123")
val acctReadJson = jsonMapper.readValue<Account>(item.toJSON())
assertEquals(acct, acctReadJson)
}
}
UWAGA: niektóre części przykładów są skracane...