Eclipse Vert.x 入门

流程

1. 创建新目录 getting-started 并浏览到其中。

   $ mkdir getting-started
   $ cd getting-started

   Copy to Clipboard Toggle word wrap

   这是应用的根目录。

2. 在根目录中创建目录结构 src/main/java/com/example/，然后导航到.

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

   Copy to Clipboard Toggle word wrap

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 Toggle word wrap

   该应用在端口 8080 上启动 HTTP 服务器。向您发送不动时，它又会得到 回报！ 我很好。

4. 在应用程序根目录中创建一个 pom.xml 文件，其内容如下：

   • 在 & lt;dependencyManagement& gt; 部分中，添加 io.vertx:vertx-dependencies 构件。
   • 将 类型指定为 pom，范围 指定为 导入。

   • 在 & lt;project& gt; 部分的 <properties > 下，指定 Eclipse Vert.x 和 Eclipse Vert.x Maven 插件的版本。

     注意

     属性可用于设置在每个版本中更改的值。例如，产品或插件的版本。

   • 在 &lt ;project&gt; 部分中，在 & lt;plugin& gt; 下，指定 vertx-maven-plugin。Eclipse Vert.x Maven 插件用于打包您的应用程序。

   • 包含 软件仓库 和插件，以指定 包含要构建应用程序的工件和插件的存储库。

     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 Toggle word wrap

5. 从应用的根目录使用 Maven 构建应用。

   mvn vertx:run

   Copy to Clipboard Toggle word wrap

6. 验证应用是否正在运行。

   使用 curl 或浏览器验证您的应用程序是否在 http://localhost:8080 中运行，并返回 "Greetings!" 作为回答。

   $ curl http://localhost:8080
   Greetings!

   Copy to Clipboard Toggle word wrap

流程

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 Toggle word wrap

2. 在根目录中创建目录结构 src/test/java/com/example/，然后导航到.

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

   Copy to Clipboard Toggle word wrap

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 Toggle word wrap

4. 使用 Maven 在我的应用上运行 JUnit 测试，可从应用的根目录运行以下命令：

   mvn clean verify

   Copy to Clipboard Toggle word wrap

   您可以检查 目标/surefire-reports 的测试结果。com.example.MyAppTest.txt 文件包含测试结果。