Test container example for ImmuDB (#5860)

Test container example using ImmuDB, performing basic operations

Fixes #5594

Co-authored-by: Eddú Meléndez Gonzales <[email protected]>

Author: hariohmprasath

docs/examples.md

@@ -2,14 +2,15 @@
 
 Examples of different use cases provided by Testcontainers can be found below:
 
-- [Kafka Cluster with multiple brokers](https://github.com/testcontainers/testcontainers-java/tree/main/examples/kafka-cluster)
-- [Linked containers](https://github.com/testcontainers/testcontainers-java/tree/main/examples/linked-container)
-- [Neo4j](https://github.com/testcontainers/testcontainers-java/tree/main/examples/neo4j-container)
-- [Redis](https://github.com/testcontainers/testcontainers-java/tree/main/examples/redis-backed-cache)
-- [Selenium](https://github.com/testcontainers/testcontainers-java/tree/main/examples/selenium-container)
-- [Selenium Module with Cucumber](https://github.com/testcontainers/testcontainers-java/tree/main/examples/cucumber)
-- [Singleton Container Pattern](https://github.com/testcontainers/testcontainers-java/tree/main/examples/singleton-container)
-- [Solr](https://github.com/testcontainers/testcontainers-java/tree/main/examples/solr-container)
-- [Spring Boot](https://github.com/testcontainers/testcontainers-java/tree/main/examples/spring-boot)
-- [Spring Boot with Kotlin](https://github.com/testcontainers/testcontainers-java/tree/main/examples/spring-boot-kotlin-redis)
-- [TestNG](https://github.com/testcontainers/testcontainers-java/tree/main/examples/redis-backed-cache-testng)
+- [Kafka Cluster with multiple brokers](https://github.com/testcontainers/testcontainers-java/tree/master/examples/kafka-cluster)
+- [Linked containers](https://github.com/testcontainers/testcontainers-java/tree/master/examples/linked-container)
+- [Neo4j](https://github.com/testcontainers/testcontainers-java/tree/master/examples/neo4j-container)
+- [Redis](https://github.com/testcontainers/testcontainers-java/tree/master/examples/redis-backed-cache)
+- [Selenium](https://github.com/testcontainers/testcontainers-java/tree/master/examples/selenium-container)
+- [Selenium Module with Cucumber](https://github.com/testcontainers/testcontainers-java/tree/master/examples/cucumber)
+- [Singleton Container Pattern](https://github.com/testcontainers/testcontainers-java/tree/master/examples/singleton-container)
+- [Solr](https://github.com/testcontainers/testcontainers-java/tree/master/examples/solr-container)
+- [Spring Boot](https://github.com/testcontainers/testcontainers-java/tree/master/examples/spring-boot)
+- [Spring Boot with Kotlin](https://github.com/testcontainers/testcontainers-java/tree/master/examples/spring-boot-kotlin-redis)
+- [TestNG](https://github.com/testcontainers/testcontainers-java/tree/master/examples/redis-backed-cache-testng)
+- [ImmuDb](https://github.com/testcontainers/testcontainers-java/tree/master/examples/immudb)

examples/immudb/build.gradle

@@ -0,0 +1,14 @@
+plugins {
+    id 'java'
+}
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    compileOnly 'org.slf4j:slf4j-api:2.0.0'
+    implementation 'io.codenotary:immudb4j:0.9.10.2'
+    testImplementation 'org.testcontainers:testcontainers'
+    testImplementation 'org.assertj:assertj-core:3.23.1'
+}

examples/immudb/src/test/java/ImmuDbTest.java

@@ -0,0 +1,63 @@
+import io.codenotary.immudb4j.Entry;
+import io.codenotary.immudb4j.ImmuClient;
+import io.codenotary.immudb4j.exceptions.CorruptedDataException;
+import io.codenotary.immudb4j.exceptions.VerificationException;
+import org.junit.Assert;
+import org.junit.Before;
+import org.junit.ClassRule;
+import org.junit.Test;
+import org.testcontainers.containers.GenericContainer;
+import org.testcontainers.containers.wait.strategy.Wait;
+import static org.assertj.core.api.Assertions.assertThat;
+
+/**
+ * Test class for the ImmuDbClient.
+ */
+public class ImmuDbTest {
+
+    // Default port for the ImmuDb server
+    private static final int IMMUDB_PORT = 3322;
+    // Default username for the ImmuDb server
+    private final String IMMUDB_USER = "immudb";
+    // Default password for the ImmuDb server
+    private final String IMMUDB_PASSWORD = "immudb";
+    // Default database name for the ImmuDb server
+    private final String IMMUDB_DATABASE = "defaultdb";
+
+    // Test container for the ImmuDb database, with the latest version of the image and exposed port
+    @ClassRule
+    public static final GenericContainer<?> immuDbContainer = new GenericContainer<>("codenotary/immudb:1.3")
+        .withExposedPorts(IMMUDB_PORT).waitingFor(
+            Wait.forLogMessage(".*Web API server enabled.*", 1)
+        );
+    // ImmuClient used to interact with the DB
+    private ImmuClient immuClient;
+
+    @Before
+    public void setUp() {
+        this.immuClient = ImmuClient.newBuilder()
+            .withServerUrl(immuDbContainer.getHost())
+            .withServerPort(immuDbContainer.getMappedPort(IMMUDB_PORT))
+            .build();
+        this.immuClient.login(IMMUDB_USER, IMMUDB_PASSWORD);
+        this.immuClient.useDatabase(IMMUDB_DATABASE);
+    }
+
+    @Test
+    public void testGetValue() {
+        try {
+            immuClient.set("test1", "test2".getBytes());
+
+            Entry entry = immuClient.verifiedGet("test1");
+
+            if (entry != null) {
+                byte[] value = entry.getValue();
+                assertThat(new String(value)).isEqualTo("test2");
+            } else {
+                Assert.fail();
+            }
+        } catch (CorruptedDataException | VerificationException e) {
+            Assert.fail();
+        }
+    }
+}

examples/settings.gradle

@@ -30,6 +30,7 @@ include 'solr-container'
 include 'spring-boot'
 include 'cucumber'
 include 'spring-boot-kotlin-redis'
+include 'immudb'
 
 ext.isCI = System.getenv("CI") != null