IntelliJ IDEA 2025.1 ヘルプ

既存のプロジェクトに Spring サポートを追加

IntelliJ IDEA は、XML 構成または @Configuration アノテーションに基づいて、プロジェクト内の Spring を自動的に検出します。通常、Spring プロジェクトは手動構成を必要とせず、ほとんどの機能は Spring ファセットを追加しなくても使用できます。

ただし、複数の Spring アプリケーションコンテキストがある場合は、IntelliJ IDEA が正しいコーディング支援を提供し、bean 定義でガターアイコンを有効にするために、既存の構成ファイルをアプリケーションコンテキストにマップする必要があります。IDE は、プロジェクトに追加の構成が必要かどうかを通知し、構成ファイルがアプリケーションコンテキストにマップされていない場合は、構成ファイルの先頭に警告が表示されます。専用のアクションを使用して Spring 構成を確認することもできます。構成ファイルをアプリケーションコンテキストにマップするには、次のことを行う必要があります。

Spring ファセットを追加

  1. メインメニューでファイル | プロジェクト構造に移動するか、Ctrl+Alt+Shift+S を押してプロジェクト構造ダイアログを開きます。

  2. 左側のリストからモジュールを選択します。

  3. 必要なモジュールを選択し、中央の The Add button をクリックします。

  4. リストから Spring を選択します。

この時点で、自動検出されたコンテキストと構成ファイル、マップされていないファイルがすでに表示されている場合があります。

Spring Add Facet

アプリケーションコンテキストを作成する

  1. プロジェクト構造 (Ctrl+Alt+Shift+S) のプロジェクト設定 | ファセットで、追加された Spring ファセットを選択します。

  2. The Add button をクリックして、新しいコンテキストを作成します。

  3. 新規アプリケーションのコンテキストダイアログで、コンテキストの名前を指定し、コンテキストで使用する構成ファイルを選択します (XML ファイルまたは @Configuration でアノテーションが付けられたソースコードファイル)。

Spring Add Facet

プロジェクトが正しく構成されている場合、各コンポーネント、bean などを示す Spring ガターアイコンが表示されます。ガターアイコンを構成するには、Ctrl+Alt+S で IDE 設定を開き、エディター | 一般 | ガターアイコンに移動します。

Spring 構成の確認

マップされていない構成ファイルがある場合、対応する警告がファイル | プロジェクト構造に表示され、エディターで開いたときに構成ファイルの上に表示されます。不明な場合は、専用アクションを使用して Spring 構成を確認できます。

  1. Shift を 2 回押して検索ウィンドウを開き、アクションタブに移動するか、単に Ctrl+Shift+A を押します。

  2. 検索フィールドに「Spring 構成の確認」と入力し、対応するアクションを選択します。プロジェクトにマップされていない構成ファイルがある場合は、通知が表示されます。

  3. マップされていないファイルの数 (2 ファイルなど) のリンクをクリックし、ファイルの 1 つを選択します。これにより、エディターでファイルが開き、使用可能なコンテキストのいずれかを選択するか、新しいコンテキストを作成できます

親コンテキストを構成する

IntelliJ IDEA では、コンテキスト間の親子関係を設定できます。親コンテクストの Bean は、子コンテクストの Bean には表示されますが、その逆はありません。子コンテキストからの Bean は、親コンテキストからの構成を使用できます。

例: Spring MVC アプリケーションには通常、2 つのコンテキストがあります。1 つは Web レイヤー Bean 用で、もう 1 つはサービスとリポジトリ用です。この場合、Web レイヤーコンテキストは子コンテキストになります。逆にではなく、コントローラーにサービスをインジェクションする必要があるためです。

親コンテキストを構成するには、アプリケーションコンテキストを作成するで説明されている新規アプリケーションのコンテキストダイアログを使用します。

複数のコンテキストパネルは、2 つ以上のアプリケーションコンテキストに含まれるファイルのエディターの上部に表示されます。たとえば、特定の構成でアプリケーションを実行し、ハイライトを変更する場合は、このパネルを使用してアクティブなコンテキストを選択できます。パネルを無効にするには、The Settings button をクリックし、マルチコンテキストパネルを表示するチェックボックスをオフにします。

アクティブなプロファイルを変更する

Spring を使用すると、特定のコンテキストまたは Bean を、たとえばテスト本番などの異なるプロファイルにマップできます。このようにして、さまざまな環境でさまざまなプロファイルをアクティブ化できます。

プロジェクトに少なくとも 1 つのプロファイルを定義している場合、IntelliJ IDEA は構成 bean ファイル内のエディターの上部に特別なパネルを表示します。このパネルを使用して、現在のプロファイル名を表示し、アクティブなプロファイルを変更できます。

アクティブなプロファイルを変更する

  1. パネル上でプロファイルの変更をクリックします。

  2. プロファイルをマップするコンポーネントを選択します。これは、プロジェクト全体、現在のモジュール、現在のコンテキストのいずれかです。

  3. このコンポーネントをマップするプロファイルを選択します。

Changing the Spring profile

パネルを非表示にする場合は、The Settings button をクリックし、プロファイルパネルを表示するチェックボックスをオフにします。

ファセット設定の共有

カスタムファセットを作成し、拡張子 .iml を持つモジュールファイルをバージョン管理システムに追加することで、設定を変更および共有できます。

例: チーム内でアプリケーションコンテキストを共有するには、Spring ファセットを作成し、その設定をコミットします。

  1. メインメニューで、ファイル | プロジェクト構造に移動するか、Ctrl+Alt+Shift+S を押します。次に、モジュールを選択します。

  2. ファセットを追加するモジュールが選択されていることを確認し、モジュールのリストの上にある the Add button をクリックします。使用可能なファセットのリストから、Spring を選択します。

    Adding Spring facet
  3. 右側のセクションで、「 the Add button 」をクリックして、新しいアプリケーションコンテキストを追加します。

  4. コンテキストに名前を付け、the Add button をクリックし、コンテキストタイプを選択して、コンピューター上のファイルを選択します。

  5. プロジェクトを再度開きます。その後、ファセットを追加したモジュールの .iml ファイルに変更が反映されます。

    Spring facet in module file
  6. .iml ファイルを追加するをバージョン管理システムに追加します。

関連ページ:

Spring ツールウィンドウ

Spring ツールウィンドウを使用すると、プロジェクトを Spring の観点から見ることができます。これは次のタブで構成されます。ドキュメント、Bean グラフ、MVC、データ、Spring の他に、プロジェクトに Micronaut または Java EE CDI 依存関係がある場合、ツールウィンドウ名は Spring ではなく Bean になり、プロジェクトで検出されたすべての Bean が表示されます。ドキュメント:ドキュメントタブでは、bean ドキュメントを表示できます。基本的に、bean...

ファイルを Git に追加し、変更を追跡する

Git にファイル追加コミットツールウィンドウを開きます。を押すか、コンテキストメニューから VCS に追加を選択して、バージョン管理外ファイル変更リスト内のファイルをバージョン管理下に置きます。変更リスト全体を追加することも、個別のファイルを選択することもできます。プロジェクトで Git 統合を有効にしている場合、IntelliJ IDEA は、新しく作成された各ファイルをバージョン管理下に追加することを提案します。この動作は、の設定ダイアログで変更できます。特定のファイルを常にバージョン管...

チュートリアル: Spring サポート機能を見る

このチュートリアルでは、チュートリアル: 最初の Spring アプリケーションを作成するを拡張して、コードの記述、Spring アプリケーションの分析、実行時の管理に IntelliJ IDEA がどのように役立つかを示します。このチュートリアルは、Spring Initializr で生成された単純な Spring Boot Maven プロジェクトから開始することを前提としています。Web アプリケーションを構築するための Spring Boot Starter Web 依存関係がすでにあ...

Spring 設定

このページを使用して、IntelliJ IDEA で Spring サポートを構成します。プロファイルパネルを表示するエディターの上部に特別なパネルを表示して、現在アクティブな Spring のプロファイルを表示および変更できるようにします。マルチコンテキストパネルを表示する 2 つ以上の Spring アプリケーションコンテキストに含まれるファイルの特別なパネルを表示します。詳細については、親コンテキストを構成するを参照してください。スマート Bean 補完 IntelliJ IDEA は、オートワイヤ...