Eclipse Vert.x の使用

手順

1. 新しいディレクトリー getting-started を作成し、そこに移動します。

   $ mkdir getting-started
   $ cd getting-started

   Copy to Clipboard

   これは、アプリケーションのルートディレクトリーです。

2. ルートディレクトリーにディレクトリー構造 src/main/java/com/example/ を作成し、そこに移動します。

   $ mkdir -p src/main/java/com/example/
   $ cd src/main/java/com/example/

   Copy to Clipboard

3. アプリケーションコードを含む Java クラスファイル MyApp.java を作成します。

   package com.example;
   
   import io.vertx.core.AbstractVerticle;
   import io.vertx.core.Promise;
   
   public class MyApp extends AbstractVerticle {
   
       @Override
       public void start(Promise<Void> promise) {
           vertx
               .createHttpServer()
               .requestHandler(r ->
                   r.response().end("Greetings!"))
               .listen(8080, result -> {
                   if (result.succeeded()) {
                       promise.complete();
                   } else {
                       promise.fail(result.cause());
                   }
               });
       }
   }

   Copy to Clipboard

   アプリケーションは、ポート 8080 で HTTP サーバーを起動します。リクエストを送信すると、Greetings! メッセージが返されます。

4. アプリケーションルートディレクトリー getting-started に、以下の内容で pom.xml ファイルを作成します。

   • <dependencyManagement> セクションに、io.vertx:vertx-dependencies アーティファクトを追加します。
   • type を pom として指定し、scope を import として指定します。

   • <project> セクションの <properties> で、EclipseVert.x と EclipseVert.xMaven Plugin のバージョンを指定します。

     注記

     プロパティーを使用して、リリースごとに変更する値を設定できます。たとえば、製品またはプラグインのバージョンです。

   • <project> セクションの <plugin> で、vertx-maven-plugin を指定します。Eclipse Vert.x Maven Plugin は、アプリケーションのパッケージ化に使用されます。

   • repositories および pluginRepositories を追加して、アプリケーションのビルド用のアーティファクトおよびプラグインが含まれるリポジトリーを指定します。

     pom.xml には、以下のアーティファクトが含まれます。

   <?xml version="1.0" encoding="UTF-8"?>
   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
   
     <groupId>com.example</groupId>
     <artifactId>my-app</artifactId>
     <version>1.0.0-SNAPSHOT</version>
     <packaging>jar</packaging>
   
     <name>My Application</name>
     <description>Example application using Vert.x</description>
   
     <properties>
       <vertx.version>4.3.7.redhat-00002</vertx.version>
       <vertx-maven-plugin.version>1.0.24</vertx-maven-plugin.version>
       <vertx.verticle>com.example.MyApp</vertx.verticle>
   
       <maven.compiler.source>1.8</maven.compiler.source>
       <maven.compiler.target>1.8</maven.compiler.target>
       <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
       <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
     </properties>
   
     <!-- Import dependencies from the Vert.x BOM. -->
     <dependencyManagement>
       <dependencies>
         <dependency>
           <groupId>io.vertx</groupId>
           <artifactId>vertx-dependencies</artifactId>
           <version>${vertx.version}</version>
           <type>pom</type>
           <scope>import</scope>
         </dependency>
       </dependencies>
     </dependencyManagement>
   
     <!-- Specify the Vert.x artifacts that your application depends on. -->
     <dependencies>
       <dependency>
         <groupId>io.vertx</groupId>
         <artifactId>vertx-core</artifactId>
       </dependency>
       <dependency>
         <groupId>io.vertx</groupId>
         <artifactId>vertx-web</artifactId>
       </dependency>
   
       <!-- Test dependencies -->
       <dependency>
         <groupId>io.vertx</groupId>
         <artifactId>vertx-junit5</artifactId>
         <scope>test</scope>
       </dependency>
       <dependency>
         <groupId>org.junit.jupiter</groupId>
         <artifactId>junit-jupiter-engine</artifactId>
         <version>5.4.0</version>
         <scope>test</scope>
       </dependency>
   
     </dependencies>
   
     <!-- Specify the repositories containing Vert.x artifacts. -->
     <repositories>
       <repository>
         <id>redhat-ga</id>
         <name>Red Hat GA Repository</name>
         <url>https://maven.repository.redhat.com/ga/</url>
       </repository>
     </repositories>
   
   <!-- Specify the version of the Maven Surefire plugin. -->
       <build>
       <plugins>
         <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-surefire-plugin</artifactId>
           <version>3.0.0-M5</version>
         </plugin>
         <plugin>
   
   <!-- Configure your application to be packaged using the Vert.x Maven Plugin. -->
           <groupId>io.reactiverse</groupId>
           <artifactId>vertx-maven-plugin</artifactId>
           <version>${vertx-maven-plugin.version}</version>
           <executions>
             <execution>
               <id>vmp</id>
               <goals>
                 <goal>initialize</goal>
                 <goal>package</goal>
               </goals>
             </execution>
           </executions>
         </plugin>
       </plugins>
     </build>
   </project>

   Copy to Clipboard

5. アプリケーションのルートディレクトリーから Maven を使用してアプリケーションをビルドします。

   mvn vertx:run

   Copy to Clipboard

6. アプリケーションが実行していることを確認します。

   curl またはブラウザーを使用して、アプリケーションが http://localhost:8080 で実行されているかどうかを確認し、"Greetings!" がレスポンスとして返されるかを確認します。

   $ curl http://localhost:8080
   Greetings!

   Copy to Clipboard

手順

1. 生成された pom.xml ファイルを開き、Surefire Maven プラグインのバージョンを設定します。

   <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-surefire-plugin</artifactId>
           <version>3.0.0-M5</version>
   </plugin>

   Copy to Clipboard

2. ルートディレクトリーにディレクトリー構造 src/test/java/com/example/ を作成し、そこに移動します。

   $ mkdir -p src/test/java/com/example/
   $ cd src/test/java/com/example/

   Copy to Clipboard

3. アプリケーションコードを含む Java クラスファイル MyTestApp.java を作成します。

   package com.example;
   
   import static org.junit.jupiter.api.Assertions.assertEquals;
   
   import org.junit.jupiter.api.BeforeEach;
   import org.junit.jupiter.api.DisplayName;
   import org.junit.jupiter.api.Test;
   import org.junit.jupiter.api.extension.ExtendWith;
   
   import io.vertx.core.Vertx;
   import io.vertx.core.http.HttpMethod;
   import io.vertx.junit5.VertxExtension;
   import io.vertx.junit5.VertxTestContext;
   
   @ExtendWith(VertxExtension.class)
   class MyAppTest {
   
     @BeforeEach
     void prepare(Vertx vertx, VertxTestContext testContext) {
       // Deploy the verticle
       vertx.deployVerticle(new MyApp())
         .onSuccess(ok -> testContext.completeNow())
         .onFailure(failure -> testContext.failNow(failure));
     }
   
     @Test
     @DisplayName("Smoke test: check that the HTTP server responds")
     void smokeTest(Vertx vertx, VertxTestContext testContext) {
       // Issue an HTTP request
       vertx.createHttpClient()
         .request(HttpMethod.GET, 8080, "127.0.0.1", "/")
         .compose(request -> request.send())
         .compose(response -> response.body())
         .onSuccess(body -> testContext.verify(() -> {
           // Check the response
           assertEquals("Greetings!", body.toString());
           testContext.completeNow();
         }))
         .onFailure(failure -> testContext.failNow(failure));
     }
   }

   Copy to Clipboard

4. Maven を使用してアプリケーションで JUnit テストを実行するには、アプリケーションのルートディレクトリーから以下のコマンドを実行します。

   mvn clean verify

   Copy to Clipboard

   テスト結果は、target/surefire-reports で確認できます。com.example.MyAppTest.txt ファイルにはテスト結果が含まれます。