Java Testcontainers庫(kù)實(shí)現(xiàn)測(cè)試功能
1.Testcontainers介紹:
Testcontainers是一個(gè)Java庫(kù),它支持JUnit測(cè)試,提供公共數(shù)據(jù)庫(kù)、SeleniumWeb瀏覽器或任何可以在Docker容器中運(yùn)行的輕量級(jí)、一次性實(shí)例。
測(cè)試容器使以下類型的測(cè)試更加容易:
數(shù)據(jù)訪問層集成測(cè)試:
使用MySQL,PostgreSQL或Oracle數(shù)據(jù)庫(kù)的容器化實(shí)例測(cè)試您的數(shù)據(jù)訪問層代碼,但無需在開發(fā)人員的計(jì)算機(jī)上進(jìn)行復(fù)雜的設(shè)置,并且測(cè)試將始終從已知的數(shù)據(jù)庫(kù)狀態(tài)開始,避免“垃圾”數(shù)據(jù)的干擾。也可以使用任何其他可以容器化的數(shù)據(jù)庫(kù)類型。
應(yīng)用程序集成測(cè)試:
用于在具有相關(guān)性(例如數(shù)據(jù)庫(kù),消息隊(duì)列或Web服務(wù)器)的短期測(cè)試模式下運(yùn)行應(yīng)用程序。
UI /驗(yàn)收測(cè)試:
使用與Selenium兼容的容器化Web瀏覽器進(jìn)行自動(dòng)化UI測(cè)試。每個(gè)測(cè)試都可以獲取瀏覽器的新實(shí)例,而無需擔(dān)心瀏覽器狀態(tài),插件版本或?yàn)g覽器自動(dòng)升級(jí)。您將獲得每個(gè)測(cè)試會(huì)話或測(cè)試失敗的視頻記錄。
更多:
可以簽出各種貢獻(xiàn)的模塊,或使用 GenericContainer作為基礎(chǔ)創(chuàng)建自己的自定義容器類。
2.Testcontainers實(shí)踐示例:
Testcontainers提供了多種現(xiàn)成的與測(cè)試關(guān)聯(lián)的應(yīng)用程序容器,如下圖:
在本文中,將演示集成postgresql容器和mockserver容器的測(cè)試。
Testcontainers必要條件:
1.Docker
2.支持的JVM測(cè)試框架:JUnit4,JUnit5,spock...
2.1 集成postgresql測(cè)試依賴:
<dependency> <groupId>org.testcontainers</groupId> <artifactId>testcontainers</artifactId> <version>1.12.5</version> <scope>test</scope></dependency><dependency> <groupId>org.testcontainers</groupId> <!--指定數(shù)據(jù)庫(kù)名稱,mysql,mariadb等等--> <artifactId>postgresql</artifactId> <version>1.12.5</version> <scope>test</scope></dependency>
配置:
在項(xiàng)目的src/test/resources/application.properties文件中配置postgresql相關(guān)信息
#將驅(qū)動(dòng)程序設(shè)置為org.testcontainers.jdbc.ContainerDatabaseDriver,它是一個(gè)Testcontainers JDBC代理驅(qū)動(dòng)程序。初始化數(shù)據(jù)源時(shí),此驅(qū)動(dòng)程序?qū)⒇?fù)責(zé)啟動(dòng)所需的Docker容器。spring.datasource.driver-class-name=org.testcontainers.jdbc.ContainerDatabaseDriver
#將JDBC URL設(shè)置為JDBC:tc:<database image>:<version>:///以便Testcontainers知道要使用哪個(gè)數(shù)據(jù)庫(kù)。#TC_INITSCRIPT=指定的數(shù)據(jù)庫(kù)初始化的腳本文件位置spring.datasource.url=jdbc:tc:postgresql:9.6:///?TC_INITSCRIPT=file:src/main/resources/init_db.sql
#將方言明確設(shè)置為數(shù)據(jù)庫(kù)的方言實(shí)現(xiàn),否則在啟動(dòng)應(yīng)用程序時(shí)會(huì)收到異常。當(dāng)您在應(yīng)用程序中使用JPA時(shí)(通過Spring Data JPA),此步驟是必需的spring.jpa.database-platform=org.hibernate.dialect.PostgreSQL9Dialect
測(cè)試示例:
為了在@DataJpaTest中使用TC,您需要確保使用了應(yīng)用程序定義的(自動(dòng)配置的)數(shù)據(jù)源。您可以通過使用@AutoConfigureTestDatabase注釋測(cè)試來輕松完成此操作,如下所示:
@RunWith(SpringJUnit4ClassRunner.class)@DataJpaTest@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)public class OwnerRepositoryTests { @Autowired private OwnerRepository ownerRepository; @Test void findAllReturnsJohnDoe() { // as defined in tc-initscript.sql var owners = ownerRepository.findAll(); assertThat(owners.size()).isOne(); assertThat(owners.get(0).getFirstName()).isEqualTo('John'); assertThat(owners.get(0).getLastName()).isEqualTo('Doe'); }}
以上測(cè)試將使用Testcontainers提供的postgresql容器進(jìn)行測(cè)試,從而排除了外部環(huán)境對(duì)測(cè)試的干擾。
當(dāng)需要用本地?cái)?shù)據(jù)庫(kù)進(jìn)行集成測(cè)試時(shí),我們只要使用@SpringBootTest替換如上兩個(gè)注解即可:
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)@AutoConfigureMockMvcpublic class OwnerResourceTests { @Autowired WebApplicationContext wac; @Test void findAllReturnsJohnDoe() throws Exception { given().webAppContextSetup(wac) .when().get('/owners') .then().status(HttpStatus.OK).body( '_embedded.owners.firstName', containsInAnyOrder('John'), '_embedded.owners.lastName', containsInAnyOrder('Doe')); }}
以上測(cè)試將使用真實(shí)運(yùn)行環(huán)境的數(shù)據(jù)庫(kù)進(jìn)行測(cè)試。
2.2 集成mockServer測(cè)試
Mock Server可用于通過將請(qǐng)求與用戶定義的期望進(jìn)行匹配來模擬HTTP服務(wù)。
依賴:
<dependency> <groupId>org.testcontainers</groupId> <artifactId>mockserver</artifactId> <version>1.12.5</version> <scope>test</scope> </dependency> <dependency> <groupId>org.mock-server</groupId> <artifactId>mockserver-netty</artifactId> <version>5.5.4</version> </dependency> <dependency> <groupId>org.mock-server</groupId> <artifactId>mockserver-client-java</artifactId> <version>5.5.4</version> </dependency>
測(cè)試示例:
//創(chuàng)建一個(gè)MockServer容器@Rulepublic MockServerContainer mockServer = new MockServerContainer();
以及使用Java MockServerClient設(shè)置簡(jiǎn)單的期望。
new MockServerClient(mockServer.getContainerIpAddress(), mockServer.getServerPort()).when(request() .withPath('/person') .withQueryStringParameter('name', 'peter')).respond(response() .withBody('Peter the person!'));//...當(dāng)一個(gè)get請(qǐng)求至’/person?name=peter’ 時(shí)會(huì)返回 'Peter the person!'
測(cè)試(使用restassured進(jìn)行測(cè)試):
RestAssured.baseURI = 'http://' + mockServer.getContainerIpAddress();RestAssured.port = mockServer.getServerPort();given().queryParam('name', 'peter').get('/person').then().statusCode(HttpStatus.OK.value()).body(is('Peter the person!'));
完整代碼如下:
@RunWith(SpringJUnit4ClassRunner.class)public class OneTests { @Rule public MockServerContainer mockServer = new MockServerContainer(); @Test public void v() { RestAssured.baseURI = 'http://' + mockServer.getContainerIpAddress(); RestAssured.port = mockServer.getServerPort(); new MockServerClient(mockServer.getContainerIpAddress(), mockServer.getServerPort()).when(request() .withPath('/person') .withQueryStringParameter('name', 'peter')).respond(response() .withBody('Peter the person!')); given().queryParam('name', 'peter').get('/person').then().statusCode(HttpStatus.OK.value()).body(is('Peter the person!')); }}
3.總結(jié):
Testcontainers輕松的解決了集成測(cè)試時(shí)測(cè)試代碼與本地組件耦合,從而出現(xiàn)各種意外失敗的問題(比如本地?cái)?shù)據(jù)庫(kù)中存在臟數(shù)據(jù)影響到了集成測(cè)試,多個(gè)集成測(cè)試同時(shí)運(yùn)行時(shí)相互干擾導(dǎo)致測(cè)試結(jié)果意外失敗)。筆者之前專門為集成測(cè)試準(zhǔn)備了一套數(shù)據(jù)庫(kù),使數(shù)據(jù)和其他環(huán)境隔離掉,但還是會(huì)遇到多個(gè)集成測(cè)試一起跑相互干擾的問題,Testcontainers輕松的解決了筆者的問題。
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持好吧啦網(wǎng)。
相關(guān)文章:
1. React+umi+typeScript創(chuàng)建項(xiàng)目的過程2. ASP中常用的22個(gè)FSO文件操作函數(shù)整理3. ASP.NET Core 5.0中的Host.CreateDefaultBuilder執(zhí)行過程解析4. SharePoint Server 2019新特性介紹5. .Net core 的熱插拔機(jī)制的深入探索及卸載問題求救指南6. 解決ASP中http狀態(tài)跳轉(zhuǎn)返回錯(cuò)誤頁(yè)的問題7. 讀大數(shù)據(jù)量的XML文件的讀取問題8. ASP編碼必備的8條原則9. 無線標(biāo)記語(yǔ)言(WML)基礎(chǔ)之WMLScript 基礎(chǔ)第1/2頁(yè)10. ASP調(diào)用WebService轉(zhuǎn)化成JSON數(shù)據(jù),附j(luò)son.min.asp
