第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.1.8.redhat-00003 \
   -DprojectGroupId=io.vertx.myapp \
   -DprojectArtifactId=my-new-project \
   -DprojectVersion=1.0-SNAPSHOT \
   -DvertxVersion=4.1.8.redhat-00003 \
   -Dverticle=io.vertx.myapp.MainVerticle \
   -Ddependencies=web

   次の表に、setup コマンドで定義できる属性を示します。

   属性	デフォルト値	説明
   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

   このコマンドは、getting-started ディレクトリーで以下のアーティファクトを使用して空の Eclipse Vert.x プロジェクトを作成します。

   • アプリケーションをビルドおよび実行するように設定された Maven ビルド記述子 pom.xml
   • src/main/java フォルダーの verticle の例

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>

   または、settings.xml ファイルでビルドアーティファクトを指定するように Maven リポジトリーを設定することもできます。詳細は、「Configuring the Apache Maven repository for your Eclipse Vert.x projects」セクションを参照してください。

6. Eclipse Vert.x プロジェクトをテンプレートとして使用し、独自のアプリケーションを作成します。

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

   mvn package

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

   mvn vertx:run