Migration Guide 5.3.1_en - terasolunaorg/terasoluna-gfw GitHub Wiki

Migration guideline from 5.3.0 to 5.3.1

.. only:: html

 .. contents:: Index
    :depth: 2
    :local:

Major changes in 5.3.1

Major changes in 5.3.1 are as follows.

  • Changes in some of the specifications of common library

Changes in some of the specifications of common library

Some of the specifications of common library were changed from 5.3.1, in accordance with the bug fixing.

  • [#747] Wrong full width string in DefaultFullHalf

Procedure for migration from 5.3.0 to 5.3.1

Migration procedure is as follows.

Note

Notes

Required : Applying the procedure is mandatory
Required by case : Applying the procedure is mandatory under certain conditions
Optional : Applying the procedure is recommended (Procedure to be implemented when required)
- : Applying the procedure is not necessary

[Overall]

.. tabularcolumns:: |p{0.10\linewidth}|p{0.30\linewidth}|p{0.20\linewidth}|p{0.20\linewidth}|p{0.20\linewidth}|
Step Procedure MavenMultiple Projects MavenSingle Project EclipseWTP Project
Update dependent library Required Required Required

[Step 1] Update dependent library

Update common library and dependent library of TERASOLUNA Server Framework for Java (5.x).

.. tabularcolumns:: |p{0.35\linewidth}|p{0.25\linewidth}|p{0.25\linewidth}|p{0.15\linewidth}|
Library name Version before update Version after update Remarks
TERASOLUNA Server Framework for Java (5.x) Common Library 5.3.0.RELEASE 5.3.1.RELEASE  

[When procedure is required]

Application of this procedure is mandatory.

[Step 1-1] When Maven Multiple Projects are being used

This update procedure is for the project created by using mvn archetype.

Modify the version of pom file of parent project to 5.3.1.RELEASE.

  • ($YOUR_MULTIPLE_PROJECT_ROOT/pom.xml)
<!-- omitted -->
<parent>
    <groupId>org.terasoluna.gfw</groupId>
    <artifactId>terasoluna-gfw-parent</artifactId>
    <version>5.3.1.RELEASE</version>                    <!-- ### Modification part ### -->
</parent>
<!-- omitted -->

[Step 1-2] When Maven Single Project is being used

This update procedure is for the project created by using mvn archetype, or for the project downloaded from release site.

Change the version of pom file of project to 5.3.1.RELEASE.

  • ($YOUR_SINGLE_PROJECT/pom.xml)
<!-- omitted -->
<parent>
    <groupId>org.terasoluna.gfw</groupId>
    <artifactId>terasoluna-gfw-parent</artifactId>
    <version>5.3.1.RELEASE</version>                    <!-- ### Modification part ### -->
</parent>
<!-- omitted -->

[Step 1-3] When Eclipse WTP Project is being used

This update procedure is for the Eclipse WTP project downloaded from release site .

Refer to [Update library while using Eclipse WTP Project] for the update procedure.

Appendix for 5.3.1

Update library for using Eclipse WTP Project

This update procedure is for Eclipse WTP project downloaded from release site.

Note

Notes

[Table header]
Non : Blank project which is not dependent on O/R Mapper
MB3 : Blank project for MyBatis3
JPA : Blank project for JPA
[Remarks column]
* : Operation target

[Step 1]

Download Eclipse WTP Project of 5.3.1.RELEASE .

[Step 2]

Terminate Eclipse, if it is activated.

[Step 3]

Update jar file (Delete and then add) of $YOUR_ECLIPSE_WTP_PROJECT/src/main/webapp/WEB-INF/lib.

.. tabularcolumns:: |p{0.25\linewidth}|p{0.30\linewidth}|p{0.30\linewidth}|p{0.05\linewidth}|p{0.05\linewidth}|p{0.05\linewidth}|
Library name Delete file Add file Non MB3 JPA
TERASOLUNA Server Framework for Java (5.x) Common Library terasoluna-gfw-common-5.3.0.RELEASE.jar terasoluna-gfw-common-5.3.1.RELEASE.jar * * *
  terasoluna-gfw-jodatime-5.3.0.RELEASE.jar terasoluna-gfw-jodatime-5.3.1.RELEASE.jar * * *
  terasoluna-gfw-security-web-5.3.0.RELEASE.jar terasoluna-gfw-security-web-5.3.1.RELEASE.jar * * *
  terasoluna-gfw-web-5.3.0.RELEASE.jar terasoluna-gfw-web-5.3.1.RELEASE.jar * * *
  terasoluna-gfw-web-jsp-5.3.0.RELEASE.jar terasoluna-gfw-web-jsp-5.3.1.RELEASE.jar * * *

[Step 4]

Update jar file (Delete and then add) for storing sources of $YOUR_ECLIPSE_WTP_PROJECT/libsrc .

.. tabularcolumns:: |p{0.25\linewidth}|p{0.30\linewidth}|p{0.30\linewidth}|p{0.05\linewidth}|p{0.05\linewidth}|p{0.05\linewidth}|
Library name Delete file Add file Non MB3 JPA
TERASOLUNA Server Framework for Java (5.x) Common Library terasoluna-gfw-common-5.3.0.RELEASE-sources.jar terasoluna-gfw-common-5.3.1.RELEASE-sources.jar * * *
  terasoluna-gfw-jodatime-5.3.0.RELEASE-sources.jar terasoluna-gfw-jodatime-5.3.1.RELEASE-sources.jar * * *
  terasoluna-gfw-security-web-5.3.0.RELEASE-sources.jar terasoluna-gfw-security-web-5.3.1.RELEASE-sources.jar * * *
  terasoluna-gfw-web-5.3.0.RELEASE-sources.jar terasoluna-gfw-web-5.3.1.RELEASE-sources.jar * * *
  terasoluna-gfw-web-jsp-5.3.0.RELEASE-sources.jar terasoluna-gfw-web-jsp-5.3.1.RELEASE-sources.jar * * *

[Step 5]

Use the substitution string and update the reference library.

  • $YOUR_ECLIPSE_WTP_PROJECT/.classpath
  • $YOUR_ECLIPSE_WTP_PROJECT/build.xml
.. tabularcolumns:: |p{0.25\linewidth}|p{0.30\linewidth}|p{0.30\linewidth}|p{0.05\linewidth}|p{0.05\linewidth}|p{0.05\linewidth}|
Library name Characters to be substituted Substituted characters Non MB3 JPA
TERASOLUNA Server Framework for Java (5.x) Common Library terasoluna-gfw-common-5.3.0.RELEASE terasoluna-gfw-common-5.3.1.RELEASE * * *
  terasoluna-gfw-jodatime-5.3.0.RELEASE terasoluna-gfw-jodatime-5.3.1.RELEASE * * *
  terasoluna-gfw-security-web-5.3.0.RELEASE terasoluna-gfw-security-web-5.3.1.RELEASE * * *
  terasoluna-gfw-web-5.3.0.RELEASE terasoluna-gfw-web-5.3.1.RELEASE * * *
  terasoluna-gfw-web-jsp-5.3.0.RELEASE terasoluna-gfw-web-jsp-5.3.1.RELEASE * * *
⚠️ **GitHub.com Fallback** ⚠️