この更新手順は、Mavenをオンライン環境で使用しているプロジェクト向けです。

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

  親プロジェクトのPOMファイルのversionを5.8.1.RELEASEに修正してください。
  

  • ($YOUR_MULTIPLE_PROJECT_ROOT/pom.xml)

    <!-- omitted -->
    <parent>
        <groupId>org.terasoluna.gfw</groupId>
        <artifactId>terasoluna-gfw-parent</artifactId>
        <version>5.8.1.RELEASE</version>                    <!-- ### 修正箇所 ### -->
    </parent>
    <!-- omitted -->

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

  プロジェクトのPOMファイルのversionを5.8.1.RELEASEに修正してください。

  • ($YOUR_SINGLE_PROJECT/pom.xml)

    <!-- omitted -->
    <parent>
        <groupId>org.terasoluna.gfw</groupId>
        <artifactId>terasoluna-gfw-parent</artifactId>
        <version>5.8.1.RELEASE</version>                    <!-- ### 修正箇所 ### -->
    </parent>
    <!-- omitted -->

この更新手順は、依存ライブラリをインターネットにつながる環境でダウンロードし、ダウンロードした依存ライブラリをオフライン環境のプロジェクトに展開することで、Mavenをオフライン環境で使用しているプロジェクト向けです。

以下に記載する手順を実施してください。

1. オンライン環境

   1. ブランクプロジェクトを作成
      ガイドラインの記述を参考に、archetype:generateを実行し、5.8.1.RELEASEのブランクプロジェクトを作成してください。
      

   2. 依存関係の追加
      現行アプリのpom.xmlを確認し、アプリ独自で設定しているdependencyをブランクプロジェクトのpom.xmlに追加してください。
      アプリ独自で設定しているdependencyが不明な場合は、現行アプリで採用しているバージョンのブランクプロジェクトも作成して比較してください。
      

   3. ローカルリポジトリへのダウンロード
      以下のコマンドを実行し、依存ライブラリおよびMavenビルドに必要となるライブラリやプラグイン等をローカルリポジトリ（repositoryディレクトリ）へダウンロードしてください。
      

      mvn -P warpack clean install -Dmaven.repo.local=repository
      mvn dependency:go-offline -Dmaven.repo.local=repository

2. オンライン環境⇒オフライン環境
   

   1. オフライン環境へのコピー
      repositoryをオフライン環境の「ユーザのホームディレクトリ/.m2」へコピーしてください。

3. オフライン環境

   1. POMの修正
      オフライン環境のプロジェクトにて、[Step 1-1]に記載されている内容と同様に、pom.xmlのバージョン表記を修正してください。

   2. ビルドの実行

      1. envモジュールのjarファイルをwarファイルに含めない場合
         以下のコマンドを実行してください。
         

         mvn -P warpack clean install

         xxx-env配下に移動し以下のコマンドを実行してください。

         mvn -P test-server clean package

      2. envモジュールのjarファイルをwarファイルに含める場合
         以下のコマンドを実行してください。
         

         mvn -P warpack-with-env,test-server clean package

認可処理フィルターのデフォルト設定がFilterSecurityInterceptorからAuthorizationFilterに変更されたことに伴い、デフォルトで定義されていたExpressionHandlerがDefaultWebSecurityExpressionHandlerからDefaultHttpSecurityExpressionHandlerに変更されました。これにより、画面項目で認可処理を行っている場合、DefaultWebSecurityExpressionHandlerをBean定義する必要があります。

[手順が必要なケース]

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

• アプリケーションの画面項目で認可処理を行っている

  例 : 以下の様にauthorizeタグを使用している場合
  
  <sec:authorize access="hasRole('ADMIN')">
      <%-- omitted --%>
  </sec:authorize>

[修正方法]

spring-security.xmlにorg.springframework.security.web.access.expression.DefaultWebSecurityExpressionHandlerをwebexpressionHandlerの名前でBean定義します。

• spring-security.xml

  <bean id="webexpressionHandler" class="org.springframework.security.web.access.expression.DefaultWebSecurityExpressionHandler" /> <!-- ### 追加箇所 ### -->

AuthorizationFilterの脆弱性 CVE-2022-31692 への対応により、フォワード先でも認可処理が行われるように修正されていますが、デフォルトのDispatcherTypeはREQUESTのみが設定されているため、DispatcherTypeの見直しが必要になります。

[手順が必要なケース]

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

• 認可処理を必要とするパスに対しフォワードしている

[修正方法]

ガイドラインの web.xmlの<filter-mapping>には業務要件に応じて適切なDispatcherTypeを設定すること を参照し、業務要件に応じ適切なDispatcherTypeを設定してください。

データ移行が困難な場合は、デフォルトコンストラクタで設定していた値と同じ値を持つファクトリメソッドを使用します。
ただし、これらのファクトリメソッドは非推奨であるため、将来的に削除される可能性がある点に注意してください。

[修正方法]

デフォルトコンストラクタの代わりに、factory-methodを使用します。

• applicationContext.xml

  <!-- omitted -->
  <bean id="passwordEncoder" class="org.springframework.security.crypto.password.DelegatingPasswordEncoder">
      <constructor-arg name="idForEncode" value="pbkdf2" />
      <constructor-arg name="idToPasswordEncoder">
          <map>
              <entry key="pbkdf2">
                  <bean class="org.springframework.security.crypto.password.Pbkdf2PasswordEncoder" factory-method="defaultsForSpringSecurity_v5_5" /> <!-- ### 修正箇所 ### -->
              </entry>
              <entry key="bcrypt">
                  <bean class="org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder" />
              </entry>
              <entry key="argon2">
                  <bean class="org.springframework.security.crypto.argon2.Argon2PasswordEncoder" factory-method="defaultsForSpringSecurity_v5_2" /> <!-- ### 修正箇所 ### -->
              </entry>
              <entry key="scrypt">
                  <bean class="org.springframework.security.crypto.scrypt.SCryptPasswordEncoder" factory-method="defaultsForSpringSecurity_v4_1" /> <!-- ### 修正箇所 ### -->
              </entry>
          </map>
      </constructor-arg>
  </bean>
  <!-- omitted -->

既存の設定と新しい設定を併記することで、新規アカウント作成時もしくはパスワード変更時に新しい設定で値を作成することが可能となります。

[修正方法]

デフォルトコンストラクタの代わりに、factory-methodを使用します。

• applicationContext.xml

  <bean id="passwordEncoder" class="org.springframework.security.crypto.password.DelegatingPasswordEncoder">
      <constructor-arg name="idForEncode" value="pbkdf2@SpringSecurity_v5_8" /> <!-- ### 修正箇所 ### -->
      <constructor-arg name="idToPasswordEncoder">
          <map>
              <!-- ### 追加箇所 開始 ### -->
              <entry key="pbkdf2@SpringSecurity_v5_8">
                  <bean class="org.springframework.security.crypto.password.Pbkdf2PasswordEncoder" factory-method="defaultsForSpringSecurity_v5_8" />
              </entry>
              <entry key="argon2@SpringSecurity_v5_8">
                  <bean class="org.springframework.security.crypto.argon2.Argon2PasswordEncoder" factory-method="defaultsForSpringSecurity_v5_8" />
              </entry>
              <entry key="scrypt@SpringSecurity_v5_8">
                  <bean class="org.springframework.security.crypto.scrypt.SCryptPasswordEncoder" factory-method="defaultsForSpringSecurity_v5_8" />
              </entry>
              <!-- ### 追加箇所 終了 ### -->
              <entry key="pbkdf2">
                  <bean class="org.springframework.security.crypto.password.Pbkdf2PasswordEncoder" factory-method="defaultsForSpringSecurity_v5_5" /> <!-- ### 修正箇所 ### -->
              </entry>
              <entry key="bcrypt">
                  <bean class="org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder" />
              </entry>
              <entry key="argon2">
                  <bean class="org.springframework.security.crypto.argon2.Argon2PasswordEncoder" factory-method="defaultsForSpringSecurity_v5_2" /> <!-- ### 修正箇所 ### -->
              </entry>
              <entry key="scrypt">
                  <bean class="org.springframework.security.crypto.scrypt.SCryptPasswordEncoder" factory-method="defaultsForSpringSecurity_v4_1" /> <!-- ### 修正箇所 ### -->
              </entry>
          </map>
      </constructor-arg>
  </bean>

spring-mvc.xmlから、Tilesの設定を削除します。

• spring-mvc.xml

  <!-- omitted -->
  <mvc:view-resolvers>
      <mvc:bean-name />
      <mvc:tiles /> <!-- ### 削除対象 ### -->
      <mvc:jsp prefix="/WEB-INF/views/" />
  </mvc:view-resolvers>
  
  <!-- ### 削除対象 開始 ### -->
  <mvc:tiles-configurer>
      <mvc:definitions location="/WEB-INF/tiles/tiles-definitions.xml" />
  </mvc:tiles-configurer>
  <!-- ### 削除対象 終了 ### -->
  <!-- omitted -->

template.jspでTilesによって組み立てられていたJSPを実装し直します。
以下は、 ブランクプロジェクト(5.7.1.RELEASE)のtemplate.jsp を対象とした例となります。

• Tilesでレイアウトを行っている各JSP
  template.jspをベースに、各JSPファイルを修正します。

  template.jsp
  
  <%-- omitted --%>
  <body>
      <div class="container">
          <tiles:insertAttribute name="header" /> <%-- ### 修正対象 ### --%>
          <tiles:insertAttribute name="body" />   <%-- ### 修正対象 ### --%>
          <hr>
          <p style="text-align: center; background: #e5eCf9;">Copyright &copy; 20XX CompanyName</p>
      </div>
  </body>
  <%-- omitted --%>

  • tiles:insertAttributeでbodyをinsertしている箇所を各JSPの中身で置き換えます

  • tiles:insertAttributeでbody以外をinsertしている箇所を、jsp:includeで読み込むように修正します

  各JSPファイル（例 : home.jsp）
  
  <%-- omitted --%>
  <body>
      <div class="container">
          <jsp:include page="/WEB-INF/views/layout/header.jsp" /> <%-- ### 修正箇所 ### --%>
          <%-- ### JSPの中身で置換 開始 ### --%>
          <div id="wrapper">
              <h1 id="title">Hello world!</h1>
              <p>The time on the server is ${serverTime}.</p>
          </div>
          <%-- ### JSPの中身で置換 終了 ### --%>
          <hr>
          <p style="text-align: center; background: #e5eCf9;">Copyright &copy; 20XX CompanyName</p>
      </div>
  </body>
  <%-- omitted --%>

Tiles関連の設定を削除してください。
削除対象は以下の通りです。

• project-web/src/main/webapp/WEB-INF/tiles

• project-web/src/main/webapp/WEB-INF/views/layout/template.jsp

template.jspを増やしている場合は、そちらも削除してください。

Lombokを使用している場合と使用していない場合で設定内容が異なります。

MapStructはコンパイル時にMapperインタフェースから実装クラスを生成するコードジェネレータであるため、Mapperインタフェースの実装が必要になります。
Mapperインタフェースの記載方法についてはガイドラインの Beanマッピング(MapStruct) を参照してください。

作成したMapperインタフェースを呼び出すよう修正します。
以下は、ガイドラインの 11.1.4.2.3. Create TODOの実装 を例としています。

• TodoController.java

  import com.github.dozermapper.core.Mapper; // ### 削除箇所 ###
  
  // omitted
  
  @Controller
  @RequestMapping("todo")
  public class TodoController {
      @Inject
      TodoService todoService;
  
      @Inject
      TodoMapper beanMapper; // ### 修正箇所 ###
  
      // omitted
  
      @PostMapping("create")
      public String create(@Valid TodoForm todoForm, BindingResult bindingResult,
              Model model, RedirectAttributes attributes) {
  
         // omitted
  
         Todo todo = beanMapper.map(todoForm); // ### 修正箇所 ###
  
         // omitted
      }
  
      // omitted
  
  }

以下のフォルダを削除します。

• project-domain/src/main/resources/dozer

• project-web/src/main/resources/dozer

applicationContext.xmlからdozerの設定を削除します。

• project-env/src/main/resources/META-INF/spring/applicationContext.xml

  <!-- ### 削除箇所 開始 ### -->
  <bean class="com.github.dozermapper.spring.DozerBeanMapperFactoryBean">
      <property name="mappingFiles"
          value="classpath*:/META-INF/dozer/**/*-mapping.xml" />
  </bean>
  <!-- ### 削除箇所 終了 ### -->

以下の情報を参照し、適切なバージョンを設定してください。

• PostgreSQL
  

以降では、 TERASOLUNA Server Framework for Java 5.8.1.RELEASE の動作検証環境に合わせる形での変更方法を示します。

[修正方法]

pomファイルのプロパティを修正してください。

• pom.xml

Java のベースラインが17に変更されることに伴い、OJDBCの見直しが必要となります。

以下の情報を参照し、適切なバージョンを設定してください。

• What are the Oracle JDBC releases Vs JDK versions?

• What are the Oracle JDBC releases Vs JDBC specifications?

以降では、 TERASOLUNA Server Framework for Java 5.8.1.RELEASE の動作検証環境に合わせる形での変更方法を示します。

[修正方法]

アプリケーション内で使用するOJDBCのバージョンを修正してください。

• pom.xml

  <dependencyManagement>
      <dependencies>
      <!-- omitted -->
          <dependency>
              <groupId>com.oracle.jdbc</groupId>
              <artifactId>ojdbc11</artifactId> <!-- ### 修正箇所 ### -->
              <version>${ojdbc.version}</version>
          </dependency>
      <!- omitted -->
      </dependencies>
  </dependencyManagement>
  
  <properties>
      <!-- omitted -->
      <ojdbc.version>21.8.0.0</ojdbc.version> <!-- ### 修正箇所 ### -->
      <!-- omitted -->
  </properties>

以下の方法で修正してください。

• 末尾の/なしのリクエストを前提にリクエストパスの仕様を変更し、それに合わせてコントローラクラスのハンドラメソッドも修正する

以下のいずれかで修正します。

1. ハンドラメソッドを修正する

2. trailing-slashをtrueに設定する