Apache Maven を使用した Quarkus アプリケーションの作成

手順

1. コマンドターミナルで以下のコマンドを入力し、Maven が JDK 11 を使用していること、そして Maven のバージョンが 3.6.2 以上であることを確認します。

   mvn --version

   Copy to Clipboard Toggle word wrap
2. 上記のコマンドで JDK 11 が返されない場合は、JDK 11 へのパスを PATH 環境変数に追加し、上記のコマンドを再度入力します。

3. Quarkus Maven プラグインを使用して新規プロジェクトを作成するには、以下のいずれかの方法を使用します。

   • 以下のコマンドを入力します。

     mvn io.quarkus:quarkus-maven-plugin:1.3.4.Final-redhat-00004:create \
         -DprojectGroupId=PROJECT_GROUP_ID \
         -DprojectArtifactId=PROJECT_ARTIFACT_ID \
         -DplatformGroupId=com.redhat.quarkus \
         -DplatformArtifactId=quarkus-universe-bom \
         -DplatformVersion=1.3.4.Final-redhat-00004 \
         -DclassName="CLASSNAME"

     Copy to Clipboard Toggle word wrap

     このコマンドで、以下の値を置き換えます。

     • PROJECT_GROUP_ID: プロジェクトの一意識別子。
     • PROJECT_ARTIFACT_ID: プロジェクトおよびプロジェクトディレクトリーの名前。
     • CLASSNAME: 生成されたリソースの完全修飾名 (例: org.acme.quarkus.sample.HelloResource)。

   • インタラクティブモードでプロジェクトを作成します。

     mvn io.quarkus:quarkus-maven-plugin:1.3.4.Final-redhat-00004:create

     Copy to Clipboard Toggle word wrap

     プロンプトが表示されたら、必要な属性値を入力します。

     注記

     以下のコマンドを入力し、プロジェクト属性のデフォルト値を使用してプロジェクトを作成することもできます。

     mvn io.quarkus:quarkus-maven-plugin:1.3.4.Final-redhat-00004:create -B

     以下の表は、create コマンドで定義できる属性を一覧表示しています。

     Expand

     属性	デフォルト値	説明
     projectGroupId	org.acme.sample	プロジェクトの一意識別子。
     projectArtifactId	なし	プロジェクトおよびプロジェクトディレクトリーの名前。projectArtifactId を指定しないと、Maven プラグインはインタラクティブモードを起動します。ディレクトリーがすでに存在する場合、生成は失敗します。
     projectVersion	1.0-SNAPSHOT	プロジェクトのバージョン。
     platformGroupId	io.quarkus	プラットフォームのグループ ID。既存のプラットフォームのデフォルト値はすべて、io.quarkus です。ただし、デフォルト値は変更することができます。
     platformArtifactId	quarkus-universe-bom	プラットフォーム BOM のアーティファクト ID。ローカルにビルドされた Quarkus を使用するには、quarkus-universe-bom を pom.xml ファイルに追加します。
     platformVersion	プラットフォームの最新バージョン	プロジェクトに使用するプラットフォームのバージョン。バージョン範囲を指定でき、Maven プラグインは最新バージョンを使用します。
     className	なし	生成されたリソースの完全修飾名。アプリケーションの作成後、REST エンドポイントは以下の URL で公開されます。 http://localhost:8080/$path デフォルトの path を使用する場合、URL は http://localhost:8080/hello になります。
     path	/hello	リソースパス (className を設定した場合のみ)。
     extensions	[]	プロジェクトに追加するエクステンションのコンマ区切りリスト。

     Show more

手順

1. テキストエディターで pom.xml ファイルを開きます。

2. Quarkus GAV (Group、Artifact、Version) を追加し、quarkus-universe-bom ファイルを使用して、Quarkus の異なる依存関係のバージョンを省略します。

   <dependencyManagement>
       <dependencies>
         <dependency>
           <groupId>${quarkus.platform.group-id}</groupId>
           <artifactId>${quarkus.platform.artifact-id}</artifactId>
           <version>${quarkus-plugin.version}</version>
           <type>pom</type>
           <scope>import</scope>
         </dependency>
       </dependencies>
     </dependencyManagement>

   Copy to Clipboard Toggle word wrap

3. Quarkus Maven プラグインを追加します。

   <build>
       <plugins>
           <plugin>
               <groupId>io.quarkus</groupId>
               <artifactId>quarkus-maven-plugin</artifactId>
               <version>${quarkus-plugin.version}</version>
               <executions>
                   <execution>
                       <goals>
                           <goal>build</goal>
                       </goals>
                   </execution>
               </executions>
           </plugin>
       </plugins>
   </build>

   Copy to Clipboard Toggle word wrap

手順

1. Quarkus プロジェクトディレクトリーに移動します。

2. 利用可能なエクステンションを一覧表示するには、以下のコマンドを入力します。

   ./mvnw quarkus:list-extensions

   Copy to Clipboard Toggle word wrap

3. プロジェクトにエクステンションを追加するには、以下のコマンドを入力します。ここで、EXTENSION は、追加するエクステンションの Group、Artifact、Version (GAV) に置き換えます。

   ./mvnw quarkus:add-extension -Dextensions="EXTENSION"

   Copy to Clipboard Toggle word wrap

   たとえば、Agroal エクステンションを追加するには、以下のコマンドを入力します。

   ./mvnw quarkus:add-extension -Dextensions="io.quarkus:quarkus-agroal"

   Copy to Clipboard Toggle word wrap

4. 特定のエクステンションを検索するには、-Dextensions= の後にエクステンション名または名前の一部を入力します。以下の例では、名前に jdbc、agroal、および non-exist-ent のテキストが含まれるエクステンションを検索します。

   ./mvnw quarkus:add-extension -Dextensions=jdbc,agroal,non-exist-ent

   Copy to Clipboard Toggle word wrap

   このコマンドは、以下の結果を返します。

   ❌ Multiple extensions matching 'jdbc'
       * io.quarkus:quarkus-jdbc-h2
       * io.quarkus:quarkus-jdbc-mariadb
       * io.quarkus:quarkus-jdbc-postgresql
       Be more specific e.g using the exact name or the full gav.
   ✅ Adding extension io.quarkus:quarkus-agroal
   ❌ Cannot find a dependency matching 'non-exist-ent', maybe a typo?
   [...]

   Copy to Clipboard Toggle word wrap

5. 特定のテキスト文字列が返すすべてのエクステンションをインストールするには、-Dextensions= の後にエクステンション名または名前の一部を入力します。以下の例では、hibernate- で始まるすべてのエクステンションを検索し、インストールします。

   ./mvnw quarkus:add-extension -Dextensions="hibernate-*"

   Copy to Clipboard Toggle word wrap

CodeReady Studio または Eclipse

1. CodeReady Studio または Eclipse で、File → Import とクリックします。
2. Maven → Existing Maven Project と選択します。
3. 次の画面で、プロジェクトのルートロケーションを選択します。見つかったモジュールの一覧が表示されます。
4. 生成されたプロジェクトを選択し、Finish をクリックします。

5. アプリケーションを起動するには、新しいターミナルウィンドウに以下のコマンドを入力します。

   ./mvnw compile quarkus:dev

   Copy to Clipboard Toggle word wrap

IntelliJ

1. IntelliJ で、以下のタスクのいずれかを実行します。

   • File → New → Project From Existing Sources と選択します。
   • Welcome ページで Import project を選択します。
2. プロジェクトの root ディレクトリーを選択します。
3. Import project from external model を選択してから、Maven を選択します。
4. オプションを確認して Next をクリックします。
5. Finish をクリックします。

6. アプリケーションを起動するには、新しいターミナルウィンドウに以下のコマンドを入力します。

   ./mvnw compile quarkus:dev

   Copy to Clipboard Toggle word wrap

Apache NetBeans

1. File → Open Project と選択します。
2. プロジェクトの root ディレクトリーを選択します。
3. Open Project クリックします。

4. アプリケーションを起動するには、新しいターミナルウィンドウに以下のコマンドを入力します。

   ./mvnw compile quarkus:dev

   Copy to Clipboard Toggle word wrap

Visual Studio Code

1. Java Extension Pack をインストールします。
2. Visual Studio Code でプロジェクトディレクトリーを開きます。プロジェクトは Maven プロジェクトとしてロードされます。

手順

1. テキストエディターで application.properties ファイルを開きます。

2. 変更するプロパティーの値を編集し、ファイルを保存します。

   以下の表は、変更可能なプロパティーをまとめたものです。

   Expand

   プロパティー	説明	タイプ	デフォルト
   quarkus.package.main-class	アプリケーションのエントリーポイント。ほとんどの場合、この値は変更する必要があります。	string	io.quarkus.runner.GeneratedMain
   quarkus.package.type	要求された出力タイプ。	string	jar
   quarkus.package.uber-jar	Java ランナーを uber-JAR としてパックすべきかどうか。	boolean	false
   quarkus.package.manifest.add-implementation-entries	実装情報をランナー JAR ファイルの MANIFEST.MF ファイルに含めるかどうか。	boolean	true
   quarkus.package.user-configured-ignored-entries	出力アーティファクトにコピーしてはならないファイル。	string (list)
   quarkus.package.runner-suffix	ランナー JAR ファイルに適用される接尾辞。	string	-runner
   quarkus.package.output-directory	アプリケーションビルドの出力フォルダー。これは、ビルドシステムのターゲットディレクトリーと相対的に解決されます。	string
   quarkus.package.output-name	最終的なアーティファクトの名前。	string

   Show more

手順

1. プラグイン設定を pom.xml ファイルに追加します。

   <project>
       [...]
         <plugin>
             <groupId>io.quarkus</groupId>
             <artifactId>quarkus-bootstrap-maven-plugin</artifactId>
             <version>${quarkus-plugin.version}</version>
         </plugin>
       [...]
   </project>

   Copy to Clipboard Toggle word wrap

2. アプリケーションのビルド依存関係ツリーを一覧表示するには、以下のコマンドを入力します。

   ./mvnw quarkus-bootstrap:build-tree

   Copy to Clipboard Toggle word wrap

3. このコマンドの出力は、以下のようになります。

   [INFO] --- quarkus-bootstrap-maven-plugin:1.3:build-tree (default-cli) @ getting-started ---
   [INFO] org.acme:getting-started:jar:1.0-SNAPSHOT
   [INFO] └─ io.quarkus:quarkus-resteasy-deployment:jar:1.3 (compile)
   [INFO]    ├─ io.quarkus:quarkus-resteasy-server-common-deployment:jar:1.3 (compile)
   [INFO]    │  ├─ io.quarkus:quarkus-core-deployment:jar:1.3 (compile)
   [INFO]    │  │  ├─ commons-beanutils:commons-beanutils:jar:1.9.3 (compile)
   [INFO]    │  │  │  ├─ commons-logging:commons-logging:jar:1.2 (compile)
   [INFO]    │  │  │  └─ commons-collections:commons-collections:jar:3.2.2 (compile)
   ...

   Copy to Clipboard Toggle word wrap

手順

1. 開発モードで Quarkus を起動するには、Quarkus アプリケーションの pom.xml ファイルが含まれるディレクトリーで以下のコマンドを入力します。

   ./mvnw quarkus:dev

   Copy to Clipboard Toggle word wrap
2. アプリケーションに変更を加え、ファイルを保存します。

3. ブラウザーを更新して、ワークスペースのスキャンをトリガーします。

   変更が検出されると、Java ファイルが再コンパイルされ、アプリケーションが再デプロイされます。その後、要求は再デプロイされたアプリケーションによって処理されます。コンパイルまたはデプロイメントに問題がある場合には、エラーページが表示されます。

   開発モードでは、デバッガーがアクティベートされ、ポート 5005 をリッスンします。

4. 任意手順: アプリケーションの実行前にデバッガーが割り当てられるのを待つには、-Dsuspend を追加します。

   ./mvnw quarkus:dev -Dsuspend

   Copy to Clipboard Toggle word wrap

5. 任意手順: デバッガーが実行されないようにするには、-Ddebug=false を追加します。

   ./mvnw quarkus:dev -Ddebug=false

   Copy to Clipboard Toggle word wrap

システムプロパティーを使用したデバッガーの制御

1. 以下の debug システムプロパティーの値の 1 つを変更します。ここで、PORT はデバッガーがリッスンするポートです。

   • false: JVM はデバッグモードを無効にして開始します。
   • true: JVM はデバッグモードで開始され、ポート 5005 でリッスンしています。
   • client: JVM はクライアントモードで起動され、localhost:5005 への接続を試みます。
   • PORT: JVM はデバッグモードで開始され、PORT をリッスンしています。

2. suspend システムプロパティーの値を変更します。このプロパティーは、Quarkus がデバッグモードで開始する際に使用されます。

   • y または true: デバッグモードの JVM の起動が一時停止します。
   • n または false: デバッグモードの JVM は一時停止せずに起動します。

コマンドラインからのデバッガーの制御

1. JVM を使用してデバッグモードで Quarkus アプリケーションを起動するには、以下のコマンドを入力します。

   ./mvnw compile quarkus:dev -Ddebug

   Copy to Clipboard Toggle word wrap
2. localhost:5005 にデバッガーを割り当てます。