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

生徒

「Micronautで依存性注入って聞くんですが、注入の方法がいくつもあって混乱します」

先生

「Micronautでは主にコンストラクタ注入、フィールド注入、メソッド注入の三つがあります。それぞれ役割と特徴が違います」

生徒

「どれを使えばいいんですか？」

先生

「基本はコンストラクタ注入です。他の方法は特徴を理解してから使うと迷わなくなります」

生徒

「違いを順番に教えてほしいです」

先生

「では、依存性注入の考え方から順に見ていきましょう」

1. Micronautにおける依存性注入の基本

依存性注入とは、クラスが必要とするオブジェクトを自分で生成せず、外部から受け取る仕組みです。 MicronautではDIコンテナがその役割を担い、Beanの生成と管理を自動で行います。これにより、クラス同士の結びつきが弱くなり、修正やテストがしやすくなります。

Javaでアプリケーションを作ると、処理が増えるほどクラス間の関係が複雑になります。依存性注入を使うことで、その複雑さを整理し、読みやすい設計を保つことができます。 MicronautはこのDIをコンパイル時に解析するため、高速で軽量に動作します。

2. コンストラクタ注入の特徴と使い方

コンストラクタ注入は、最も推奨されている依存性注入の方法です。必要な依存関係をコンストラクタの引数として受け取ります。この方法では、依存関係が明確になり、クラスの設計意図が分かりやすくなります。

Micronautでは、コンストラクタが一つしかない場合、@Injectを省略しても自動的に注入されます。初心者でも理解しやすく、テストコードも書きやすい点が大きな利点です。


import jakarta.inject.Singleton;

@Singleton
public class OrderService {
    public String process() {
        return "注文処理";
    }
}


import jakarta.inject.Singleton;

@Singleton
public class OrderController {

    private final OrderService orderService;

    public OrderController(OrderService orderService) {
        this.orderService = orderService;
    }

    public void execute() {
        System.out.println(orderService.process());
    }
}

この例では、OrderControllerがOrderServiceに依存しています。コンストラクタで受け取ることで、必ずOrderServiceが存在する状態で利用されます。依存関係が不足した状態で動作することを防げる点が特徴です。

3. フィールド注入の特徴と注意点

フィールド注入は、クラスのフィールドに直接@Injectを付ける方法です。記述量が少なく、コードが短くなるため、最初は便利に感じるかもしれません。しかし、依存関係が見えにくくなるという欠点があります。

フィールド注入では、どのタイミングで依存関係が設定されるのかが分かりづらくなります。そのため、大規模な開発では可読性や保守性が下がる原因になります。


import jakarta.inject.Inject;
import jakarta.inject.Singleton;

@Singleton
public class FieldController {

    @Inject
    OrderService orderService;

    public void execute() {
        System.out.println(orderService.process());
    }
}

この方法でも正しく動作しますが、依存関係がコードから直感的に読み取りにくくなります。学習段階では、仕組みを理解するために使う程度にとどめるのがおすすめです。

4. メソッド注入の特徴と利用場面

メソッド注入は、特定のメソッドに@Injectを付けて依存性を受け取る方法です。初期化処理の一部として依存関係を設定したい場合に使われることがあります。コンストラクタ注入ほど一般的ではありませんが、状況によっては有効です。

この方法では、依存関係が後から設定されるため、必須の依存には向いていません。一時的な設定や補助的な処理に使われることが多いです。


import jakarta.inject.Inject;
import jakarta.inject.Singleton;

@Singleton
public class MethodController {

    private OrderService orderService;

    @Inject
    public void setOrderService(OrderService orderService) {
        this.orderService = orderService;
    }

    public void execute() {
        System.out.println(orderService.process());
    }
}

この例では、setOrderServiceメソッドを通じて依存性が注入されます。処理の流れを理解していないと、どこで設定されたのか分かりにくくなる点に注意が必要です。