• Spring Framework 5.3.39へ更新

• Spring Security 5.7.13へ更新

• MyBatis 3.5.17へ更新

TARASOLUNAが使用するOSSライブラリのバージョンを一元管理するため、TERASOLUNA BOMを新規作成しました。

• terasoluna-dependencies

今まで terasoluna-gfw-parent で定義していたOSSライブラリのバージョンを terasoluna-dependencies に移動し、 terasoluna-gfw-parent は terasoluna-dependencies を継承する形に変更しました。
terasoluna-dependencies は terasoluna-gfw-parent から参照されるため、ユーザ側での変更は不要です。

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

  • [#1370] remove dependency definitions when creating a bom project

  • [#1375] terasoluna-gfw-security-web still depends on jsp.

  • [#1386] update to maven-dependency-plugin.

• 機能変更

  • [#1326] Add options to SystemExceptionResoluver

  • [#1336] The URL of the link generated by f:link is incorrect.

  • [#1383] Remove the snapshot repository settings from pom.xml.

• 機能改善

  • [single#647] [multi#707] Need to override <developers> and <scm> on pom.xml

• logbackの設定変更

  • [single#620] [multi#680] Resolve logback warnings

  • [single#622] [multi#682] Update Hibernate log output settings

• Servletバージョンの変更

  • [single#637] [multi#697] [5.7.x] Set the servlet version to 4.0.

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

[手順が必要なケース]

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

予期せずSnapshotバージョンのライブラリを使用することを防ぐため、terasoluna-gfw-parentで定義していたSnapshot Repositoryを削除しました。

[手順が必要なケース]

この手順の適用は任意です。
Snapshot Repositoryが必要な場合は本手順を適用してください。

[修正方法]

本手順は、terasoluna-gfw-parentに設定されていたSnapshot Repositoryを使用していたユーザ向けです。
以下2つの対応方法について説明します。

1. settings.xmlを修正する場合【推奨】

2. pom.xmlを修正する場合

共通ライブラリが管理するMaven Dependency Pluginプラグインを更新しました。

更新されたプラグインのバージョンについては、以下を参照してください。

変更前 : terasoluna-gfw-parent 5.7.3.RELEASEのpom.xml

変更後 : terasoluna-gfw-parent 5.7.4.RELEASEのpom.xml

[手順が必要なケース]

以下のケースに当てはまる場合、ビルドの挙動を確認して必要に応じて修正を行ってください。

• 共通ライブラリが提供するプラグインのバージョンから変更したい場合

[修正方法]

仕様の詳細はMaven Dependency Pluginを参照して下さい。

なお、terasoluna-gfw-parentで定義しているプラグインのバージョンを変更したい場合は、terasoluna-gfw-parentのpom.xmlに定義されたプロパティを自アプリのpom.xmlで上書きします。 例えば Maven Dependency Plugin のバージョンを戻す場合は以下のように定義します。

• ($YOUR_PROJECT/pom.xml)

ブランクプロジェクトで以下のライブラリについてバージョンを固定値で設定していましたが、terasoluna-dependenciesで管理するよう変更しました。

• io.github.bonigarcia:webdrivermanager

• org.apache.httpcomponents.client5:httpclient5

• org.mockito:dbunit

• com.github.springtestdbunit:spring-test-dbunit

[手順が必要なケース]

本手順は任意です。
プロジェクト側でバージョン定義せずにTERASOLUNAが提供するライブラリのバージョンに従う場合は、バージョン定義を削除してください。

[修正方法]

POMファイルからバージョン定義情報を削除してください。

• ($YOUR_MULTIPLE_PROJECT_ROOT/pom.xml)

• ($YOUR_SINGLE_PROJECT/pom.xml)

本手順を実施した場合、ライブラリのバージョンはそれぞれ以下のようになります。

Oracle公式のFAQ(What are the Oracle JDBC releases Vs JDK versions?)に記載されているOracle DatabaseとJDKの対応表に従い、TERASOLUNAが使用するojdbcのバージョンを更新しました。

[手順が必要なケース]

本手順は任意です。
Oracle Databaseを使用している場合は、使用するJDKバージョンとデータベースのバージョンに合わせ、適切に設定してください。

[修正方法]

下記POMファイルに記載しているojdbcの設定を修正してください。

• ($YOUR_MULTIPLE_PROJECT_ROOT/pom.xml)

• ($YOUR_SINGLE_PROJECT/pom.xml)

以下のソースコード例は、TERASOLUNAの試験環境で使用しているバージョンに合わせた例です。使用するJDKバージョンとデータベースのバージョンに合わせ、適切に設定してください。

• JDK8、JDK11の場合

• JDK17、JDK21の場合

ブランクプロジェクトではServletバージョン3.0を使用していましたが、Tomcat 9.0.xがサポートするServletバージョン4.0に合わせて、バージョンを更新しました。

[手順が必要なケース]

この手順の適用を推奨します。

[修正方法]

web.xml のスキーマで定義されているServlet3.0の記述を、Servlet4.0に修正してください。

• web.xml

terasoluna-gfw-web-securityにJSPに関する不要なライブラリが設定されていたため、Servlet APIを設定するように修正しました。

• 修正前

  <dependency>
      <groupId>org.apache.tomcat</groupId>
      <artifactId>tomcat-jsp-api</artifactId>
      <scope>provided</scope>
  </dependency>

• 修正後

  <dependency>
      <groupId>jakarta.servlet</groupId>
      <artifactId>jakarta.servlet-api</artifactId>
      <scope>provided</scope>
  </dependency>

[手順が必要なケース]

JSPに関するライブラリはterasoluna-gfw-web-jspで定義されているため、本修正に伴う対応は特にありませんが、JSP関連でエラーが出る場合は依存関係の見直しを行ってください。

logback.xmlにJPAのログを出力する設定がありましたが、JPAのパッケージ名の変更に伴いログが出力されていませんでした。そのため、ブランクプロジェクトのlogback.xmlの当該設定を修正しています。

[手順が必要なケース]

JPAを使用している場合、この手順の適用を推奨します。

[修正方法]

logback.xmlの設定を修正してください。

logback.xmlの修正は本手順以外にlogbackの非推奨な記述を修正にも記載していますので、合わせて参照してください。

pom.xmlに記載するプロジェクト情報は、明示的に設定しない場合parentの情報が設定されます。TERASOLUNAが提供するブランクプロジェクトも、バージョンアップ前は開発者要素（developers）およびソース管理システム要素（scm）が設定されていなかったため、terasoluna-gfw-parentに記載された情報を参照していました。 そのため、開発者が明示的にプロジェクト情報を意識できるようにするため、ブランクプロジェクトに開発者要素およびソース管理システム要素を追加しました。

プロジェクト情報はユーザ側で適切に変更する必要があります。
詳しくは、プロジェクト情報を参照してください。

[手順が必要なケース]

以下のケースに当てはまる場合、必ず修正を行ってください。

• プロジェクト側でdevelopers要素およびscm要素を設定していない

[修正方法]

POMファイルにdevelopers要素およびscm要素を追加し、プロジェクト側で適切に情報を設定してください。また、developers要素およびscm要素以外の要素についてもプロジェクト側で適切に設定する必要がある点に注意してください。
以下のコード例は、ブランクプロジェクトに生成時に設定されているプロジェクト情報です。

• ($YOUR_MULTIPLE_PROJECT_ROOT/pom.xml)

• ($YOUR_SINGLE_PROJECT/pom.xml)

ブランクプロジェクトのlogback.xmlではlevelタグを使用してログレベルを指定していたため、以下のWARNログが出力されていました。

[手順が必要なケース]

この手順の適用を推奨します。

[修正方法]

Logback configurationに記載されているとおり、loggerタグのlevel属性を指定するように修正してください。
なお、これ以外にも非推奨な記述方法や、推奨される記述方法があるため、Logback error messages and their meaningsを参照し適切に修正することを推奨します。

• 修正前

  <logger name="xxxxxx.yyyyyy.zzzzzz">
      <level value="debug" />
  </logger>

• 修正後

  <logger name="xxxxxx.yyyyyy.zzzzzz" level="debug" />

共通ライブラリで提供しているSystemExceptionResolverに、以下2つの機能を追加しました。

• 指定した例外のサブクラスも対象とするオプションの追加

• causeに設定された例外を確認するオプションの追加

これらのオプションを使用することにより、より柔軟に例外ハンドリングを行うことが可能になります。なお、デフォルトの設定はfalseとなっているため、明示的に変更しない限り挙動に変更はありません。

[使用方法]

それぞれの機能を利用する場合、以下のように SystemExceptionResolver の設定で checkCause および checkSubClass を true に設定してください。
詳細はガイドラインの原因例外の除外対象確認の有無およびサブクラスの除外対象確認の有無を参照してください。

• spring-mvc.xml

共通ライブラリが提供するJSP Tagのf:linkについてRFC 3986に準拠するよう修正しました。
この機能変更により、例えば以下のような#フラグメント付きのリンクが正しく生成されるようになります。

• バージョンアップ前

  ${f:link("http://aaa/bbb#flagment")}
  →
  <a href="http://aaa/bbb">http://aaa/bbb</a>#flagment

• バージョンアップ後

  ${f:link("http://aaa/bbb#flagment")}
  →
  <a href="http://aaa/bbb#flagment">http://aaa/bbb#flagment</a>

[使用方法]

JSPでハイパーリンクを作成する際にご活用ください。

共通ライブラリではf:link以外にもJSP Tagを提供していますので、詳しくはガイドライン（共通ライブラリが提供するJSP Tag Library と EL Functions）を参照してください。