Spring Module のバージョン 2.0 へのアップグレードおよび移行

Spring Module をバージョン 2.x にアップグレードします。

サポートされているアップグレードパス

開始バージョン 終了バージョン

1.x

2.x

このリリースでの変更

Spring Module 2.0 には次の変更内容が含まれます。

  • Spring Module (およびその連動関係) が Java 17 のみと互換性があるようになりました。

  • 最新の開発プラクティスに沿い、引き続きセキュアでサポートされているライブラリとの互換性を保てるように、Spring Module は Spring 5.x から Spring 6.x にアップグレードされます。

  • DSL に関する検証の問題を解決できるように、​spring:security-manager​ 要素の構造が更新されます。以前は、​delegate-security-providers​ を直接 ​spring:security-manager​ 内で定義することができました。すべての ​spring:delegate-security-provider​ 要素を新しい ​spring:delegate-security-providers​ 要素内にラップする必要があるようになりました。

    • 以前の構造 (サポートされなくなりました):

      <spring:security-manager doc:name="Spring Security Manager">
         <spring:delegate-security-provider name="memory-provider" delegate-ref="authenticationManager" />
      </spring:security-manager>
    • 新しい構造 (必須):

      <spring:security-manager doc:name="Spring Security Manager">
         <spring:delegate-security-providers>
           <spring:delegate-security-provider name="memory-provider" delegate-ref="authenticationManager" />
         </spring:delegate-security-providers>
      </spring:security-manager>

アップグレード前提条件

アップグレードを実行する前に、復元する必要がある場合に備えて、ファイル、データ、および設定のバックアップを作成する必要があります。

アップグレード手順

以下の手順でアップグレードを実行します。

  1. Anypoint Studio で、プロジェクトを右クリックし、​[Manage Dependencies (連動関係の管理)]​ > ​[Manage Modules (モジュールを管理)]​ を選択します。

  2. [Spring Module - Mule 4]​ を選択し、​[Update version (バージョンを更新)]​ をクリックします。

  3. [Apply and Close (適用して閉じる)]​ をクリックします。

  4. Mule プロジェクトの ​pom.xml​ ファイルで Spring Module 連動関係のバージョンが ​2.0.0​ であることを確認します。

または、Mule プロジェクトの ​pom.xml​ ファイルで Spring Module 連動関係を手動で更新するか、単に更新済みのモジュールをプロジェクトに追加することもできます。

アップグレードを確認する

コネクタをアップグレードしたら、次の手順に従ってアップグレードを検証します。

  1. Studio の ​[Problems (問題)]​ または ​[Console (コンソール)]​ ビューでエラーがないことを確認します。

  2. プロジェクトの ​pom.xml​ ファイルに問題がないことを確認します。

  3. 接続をテストして、操作が機能することを確認します。

トラブルシューティング

パラメーターのキャッシュおよびメタデータのキャッシュで問題がある場合、Anypoint Studio の再起動をお試しください。

アップグレードの復元

前のバージョンの Spring Module に戻す必要がある場合、プロジェクトの ​pom.xml​ で Spring Module 連動関係バージョン ​2.0.0​ を前のバージョンに変更します。

Anypoint Studio でプロジェクトの ​pom.xml​ を更新する必要があります。