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

生徒

「MicronautのDIって便利そうですが、どう設計すれば保守しやすくなるのか分かりません」

先生

「MicronautのDIは設計次第で、コードの読みやすさや変更のしやすさが大きく変わります。基本を押さえることが大切です」

生徒

「DIの書き方は分かってきましたが、良い構成と言われると難しいです」

先生

「では、初心者でも実践しやすいDI設計の考え方を、Micronautの特徴と一緒に見ていきましょう」

1. MicronautにおけるDI設計の基本的な考え方

Micronautは、Java向けの軽量フレームワークとして設計されており、DIをコンパイル時に解決する点が大きな特徴です。この仕組みにより、起動が高速でメモリ消費も少なくなります。DI設計では、クラス同士の依存関係を直接結び付けず、役割ごとに分離することが重要です。

初心者のうちは、処理を一つのクラスにまとめてしまいがちですが、それでは変更に弱い構成になります。MicronautのDIを活用すると、サービス、リポジトリ、ユーティリティといった役割を明確に分けられ、保守性の高い構成を作りやすくなります。

2. @Singletonを使った基本的なBean設計

Micronautで最もよく使われるDIアノテーションが@Singletonです。これはアプリケーション全体で一つのインスタンスを共有するBeanを定義するために使います。業務ロジックを担うサービスクラスでは、@Singletonを付けるのが基本となります。

DI設計のベストプラクティスとして、状態を持たないクラスをSingletonとして定義することが挙げられます。状態を持たないことで、予期しない副作用を防ぎやすくなり、テストや変更も容易になります。


import jakarta.inject.Singleton;

@Singleton
public class UserService {

    public String getUserName() {
        return "Micronaut User";
    }
}

3. コンストラクタインジェクションを使う理由

Micronautでは、フィールドインジェクションよりもコンストラクタインジェクションが推奨されています。コンストラクタインジェクションを使うことで、依存関係が明確になり、どのクラスが何に依存しているか一目で分かるようになります。

また、依存関係が不足している場合はコンパイル時にエラーとして検出されやすく、実行時のトラブルを防げます。保守しやすいDI設計では、この点が非常に重要です。


import jakarta.inject.Singleton;

@Singleton
public class UserController {

    private final UserService userService;

    public UserController(UserService userService) {
        this.userService = userService;
    }

    public String showUser() {
        return userService.getUserName();
    }
}

4. インターフェースを使った疎結合な設計

保守しやすいMicronautのDI設計では、クラス同士を直接結び付けるのではなく、インターフェースを介して依存させる方法が効果的です。これにより、実装の差し替えが簡単になり、将来的な仕様変更にも柔軟に対応できます。

例えば、データ取得処理をインターフェースとして定義し、その実装をBeanとして登録することで、テスト用実装や別の実装に切り替えやすくなります。


public interface MessageRepository {
    String findMessage();
}


import jakarta.inject.Singleton;

@Singleton
public class MessageRepositoryImpl implements MessageRepository {

    @Override
    public String findMessage() {
        return "Hello Micronaut";
    }
}