Add TestKit to BOM and archetype modules [ECR-3056] (#989)

Also add a test with testkit that verifies the correctness of the installation.

Author: MakarovS

exonum-java-binding/bom/pom.xml

@@ -35,6 +35,12 @@
         <version>${project.version}</version>
       </dependency>
 
+      <dependency>
+        <groupId>com.exonum.binding</groupId>
+        <artifactId>exonum-testkit</artifactId>
+        <version>${project.version}</version>
+      </dependency>
+
       <!-- Exported third-party artefacts the services depend upon. -->
       <dependency>
         <groupId>io.vertx</groupId>

exonum-java-binding/service-archetype/pom.xml

@@ -22,7 +22,8 @@
   </properties>
 
   <dependencies>
-    <!-- The archetype has to have a dependency on core so that it is built strictly after it.
+    <!-- The archetype has to have a dependency on core and TestKit so that it is built strictly
+    after those.
 
     The ITs naturally generate a project that is not a child of the parent project.
     Therefore, they also require that the core and its dependencies are available in the (local)
@@ -34,6 +35,13 @@
       <version>${project.version}</version>
       <scope>runtime</scope>
     </dependency>
+
+    <dependency>
+      <groupId>com.exonum.binding</groupId>
+      <artifactId>exonum-testkit</artifactId>
+      <version>${project.version}</version>
+      <scope>runtime</scope>
+    </dependency>
   </dependencies>
 
   <build>
@@ -43,6 +51,11 @@
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-archetype-plugin</artifactId>
           <version>${maven-archetype.version}</version>
+          <configuration>
+            <properties>
+              <nativeLibPath>${project.parent.basedir}/core/rust/target/debug</nativeLibPath>
+            </properties>
+          </configuration>
           <executions>
           	<execution>
           		<goals>

exonum-java-binding/service-archetype/src/main/resources/archetype-resources/pom.xml

@@ -16,6 +16,7 @@
     <java.compiler.source>8</java.compiler.source>
     <java.compiler.target>8</java.compiler.target>
     <junit.jupiter.version>5.5.0</junit.jupiter.version>
+    <nativeLibPath>${env.EXONUM_HOME}/lib/native</nativeLibPath>
     <hamcrest.version>2.1</hamcrest.version>
     <mockito.version>3.0.0</mockito.version>
     <exonum.version>0.7.0-SNAPSHOT</exonum.version>
@@ -72,6 +73,12 @@
       <scope>test</scope>
     </dependency>
 
+    <dependency>
+      <groupId>com.exonum.binding</groupId>
+      <artifactId>exonum-testkit</artifactId>
+      <scope>test</scope>
+    </dependency>
+
     <dependency>
       <groupId>io.vertx</groupId>
       <artifactId>vertx-web-client</artifactId>
@@ -117,7 +124,7 @@
         <version>2.22.2</version>
         <configuration>
           <argLine>
-            -Djava.library.path=${env.EXONUM_HOME}/lib/native
+            -Djava.library.path=${nativeLibPath}
           </argLine>
         </configuration>
       </plugin>

exonum-java-binding/service-archetype/src/main/resources/archetype-resources/src/test/java/ServiceModuleTest.java

@@ -1,4 +1,4 @@
-/* 
+/*
  * Copyright 2018 The Exonum Team
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
@@ -16,36 +16,34 @@
 
 package ${package};
 
-import static org.hamcrest.CoreMatchers.instanceOf;
 import static org.hamcrest.MatcherAssert.assertThat;
+import static org.hamcrest.Matchers.equalTo;
 
-import com.exonum.binding.core.service.Service;
-import com.exonum.binding.core.service.TransactionConverter;
-import com.google.inject.Guice;
-import com.google.inject.Injector;
+import com.exonum.binding.core.blockchain.Blockchain;
+import com.exonum.binding.testkit.TestKit;
 import org.junit.jupiter.api.Test;
 
 class ServiceModuleTest {
 
+  /**
+   * This is an example service integration test with Exonum Testkit. It simply verifies
+   * that a Service can be instantiated by Testkit, and that the libraries required for Testkit
+   * operation are accessible.
+   *
+   * <p>If you get an UnsatisfiedLinkError in this test — please check that the EXONUM_HOME
+   * environment variable is set properly:
+   * https://exonum.com/doc/version/latest/get-started/java-binding/#after-install
+   */
   @Test
-  void testServiceBinding() {
-    Injector injector = createInjector();
-
-    Service s = injector.getInstance(Service.class);
-
-    assertThat(s, instanceOf(MyService.class));
-  }
-
-  @Test
-  void testTransactionConverterBinding() {
-    Injector injector = createInjector();
-
-    TransactionConverter s = injector.getInstance(TransactionConverter.class);
-
-    assertThat(s, instanceOf(MyTransactionConverter.class));
-  }
-
-  private static Injector createInjector() {
-    return Guice.createInjector(new ServiceModule());
+  void testServiceInstantiation() {
+    try (TestKit testKit = TestKit.forService(ServiceModule.class)) {
+      MyService service = testKit.getService(MyService.ID, MyService.class);
+
+      // Check that genesis block was committed
+      testKit.withSnapshot((view) -> {
+        Blockchain blockchain = Blockchain.newInstance(view);
+        assertThat(blockchain.getBlockHashes().size(), equalTo(1L));
+      });
+    }
   }
 }