初心者必見！@requiredargsconstructorとは何かを徹底解説共起語・同意語・対義語も併せて解説！

この記事を書いた人

高岡智則

年齢：33歳性別：男性職業：Webディレクター（兼ライティング・SNS運用担当）居住地：東京都杉並区・永福町の1LDKマンション出身地：神奈川県川崎市身長：176cm 体系：細身〜普通（最近ちょっとお腹が気になる）血液型：A型誕生日：1992年11月20日最終学歴：明治大学・情報コミュニケーション学部卒通勤：京王井の頭線で渋谷まで（通勤20分）家族構成：一人暮らし、実家には両親と2歳下の妹恋愛事情：独身。彼女は2年いない（本人は「忙しいだけ」と言い張る）

はじめに

このページでは、@requiredargsconstructorについて、初心者の方にも分かるように丁寧に解説します。Javaを使うときに「コンストラクタ」はとても大切ですが、全てのフィールドを書いて毎回作るのは大変です。そこで Lombok というライブラリが登場します。その中に含まれる @RequiredArgsConstructor（日本語表記では @requiredargsconstructor と同義に理解されがちです）が、ソースを短く、読みやすくしてくれます。

@requiredargsconstructorとは

まず大切なのは、このアノテーションが「必須の引数だけを引数に取るコンストラクタ」を自動で作ってくれるという点です。具体的には「final」修飾子が付いたフィールドや、@NonNull がついたフィールドを、引数として受け取るコンストラクタを生成します。つまり、値を必ず渡したいフィールドだけをコンストラクタの引数にする、という意味です。

使い方の基本

使い方はとても簡単です。まず Lombok をプロジェクトに導入します。Maven の場合は 依存関係 を追加します。Gradle の場合は プラグインと依存関係 を追加します。導入が済んだら、対象のクラスに @RequiredArgsConstructor アノテーションを付けます。すると、final フィールドや @NonNull のついたフィールドを引数に取るコンストラクタが自動で生成されます。

例えば、クラスに final int id と String name、@NonNull なフィールドがあるとします。この場合、生成されるのは id と name を受け取るコンストラクタです。name が null の場合には例外を投げる処理が組み込まれることが多い、などの挙動は Lombok の仕様です。

実務での使い方のコツ

実務では、データを受け取る際に必須項目だけをコンストラクタにすることで、意図しない空値を減らせます。また、単体テストを書くときにも「必須項目だけ確実に渡してオブジェクトを作成する」ことができ、テストの可読性が上がります。なお、全てのフィールドを必須としたい場合には @AllArgsConstructor を使い、引数なしのデフォルトコンストラクタが必要な場合には @NoArgsConstructor を使います。これらの違いを理解して使い分けることが、安定したコードを書くコツです。

注意点とよくある誤解

注意点として、@RequiredArgsConstructor は Lombok の「アノテーション処理」が動く環境でのみ機能します。つまり、ビルドツールがアノテーションを処理できる状態であることが前提です。IDEの設定やビルド設定が不十分だと、生成されたコンストラクタが見えなかったり、エラーに見えることがあります。また、final フィールドや @NonNull のついたフィールドが無いと、引数を取らないコンストラクタしか生成されません。この点を理解しておかないと、意図せず動作が変わることがあります。

代表的なアノテーションとの違い

<th>アノテーション

機能
@RequiredArgsConstructor	final フィールドと @NonNull フィールドを引数にとるコンストラクタを自動生成
@AllArgsConstructor	全フィールドを引数にとるコンストラクタを自動生成
@NoArgsConstructor	引数なしのデフォルトコンストラクタを自動生成

実務でのまとめ

要点を整理すると、@requiredargsconstructorは「必須のフィールドだけを引数に取るコンストラクタを自動生成」するため、日常の開発を楽にしてくれます。適切な場面で活用することで、コードの可読性と安全性を高められます。反対に、全てのフィールドを必須としたい場合や特殊な生成規則が必要な場合は、他の Lombok アノテーションと組み合わせて使い分けましょう。

まとめのポイント

・必須のフィールドのみを引数に取るコンストラクタを自動生成するのが @requiredargsconstructor の役割です。

・Lombok の導入と IDE/ビルド設定の整備が前提です。設定が正しくないと生成が反映されません。

・他のアノテーションとの違いを理解して、適材適所で使い分けましょう。

@requiredargsconstructorの同意語

RequiredArgsConstructor: Lombok のアノテーション名。final フィールドと @NonNull のフィールドを初期化するコンストラクタを自動生成します。
必須引数コンストラクタ: Lombok の @RequiredArgsConstructor により、必須となるフィールドだけを引数として初期化するコンストラクタを自動生成する機能を指します。
必須フィールド用コンストラクタ: クラス内の必須フィールド（通常は final フィールドと @NonNull のフィールド）を初期化するためのコンストラクタを生成することを指します。
最小限の引数を持つコンストラクタ: 必要最小限のフィールドだけを受け取る形のコンストラクタを生成する機能を表します。
final フィールド初期化コンストラクタ: final 修飾子が付いたフィールドを必ず初期化するためのコンストラクタを生成するという意味の説明です。
@RequiredArgsConstructor アノテーション: この表記自体は同じアノテーションを指し、クラスに付与すると必須フィールドを引数に取るコンストラクタを自動生成します。
Lombok の必須引数コンストラクタ機能: Lombok が提供する、必須フィールドのみを初期化するコンストラクタを自動作成する機能を指します。

@requiredargsconstructorの対義語・反対語

NoArgsConstructor: 引数なしのコンストラクタを自動生成する Lombok アノテーション。デフォルトコンストラクタと同等の役割を担う場合が多く、必須引数を取らない設計を意味します。
AllArgsConstructor: 全フィールドを引数として受け取るコンストラクタを自動生成する Lombok アノテーション。required-args の発想とは反対の設計（すべてのフィールドを初期化する前提）を表します。
DefaultConstructor: デフォルトコンストラクタ（引数なしのコンストラクタ）を指す一般用語。特定のアノテーションではなく、通常は何も引数を取らないコンストラクタを指します。
OptionalArgsConstructor: 任意の引数を受け取るコンストラクタのイメージ。公式の Lombok アノテーションではないが、引数が必須ではない設計を示す表現として使われることがある。

@requiredargsconstructorの共起語

Lombok: Javaで使われるアノテーションベースのライブラリ。クラスのボイラープレートを自動生成します（getter/setter/toString/equals/hashCode/コンストラクタなど）。
finalフィールド: finalとして宣言されたフィールドは初期化後に変更できません。@RequiredArgsConstructorはこのfinalフィールドを引数に含むコンストラクタを作成します。
@NonNull: Lombokのアノテーション。nullを許容しないフィールドを示します。@RequiredArgsConstructorは@NonNullが付いたフィールドをコンストラクタの引数に含めます。
コンストラクタ生成: クラスのコンストラクタを自動で作成する機能。@RequiredArgsConstructorは“必須の”フィールドだけを引数に持つコンストラクタを生成します。
RequiredArgsConstructor: Lombokのアノテーション。finalフィールドと@NonNullが付いたフィールドを引数に取るコンストラクタを自動生成します。
AllArgsConstructor: クラスの全フィールドを引数に取るコンストラクタを生成します。初期値を一括設定したい場合に使います。
NoArgsConstructor: 引数なしのデフォルトコンストラクタを生成します。既存のコードと組み合わせる時に有用です。
アノテーション処理: Javaのアノテーションをコンパイル時に処理してコードを生成するメカニズム。Lombokはこれを利用します。
Java: 対象プログラミング言語。Lombokと@RequiredArgsConstructorは主にJavaで使われます。
Builder: オブジェクトの生成をビルダーパターンで行う機能。Lombokの@Builderと組み合わせると柔軟に生成できます。
依存性注入: 外部から必要な依存オブジェクトを注入する設計パターン。「必須の依存」をコンストラクタで受け取る際に@RequiredArgsConstructorが役立つことがあります。
IDEサポート: IntelliJ IDEAやEclipseなどのIDEでLombokを有効化すると、補完やエラー検知が快適になります。

@requiredargsconstructorの関連用語

@RequiredArgsConstructor: @RequiredArgsConstructor は final フィールドや @NonNull が付与されたフィールドだけを引数にするコンストラクタを自動生成する Lombok のアノテーション。依存性の注入や必須値の初期化に便利です。
finalフィールド: 値を初期化後に変更できないフィールドのこと。@RequiredArgsConstructor の対象になりやすく、オブジェクトの不変性設計に役立ちます。
@NonNull: @NonNull は対象フィールドに null を許さず、コンストラクタ生成時に null チェックを自動挿入します。null が渡されると NullPointerException を投げます。
@AllArgsConstructor: 全てのフィールドを引数とするコンストラクタを自動生成します。
@NoArgsConstructor: 引数なしのデフォルトコンストラクタを自動生成します。
@Data: @Data は @Getter / @Setter / @ToString / @EqualsAndHashCode / @RequiredArgsConstructor をまとめて生成する総合的なアノテーションです。データ保持クラスに便利。
@Getter: フィールドごとの getter メソッドを自動生成します。
@Setter: フィールドごとの setter メソッドを自動生成します。
@ToString: クラスの状態を文字列として返す toString メソッドを自動生成します。
@EqualsAndHashCode: オブジェクトの等価性比較とハッシュコード生成を自動化します。
@Builder: ビルダーパターンを実装するためのクラスを自動生成します。任意の順序でフィールドを設定してオブジェクトを組み立てられます。
アノテーション処理: Lombok はコンパイル時にアノテーションを解析して対応するコードを生成する「アノテーション・プロセッサ」の仕組みを利用します。
IDEプラグイン: IntelliJ IDEA や Eclipse で Lombok の補完・リファクタリング・表示を正しく機能させるためのプラグインがあります。
Maven/Gradle設定: ビルドツールの設定で Lombok を依存関係に追加し、コンパイル時にアノテーション処理が走るようにします。
lombok.config: Lombok の挙動を細かく制御する設定ファイル。nonNull の挙動や生成の細かな動作を調整できます。
Javaレコード: Java のレコードはBoilerplate を大幅に削減しますが、@RequiredArgsConstructor の挙動とは異なる仕組みです。代替・補完として比較されることがあります。
DI（Constructor Injection）: 依存オブジェクトをコンストラクタ経由で注入する設計。@RequiredArgsConstructor はこの設計と相性が良いです。
ボイラープレート削減: getter/setter/equals/hashCode/toString などの繰り返しコードを減らし、コードをすっきりさせます。
デバッグ時の挙動: Lombok はコンパイル時にコードを生成するため、デバッグ時に生成コードが見えにくいことがあります。IDE の Lombok プラグインを使うと改善します。
互換性と注意点: Java のバージョンや Lombok のバージョン間の互換性、IDE のサポート状況、ビルド設定の影響などに留意してください。