IntelliJ IDEA 2019.2ヘルプ

Spring Boot

Spring Boot入門

Spring Initializrは、プロジェクトまたはモジュールを作成するときに必要な構成を選択できるウィザードです。例:ビルドツールを選択し、Spring Bootのスターターと依存関係を追加することができます。

Spring Bootプロジェクトを作成する

  1. メインメニューからファイル | 新規 | プロジェクトを選択し、Spring Initializrを選択します。

  2. プロジェクト SDKリストから、このSpring Bootプロジェクトで使用するJDKバージョンを選択します。必要なバージョンがインストールされていない場合は、Java開発キット (JDK)をダウンロードしてインストールする方法を参照してください。

  3. 使用するInitializrサービスのURLを入力するか、デフォルトのままにします。次へをクリックします。

  4. プロジェクトメタデータの設定:言語(Java、KotlinまたはGroovy)、ビルドツール(MavenまたはGradle)を選択し、アーティファクトIDとバージョンを指定します。

    プロジェクトJDKのバージョンとは異なるJavaバージョンでプロジェクトをビルドする場合は、ここで選択できます。

    次へをクリックします。

  5. スターターと依存関係を選択します。追加のプラグインが必要なテクノロジを選択すると、IDEはプロジェクトの作成後にそのことを通知し、インストールまたは有効化を提案します。

その結果、Spring Initializrは定義済みのビルドファイル pom.xml または build.gradle、ソースファイル、テストファイル、および空の application.properties ファイルを使用してプロジェクトを作成します。

以前に高度なコード書式設定を構成していた場合は、事前定義ファイルに適用されます。Spring Initializrでデフォルトのコード書式設定でプロジェクトを作成する場合は、設定/環境設定ダイアログを開き、 言語 & フレームワーク | Spring | Spring Bootに移動してコードの再フォーマットオプションを無効にします。

カスタム構成ファイルを構成する

Spring Initializrは、開発には必ずしも十分でないかもしれない1つのデフォルト設定ファイルを作成します。既定の構成ファイルを使用したくない場合や、異なる環境でコードを実行する場合は、カスタム構成ファイルを使用できます。

これを行うには、IntelliJ IDEAにどのファイルがプロジェクトの構成ファイルであるかを知らせなければなりません。これにより、関連するハイライトとコーディングの支援が可能になります。

  1. メインメニューからファイル | プロジェクト構造 | ファセットを選択します。

  2. ツールバーの Spring Boot iconSpring Bootをカスタマイズ)をクリックします。

  3. 既定の構成ファイルではなくカスタム構成ファイルを使用する場合は、新しいカスタム構成ファイルの名前を検索ボックスに入力します。

    複数の設定ファイルを使用する場合は、Add ボタンをクリックし、プロジェクトツリーからファイルを選択します。

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

    カスタム設定ファイルが正しく設定されている場合は、Spring Boot icon アイコンでマークされます。

    Configuring a custom configuration file

Spring Bootエンドポイントを監視する

Spring Bootには、ヘルスやbeanの詳細などの異なるエンドポイントを呼び出すことによって、主要なメトリックを取得し、運用環境でのアプリケーションの状態を監視できるようにする機能が組み込まれています。

IntelliJ IDEAでは、エンドポイントタブでエンドポイントを表示できます。このタブは、サービスツールウィンドウ、またはアプリケーションの起動後に実行ツールウィンドウに表示されます。

「エンドポイント」タブでは、メソッドとBeanにナビゲートできます。マッピングまたはBeanタブで必要な項目をダブルクリック(または Enterを押す)し、選択したメソッドまたはbeanをエディターで開きます。

実行ツールウィンドウのエンドポイントにアクセスする

アプリケーションを起動すると、実行ツールウィンドウが自動的に開きます。

ツールウィンドウを閉じていて、再度開く場合は、Alt+4を押すか、表示 | ツール・ウィンドウ | 実行に移動します。

デバッグツールウィンドウのエンドポイントにアクセスする

アプリケーションのデバッグを開始すると、デバッグツールウィンドウが開きます。

ツールウィンドウを閉じていて、再度開く場合は、Alt+5を押すか、表示 | ツール・ウィンドウ | デバッグに移動します。

サービスツールウィンドウでエンドポイントにアクセスする

  1. メインメニューから実行 | 構成の編集を選択し、左側のリストでテンプレートをクリックします。

  2. サービスで利用可能な構成セクションで、Add ボタンをクリックし、Spring Bootを選択します。

  3. 実行/デバッグ構成ダイアログで、必要なSpring Boot設定を開き、JMX エージェントを使用可能にするチェックボックスを選択します。

さらに、アプリケーションを実行する前に、モジュールに org.springframework.boot.spring-boot-starter-actuator 依存関係を追加してください。

マッピングエンドポイントについては、org.springframework.boot.spring-boot-starter-web スターターも追加してください。

Spring endpoints shown in Services tool window

ツールウィンドウを表示または非表示にするには、表示 | ツール・ウィンドウに移動してサービスをクリックします。

アプリケーションを実行すると、Spring Live bean アイコンがbean宣言のガターに表示され、コンテキスト内でBeanが見つかることを示します。このアイコンを使用して、依存するBeanと挿入されたBeanを表示できます。

アイコンが表示されない場合は、実行 / デバッグの構成ダイアログでJMX エージェントを使用可能にするチェックボックスが選択されていることを確認してください。

Beanタブでは、ガターのアイコンを使用してBeanの情報の表示方法を変更できます。例:Beanのみを表示したり、ライブラリーBean(Library icon)の表示を無効にしたり、ドキュメントの表示(Show documentation icon)などを有効または無効にすることができます。各アイコンには、それを識別するツールチップが表示されます。

Spring ランタイム Bean ダイアグラム

SpringランタイムBeanダイアグラムは、Spring BootアプリケーションのランタイムBean間の依存関係を視覚化できます。

サービスツールウィンドウ、実行ツールウィンドウ、またはデバッグツールウィンドウのエンドポイント | Beanタブでダイアグラムにアクセスできます。アプリケーションを起動して図モードアイコンをクリックします。

Diagram showing dependencies between runtime beans

HTTPリクエストマッピングにアクセスする

開始する前に、実行 / デバッグの構成ダイアログでJMX エージェントを使用可能にするチェックボックスが選択されていることを確認し、org.springframework.boot.spring-boot-starter-actuator の依存関係をビルドファイルに追加します。

Spring Boot Webアプリケーションを実行すると、@RequestMapping 注釈が付いたメソッドのガターに Run アイコンが表示され、Springがハンドラとして登録されていることを示します。

このアイコンをクリックすると、次のアクションが選択されます。要求をすぐに実行することも、エディターでHTTP拡張子を持つスクラッチファイルで開くこともできます。必要に応じて編集し、RESTクライアント経由で実行できます。 @GetMapping 注釈を持つメソッドの場合は、マップされたURLをブラウザで開くこともできます。

Opening HTTP request mappings in the Request editor

サービスツールウィンドウ、実行ツールウィンドウ、またはデバッグツールウィンドウのエンドポイント | マッピングタブで要求マッピングにアクセスすることもできます。必要な要求をクリックしてから、次のアクションを選択します。

Opening HTTP request mappings from Services tool window

devtoolsでアプリケーションのアップデートポリシーを設定する

spring-boot-devtools モジュールを使用すると、クラスパス上のファイルが変更されるたびにアプリケーションが再起動します。ただし、アプリケーションを特定の瞬間にのみ再起動したい場合は、トリガーファイルを設定することができます。この場合、アプリケーションはトリガーファイルを変更した後でのみ再開します。

IntelliJ IDEAは実行中のアプリケーションを更新するためのより多くのオプションを提供します。devtoolsを使用可能にした後、<アプリケーション名>アプリケーションの更新 Update application オプション(Ctrl+F10)は、「サービス」ツール・ウィンドウの左フレーム、「実行/デバッグ」ツール・ウィンドウ、およびメインメニュー(実行 | <アプリケーション名>アプリケーションの更新)から使用可能になります。必要に応じて、このオプションをクリックした後にIDEが実行する動作を設定できます。

  1. メインメニューから実行 | 構成の編集を選択します。

  2. 必要なSpring Boot構成を選択するか、新しい構成を作成します( Add icon をクリックし、Spring Boot icon Spring Bootを選択します)。

  3. この構成を適用する必要があるメインクラスを指定します。

  4. '更新' アクション時リストから、ポリシーを選択します。リソースのみの更新、クラスとリソースの更新(アプリケーションのビルド)、トリガファイルの更新(再起動)、またはクラスのホットスワップを実行できます。失敗した場合、IntelliJ IDEAはトリガファイルを更新します。

フレーム切り替え時リストから、別のアプリケーションに切り替えた後にIDEが実行するアクションを選択することもできます。IntelliJ IDEAは、リソースを更新したり、アプリケーションをビルドすることができます。

最終更新日: 2019年8月1日

関連事項

関連ページ:

SDK

ソフトウェア開発キットまたはSDKは、特定のソフトウェアフレームワーク用のアプリケーションを開発するために必要なツールの集まりです。例:Javaでアプリケーションを開発するには、Java SDK(JDK)が必要です。SDKには、バイナリ、バイナリのソースコード、およびソースコードのドキュメントが含ま...

デバッグ

このセクションでは、さまざまな種類のアプリケーションに共通する手順について説明します。IntelliJ IDEAは、ソースコードをデバッグするためのあらゆる機能を提供します。Javaのブレークポイント、JavaScriptのブレークポイント、複数の同時デバッグセッション。カスタマイズ可能なブレークポ...

実行/デバッグ構成の作成と編集

ナビゲーションバーが表示されると、使用可能な実行/デバッグ構成が実行エリアの実行/デバッグ設定セレクタに表示されます。IntelliJ IDEAは、実行/デバッグ設定を処理するためのツールとして実行/デバッグ構成ダイアログを提供します:設定プロファイルを作成するか、デフォルトの設定を変更します。In...

Spring

Springファセットの設定:この機能はUltimateエディションでのみサポートされています。プロジェクトでSpringを使用するには、Spring固有の設定を構成するためのライブラリーとUI要素で構成されるSpringファセットが必要です。IntelliJ IDEAはコード内のSpring構成を...

Struts 2

この機能はUltimateエディションでのみサポートされています。IntelliJ IDEAは、Java EEおよびWebアプリケーションを作成するためのStruts 2フレームワークとの統合をサポートします。専用のWebファセットに基づいて、特定のモジュール構造とWebアプリケーションデプロイ記述...