IntelliJ IDEA 2026.1 Help

OpenRewrite

OpenRewrite プラグインをインストールする

この機能は、インストールして有効化する必要がある OpenRewrite プラグインに依存しています。

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。

  2. Marketplace タブを開き、 OpenRewrite プラグインを見つけて、 インストール をクリックします（プロンプトが表示されたら、IDE を再起動します）。

OpenRewrite(英語) は、一般的なフレームワークの移行、セキュリティ修正、スタイルの一貫性タスクの レシピを実行するためのツールです。 例: ビルドファイルの変更、非推奨の API の変更、構成設定の移行によって、新しいフレームワークバージョンへの移行を自動化できます。

Gradle および Maven プロジェクトでは、IntelliJ IDEA はコーディング支援、専用の実行構成、OpenRewrite レシピの作成と実行のプロセスを容易にするように設計されたアクションなど、OpenRewrite との統合を提供します。

OpenRewrite レシピを作成する

  1. プロジェクト ツールウィンドウで、フォルダーを右クリック (または Alt+Insert を押す) して、 新規 | OpenRewrite レシピ を選択します。

  2. 開いた 新規 OpenRewrite レシピ ダイアログで、新しいレシピファイルの名前を入力し、 Enter を押します。

    これにより、専用の ファイルテンプレートに基づいて新しいレシピファイルが作成されます。

  3. 完全に修飾された一意の name を指定し、 recipeList に、追加するレシピの名前の入力を開始します。

    IntelliJ IDEA は、既知のレシピ名の自動補完、ドキュメントのクイック検索、レシピの説明にヒントを組み込む機能などを含む OpenRewrite コーディング支援を提供します。

OpenRewrite のサポート

OpenRewrite レシピを実行する

  1. OpenRewrite レシピファイルを開きます。

  2. ガターで、 The Run icon をクリックします。

実行出力は 実行 ツールウィンドウで確認できます。

移行が完了したら、 変更の表示 をクリックして変更されたファイルの一覧をプレビューします。 いずれかのファイルをクリックすると、どのような変更が加えられたかが表示されます。

レシピの変更を表示

レシピを初めて実行する場合、IntelliJ IDEA は カスタマイズ可能な一時的な実行構成を作成します。

組み込みの移行レシピを実行する

一部のフレームワークでは、IntelliJ IDEA はビルドファイルから直接実行できる移行レシピを提供しているため、レシピを手動で記述する手間が省けます。 これは、Spring バージョン 3 未満、Quarkus バージョン 2 未満、および Micronaut バージョン 3 以下で利用できます。

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

  2. エディターの右側のツールバーにある OpenRewrite アイコン OpenRewrite icon をクリックします。

    または、 プロジェクト ツールウィンドウでビルドファイルを右クリックし、 リファクタリング | OpenRewrite 移行の実行 を選択します。

  3. 開いたリストからレシピを選択します。

OpenRewrite レシピのリスト

これにより、選択した移行レシピが実行されます。

複雑なレシピを拡張する

レシピは 1 つの操作を表すことも、複数のレシピから構成されることもあります。 たとえば、 UpgradeSpringBoot_3_2 レシピには十数個以上の他のレシピが含まれています。Gradle や Maven の Spring Boot 依存関係バージョンのアップグレードに加えて、Spring Security、Spring Data の移行や API 要素の更新なども必要です。

IntelliJ IDEA を使用すると、より複雑なレシピの構成要素であるレシピを取得してプレビューできます。 これにより、たとえば、大規模な移行の一部を遅らせたい場合や、これらの変更を手動で実装したい場合に、特定のスタンドアロン操作を削除できます。

  1. OpenRewrite YAML ファイルで、レシピ名にキャレットを置き、 Alt+Enter (コンテキストアクションの表示) を押します。

  2. レシピのインライン化 を選択します。 レシピが他のレシピで構成されている場合、このアクションは使用できます。

    レシピのインライン化

OpenRewrite 実行構成

IntelliJ IDEA には専用の OpenRewrite 実行構成が付属しています。 ガターアイコン The Run icon を使用してレシピを初めて実行すると、IntelliJ IDEA によって一時的な実行構成が作成されます。

IntelliJ IDEA がレシピを起動する方法をカスタマイズする場合は、この実行構成を変更するか、新しい実行構成を作成できます： 実行 | 実行構成の編集 に移動するか、 Alt+Shift+F10 を押します。

OpenRewrite 実行構成

主なパラメーター

名前

実行構成の名前を指定してください。

プロジェクトファイルとして保存

他のチームメンバーと共有できるファイルに実行構成設定を保存します。 デフォルトの場所は .idea/runConfigurations です。 ただし、 .idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。

作業ディレクトリ

レシピを実行したいディレクトリ。

有効なレシピ

実行するレシピ。 名前の入力を始めると、ご自身のローカルレシピ名や OpenRewrite カタログから該当するレシピ名で補完が表示されます。

ログ

アプリケーションの実行中に生成されるログファイルのうち、 実行ツールウィンドウの専用タブのコンソールに表示するログファイルを指定します。

OpenRewrite の変更オプション

有効なスタイル

適用する OpenRewrite スタイル の一覧。 レシピと同様に、ローカルスタイルの名前を入力するか、名前の入力を始めると OpenRewrite カタログからスタイルの補完が表示されます。

構成の場所

OpenRewrite 構成ファイルのカスタムロケーションを指定します。

除外対象

OpenRewrite の処理から除外したいファイルやパスを指定します。たとえば、 **/internal/** です。

プレーンテキストマスク

プレーンテキストとして構文解析中のファイルを示すためのファイルマスクの設定。

OpenRewrite バージョン

使用する Maven/Gradle OpenRewrite プラグインのバージョンをカスタマイズします。

VM オプションの追加

アプリケーションの起動時に Java 仮想マシンに渡す VM オプションを指定します。

環境変数

OpenRewrite レシピ実行で使用する Maven ゴールまたは Gradle タスクの環境変数を設定します。

Dry run

dryRun タスク (英語) (Gradle の場合) または dryRun ゴール (英語) (Maven の場合) を実行して、実際にファイルを変更せずに、レシピによって行われる変更をプレビューします。

ドライランレポートへのパスは、 実行 ツールウィンドウで見つけることができます。

起動前

選択した実行 / デバッグ構成を開始する前に実行するタスクを選択します。

2026 年 3 月 30 日
メッセージキューReactive Streams