MicronautとGradleの基本！プロジェクト生成・ビルド・実行の流れを解説

1. Micronautプロジェクトの生成

1. Micronautプロジェクトの生成

Micronautで開発を始める最初のステップが、プロジェクトの生成です。 ここではMicronaut CLIを使って、GradleベースのJavaプロジェクトを作成します。 コマンド操作に慣れていない初心者でも、決まった形式のコマンドを実行するだけで、 実務で使える雛形が自動的に用意されるため安心です。

ターミナルを開き、プロジェクトを作成したいフォルダに移動したら、 次のコマンドを入力して実行します。 この操作によって、MicronautとGradleの設定があらかじめ組み込まれた状態のプロジェクトが生成されます。

mn create-app demo-app --build=gradle --lang=java

このコマンドでは、demo-app がプロジェクト名になります。 --build=gradle はビルドツールとしてGradleを使う指定、 --lang=java は開発言語としてJavaを使う指定です。 実行が完了すると、demo-app というフォルダが作成され、 その中にGradle設定ファイルやMicronaut用の初期コードが自動で配置されます。

生成されたフォルダの中には、build.gradle や src/main/java といった基本的な構成が含まれており、 すぐにビルドや実行ができる状態になっています。 プログラミング未経験者でも、 「まずはプロジェクトを作って動かしてみる」という体験をスムーズに始められる点が、 Micronaut CLIとGradleを組み合わせる大きなメリットです。

2. Gradleビルドの基本

2. Gradleビルドの基本

生成されたMicronautプロジェクトには build.gradle（設定ファイル）が含まれており、 ここに「どのライブラリを使うか」「どうやってビルドするか」といったルールがまとめられています。 ビルドとは、ざっくり言うと「ソースコードを実行できる形にまとめる作業」です。 まだ仕組みがピンとこなくても大丈夫で、まずはGradleのコマンドを一度動かして流れをつかむのが近道です。

プロジェクトのルート（build.gradle がある場所）で、次のコマンドを実行します。 ./gradlew はGradleを動かすための専用スクリプトで、PCにGradleを別途インストールしていなくても動かせるのが便利なポイントです。

./gradlew build

実行すると、必要なライブラリのダウンロード（依存関係の解決）が行われ、 その後にコンパイルとテストが順番に実行されます。 初回はダウンロードが入るため少し時間がかかりますが、2回目以降は早くなることが多いです。 途中でエラーが出た場合も、原因はログに表示されるので、まずは慌てずに表示内容を確認しましょう。

ビルド後に「成果物（できあがったもの）」が置かれる場所も、最低限だけ押さえておくと安心です。

build/
└── libs/   （Jarファイルなどの成果物が入る）

このように、Gradleビルドを一度通しておくことで、 「依存関係をそろえる → コンパイルする → テストする → 成果物を作る」という基本の流れが体験できます。 MicronautとGradleの組み合わせなら、複雑な設定を自分で用意しなくてもここまで自動で進むため、 プログラミング未経験者でも開発の土台を作りやすいのが特徴です。

3. アプリケーションの実行

3. アプリケーションの実行

ビルドが無事に終わったら、いよいよMicronautアプリケーションを起動します。 ここでやることはシンプルで、Gradleの run タスクを実行するだけです。 「起動」と聞くと難しそうですが、Micronautの場合は開発用サーバーを立ち上げて、ブラウザから動作確認できる状態にする作業だと思うと分かりやすいです。

プロジェクトのルート（build.gradle がある場所）で、次のコマンドを実行します。 Windowsの場合は ./gradlew が動かないことがあるので、そのときは gradlew.bat run を使うとスムーズです。

./gradlew run

起動に成功すると、ターミナルにログが流れ続ける状態になります。 これはエラーではなく「アプリが動き続けている」サインです。 ブラウザで http://localhost:8080/ にアクセスできれば、ローカル環境でMicronautのHTTPサーバーが起動していることを確認できます。 もし別のアプリが同じポートを使っていて起動できない場合は、ログに原因が表示されるので、まずはその行を探してみましょう。

起動したアプリを停止したいときは、ターミナルで次の操作を行います。

Ctrl + C

この停止方法を覚えておくと、コードを直して何度も「起動→確認→停止」を繰り返すときに迷いません。 ここまでできれば、MicronautをGradleで実行する基本操作はひと通り押さえられています。

4. 簡単なサンプルコントローラの作成

4. 簡単なサンプルコントローラの作成

アプリケーションが正常に起動したら、次は「自分で作ったページ（API）が表示できるか」を確認してみましょう。 Micronautでは、URLにアクセスされたときの処理を コントローラ というクラスで用意します。 ここではまず、ブラウザでアクセスすると短いメッセージを返すだけの、とても簡単な例を作ります。 「動いた！」を体験できると、次の学習がぐっと進めやすくなります。

例として、src/main/java 配下に GreetController を作成し、次のコードを配置します。 すでに生成されている Application クラスは基本そのままでOKなので、未経験者の方は「コントローラ部分が追加された」くらいの理解で大丈夫です。

import io.micronaut.runtime.Micronaut;
import io.micronaut.http.annotation.*;

@Controller("/greet")
class GreetController {

    @Get("/")
    public String index() {
        return "Hello, Micronaut with Gradle!";
    }
}

public class Application {
    public static void main(String[] args) {
        Micronaut.run(Application.class);
    }
}

コードの読み方も、ポイントだけ押さえればOKです。 @Controller("/greet") は「/greet という入口を作る」合図で、 @Get("/") は「ブラウザでGETアクセスされたときに動く処理」を意味します。 つまり http://localhost:8080/greet にアクセスすると、index() が呼ばれて文字列が返る、という流れになります。

起動中の状態でブラウザを開き、http://localhost:8080/greet にアクセスしてください。 画面に「Hello, Micronaut with Gradle!」と表示されれば成功です。 もし表示されない場合は、URLの打ち間違い（/greet の有無）や、アプリが起動したままになっているかを確認すると解決しやすいです。

5. 開発を効率化するポイント

5. 開発を効率化するポイント

Gradleのタスクを使いこなすことで、ビルドや実行の効率が上がります。また、IDEでGradleタスクを実行できるように設定すると、コマンドを覚えなくてもクリックだけでビルドや実行が可能です。Micronaut CLIとGradleを組み合わせることで、初心者でもスムーズにプロジェクトを作成し、テストや実行まで行える環境が整います。

まとめ

まとめ

MicronautとGradleで学んだ開発の基本的な流れ

この記事では、MicronautとGradleを組み合わせた基本的な開発の流れについて、プロジェクト生成からビルド、実行、そして簡単なコントローラ作成までを一通り確認しました。Micronautは高速起動と省メモリを特徴とするJavaフレームワークであり、クラウドネイティブなアプリケーション開発に適しています。一方、Gradleはビルドツールとして依存関係管理やタスク実行を担い、Micronautプロジェクトの作成や実行を支える重要な役割を果たします。

Micronaut CLIを利用することで、Gradle設定済みのプロジェクトを簡単に生成できる点は、初心者にとって大きなメリットです。プロジェクト構成や設定ファイルを一から用意する必要がなく、すぐにアプリケーション開発へ進めます。生成されたbuild.gradleには、Micronautの実行に必要なプラグインや依存関係があらかじめ定義されており、Gradleコマンドを実行するだけでビルドやテストが完了します。

ビルド工程では、Gradleがライブラリのダウンロード、コンパイル、テスト実行を自動で処理します。これにより、JavaやMicronautの初心者でも環境構築でつまずきにくくなります。また、runタスクを使ったアプリケーション起動は非常にシンプルで、ローカル環境ですぐにHTTPサーバーを立ち上げて動作確認が可能です。Micronautの軽量さとGradleの自動化が組み合わさることで、開発体験がスムーズになります。

サンプルプログラムで理解するポイント

サンプルとして作成したコントローラでは、@Controllerや@GetといったMicronautのアノテーションを使用しました。これらのアノテーションを付与することで、HTTPリクエストとJavaメソッドを簡単に紐づけることができます。Gradleでビルドしたアプリケーションを起動し、ブラウザからURLへアクセスするだけで、レスポンスが返ってくる流れを確認できました。

@Controller("/sample")
class SampleController {

    @Get("/")
    public String message() {
        return "MicronautとGradleの基本を学びました";
    }
}

    

このようなシンプルなクラス構成でも、MicronautのDIやHTTP機能が自動的に有効になります。Gradleで管理されたプロジェクト構造の中でコードを書くことで、設定よりも実装に集中できる点が特徴です。今後、サービスクラスや設定ファイルを追加していく場合でも、基本の流れは今回学んだ内容と変わりません。

Gradleを使い続けるメリット

Gradleはタスク指向のビルドツールであり、buildやrun以外にもtestやcleanなど多くの便利なタスクを提供します。Micronautプロジェクトでは、これらのタスクを活用することで開発効率を高められます。また、IDEと連携することで、コマンドを入力せずにビルドや実行を行えるため、開発のハードルがさらに下がります。

MicronautとGradleの組み合わせは、JavaによるWebアプリケーション開発を学び始めた人にとって、非常に理解しやすい構成です。プロジェクト生成、ビルド、実行という一連の流れを繰り返すことで、自然と開発の基本が身につきます。今回の内容を土台として、REST API開発や設定管理、テストの追加などに挑戦していくとよいでしょう。