• Spring Boot Dependenciesを3.2.2へ更新

  • Spring Frameworkを6.1.3へ更新

  • Spring Securityを6.2.1へ更新

  • Spring Dateを3.2.2へ更新

  • Hibernate ORMを6.4.1.Finalへ更新

• MyBatisを3.5.15、MyBatis Springを3.0.3へ更新

• 共通ライブラリのライブラリ及びMavenプラグインのバージョンを変更

  • [#1246] update cargo-maven3-plugin version

  • [#1272] Update the library version

  • [#1275] Apply Spring Boot 3.2.2

  • [#1287] update JaCoCo Maven Plugin

• ブランクプロジェクトのライブラリ及びMavenプラグインのバージョンを変更

  • [single#583] [multi#637] update boot to 3.2.0

  • [single#592] [multi#648] Update the library version

  • [single#594] [multi#650] Set parameters to guess the parameter name

• Thymeleafを使用したブランクプロジェクトを生成できるよう修正

  • [single#553] [multi#605] Added materials for Thymeleaf

• JavaConfigを使用したブランクプロジェクトを生成できるよう修正

  • [single#567] [multi#619] HandlerExceptionResolverLoggingInterceptor does not work in JavaConfing

  • [single#577] [multi#632] The JavaConfig description method has been changed

  • [single#585] [multi#639] The JavaConfig description method has been unified

  • [single#598] [multi#654] Corrected withDefault settings

ViewとConfigrationの追加に伴いアーキタイプを新規追加しました。
詳しくは single blank、 multi blank を参照してください。

TERASOLUNA 5.8.1.RELEASEからJakartaEEのバージョンが上がったことにより、Tilesが使用できなくなりました。その影響により、JSPでTilesによる画面レイアウトができなくなっています。画面レイアウトが可能なViewを提供する目的で、ThymeleafをViewに追加しています。

JSPからThymeleafへの移行手順についてはJPSからThymeleafへの移行手順を参照してください。
この手順はXMLConfigのJSPからXMLConfigのThymeleafへの移行手順となります。XMLConfigのJSPからJavaConfigのThymeleafへの移行を行いたい場合は、XMLConfigからJavaConfigへの移行手順よりも先にJPSからThymeleafへの移行手順を実施してください。

Spring FrameworkがJavaConfigをメインで更新しており、徐々にXMLConfigがメンテナンスされなくなっています。TERASOLUNAにおいてもSpring Frameworkの開発動向に合わせJavaConfigに関するコンテンツを追加しました。
5.9.0.RELEASEではJavaConfigとXMLConfigについて対応していますが、XMLConfigに関しては次版以降削除する可能性があります。

XMLConfigからJavaConfigへの移行手順についてはXMLConfigからJavaConfigへの移行手順を参照してください。

TERASOLUNA Server Framework for Java (5.x)の共通ライブラリと依存ライブラリを更新してください。
以下に、この手順により更新される代表的な依存ライブラリを示します。

[手順が必要なケース]

この手順の適用は必須です。

Parameter Name Retention に記載されている通り、Spring Framewrok 6.1 からLocalVariableTableParameterNameDiscovererが削除されました。この影響によりバイトコードによるパラメータ名の推測がされなくなりましたが、Spring系の各機能は名前解決を前提とした作りとなっています。そのため、Java 8+のオプションである-parametersを使用しコンパイルする必要があります。
-parametersを設定しない場合、 Parameter Name Retention に記載されている通り、パラメータ名に依存した様々なケースで問題が発生する可能性があるため、5.9.0.RELEASEのブランクプロジェクトではデフォルトで設定しています。

[手順が必要なケース]

この手順の適用は必須です。

[修正方法]

pom.xmlに記載しているApache Maven Compiler Pluginにオプションを設定します。

• ($YOUR_PROJECT_ROOT/pom.xml)

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <configuration>
          <parameters>true</parameters> <!-- ### 追加箇所 ### -->
          <annotationProcessorPaths>
              <path>
                  <groupId>org.mapstruct</groupId>
                  <artifactId>mapstruct-processor</artifactId>
                  <version>${mapstruct.version}</version>
              </path>
              <!-- REMOVE THIS LINE IF YOU USE MapStruct AND Lombok
              <path>
                  <groupId>org.projectlombok</groupId>
                  <artifactId>lombok</artifactId>
                  <version>${lombok.version}</version>
              </path>
              <path>
                  <groupId>org.projectlombok</groupId>
                  <artifactId>lombok-mapstruct-binding</artifactId>
                  <version>${lombok-mapstruct-binding.version}</version>
              </path>
              REMOVE THIS LINE IF YOU USE MapStruct AND Lombok -->
          </annotationProcessorPaths>
          <compilerArgs>
              <arg>-Amapstruct.defaultComponentModel=spring</arg>
          </compilerArgs>
      </configuration>
  </plugin>

blankプロジェクトにfooter.jspを追加しました。

[手順が必要なケース]

この手順の適用は任意です。

[修正方法]

マルチブランクプロジェクト を例に説明します。

1. footer.jspを作成

   layoutフォルダ配下にfooter.jspを作成します。

   以下は ガイドラインに記載のfooter.jspの例 となります。

   • ($YOUR_PROJECT/src/main/webapp/WEB-INF/views/layout/footer.jsp)

     <p style="text-align: center; background: #e5eCf9;">Copyright &copy; 20XX CompanyName</p>

2. footer.jspの読み込み

   footer.jspを読み込むJSPでincludeします。

   以下は ガイドラインに記載のfooter.jspを読み込むJSPの例 となります。

   <jsp:include page="../layout/header.jsp" />
   <div id="wrapper">
       <h1 id="title">Hello world!</h1>
       <p>The time on the server is ${serverTime}.</p>
   </div>
   <!-- ### 追加箇所 開始 ### -->
   <hr>
   <jsp:include page="../layout/fotter.jsp" />
   <!-- ### 追加箇所 終了 ### -->

XMLConfigベースのブランクプロジェクトにaop:aspectj-autoproxyを追加しました。
XMLConfigベースのブランクプロジェクトではアノテーションベースのAOPは必須ではありませんが、ConfigrationにJavaConfigを追加する対応の一環で、アノテーションベースのAOPを有効にするためweb層にEnableAspectJAutoProxyを追加しています。JavaConfigとXMLConfigの設定を統一する目的で、XMLConfigベースのブランクプロジェクトにもaop:aspectj-autoproxyを追加しました。

[手順が必要なケース]

この手順の適用は任意です。

[修正方法]

applicationContext.xmlおよびspring-mvc.xmlにaop:aspectj-autoproxyを追加します。

• ($YOUR_PROJECT/src/main/resources/META-INF/spring/applicationContext.xml)

  <?xml version="1.0" encoding="UTF-8"?>
  <beans xmlns="http://www.springframework.org/schema/beans"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:context="http://www.springframework.org/schema/context"
      xmlns:aop="http://www.springframework.org/schema/aop" <!-- ### 追加箇所 ### -->
      xsi:schemaLocation="
          http://www.springframework.org/schema/beans https://www.springframework.org/schema/beans/spring-beans.xsd
          http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd
          http://www.springframework.org/schema/aop https://www.springframework.org/schema/aop/spring-aop.xsd <!-- ### 追加箇所 ### -->
      ">
  
      <!-- omitted -->
  
      <aop:aspectj-autoproxy /> <!-- ### 追加箇所 ### -->
  
      <!-- omitted -->
  
  </beans>

• ($YOUR_PROJECT/src/main/resources/META-INF/spring/spring-mvc.xml)

  <?xml version="1.0" encoding="UTF-8"?>
  <beans xmlns="http://www.springframework.org/schema/beans"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:context="http://www.springframework.org/schema/context"
      xmlns:mvc="http://www.springframework.org/schema/mvc"
      xmlns:util="http://www.springframework.org/schema/util"
      xmlns:aop="http://www.springframework.org/schema/aop"
      xsi:schemaLocation="http://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd
          http://www.springframework.org/schema/beans https://www.springframework.org/schema/beans/spring-beans.xsd
          http://www.springframework.org/schema/util https://www.springframework.org/schema/util/spring-util.xsd
          http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd
          http://www.springframework.org/schema/aop https://www.springframework.org/schema/aop/spring-aop.xsd
      ">
  
      <!-- omitted -->
  
      <aop:aspectj-autoproxy /> <!-- ### 追加箇所 ### -->
  
      <!-- omitted -->
  
  </beans>

blankプロジェクトのPOMにwebdrivermanagerの依存関係を追加しました。

[手順が必要なケース]

この手順の適用は任意です。
seleniumを使用した試験を実施しない場合は適用する必要はありません。

[修正方法]

• Maven Multiple Projectsを利用している場合
  この更新手順は、 multi blank を使用して作成したマルチプロジェクト向けです。

  親プロジェクトのPOMファイルにwebdrivermanagerを追加してください。

  • ($YOUR_MULTIPLE_PROJECT_ROOT/pom.xml)

        <dependencyManagement>
            <dependencies>
                <!-- omitted -->
                <!-- == Begin Unit Test == -->
                <dependency>
                    <groupId>junit</groupId>
                    <artifactId>junit</artifactId>
                    <scope>test</scope>
                </dependency>
                <!-- ### 追加箇所 開始 ### -->
                <dependency>
                    <groupId>io.github.bonigarcia</groupId>
                    <artifactId>webdrivermanager</artifactId>
                    <version>${webdrivermanager.version}</version>
                    <scope>test</scope>
                </dependency>
                <!-- ### 追加箇所 終了 ### -->
                <dependency>
                    <groupId>org.mockito</groupId>
                    <artifactId>mockito-core</artifactId>
                    <scope>test</scope>
                </dependency>
                <!-- omitted -->
            </dependencies>
        </dependencyManagement>
    
        <properties>
            <!-- omitted -->
            <webdrivermanager.version>5.6.3</webdrivermanager.version> <!-- ### 追加箇所 ### -->
            <!-- omitted -->
        </properties>

• Maven Single Projectを利用している場合
  この更新手順は、 single blank を使用して作成したシングルプロジェクト向けです。

  プロジェクトのPOMファイルにwebdrivermanagerを追加してください。

  • ($YOUR_SINGLE_PROJECT/pom.xml)

        <dependencies>
            <!-- omitted -->
            <!-- == Begin Unit Test == -->
            <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
                <scope>test</scope>
            </dependency>
            <!-- ### 追加箇所 開始 ### -->
            <dependency>
                <groupId>io.github.bonigarcia</groupId>
                <artifactId>webdrivermanager</artifactId>
                <version>${webdrivermanager.version}</version>
                <scope>test</scope>
            </dependency>
            <!-- ### 追加箇所 終了 ### -->
            <dependency>
                <groupId>org.mockito</groupId>
                <artifactId>mockito-core</artifactId>
                <scope>test</scope>
            </dependency>
            <!-- omitted -->
        </dependencies>
    
        <properties>
            <!-- omitted -->
            <webdrivermanager.version>5.6.3</webdrivermanager.version> <!-- ### 追加箇所 ### -->
            <!-- omitted -->
        </properties>

Spring Framework 6.1 から SimpleClientHttpRequestFactory#setConnectTimeout(Duration) や SimpleClientHttpRequestFactory#setReadTimeout(Duration) メソッドが追加されたことにより、XMLConfigでパラメータを設定する際に誤ったSetterにマッピングされてしまう事象が確認されています。なお、JavaConfigでは問題なく動作します。
当問題については Spring#31872 がcloseされていますが問題は解消されておらず、Spring Framework 6.1.4 以降の Spring#32159 および Spring#32329 で対応されています。当フレームワークが使用するSpring Frameworkのバージョンは6.1.3であり、想定外のSetterが使われる事象は解消されていないため、FactoryBeanを使用してJavaクラスでSetterを呼び出してください。

[手順が必要なケース]

この手順の適用は条件付き必須です。
以下の両方のケースに当てはまる場合、修正を行ってください。

• SimpleClientHttpRequestFactoryをXMLConfigでBean定義している

• setConnectTimeout(int)またはsetReadTimeout(int)を設定している

[修正方法]

SimpleClientHttpRequestFactoryをFactoryBean経由でBean定義します。
詳しくは 通信タイムアウトの設定のXML Configタグ を参照してください。

「HTTP Proxyサーバの指定方法」のXML Configタグ に記載のとおり、引数の数が等しいコンストラクタが存在する場合、想定していないコンストラクタが使用されるケースが存在しています。これは LocalVariableTableParameterNameDiscovererが削除されたことに伴う対応 に記載した通り、-parameterを設定していない場合に変数の名前を解決しなくなったことが原因ですが、HttpHostのように3rd-party製のライブラリが-parameterを設定せずにビルドしている場合は名前解決ができない状態のままとなっています。

[手順が必要なケース]

この手順の適用は条件付き必須です。
以下のケースに当てはまる場合、修正を行ってください。

• 3rd-party製のAPIで、オーバーロードされたコンストラクタを使用しており、誤ったコンストラクタが使用される場合

[修正方法]

コンストラクタ引数にtype属性を付与し、型を指定することで使用するコンストラクタを一意に特定できるようにします。
修正例は 「HTTP Proxyサーバの指定方法」のXML Configタグ を参照してください。

Tomcat 10.1.8 から RFC9239 に準拠するよう変更されました。この影響により、text/ecmascript、application/javascript、application/ecmascriptが非公開となりtext/javascriptが返却されるようになります。

[手順が必要なケース]

この手順の適用は条件付き必須です。
以下のケースに当てはまる場合、修正を行ってください。

• リクエストを受け取るアプリケーションサーバにTomcat 10.1.8以上のバージョンを使用している

• Content-Typeヘッダにtext/ecmascript、application/javascript、application/ecmascriptのいずれかを指定している

[修正方法]

Content-Typeヘッダに指定する値をtext/javascriptに変更する。

Web Applications に記載されている通り、Spring Framewrok 6.1 からRestTemplateを使用した通信ではContent-Lengthヘッダが設定されないよう修正されました。
Content-Lengthヘッダを設定したい場合は、使用しているClientHttpRequestFactoryを BufferingClientHttpRequestFactory でラップする必要があります。

[手順が必要なケース]

この手順の適用は任意です。

[修正方法]

ClientHttpRequestFactoryをBufferingClientHttpRequestFactoryでラップしてください。
以下は、SimpleClientHttpRequestFactoryを使用する場合の例となります。

リクエストパラメータが誤っている場合にスローされる例外がBindExceptionからMethodArgumentNotValidExceptionに変更されました。

[手順が必要なケース]

この手順の適用は任意です。

[修正方法]

MethodArgumentNotValidExceptionはBindExceptionのサブクラスであるため、BindExceptionをハンドリングしていればMethodArgumentNotValidExceptionがスローされた際にもハンドリングはされますが、より厳密にハンドリングを実施するためにはBindExceptionからMethodArgumentNotValidExceptionへ修正してください。

Spring Framework 6.0 から下記のAPIが非推奨となりました。

• CookieLocaleResolver#setCookieName(String)メソッド

• CookieLocaleResolver#setCookieMaxAge(Integer)メソッド

• CookieGeneratorクラス

[手順が必要なケース]

この手順の適用を推奨します。
以下のケースに当てはまる場合、必要に応じて修正を行ってください。

• 上記の非推奨APIを利用している

[修正方法]

Javadocを参考に、非推奨APIを代替APIに置き換えてください。

• CookieLocaleResolver#dsetCookieName(String) メソッド

• CookieLocaleResolver#setCookieMaxAge(Integer) メソッド

• CookieGenerator クラス

Spring Security 6.0 および 6.1 から下記のAPIが非推奨となりました。

• Pbkdf2PasswordEncoder(CharSequence, int, int, int)コンストラクタ

• <global-method-security/>タグ

[手順が必要なケース]

この手順の適用を推奨します。
以下のケースに当てはまる場合、必要に応じて修正を行ってください。

• 上記の非推奨APIを利用している

[修正方法]

Spring Security DocumentやJavadocを参考に、非推奨APIを代替APIに置き換えてください。

• Pbkdf2PasswordEncoder(CharSequence, int, int, int) コンストラクタ

• How Method Security Works

Apache Commons DBCP 2.10.0 から下記のAPIが非推奨となりました。

• BasicDataSource#setMaxWaitMillis(long)メソッド

[手順が必要なケース]

この手順の適用を推奨します。
以下のケースに当てはまる場合、必要に応じて修正を行ってください。

• 上記の非推奨APIを利用している

[修正方法]

Javadocを参考に、非推奨APIを代替APIに置き換えてください。

• BasicDataSource#setMaxWaitMillis(long) メソッド

Hibernate ORM 6.3 から下記のAPIが非推奨となりました。

• @Whereアノテーション

[手順が必要なケース]

この手順の適用を推奨します。
以下のケースに当てはまる場合、必要に応じて修正を行ってください。

• 上記の非推奨APIを利用している

[修正方法]

Javadocを参考に、非推奨APIを代替APIに置き換えてください。

• Where アノテーション

JSP関連の依存関係を削除し、Thymeleaf関連の依存関係を追加します。

• todo-web/pom.xml

• todo-web/src/main/resources/META-INF/spring/spring-mvc.xml

  JSP関連の設定を削除し、Thymeleaf関連の設定を追加します。

• todo-web/src/main/resources/META-INF/spring/spring-security.xml

  thymeleafでは直接viewファイルを参照させず、Controllerを経由させます。

thymeleafでは直接viewファイルを参照させず、Controllerを経由させます。
以下のクラスを追加します。

• todo-web/src/main/java/com/example/todo/app/common/error/CommonErrorController.java

thymeleafでは直接viewファイルを参照させず、Controllerを経由させます。

• todo-web/src/main/webapp/WEB-INF/web.xml

unhandledSystemError.htmlはテンプレートHTMLではなく静的HTMLのため、直接参照させて問題ありません。

テンプレートエンジン(Thymeleaf) や Thymeleafにおける画面レイアウト 、関連機能を参考にJSPファイルをテンプレートHTMLへ修正してください。

この更新手順は、 multi blank を使用して作成したマルチプロジェクト向けです。

この更新手順は、 single blank を使用して作成したシングルプロジェクト向けです。