第 5 章 创建 Eclipse Vert.x 项目的其它方法

流程

1. 在命令终端中，输入以下命令验证 Maven 是否使用 OpenJDK 8 或 OpenJDK 11，并且 Maven 版本为 3.6.0 或更高版本：

   mvn --version

2. 如果前面的命令没有返回 OpenJDK 8 或 OpenJDK 11，请将到 OpenJDK 8 或 OpenJDK 11 的路径添加到 PATH 环境变量中，然后再次输入该命令。

3. 创建目录并前往目录位置。

   mkdir getting-started && cd getting-started

4. 使用以下命令，使用 Eclipse Vert.x Maven 插件创建新项目。

   mvn io.reactiverse:vertx-maven-plugin:${vertx-maven-plugin-version}:setup -DvertxBom=vertx-dependencies \
   -DvertxVersion=${vertx_version} \
   -DprojectGroupId= ${project_group_id} \
   -DprojectArtifactId= ${project_artifact_id} \
   -DprojectVersion=${project-version} \
   -Dverticle=${verticle_class} \
   -Ddependencies=${dependency_names}

   以下示例演示了如何使用 命令创建 Eclipse Vert.x 应用。

   mvn io.reactiverse:vertx-maven-plugin:1.0.24:setup -DvertxBom=vertx-dependencies \
   -DvertxVersion=4.3.7.redhat-00002 \
   -DprojectGroupId=io.vertx.myapp \
   -DprojectArtifactId=my-new-project \
   -DprojectVersion=1.0-SNAPSHOT \
   -DvertxVersion=4.3.7.redhat-00002 \
   -Dverticle=io.vertx.myapp.MainVerticle \
   -Ddependencies=web

   下表列出了您可以使用 setup 命令定义的属性：

   属性	默认值	Description
   vertx_version	Eclipse Vert.x 的版本。	要在项目中使用的 Eclipse Vert.x 版本。
   project_group_id	io.vertx.example	项目的唯一标识符。
   project_artifact_id	my-vertx-project	项目和项目目录的名称。如果没有指定 project_artifact_id，则 Maven 插件会启动交互模式。如果 目录已存在，生成会失败。
   project-version	1.0-SNAPSHOT	项目的版本。
   verticle_class	io.vertx.example.MainVerticle	由 verticle 参数创建的新 verticle 类文件。
   dependency_names	可选参数	要添加到项目中以逗号分开的依赖关系列表。您还可以使用以下语法来配置依赖项： groupId:artifactId:version:classifier 例如： - 从 BOM 继承版本，使用以下语法： io.vertx:vertxcodetrans - 指定依赖项使用以下语法： commons-io:commons-io:2.5 - 使用类符指定依赖项，使用以下语法： io.vertx:vertx-template-engines:3.4.1:shaded

   该命令会创建一个空 Eclipse Vert.x 项目，其中包含 getting-started 目录中的以下工件：

   • Maven build de­s­ip­tor pom.xml con­ured to build and run apli­ca­tion
   • src/main/java 文件夹中的示例

5. 在 pom.xml 文件中，指定包含 Eclipse Vert.x 工件的存储库以构建应用程序。

   <repositories>
       <repository>
         <id>redhat-ga</id>
         <name>Red Hat GA Repository</name>
         <url>https://maven.repository.redhat.com/ga/</url>
       </repository>
     </repositories>

   或者，您也可以配置 Maven 存储库，以在 settings.xml 文件中指定构建工件。如需更多信息，请参阅为 Eclipse Vert.x 项目配置 Apache Maven 存储库。

6. 使用 Eclipse Vert.x 项目作为模板来创建自己的应用程序。

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

   mvn package

8. 从应用的根目录使用 Maven 运行应用。

   mvn vertx:run