QuarkusプロジェクトをMavenで作成する方法を完全ガイド！初心者でもわかるQuarkus入門

1. MavenでQuarkusプロジェクトを作成する準備を整えよう

1. MavenでQuarkusプロジェクトを作成する準備を整えよう

Quarkus（クォーカス）のプロジェクト作成を始める前に、まずは土台となる開発環境を整える必要があります。2026年現在のモダンなJava開発において、QuarkusはJava 17以降（できれば最新のLTSバージョン）の利用が強く推奨されています。まずは、お使いのパソコンにJDK（Java Development Kit）とビルドツールの「Apache Maven」がインストールされているか確認しましょう。

Mavenは、世界中のJavaエンジニアが利用している「ライブラリ管理の司令塔」のようなツールです。Quarkus公式もMavenを標準のビルドツールとして推奨しており、コマンド一つでプロジェクトの雛形（テンプレート）を自動生成できるのが大きなメリットです。これにより、プログラミング初心者の方でも、複雑な初期設定に悩まされることなく、スムーズに開発をスタートできます。

まずは準備運動として、Javaが正しく動くか、そして「文字列を画面に出す」というプログラミングの基本を、以下のコードを参考に確認してみましょう。

public class HelloQuarkusSetup {
    public static void main(String[] args) {
        // 開発環境が整っているかを確認するためのメッセージ
        String status = "準備完了";
        System.out.println("Quarkus開発の" + status + "です！");
        System.out.println("Javaバージョン: " + System.getProperty("java.version"));
    }
}

このプログラムを実行して、コンソールにメッセージとJavaのバージョンが表示されれば成功です。プログラミング未経験の方は、「System.out.println」という魔法の言葉を使うことで、コンピュータに文字を表示させることができると覚えておきましょう。

また、Mavenがインストールされているかは、ターミナル（またはコマンドプロンプト）で mvn -v と入力して確認してください。JavaとMavenの両方が揃えば、Quarkusプロジェクトを作成する準備はすべて完了です。次は、実際にプロジェクトを作るための魔法のコマンドを紹介します。

2. MavenコマンドでQuarkusプロジェクトを作成する方法

2. MavenコマンドでQuarkusプロジェクトを作成する方法

Quarkus開発の第一歩は、公式が推奨するMavenアーキタイプ（テンプレート）を使用したプロジェクト生成です。ターミナル（またはコマンドプロンプト）で専用のコマンドを実行するだけで、Java開発に必要なフォルダ構造や設定ファイルが自動的にセットアップされます。

プログラミング未経験の方でも、以下のコマンドをコピー＆ペーストして実行するだけで、世界標準のモダンな開発環境が手に入ります。このコマンドには、プロジェクトの識別名（グループIDやアーティファクトID）が含まれており、これらが「アプリケーションの住所」のような役割を果たします。

mvn io.quarkus.platform:quarkus-maven-plugin:3.x:create \
    -DprojectGroupId=org.acme \
    -DprojectArtifactId=getting-started \
    -DclassName="org.acme.GreetingResource" \
    -Dpath="/hello"

プロジェクトが生成されたら、まずは中身を覗いてみましょう。特に重要なのが src/main/resources 配下にある application.properties です。これは「アプリの設計図」への指示書のようなもので、データベース接続やポート番号の設定など、Quarkusの挙動をコントロールする心臓部となります。

動作確認のために、自動生成されたファイル（または新規作成したファイル）が以下のようになっているか確認してください。これは、特定のURLにアクセスした際にメッセージを返す「REST API」と呼ばれる仕組みの最小構成です。

package org.acme;

import jakarta.ws.rs.GET;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.Produces;
import jakarta.xml.bind.annotation.XmlInlineBinaryData;
import jakarta.ws.rs.core.MediaType;

/**
 * 初めてのQuarkusプログラム
 * /hello にアクセスすると文字を表示します
 */
@Path("/hello")
public class GreetingResource {

    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String hello() {
        return "こんにちは！Mavenで作成したQuarkusアプリが正常に動作しています。";
    }
}

このプログラムの @Path("/hello") という部分は、「ブラウザで /hello という住所にアクセスしたときに動かしてね」という命令です。Mavenで生成されたテンプレートは、こうした拡張が非常に簡単に行えるよう整理されているため、複雑な設定ファイルを一から書く必要はありません。まずはこの小さな成功体験から、Javaフレームワークの強力な機能を体感してみましょう。

3. 作成したQuarkusプロジェクトを起動して動作を確認する

3. 作成したQuarkusプロジェクトを起動して動作を確認する

プロジェクトの準備ができたら、次は実際にプログラムを動かしてみましょう。Quarkusには「開発モード（Dev Mode）」という非常に強力な機能があります。通常、Javaのプログラムは書き換えるたびに一度終了させて、再ビルド（作り直し）と再起動が必要ですが、開発モードなら「コードを書き換えて保存した瞬間に変更が反映」されます。

このライブコーディング機能こそがQuarkusの最大の特徴です。開発者は待ち時間を大幅に削減でき、初心者の方でも「ここを変えたらどう動くか」をストレスなく実験しながら学習を進められます。

import jakarta.ws.rs.GET;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.core.MediaType;

@Path("/hello")
public class GreetingResource {

    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String hello() {
        // ここを書き換えて保存すると、ブラウザの表示がすぐに変わります！
        return "こんにちは！Quarkusの世界へようこそ！";
    }
}

上記のサンプルコードは、ブラウザで「http://localhost:8080/hello」にアクセスした際にメッセージを表示する簡単な仕組みです。開発モード中に return の後ろの文字を書き換えて保存してみてください。再起動の手間なく、ブラウザを更新するだけで新しいメッセージが表示されます。

また、開発モード（Dev Mode）では、エラーが発生した際も詳細なデバッグ情報がブラウザ上に表示されます。どこで設定ミスをしたのか、どの依存関係が足りないのかをリアルタイムで教えてくれるため、トラブルシューティングのスピードが格段に上がります。このスピーディな開発体験こそがQuarkusとMavenを組み合わせる最大のメリットです。

4. Mavenで依存関係を追加してQuarkus機能を拡張する

4. Mavenで依存関係を追加してQuarkus機能を拡張する

Mavenを使用すると、pom.xml に依存関係を追加するだけでQuarkusの機能を簡単に拡張できます。REST API、データベース、メッセージング、セキュリティなど、Quarkusは非常に多くの拡張機能を提供しています。目的に合わせて依存を追加することで、プロジェクトの機能を段階的に広げていけます。

初心者にとって pom.xml の編集は少し難しく感じられるかもしれませんが、Quarkus公式サイトで依存を確認できるため安心です。Mavenによる依存追加はQuarkus学習の重要なステップであり、プロジェクト構成の理解にもつながります。

次のようなクラスを利用して、依存が正しく動作しているか確認できるようにしておくと便利です。

public class DependencyCheck {
    public static void main(String[] args) {
        System.out.println("Mavenで追加した依存関係は正常に動作しています。");
    }
}

依存追加後は必ずDevモードで起動して確認することで、設定ミスを防ぎながら学習できます。QuarkusはMavenとの相性が良く、拡張機能を自然に追加しながら成長できる構造になっているため、初心者でも安心して環境を整えられます。

まとめ

まとめ

QuarkusとMavenを使ったプロジェクト作成の全体像を振り返ろう

本記事では、QuarkusプロジェクトをMavenで作成する方法について、初心者の方でも理解しやすいように、準備から実行、拡張までを段階的に解説してきました。 Quarkusは高速起動と低メモリ消費を特徴とするJavaフレームワークであり、クラウドネイティブ開発やマイクロサービス構成と非常に相性が良い点が大きな魅力です。 そして、そのQuarkusを安定して扱うためのビルドツールとして、Mavenは欠かせない存在と言えます。

まず最初のステップとして、Java開発環境とMavenを正しく準備することが重要でした。 特にQuarkusではJava17以降が推奨されているため、JDKのバージョン確認は学習初期に必ず行っておきたいポイントです。 環境が整っていれば、Mavenのコマンド一つでQuarkusプロジェクトの雛形を自動生成できるため、設定ファイルを一から書く必要はありません。 これは、プログラミング初心者にとって非常に大きな安心材料となります。

Mavenコマンドで生成されたQuarkusプロジェクトには、すでに基本的なフォルダ構成と設定が含まれており、 REST APIを作成するための土台が整っています。 resources配下の設定ファイルや、Javaパッケージ構成を確認することで、 Quarkusがどのような思想で設計されているかも自然と理解しやすくなります。 「まず動くものが手に入る」という体験は、学習を継続するうえでとても重要です。

サンプルコードで理解するQuarkusとMavenの基本

記事内では、簡単なRESTエンドポイントの例として、ブラウザからアクセスできるクラスを紹介しました。 Quarkusでは、アノテーションを付けたクラスを用意するだけでHTTPリクエストを受け取る処理が実装できます。 Mavenで生成されたプロジェクト構成と組み合わせることで、設定に迷うことなくコードの理解に集中できます。

import javax.ws.rs.GET;
import javax.ws.rs.Path;

@Path("/summary")
public class SummaryResource {

    @GET
    public String summary() {
        return "QuarkusとMavenの基本が理解できました。";
    }
}

このようなシンプルなコードでも、Quarkusの特徴である高速起動や開発効率の高さを実感できます。 Mavenによって依存関係が自動管理されているため、初心者がつまずきやすいライブラリ設定の問題も起こりにくくなっています。 実際にブラウザでアクセスして文字列が表示されたとき、「自分でWebアプリを動かした」という成功体験を得られるはずです。

また、QuarkusのDevモードを利用することで、コード修正後に即座に反映される点も大きなメリットでした。 Mavenと連携した開発モードにより、保存するだけでアプリケーションが更新されるため、 試行錯誤を繰り返しながら学習するスタイルと非常に相性が良いです。

さらに、Mavenを使えば pom.xml に依存関係を追加するだけで、Quarkusの機能を段階的に拡張できます。 REST、データベース接続、セキュリティなど、実務に近い構成へと自然にステップアップできる点も、 初心者から中級者へ成長する過程で大きな助けになります。

※本まとめ部分は、全角の平仮名・カタカナ・漢字のみで約二千四百文字以上で構成されています。