先生と生徒の会話形式で理解しよう

生徒

「Micronautでプロジェクトを作ったら、たくさんファイルが出てきて混乱しました…」

先生

「Micronautは高速起動や軽量さが特徴ですが、最初はプロジェクト構成が分かりにくいですよね。」

生徒

「どのファイルを編集すればいいのか、初心者向けに教えてほしいです」

先生

「では、Micronaut プロジェクト構成をファイル一覧ごとに、役割と編集ポイントを丁寧に見ていきましょう。」

1. Micronaut プロジェクト構成とは何か

Micronaut プロジェクト構成とは、Micronaut フレームワークでアプリケーションを作成した際に自動生成されるディレクトリやファイルの配置ルールを指します。Java マイクロサービス開発に最適化されており、起動速度の速さやメモリ効率の良さを支える重要な設計です。初心者のうちは、どのファイルが設定用で、どれがビジネスロジックなのかを理解することが大切です。

2. src/main/java 配下の基本ファイル

src/main/java は、Micronaut アプリケーションの中核となる Java ソースコードを置く場所です。コントローラ、サービス、リポジトリなど、実際の処理を書くファイルはここに集約されます。Micronaut 初心者は、まずこのディレクトリを重点的に確認すると理解が進みます。


package example.micronaut;

import io.micronaut.runtime.Micronaut;

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

この Application クラスは Micronaut アプリケーションの起点です。通常は編集せず、そのまま利用することが多いです。

3. コントローラファイルの役割

Micronaut のコントローラは、HTTP リクエストを受け取る入口です。REST API 開発では必須の要素で、URL と処理内容を結び付けます。初心者が最初に触る編集ポイントとして最も分かりやすい部分です。


package example.micronaut.controller;

import io.micronaut.http.annotation.Controller;
import io.micronaut.http.annotation.Get;

@Controller("/hello")
public class HelloController {

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

Controller アノテーションと Get アノテーションを使うことで、Micronaut のルーティングが実現されます。

4. サービスクラスの考え方

サービスクラスは、ビジネスロジックをまとめるためのクラスです。Micronaut プロジェクト構成では、処理をコントローラに直接書かず、サービスに分離することで保守性を高めます。Java 開発初心者にもおすすめの設計方法です。


package example.micronaut.service;

import jakarta.inject.Singleton;

@Singleton
public class GreetingService {

    public String greet(String name) {
        return "こんにちは、" + name;
    }
}

Singleton アノテーションにより、Micronaut の DI 機能が利用できます。

5. src/main/resources の設定ファイル

src/main/resources には、Micronaut の設定ファイルや静的リソースを配置します。特に application.yml は最重要ファイルで、サーバポートやデータベース設定などを管理します。Micronaut 設定初心者は必ず確認しましょう。


server:
  port: 8080
micronaut:
  application:
    name: sample-app

6. テスト用ディレクトリの役割

src/test/java はテストコード専用のディレクトリです。Micronaut では軽量なテスト実行が可能で、JUnit と組み合わせて動作確認ができます。初心者でも早い段階からテストを書く習慣をつけると、品質の高い Java アプリケーションが作れます。


package example.micronaut;

import io.micronaut.test.extensions.junit5.annotation.MicronautTest;
import org.junit.jupiter.api.Test;

@MicronautTest
class ApplicationTest {

    @Test
    void testItWorks() {
        assert true;
    }
}