IntelliJ IDEA 2025.2 ヘルプ

Spring Boot

Spring Boot は、Spring アプリケーションの初期構成を簡素化する Spring フレームワークの拡張です。これにより、最小限のデフォルト設定で動作するスタンドアロン Spring アプリケーションをすばやく作成できます。

Spring Initializr(英語) は、Spring Boot プロジェクトを生成できる Web アプリケーションです。ビルドツール、言語、Spring Boot フレームワークのバージョン、プロジェクトの依存関係など、必要な構成を選択できます。IntelliJ IDEA は、Spring Initializr API と統合して IDE からプロジェクトを直接生成およびインポートする Spring Initializr プロジェクトウィザードを提供します。

Spring Boot ウィザードを使用して新しい Spring Boot プロジェクトを作成する

  1. メインメニューで、ファイル | 新規 | プロジェクトに移動します。

  2. 新規プロジェクトウィザードの左側のペインで、Spring Boot を選択します。

  3. Spring Boot プロジェクトウィザードの手順を実行します。

例については、「チュートリアル: 最初の Spring アプリケーションを作成する」を参照してください。

Spring Initializr は、以下のファイルを使用して有効なプロジェクト構造を生成します。

  • ビルド構成ファイル。たとえば、Gradle の場合は build.gradle、Maven の場合は pom.xml

  • アプリケーションをブートストラップする main() メソッドを持つクラス。

  • 空の JUnit テストクラス。

  • 空の Spring アプリケーション構成ファイル: application.properties

既存の Spring Boot プロジェクトにスターターを追加する

IntelliJ IDEA を使用して新しい Spring Boot プロジェクトを作成する場合、専用の新規プロジェクトウィザードでスターターを追加できます。また、ビルドファイルでスターターの追加インレイヒントを使用して、既存のプロジェクトにスターターを追加することもできます。

  1. pom.xml または build.gradle(.kts) ファイルを開きます。

  2. dependencies ブロックで、Spring Add Starters スターターの追加をクリックします。

    Spring Add Starters inlay hint
  3. 開いたスターターの追加ダイアログで、追加するスターターを選択します。

    Edit Starters

ビルドファイルはそれに応じて変更されます。この方法で依存関係を追加すると、IntelliJ IDEA は Spring Boot のバージョンを考慮するため、互換性のある依存関係のバージョンについて心配する必要がなくなります。

このインレイヒントは、IDE 設定 (Ctrl+Alt+S)、エディター | インレイヒント | その他GroovyKotlinXML で無効または有効にすることができます。

デフォルトでは、IntelliJ IDEA は生成されたファイルにコード形式を適用します。ファイルを Spring Initializr によって生成された形式のままにしたい場合は、Ctrl+Alt+S で IDE 設定を開き、言語 & フレームワーク | Spring | Spring Initializr を選択して新規プロジェクトの作成時にコードを整形オプションを無効にします。

Spring Boot アプリケーションを実行する

  • main() メソッドでクラスを開き (通常は @SpringBootApplication アノテーションでも指定されます)、ガターで The Run icon をクリックし、クラスの実行を選択します。

    Run Spring Boot application from the gutter

    または、エディターでクラスファイルを開いた状態で Ctrl+Shift+F10 を押すこともできます。

IntelliJ IDEA は、Spring Boot 実行構成を作成して実行します。詳細については、「Spring Boot 実行構成」を参照してください。

Gradle を使用して Spring Boot を実行する

デフォルトでは、Spring Boot Gradle ベースのアプリケーションの場合、IntelliJ IDEA は Gradle を使用してプロジェクトをビルドし、IntelliJ IDEA を使用してプロジェクトを実行します。IntelliJ IDEA の代わりに Gradle を使用して Spring Boot アプリケーションを実行するように IDE を構成できます。

  1. 詳細設定設定ページ Ctrl+Alt+S に移動します。

  2. フレームワーク。Spring BootGradle を使用して実行を選択します。

ビルド、実行、デプロイ | ビルドツール | Gradle | ビルドおよび実行に使用IntelliJ IDEA が選択されている場合、Gradle を使用して実行チェックボックスは無効になります。この場合、IntelliJ IDEA は Spring Boot アプリケーションの構築と実行の両方に使用されます。

カスタム構成ファイル

Spring Initializr は 1 つのデフォルト構成ファイルを作成しますが、開発には必ずしも十分とは限りません。デフォルトの構成ファイルを使用しない場合、または異なる環境でコードを実行する場合は、プロジェクトで定義されたカスタム構成ファイルを使用できます。

IntelliJ IDEA にプロジェクト内の構成ファイルを知らせて、関連するハイライトとコーディング支援を有効にします。

プロジェクト構成ファイルを定義する

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

  2. Spring ファセットを追加します。左側のリストからファセットを選択し、the Add icon をクリックして、Spring を選択します。

  3. 右側のセクションで構成ファイルを選択し、ツールバーの Customize Spring Boot (Spring Boot のカスタマイズ ) をクリックします。

  4. デフォルトのファイルの代わりにカスタム構成ファイルを使用する場合は、その名前を spring.config.name フィールドに入力します。

    複数の構成ファイルを使用する場合は、The Add button をクリックして、プロジェクトツリーからファイルを選択します。

    有効な構成ファイルは The Spring Boot icon でマークされています。

  5. OK をクリックし、変更を適用します。

Configuring a custom configuration file

ランタイムエンドポイント

Spring Boot には、HTTP エンドポイントまたは Java Management Extensions (JMX) を使用して実稼働環境でアプリケーションの状態を監視および管理するための追加機能が含まれています。詳細については、Spring Boot アクチュエーター: 本番環境対応機能を参照してください。

Spring Boot アクチュエーターエンドポイントを有効にする

  1. pom.xml または build.gradle ファイルで、dependencies リストの横にあるスターターの追加インレイヒントをクリックします。

    あるいは、ファイル内の任意の場所で Alt+Insert を押して、スターターの追加を選択します。

  2. 開いたウィンドウで、Spring Boot アクチュエーターを選択します。

    Edit Starters

または、spring-boot-starter-actuator 依存関係を手動で追加することもできます。

pom.xml ファイルを開き、次の依存関係を dependencies に追加します。

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency>

build.gradle ファイルを開き、次の依存関係を dependencies に追加します。

implementation 'org.springframework.boot:spring-boot-starter-actuator'

build.gradle.kts ファイルを開き、次の依存関係を dependencies に追加します。

implementation("org.springframework.boot:spring-boot-starter-actuator")

この依存関係を使用してアプリケーションを実行すると、HTTP を介して公開されたアクチュエーターエンドポイントにアクセスできるようになります。例: アプリケーションがローカルホストポート番号 8080 で実行されている場合、health エンドポイントのデフォルト URL は http://localhost:8080/actuator/health になります。

Spring Boot アクチュエーターエンドポイントを表示する

  1. Spring Boot アプリケーションを実行し、サービスツールウィンドウを開きます。表示 | ツールウィンドウ | サービスを選択するか、Alt+8 を押します。

  2. 実行中の Spring Boot アプリケーションを選択し、次のタブを使用してアクチュエーターエンドポイントから情報を取得します。

Bean

Bean タブには、Spring Boot アプリケーションのランタイム Bean が表示されます。任意の bean をダブルクリックすると、その宣言がエディターで開きます。これらの Bean は、ガターの Spring Live bean アイコンで示されます。このアイコンをクリックすると、依存 Bean と挿入された Bean が表示されます。

Spring actuator beans

Bean タブには、次のツールバーアクションがあります。

アクション

説明

The Refresh button リフレッシュ

JMX エージェントによって収集されたランタイム Bean 情報をリフレッシュします。

The Diagram Mode button ダイアグラムモード

リストではなく、すべてのランタイム Bean の完全なグラフを表示します。

必要なプラグイン: ダイアグラム(バンドル)。

The Show Library Beans button ライブラリ Bean の表示

ライブラリの Bean を表示。

The Show Contexts button コンテキストの表示

利用可能な Spring アプリケーションのコンテキストを表示します。

The Show Configuration Files button 構成ファイルの表示

利用可能な設定ファイルを表示します。

The Show Bean Documentation button Bean ドキュメントの表示

選択した bean のドキュメントを表示します。

The Show Bean Graph button Bean グラフの表示

選択した bean の直接の依存関係を表示します。

必要なプラグイン: ダイアグラム(バンドル)。

状態

状態タブには、アプリケーションのステータスが表示されます。自動構成されたヘルスインジケーターもいくつかあり、カスタムのヘルスインジケーターを書き込むこともできます。

Spring Boot Health endpoints tab

詳細は、状態を参照してください。

マッピング

マッピングタブには、アプリケーションのリクエストマッピングが表示されます。@RequestMapping アノテーションまたはそのショートカット ( @GetMapping など) を持つすべてのメソッドが一覧表示されます。

パスマッピング URI をクリックすると、対応する HTTP リクエストを実行するか、リクエストを含む HTTP リクエストファイルを開くか、Web ブラウザーでリクエスト URL を開くか (GET リクエストの場合) を選択できます。詳細については、HTTP クライアントを参照してください。

Spring Boot Mappings endpoints tab

メソッドをダブルクリックして、その宣言をエディターで開きます。Spring はハンドラーなどのメソッドを登録し、IntelliJ IDEA はガター内の Spring request mapping アイコンで示します。このアイコンをクリックして、対応する HTTP リクエストを実行し、リクエストファイルで、Web ブラウザー(GET リクエストの場合)で開きます。

マッピングタブには、次のツールバーアクションがあります。

アクション

説明

The Refresh button リフレッシュ

JMX エージェントによって収集された要求マッピングをリフレッシュします。

The Open in Browser button ブラウザーで開く

Web ブラウザーでルートアプリケーションの URL を開きます。

The Request Method menu リクエストメソッド

表示するリクエストメソッドを選択します。

The Show Library Mappings button ライブラリマッピングの表示

ライブラリからのリクエストのマッピングを表示します。

環境

環境タブには、/actuator/env エンドポイントから取得された情報を含む Spring 環境が表示されます。アプリケーションプロパティや環境変数など、さまざまな構成ソースから取得可能なすべてのプロパティが含まれます。

Spring Boot Environment tab

Spring Boot バージョン 3.0 以降では、Spring 環境によって提供される値は完全にサニタイズされます ( ****** に置き換えられます)。それ以前の Spring Boot バージョンでは、資格情報関連のキーのみがデフォルトでサニタイズされます。どちらの場合も、ツールバーの をクリックするか、プロパティを右クリックして値の表示を選択すると、非表示の値を表示できます。このアクションにより、アプリケーションが再起動され、Spring Boot run 構成の構成プロパティのオーバーライドセクションに必要なフラグが追加されます。Spring バージョン 3.0 以降では management.endpoint.env.show-values=when_authorized で、それ以前のバージョンでは空の値を持つ management.endpoint.env.keys-to-sanitize です。

値を再度非表示にするには、もう一度 をクリックするか、プロパティを右クリックして値を非表示を選択します。これにより、アプリケーションも再起動され、実行構成から追加されたプロパティが削除されます。

アプリケーション更新ポリシー

spring-boot-devtools モジュールを使用すると、クラスパス上のファイルが変更されるたびにアプリケーションが再起動されます。IntelliJ IDEA が変更されたファイルを継続的にコンパイルするように構成されている場合は、トリガーファイルを設定できます。この場合、アプリケーションはトリガーファイルを変更した後にのみ再起動されます。詳細については、自動再起動を参照してください。

自動再起動を有効にする

  • プロジェクトに spring-boot-devtools モジュールの依存関係を追加します。

    pom.xml ファイルを開き、次の依存関係を dependencies に追加します。

    <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> <optional>true</optional> </dependency>

    spring-boot-devtools 依存関係を optional として設定すると、プロジェクトを使用する他のモジュールで使用されなくなります。

    build.gradle ファイルを開き、次の依存関係を dependencies に追加します。

    developmentOnly("org.springframework.boot:spring-boot-devtools")

    spring-boot-devtools 依存関係を developmentOnly として設定すると、プロジェクトを使用する他のモジュールで使用されなくなります。

実行中のアプリケーションを更新するには、メインメニューで実行 | デバッグアクション | 実行中アプリケーションの更新 Ctrl+F10 に移動するか、サービスツールウィンドウでアプリケーションを選択して Update application をクリックします。必要に応じて、このアクションを実行するときに IDE が行う動作を構成できます。

アプリケーション更新ポリシーを構成する

  1. メインメニューで、実行 | 実行構成の編集に移動します。

  2. 必要な Spring Boot 実行構成を選択して、その設定を開きます。オプションを変更をクリックします。

    Configuring Spring Boot application update policy
  3. 開いたリストで、'更新' アクション時をポイントします。リソースのみを更新するか、クラスとリソースの両方を更新する(アプリケーションをビルドする)か、トリガーファイルを更新する(再起動をトリガーする)か、クラスのホットスワップを実行してみて、失敗した場合は更新するかを選択できます。トリガーファイル。

  4. オプションを変更リストで、フレーム切り替え時をポイントし、別のアプリケーションに切り替えた後に IDE が実行するアクションを選択します。リソースを更新するか、アプリケーションをビルドします。

2025 年 2 月 20 日

関連ページ:

Spring Boot プロジェクトウィザード

Spring Boot プロジェクトウィザードを使用して、IntelliJ IDEA で新しい Spring Boot プロジェクトを生成します。Spring Boot プロジェクトを作成するメインメニューで、に移動します。新規プロジェクトダイアログで、Spring Boot を選択します。詳細は、Spring Boot ウィザードを使用して新しい Spring Boot プロジェクトを作成するを参照してください。ステップ 1. 基本的なプロジェクト構成:サーバー URL デフォルトの https:/...

コードの整形

IntelliJ IDEA を使用すると、現在のコードスタイルスキームまたは .editorconfig ファイルで指定した要件に従ってコードを再フォーマットできます。で定義されていないものがあれば、プロジェクト設定から取得されます。コードの一部、ファイル全体、ファイルのグループ、ディレクトリ、モジュールを再フォーマットできます。また、コードの一部または一部のファイルを再フォーマットから除外することもできます。コードフラグメントを再フォーマットするエディターで、再フォーマットしたいコードフラグメント...

Spring Boot 実行構成

Spring Boot 実行構成は、IntelliJ IDEA で Spring Boot アプリケーションを実行する方法を定義します。IDE は、メインクラスファイルからアプリケーションを実行するときに Spring Boot 実行構成を作成します。詳細については、Spring Boot アプリケーションを実行するを参照してください。Spring Boot 実行構成を作成するメインメニューで、に移動します。実行 / デバッグ構成ダイアログで、をクリックし、Spring Boot を選択します。名前実行...

サービスツールウィンドウ

サービスツールウィンドウを使用すると、実行 / デバッグ構成、アプリケーションサーバー、データベースセッション、Docker 接続など、ソフトウェア開発中に役立つさまざまなサービスを管理できます。プラグイン開発者は、IntelliJ プラットフォーム API を通じて他のサービスを追加できます。メインツールバーには、すべてのサービスタイプに共通の次のボタンとメニューが含まれています。すべて展開リスト内のすべての項目を展開します。すべて折りたたむリスト内のすべての項目を折りたたみます。グループ化サ...

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

IntelliJ IDEA は、XML 構成またはアノテーションに基づいて、プロジェクト内の Spring を自動的に検出します。通常、Spring プロジェクトは手動構成を必要とせず、ほとんどの機能は Spring ファセットを追加しなくても使用できます。ただし、複数の Spring アプリケーションコンテキストがある場合は、IntelliJ IDEA が正しいコーディング支援を提供し、bean 定義でガターアイコンを有効にするために、既存の構成ファイルをアプリケーションコンテキストにマップす...

HTTP クライアント

HTTP クライアントプラグインを使用すると、IntelliJ IDEA コードエディターで HTTP リクエストを直接作成、編集、実行できます。HTTP リクエストを作成して実行する必要がある場合、主に 2 つのユースケースがあります。RESTful Web サービスを開発していて、それが期待どおりに機能し、仕様に準拠してアクセス可能であり、正しく応答することを確認したい場合。RESTful Web サービスに対応するアプリケーションを開発している場合。この場合、開発を開始する前にサービスへの...