1. QuarkusにおけるDIとCDIの基本的な考え方

Quarkusでは、DIと呼ばれる仕組みを使って、クラス同士のつながりを自動で管理します。DIは依存性注入という意味で、プログラムの部品を必要な場所へ自動的に渡してくれる考え方です。Quarkusでは、このDIをCDIという標準仕様に基づいて実装しています。

初心者の方は、CDIを「部品を保管してくれる倉庫のような存在」と考えると理解しやすいです。必要な部品を自分で作らなくても、Quarkusが代わりに準備してくれます。

2. CDIで管理されるBeanとは何か

CDIでは、管理されるオブジェクトをBeanと呼びます。Beanはアプリケーションの中で使い回される部品で、Quarkusが生成や破棄のタイミングを管理します。Beanとして扱われることで、コードが整理され、変更にも強くなります。

例えば、設定情報を扱うクラスや、共通処理を行うクラスなどがBeanとしてよく使われます。

3. プロデューサーメソッドの役割とメリット

プロデューサーメソッドは、Beanを生成するための特別なメソッドです。@Producesを付けることで、「このメソッドの戻り値をBeanとして使ってください」とQuarkusに伝えられます。

通常のクラス生成では対応しにくい場合や、条件によって内容を変えたい場合に、プロデューサーメソッドは非常に便利です。設定値を使った初期化や、外部ライブラリのオブジェクト生成によく使われます。

4. @Producesを使った基本的なサンプル

まずは、最もシンプルな@Producesの例を見てみましょう。文字列をBeanとして提供する例です。


import jakarta.enterprise.context.ApplicationScoped;
import jakarta.enterprise.inject.Produces;

@ApplicationScoped
public class MessageProducer {

    @Produces
    public String createMessage() {
        return "Hello Quarkus CDI";
    }
}

このコードでは、createMessageメソッドの戻り値がBeanとして登録されます。他のクラスでは、この文字列を自動的に受け取れます。

5. @Injectと組み合わせた利用方法

@Producesで作られたBeanは、@Injectを使って簡単に利用できます。以下は、先ほどの文字列を注入して使う例です。


import jakarta.inject.Inject;
import jakarta.ws.rs.GET;
import jakarta.ws.rs.Path;

@Path("/hello")
public class HelloResource {

    @Inject
    String message;

    @GET
    public String hello() {
        return message;
    }
}

自分でnewを書かなくても、Quarkusが自動でmessageを準備してくれる点がDIの大きな特徴です。

6. 設定値を使ったプロデューサーメソッド

プロデューサーメソッドは、設定ファイルの値と組み合わせることでさらに便利になります。以下は、数値を生成する簡単な例です。


import jakarta.enterprise.inject.Produces;
import jakarta.enterprise.context.ApplicationScoped;

@ApplicationScoped
public class NumberProducer {

    @Produces
    public Integer createNumber() {
        return 100;
    }
}

このように、数値や設定情報をまとめて管理することで、コード全体が見通し良くなります。