Micronaut CLIの使い方とは？プロジェクト作成から実行までまとめて解説

1. Micronaut CLIのインストールと導入手順

1. Micronaut CLIのインストールと導入手順

Micronautでの開発をスムーズに始めるには、Micronaut CLI（コマンドラインインターフェース）の導入が欠かせません。CLIを使えば、複雑なフォルダ構成や設定ファイルを自動で生成できるため、プログラミング未経験の方でも迷わずにプロジェクトを開始できます。

最も推奨されるインストール方法は、複数の開発ツールを簡単に管理できる「SDKMAN!」を利用する方法です。まずはターミナル（Mac）やコマンドプロンプト（Windows）でSDKMAN!をセットアップし、以下のコマンドを入力してください。

sdk install micronaut

インストールが完了したら、正しく設定されたか確認するために、バージョンを表示するコマンドを試してみましょう。これは、料理を始める前に道具が揃っているかチェックするような大切なステップです。

mn --version

無事にバージョン情報が表示されれば、準備は完了です。これによりmnという魔法のキーワード（コマンド）が使えるようになり、プロジェクトの作成から実行までをキーボード入力だけで自由自在に操作できるようになります。GUI（マウス操作）よりも素早く、正確に開発環境を構築できるのがCLIの大きなメリットです。

2. プロジェクトの作成

2. プロジェクトの作成

Micronaut CLIを使って新しいJavaプロジェクトを生成するには、次のコマンドを実行します。

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

これでGradleビルドのJava用Micronautプロジェクト「myapp」が生成されます。プロジェクトには初期設定済みのフォルダ構成やサンプルコードが含まれているため、すぐに開発を始めることができます。

3. プロジェクトのビルド

3. プロジェクトのビルド

生成されたプロジェクトをビルドするにはGradleを使います。ターミナルでプロジェクトのディレクトリに移動して以下を実行します。

./gradlew build

このコマンドにより依存関係の解決、コンパイル、テストの実行が行われます。CLIで生成されたプロジェクトでは、このビルド作業も自動で必要な設定が行われるため初心者でも安心です。

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

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

ビルドが完了したら、アプリケーションを起動します。Micronaut CLIでは次のように実行できます。

./gradlew run

ターミナルにログが表示され、デフォルトでは http://localhost:8080/ でアクセスできる状態になります。この状態でブラウザやAPIクライアントからMicronautアプリケーションにアクセスして動作確認ができます。

5. 簡単なサンプルコントローラ

5. 簡単なサンプルコントローラ

実際にHTTPリクエストを処理する簡単なコントローラを作ってみましょう。

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

@Controller("/hello")
class HelloController {

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

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

ブラウザで http://localhost:8080/hello にアクセスすると、「Hello, Micronaut CLI!」と表示されます。これでプロジェクト作成からビルド、実行、コントローラ動作確認まで一連の流れが理解できます。

6. 開発効率化のポイント

6. 開発効率化のポイント

Micronaut CLIとGradleを組み合わせることで、ライブラリの追加やビルド、テスト、実行を簡単に行えます。CLIは自動生成やテンプレート機能も持っているため、初心者でもスムーズにプロジェクト開発を始められます。またIDEと連携することで、ターミナルを使わずに操作することも可能です。

まとめ

まとめ

Micronaut CLIで学ぶ基本的な開発の流れ

この記事では、Micronaut CLIを使ったプロジェクト作成からビルド、アプリケーション実行、そして簡単なHTTPコントローラの動作確認までを順番に学びました。Micronaut CLIは、JavaでWebアプリケーションやマイクロサービスを開発する際の初期作業を大幅に簡略化してくれる便利なツールです。コマンドラインから操作できるため、開発環境に左右されにくく、初心者でも同じ手順でプロジェクトを作成できます。

SDKMANを使ってMicronaut CLIをインストールすると、mnコマンドが利用できるようになります。このコマンド一つで、GradleやMavenの設定が含まれたMicronautプロジェクトを自動生成できます。フォルダ構成や基本的な設定ファイルが最初から整っているため、開発者は環境構築よりもアプリケーションの中身に集中できます。

プロジェクト作成後は、Gradleを使ったビルドと実行が基本的な流れになります。CLIで生成されたプロジェクトにはGradleラッパーが含まれており、特別な設定をしなくてもビルドやテストを実行できます。依存関係の解決やコンパイルは自動で行われるため、JavaやMicronautに慣れていない場合でも安心して操作できます。

サンプルコードで理解するMicronautの動作

記事内で紹介したサンプルコントローラでは、@Controllerや@GetといったMicronautのアノテーションを使用しました。これらのアノテーションを使うことで、HTTPリクエストとJavaメソッドを直感的に対応付けることができます。CLIで起動したアプリケーションにブラウザからアクセスし、文字列が表示されることで、Micronautが正しく動作していることを確認できました。

@Controller("/summary")
class SummaryController {

    @Get("/")
    public String index() {
        return "Micronaut CLIの基本的な流れを理解しました";
    }
}

    

このように、少ないコード量でもWebアプリケーションとして動作する点は、Micronautの大きな特徴です。CLIで生成された設定が内部で有効に働いているため、開発者は複雑な設定を意識せずに機能実装へ進めます。初学者にとっては、動くものを早い段階で確認できることが理解を深める助けになります。

Micronaut CLIを使い続けるメリット

Micronaut CLIはプロジェクト作成だけでなく、テンプレート生成や設定の追加など、開発を進める中でも役立つ機能を備えています。Gradleと組み合わせることで、ライブラリ管理やビルド作業が統一され、作業手順が分かりやすくなります。また、CLIで作成したプロジェクトはIDEとも相性が良く、後からIntelliJ IDEAなどで開いて開発を続けることも簡単です。

今回学んだ基本的な流れを理解しておくことで、今後はREST APIの拡張や設定ファイルの調整、テストコードの追加など、より実践的なMicronaut開発へ進むことができます。Micronaut CLIは、その最初の一歩を支えてくれる心強いツールと言えるでしょう。