Migration Guide 5.3.1_ja

5.3.0から5.3.1への移行ガイド

.. only:: html

 .. contents:: 目次
    :depth: 2
    :local:

5.3.1での主な変更点

5.3.1での主な変更点は以下の通りです。

• 共通ライブラリの仕様を一部変更

共通ライブラリの仕様を一部変更

5.3.0から、バグ修正に伴い共通ライブラリの一部仕様を変更しました。

• [#747] Wrong full width string in DefaultFullHalf

5.3.0から5.3.1への移行手順

移行手順は、以下の通りです。

Note

凡例

Required : 手順の適用は必須

Required by case : 手順の適用は条件付きで必須

Optional : 手順の適用を推奨 (必要に応じて手順の適用を実施)

- : 手順の適用は必要なし

[全般]

.. tabularcolumns:: |p{0.10\linewidth}|p{0.30\linewidth}|p{0.20\linewidth}|p{0.20\linewidth}|p{0.20\linewidth}|

ステップ	手順	MavenMultiple Projects	MavenSingle Project	EclipseWTP Project
1..	依存ライブラリを更新	Required	Required	Required

[Step 1] 依存ライブラリを更新

TERASOLUNA Server Framework for Java (5.x)の共通ライブラリを更新してください。

.. tabularcolumns:: |p{0.35\linewidth}|p{0.25\linewidth}|p{0.25\linewidth}|p{0.15\linewidth}|

ライブラリ名	更新前バージョン	更新後バージョン	備考
TERASOLUNA Server Framework for Java (5.x) Common Library	5.3.0.RELEASE	5.3.1.RELEASE

[手順が必要なケース]

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

[Step 1-1] Maven Multiple Projectsを利用している場合

この更新手順は、mvn archetype を使用して作成したプロジェクト向けです。

親プロジェクトのpomファイルの version を 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>                    <!-- ### 修正箇所 ### -->
</parent>
<!-- omitted -->

[Step 1-2] Maven Single Projectを利用している場合

この更新手順は、mvn archetype を使用して作成したプロジェクト、又は release site からダウンロードしたプロジェクト向けです。

プロジェクトのpomファイルの version を 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>                    <!-- ### 修正箇所 ### -->
</parent>
<!-- omitted -->

[Step 1-3] Eclipse WTP Projectを利用している場合

この更新手順は、release site からダウンロードしたEclipse WTPプロジェクト向けです。

更新手順は、Eclipse WTP Project使用時のライブラリ更新 を参照してください。

5.3.1用のAppendix

Eclipse WTP Project使用時のライブラリ更新

この更新手順は、release site からダウンロードしたEclipse WTPプロジェクト向けです。

Note

凡例

[テーブルヘッダ]

Non : O/R Mapperに非依存のブランクプロジェクト

MB3 : MyBatis3用のブランクプロジェクト

JPA : JPA用のブランクプロジェクト

[備考欄]

* : オペレーション対象

[Step 1]

Eclipse WTP Project of 5.3.1.RELEASE をダウンロードしてください。

[Step 2]

Eclipseが起動している場合、Eclipseを終了します。

[Step 3]

$YOUR_ECLIPSE_WTP_PROJECT/src/main/webapp/WEB-INF/lib のjarファイルを更新(削除して追加)してください。

.. 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}|

ライブラリ名	削除ファイル	追加ファイル	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 5]

$YOUR_ECLIPSE_WTP_PROJECT/libsrc のソース格納用jarファイルを更新(削除して追加)してください。

.. 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}|

ライブラリ名	削除ファイル	追加ファイル	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 6]

置換文字列を使用して、参照ライブラリを更新してください。

• $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}|

ライブラリ名	置換対象文字	置換文字	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	*	*	*