.. only:: html

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

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

• Spring Frameworkを4.1.7へ更新
• JSTLを1.2.5へ更新
• Spring IO Platformを1.1.3へ更新
• バグ修正するために共通ライブラリの一部仕様を変更
• ブランクプロジェクトの改善

5.0.1から、セキュリティ脆弱性を解決するためにSpring Frameworkを4.1.7.RELEASEへ更新しました。

• [CVE-2015-3192] DoS Attack with XML Input (SPR-13136)

5.0.1から、セキュリティ脆弱性を解決するために JSTLを1.2.5へ更新しました。

• [CVE-2015-0254] XXE and RCE via XSL extension in JSTL XML tags

5.0.1から、Spring IO Platformを1.1.3.RELEASEへ更新しました。 この更新は、上の2つのセキュリティ脆弱性を解決するために行い、結果として以下のライブラリも更新しました。

• Spring Securityを3.2.7.RELEASEへ更新
• Spring Data Commonsを1.9.3.RELEASEへ更新
• Spring Data JPAを1.7.3.RELEASEへ更新
• AspectJを1.8.6へ更新
• Jacksonを2.4.6へ更新
• Logbackを1.1.3へ更新
• SLF4Jを1.7.12へ更新
• Hibernate ORMを4.3.10.Finalへ更新

5.0.0.RELEASEの以下のバグを修正するために、5.0.1から、共通ライブラリ内の一部の仕様を変更しました。

• [#285] There are cases that cannot access Code List from the jsp
• [#297] f:query throws ConverterNotFoundException when the target object contains nested field

5.0.1から、ブランクプロジェクトの一部の設定ファイルを改善しました。

• [multi#126] [single#99] Use property to resolve a log output directory in logback.xml
• [single#105] logback.xml is different between terasoluna-gfw-web-multi-blank and terasoluna-gfw-web-blank
• [multi#110] When deploy as root context, can't be go back to the top page
• [multi#131] Specify UTF-8 as default encoding to <jdbc:script >

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

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

[ブランクプロジェクトの改善]

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

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

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

[Procedure's required cases]

この手順の適用は必須です。 この更新を適用すると、二つのセキュリティ脆弱性と共通ライブラリのバグが解決されます。

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

親プロジェクトのpomファイルを更新してください。 ($YOUR_MULTIPLE_PROJECT_ROOT/pom.xml)

<!-- omitted -->
<parent>
    <groupId>org.terasoluna.gfw</groupId>
    <artifactId>terasoluna-gfw-parent</artifactId>
    <version>5.0.1.RELEASE</version> <!-- ### 編集が必要 ### -->
</parent>
<!-- omitted -->

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

プロジェクトのpomファイルを更新してください。 ($YOUR_SINGLE_PROJECT/pom.xml)

<!-- omitted -->
<parent>
    <groupId>org.terasoluna.gfw</groupId>
    <artifactId>terasoluna-gfw-parent</artifactId>
    <version>5.0.1.RELEASE</version> <!-- ### 編集が必要 ### -->
</parent>
<!-- omitted -->

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

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

5.0.1から、ログ出力ディレクトリの設定にプレースフォルダーを使用するように改善されました。 詳細な情報は、GitHub multi#126 又は GitHub single#99 を参照してください。 この改善を適用すると、ログ出力ディレクトリはJavaシステムプロパティ(-D<name>=<value>)を使って指定することができます。

[手順が必要なケース]

この手順の適用は任意です。 必要に応じて、次の修正を行ってください。

[修正方法]

以下のいずれかのファイルにて、プレースフォルダー(${app.log.dir:-log})を使うように修正してください。

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-env/src/main/resources/logback.xml
• $YOUR_SINGLE_PROJECT/src/main/resources/logback.xml
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/logback.xml

<file>${app.log.dir:-log}/projectName-application.log</file> <!-- ### 編集が必要 ### -->

[参考]

5.0.0におけるデフォルト設定は以下の通りです。

<file>log/projectName-application.log</file>

5.0.1から、ブランクプロジェクトの3つのログ設定が変更されました。 詳細な情報は、GitHub single#105 を参照してください。

[手順が必要なケース]

この手順の適用は任意です。 必要に応じて、次の修正を行ってください。

[修正方法]

以下のいずれかのファイルにて、設定値を修正してください。

• $YOUR_SINGLE_PROJECT/src/main/resources/logback.xml
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/logback.xml

3つの変更点は以下の通りです。

1. <!DOCTYPE logback> から <?xml version="1.0" encoding="UTF-8"?> へ置き換え
2. "org.terasoluna.gfw" のログレベルを "debug" から "info" へ変更
3. "jdbc.resultsettable" のログ定義を追加

<?xml version="1.0" encoding="UTF-8"?> <!-- ### 置き換えが必要 ### -->
<configuration>

    <!-- ... -->

    <logger name="org.terasoluna.gfw">
        <level value="info" /> <!-- ### 編集が必要 ### -->
    </logger>

    <!-- ... -->

    <!-- only for development -->
    <logger name="jdbc.resultsettable"> <!-- ### 追加が必要 ### -->
        <level value="debug" />
    </logger>

    <!-- ... -->

</configuration>

[参考]

5.0.0におけるデフォルト設定は以下の通りです。

<!DOCTYPE logback>
<configuration>

    <!-- ... -->

    <logger name="org.terasoluna.gfw">
        <level value="debug" />
    </logger>

    <!-- ... -->

</configuration>

5.0.1から、トップページへ戻るためのURLが改善されました。 詳細な情報は、GitHub multi#110 を参照してください.

[手順が必要なケース]

以下のケースに一致する場合は、次の修正を適用してください。

• アプリケーションをルートコンテキスト("/")へデプロイする場合

[修正方法]

以下のファイルにて、${pageContext.request.contextPath} の後に "/" 文字を追加してください。

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-web/src/main/webapp/WEB-INF/views/layout/header.jsp

Note

対象ファイルについて

同じような実装が行われているJSPファイルが対象ファイルになります。

<a href="${pageContext.request.contextPath}/">projectName</a> <%-- ### 編集が必要 ### --%>

[参考]

5.0.0におけるデフォルト実装は以下の通りです。

<a href="${pageContext.request.contextPath}">projectName</a>

5.0.1から、<jdbc:script> の文字コード設定が改善されました。 詳細な情報は、GitHub multi#131 を参照してください。

[手順が必要なケース]

この手順の適用は任意です。 必要に応じて、次の修正を行ってください。

[修正方法]

以下のファイルに文字コードの設定(encoding="UTF-8")を追加してください。

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-env/src//main/resources/META-INF/spring/xxx-env.xml

<jdbc:initialize-database data-source="dataSource"
    ignore-failures="ALL">
    <jdbc:script location="classpath:/database/${database}-schema.sql" encoding="UTF-8" /> <!-- ### 編集が必要 ### -->
    <jdbc:script location="classpath:/database/${database}-dataload.sql" encoding="UTF-8" /> <!-- ### 編集が必要 ### -->
</jdbc:initialize-database>

[参考]

5.0.0におけるデフォルト設定は以下の通りです。

<jdbc:initialize-database data-source="dataSource"
    ignore-failures="ALL">
    <jdbc:script location="classpath:/database/${database}-schema.sql" />
    <jdbc:script location="classpath:/database/${database}-dataload.sql" />
</jdbc:initialize-database>

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

Note

凡例

[テーブルヘッダ]

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

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

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

[備考欄]

* : オペレーション対象

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

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

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

$YOUR_ECLIPSE_WTP_PROJECT/src/main/webapp/WEB-INF/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}|

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

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

Eclipse WTPプロジェクトの設定から参照ライブラリ(以下のjarファイル)を削除してください。

• $YOUR_ECLIPSE_WTP_PROJECT/.classpath
• $YOUR_ECLIPSE_WTP_PROJECT/build.xml

.. tabularcolumns:: |p{0.30\linewidth}|p{0.55\linewidth}|p{0.05\linewidth}|p{0.05\linewidth}|p{0.05\linewidth}|

[全てのブランクプロジェクト向けのステップ]

.classpath

<!-- ### 以下のクラスパスエントリーの削除が必要 ### -->

<!-- omitted -->

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/jstl-1.2.jar"
    sourcepath="libsrc/jstl-1.2-sources.jar" />

build.xml

<!-- ### 以下のクラスパスエントリーの削除が必要 ### -->

<path id="build.classpath">
    <!-- ... -->
    <pathelement location="${lib.dir}/jstl-1.2.jar"/>
    <!-- ... -->
</path>

Eclipse WTPプロジェクトの設定に参照ライブラリ(jarファイル以下)を追加してください。

• $YOUR_ECLIPSE_WTP_PROJECT/.classpath
• $YOUR_ECLIPSE_WTP_PROJECT/build.xml

.. tabularcolumns:: |p{0.30\linewidth}|p{0.55\linewidth}|p{0.05\linewidth}|p{0.05\linewidth}|p{0.05\linewidth}|

[全てのブランクプロジェクト向けのステップ]

.classpath

<!-- ### 以下のクラスパスエントリーの追加が必要 ### -->

<!-- ... -->

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/taglibs-standard-jstlel-1.2.5.jar"
    sourcepath="libsrc/taglibs-standard-jstlel-1.2.5-sources.jar" />

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/taglibs-standard-spec-1.2.5.jar"
    sourcepath="libsrc/taglibs-standard-jstlel-1.2.5-sources.jar" />

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/taglibs-standard-impl-1.2.5.jar"
    sourcepath="libsrc/taglibs-standard-impl-1.2.5-sources.jar" />

<!-- ... -->

build.xml

<!-- ### 以下のクラスパスエントリーの追加が必要 ### -->

<path id="build.classpath">
    <!-- ... -->
    <pathelement location="${lib.dir}/taglibs-standard-jstlel-1.2.5.jar"/>
    <pathelement location="${lib.dir}/taglibs-standard-spec-1.2.5.jar"/>
    <pathelement location="${lib.dir}/taglibs-standard-impl-1.2.5.jar"/>
    <!-- ... -->
</path>