Vert.x Java

2025年5月5日 | 阅读 4 分钟

Vert.x 是一个开源的、多语言的平台或工具包，在 Java 中。Vert.x 平台运行在 JVM（Java 虚拟机）上。我们可以说它是 JEE 的替代品。它采用不同的方法来解决开发网络化和高并发应用的问题。它在所有支持的语言如Java、Ruby、Kotlin、Scala和JavaScript之间共享通用功能。

Vert.x 是一个工具包，所以我们可以将其嵌入到我们独立的 Java 应用程序中。我们可以通过实例化 Vert.x 对象并对其调用方法来使用它。在工具包模式下，我们的代码控制 vert.x。它还充当一个平台，所以我们可以使用命令行设置它，并告诉它要运行的组件。

安装

Vert.x 的安装非常简单。它以 zip 文件的形式分发，其中包含一堆 Jar 文件。我们只需解压文件，然后将所有 JAR 文件添加到我们 Java 应用程序的类路径中。添加完所有 JAR 文件后，我们就可以在我们的应用程序中使用 Vert.x 了。

我们可以从Maven Central或从Bintray下载 zip 文件。

让我们开始一个新 vert.x Web 项目，但在那之前，我们必须确保我们的系统具备以下条件

JDK 1.8 或更高版本。
IDE 或文本编辑器。
Maven 3 或更高版本。
用于执行 HTTP 请求的浏览器。

为了使用 Vert.x 创建第一个 Web 项目，我们应该遵循以下步骤

1) 我们转到https://start.vertx.io/来创建一个新项目。我们会看到如下屏幕

2) 我们选择要在应用程序中使用的 Vert.x 版本。我们根据自己的兴趣选择语言，Java 或 Kotlin。我们还选择构建工具，Maven和Gradle。在本例中，我们使用 Maven。我们填写 Group Id 和 Artifact Id 字段。我们还添加 Vert.x Web 作为依赖项。添加依赖项后，我们单击 Generate Project 按钮来创建项目。

3) 当我们单击 Generate Project 按钮时，它会在我们的计算机上下载 zip 文件。我们将其解压到您选择的文件夹中。

生成的文件夹包含 maven 构建描述符，即pom.xml。pom.xml 配置用于构建和运行我们的应用程序。它包含一个使用JUnit 5 的示例测试和 verticle。为了强制执行代码风格，它还包含一个编辑器配置。最后，为了忽略文件，它包含一个Git配置。

4) 现在，我们将在您选择的任何 IDE 或编辑器中打开该 Vert.x 项目，并导航到以下路径

MainVerticle.java 类包含一个启动 HTTP 服务器的示例 verticle。我们修改该类以向请求我们服务器的任何人发出问候。我们按如下方式更改代码

package com.example.starter;

import io.vertx.core.AbstractVerticle;
import io.vertx.core.MultiMap;
import io.vertx.core.Promise;
import io.vertx.core.json.JsonObject;
import io.vertx.ext.web.Router;

//class to understand the vert.x toolkit
public class MainVerticle extends AbstractVerticle {
	//overriding the abstract method of the AbstractVerticle class
	@Override
	  public void start() throws Exception {
	    // instantiate the object of the Router class to create router
	    Router router = Router.router(vertx);

	    //At every path and HTTP method for all incoming requests mount the handler
	    router.route().handler(context -> {
	      // Find the address of the request by using request(), connection() and remoteAddress() method
	      String address = context.request().connection().remoteAddress().toString();
	      
	      // Find the "name" query parameter from the queryParams() by using get() method
	      MultiMap queryParams = context.queryParams();
	      String name = queryParams.contains("name") ? queryParams.get("name") : "unknown";
	      // write information in JSON format as a response 
	      context.json(
	        new JsonObject()
	          .put("name", name)
	          .put("address", address)
	          .put("message", "Hello " + name + " connected from " + address)
	      );
	    });

	    // use createHttpServer() method to create Http server
	    vertx.createHttpServer()
	      // use router to handle each upcoming request
	      .requestHandler(router)
	      // use listen() method to start listening
	      .listen(8888)
	      // using actualPort() method of server to print port
	      .onSuccess(server ->
	        System.out.println(
	          "HTTP server started on port " + server.actualPort()
	        )
	      );
	  }
	}

上面的代码将创建一个 vert.x Web 路由器，并在端口 8888 上启动一个 HTTP 服务器。它在每次请求时返回一个 JSON 对象。JSON 对象包含查询参数名称、请求的地址和一个问候消息。

5) 现在，我们运行我们的 Vert.x 项目，在运行项目之前，我们必须确保 Maven 已安装在我们的系统中。我们打开终端并运行以下命令来检查 Maven 是否已安装在我们的系统中。