.. only:: html

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

5.0.0 での主な変更点。

• Spring Framework 4.1へ更新
• Spring Security 3.2へ更新
• Spring IO Platform 1.1.1で管理されるライブラリのバージョンを更新
• Spring IO Platform 1.1.1以外で管理されているライブラリのバージョンを更新
• 新機能としてMyBatis 3.2を追加
• バグの修正に伴い、共通ライブラリの一部仕様を変更
• 改善対応に伴い、共通ライブラリの一部仕様を変更
• MyBatis3のために新たにblank project追加
• blank projectの改善

5.0.0から、Spring Framework 4.1.4.RELEASEへ更新しました。

1.0.1(Spring Framework 3.2.10)からの移行における考慮事項は以下の通りになります。

• Jackson 1.xは未サポート。
• ViewResolver のXML namespaceが追加
• RESTful Web Serviceの為に @RestController がアノテーションとして追加

その他詳細な修正内容については、下記のSpring Framework Reference Documentationを参照してください。

• New Features and Enhancements in Spring Framework 4.0
• New Features and Enhancements in Spring Framework 4.1

5.0.0から、Spring Security 3.2.5.RELEASEへ更新しました。

1.0.x(Spring Security 3.1.xとSpring Security 3.2-RC版のCSRF対策機能)からの移行における考慮事項は以下の通りになります。

• CSRF対策機能の改善
• WEBセキュリティ強化機能がHTTPヘッダーに追加
• Spring MVCと統合する為、@AuthenticationPrincipal が追加
• CsrfRequestDataValueProcessor のAPI仕様が変更
• Spring MVCと統合する為、CsrfRequestDataValueProcessor を改善

Note

1.0.xのCSRF対策機能について

1.0.1では、Spring Security 3.2-RC版のCSRF対策機能が組み込まれた。

その他詳細な修正内容については、下記のSpring Security Referenceを参照してください。

• What's new in Spring Security 3.2

5.0.0から、依存関係のバージョン管理の為にSpring IO Platform 1.1.1を適用しています。

1.0.xからの移行における懸念事項は以下の通りになります。

• Jacksonが1.9.7から2.4.4に更新
• Apache Tilesが2.2.2から3.0.5に更新
• Hibernate Validatorが4.3.1.Finalから5.1.3.Finalに更新(Bean Validationが1.0から1.1に更新)
• Joda-Timeが2.2から2.5に更新
• Apache Commons DBCPが1.2.2.patch_DBCP264_DBCP372から2.0.1に更新
• Hibernate ORMが4.2.3.Finalから4.3.7.Finalに更新(Java Persistence APIが2.0から2.1に更新)

5.0.0から、一部のライブラリが更新されました。

1.0.xからの移行における考慮事項は特にありません。

5.0.0から、MyBatis 3.2.8はデータベースアクセスの新機能として追加されます。

O / RマッパーとしてMyBatis3を使用する場合は、テンプレートプロジェクトから新しい開発プロジェクトを生成してください。

• https://github.com/terasolunaorg/terasoluna-gfw-web-multi-blank (推奨)
• https://github.com/terasolunaorg/terasoluna-gfw-web-blank

Note

org.tarasoluna.gfw:tarasoluna-gfw-mybatis3について

5.0.0から、MyBatis3のMavenアーティファクト（ org.tarasoluna.gfw：tarasoluna-GFW-mybatis3）が依存するライブラリを解決するために追加されました。 つまり、クラスファイルを提供していません。

Warning

MyBatis2(iBatis)について

MyBatis2(iBatis)は、5.0.0からサポートされていません。

5.0.0から、共通ライブラリ内の一部の仕様が1.0.1.RELEASEで以下のバグの修正に伴い変更されました。

• [#16] default message code in @ExistInCodeList is not standard form
• [#148] QueryEscapeUtils does not work on Oracle 11g Release2(11.2) later
• [#149] f:u() (EL Function) perform wrong encoding for query parameter
• [#167] Modify CompositeRequestDataValueProcessor
• [#256] ValidationMessages.properties should not be included in terasoluna-gfw-common

5.0.0から、共通ライブラリ内の一部の仕様が1.0.1.RELEASEから以下の改善対応に伴い変更されました。

• [#13] When clicked current page link of pagination, pagination request is submitted
• [#14] When clicked disabled page link of pagination, moved the top in current page
• [#24] Support the ResultMessages.warning() as new message type (ResultMessages.warn() is deprecated)
• [#224] Separate Joda-Time

5.0.0から、blank projectにおける一部の設定ファイルが1.0.1.RELEASEで以下のバグの修正に伴い変更されました。

[アプリケーションの設定ファイル]

• [multi#50] TilesViewResolver and BeanNameViewResolver is same order(priority)
• [single#39] ResultMessagesLoggingInterceptor does not define in domain.xml
• [single#45] Remove removeValue settings in UserIdMDCPutFilter

[プロジェクトの設定ファイル(POM,etc...)]

• [multi#8] "distributionManagement" element seems unnecessary.
• [multi#36] [single#46] Add <relativePath /> in pom.xm

5.0.0から、blank projectにおける一部の設定ファイルが改善されました。

[アプリケーションの設定ファイル]

• [multi#39] Add bean definition of jdbcTemplate for JdbcCodeList
• [multi#66] [single#71] Support wildcard codelistfiles import
• [multi#77] [single#62] Support CodeListInterceptor

[プロジェクトの設定ファイル(POM,etc...)]

• [multi#76] Modify scope of artifact dependency
• [multi#78] Polish parent pom.xml
• [multi#92] Improve JDBC driver dependency settings
• [single#6] add dependencies to support unit test!
• [single#60] Modify scope of artifact dependency

移行手順は以下の通りになります。

Note

Legend

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

[Spring Framework]

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

[Spring Security]

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

[Jackson]

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

[Tiles]

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

[Bean Validation(Hibernate Validator)]

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

[Joda Time]

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

[Commons DBCP]

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

[共通ライブラリの改善]

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

[Blank projectのバグ修正]

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

[Blank projectの改善]

.. 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)の共通ライブラリと依存ライブラリを更新してください。

Note

O / RマッパーとしてMyBatis3を使用する場合は、テンプレートプロジェクトから新しい開発プロジェクトを生成してください。（つまり、MyBatis3の移行手順が提供されていません。）

• https://github.com/terasolunaorg/terasoluna-gfw-web-multi-blank (推奨)
• https://github.com/terasolunaorg/terasoluna-gfw-web-blank

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

[手順の必要なケース]

この対応は必須になります。

この mvn archetype を使用して生成したプロジェクトの更新手順はこちらの方法を使用します。

親プロジェクトのpomファイルを更新します。 ($YOUR_MULTIPLE_PROJECT_ROOT/pom.xml)

<!-- omitted -->
<parent>
    <groupId>org.terasoluna.gfw</groupId>
    <artifactId>terasoluna-gfw-parent</artifactId>
    <version>5.0.0.RELEASE</version> <!-- ### Need to edit ### -->
</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.0.RELEASE</version> <!-- ### Need to edit ### -->
</parent>
<!-- omitted -->

この release site からEclipse WTP Project用にダウンロードしたプロジェクトの更新手順はこちらの方法を使用します。

更新手順については Update libraries for using Eclipse WTP Project を参照してください。

5.0.0から(Spring Framework 4.1から)、 ViewResolver 定義のXML名前空間が追加されました。 ViewResolver 定義のXML名前空間を使用することを推奨します。

[手順の必要なケース]

この手順は任意です。必要な場合、次の修正を行ってください。

[変更方法（推奨スタイル）]

以下の通り、修正してください。

• <mvc:view-resolvers> タグを使用
• <mvc:tiles-configurer> タグを使用

以下のいずれかファイルを修正します。

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-web/src/main/resources/META-INF/spring/spring-mvc.xml
• $YOUR_SINGLE_PROJECT/src/main/resources/META-INF/spring/spring-mvc.xml
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/META-INF/spring/spring-mvc.xml

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

[別の方法(参考)]

この方法は従来のスタイルになります。

<bean class="org.springframework.web.servlet.view.BeanNameViewResolver">
    <property name="order" value="0" />
</bean>

<bean
    class="org.springframework.web.servlet.view.tiles3.TilesViewResolver">
    <property name="order" value="1" />
</bean>

<bean id="viewResolver"
    class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/views/" />
    <property name="suffix" value=".jsp" />
    <property name="order" value="2" />
</bean>

<bean class="org.springframework.web.servlet.view.tiles3.TilesConfigurer">
    <property name="definitions">
        <list>
            <value>/WEB-INF/tiles/tiles-definitions.xml</value>
        </list>
    </property>
</bean>

5.0.0から(Spring Framework 4.0から)、 @RestController は、RESTのAPI（RESTfulなWebサービス）を開発するために追加されました。 REST APIを開発する場合、 @RestController は @Controller 代わりに使用することを推奨します。

[手順の必要なケース]

この手順は任意です。 必要な場合、次の修正を行ってください。

[変更方法（推奨スタイル）]

@Controller の代わりに @RestController を使用するように修正します。 @RestController を使用している場合、 @ResponseBody はメソッドアノテーションとしての記載を省略することができます。

@RequestMapping("members")
@RestController // ### Need to specify instead of @Controller ###
public class MemberRestController {

    @RequestMapping(value = "{memberId}", method = RequestMethod.GET)
    @ResponseStatus(HttpStatus.OK)
    public MemberResource getMember( // ### Can omit @ResponseBody ###
              @PathVariable("memberId") String memberId) {
        // ...
    }

}

[参考]

この方法は従来のスタイルになります。

@RequestMapping("members")
@Controller
public class MemberRestController {

    @RequestMapping(value = "{memberId}", method = RequestMethod.GET)
    @ResponseStatus(HttpStatus.OK)
    @ResponseBody
    public MemberResource getMember(
              @PathVariable("memberId") String memberId) {
        // ...
    }

}

CsrfRequestDataValueProcessor のAPI仕様に、5.0.0(From Spring Security 3.2)から変更があります。 具体的には、 create メソッド（ファクトリメソッド）が削除されました。

[手順の必要なケース]

以下のケースと一致する場合、次の修正を行ってください。

• CsrfRequestDataValueProcessor を使用している場合

[変更方法]

CsrfRequestDataValueProcessor のBean定義から factory-method を削除してください。

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

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-web/src/main/resources/META-INF/spring/spring-mvc.xml
• $YOUR_SINGLE_PROJECT/src/main/resources/META-INF/spring/spring-mvc.xml
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/META-INF/spring/spring-mvc.xml

<bean id="requestDataValueProcessor"
    class="org.terasoluna.gfw.web.mvc.support.CompositeRequestDataValueProcessor">
    <constructor-arg>
        <util:list>
            <!-- ### Need to edit(remove factory-method="create") ### -->
            <bean
                class="org.springframework.security.web.servlet.support.csrf.CsrfRequestDataValueProcessor" />
            <!-- ... -->
        </util:list>
    </constructor-arg>
</bean>

[参考]

この設定は、5.0.0から無効になります。

<bean id="requestDataValueProcessor"
    class="org.terasoluna.gfw.web.mvc.support.CompositeRequestDataValueProcessor">
    <constructor-arg>
        <util:list>
            <bean
                class="org.springframework.security.web.servlet.support.csrf.CsrfRequestDataValueProcessor"
                factory-method="create" />
            <!-- ... -->
        </util:list>
    </constructor-arg>
</bean>

5.0.0から(Spring Security 3.2から)、CSRF対策のためのXML名前空間が追加されました。

[手順の必要なケース]

以下のケースと一致する場合、次の修正を行ってください。

• Spring SecurityのCSR対策を使用している場合

[変更方法]

• <sec:csrf> を使用するように変更してください。 <sec:csrf> を使用している場合、CSRF対策のためのコンポーネントが自動的に有効になります。

• HttpSessionCsrfTokenRepository
• CsrfFilter
• CsrfAuthenticationStrategy

• CSRFエラー処理をした場合は、 AccessDeniedHandler (<sec:access-denied-handler>)の設定を変更または追加してください。

以下のいずれかのファイルを修正します。

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-web/src/main/resources/META-INF/spring/spring-security.xml
• $YOUR_SINGLE_PROJECT/src/main/resources/META-INF/spring/spring-security.xml
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/META-INF/spring/spring-security.xml

(例：5.0.0用のblank projectの設定)

<sec:http auto-config="true" use-expressions="true">
    <!-- ... -->
    <sec:csrf /> <!-- ### Need to modify ### -->
    <sec:access-denied-handler ref="accessDeniedHandler"/> <!-- ### If handling the CSRF error, need to modify or add ### -->
    <!-- ... -->
</sec:http>

<!-- ... -->

<!-- ### If handling the CSRF error, need to modify or add ### -->
<bean id="accessDeniedHandler"
    class="org.springframework.security.web.access.DelegatingAccessDeniedHandler">
    <constructor-arg index="0">
        <map>
            <!-- ### Setting for detecting a invalid CSRF token ### -->
            <entry
                key="org.springframework.security.web.csrf.InvalidCsrfTokenException">
                <bean
                    class="org.springframework.security.web.access.AccessDeniedHandlerImpl">
                    <property name="errorPage"
                        value="/WEB-INF/views/common/error/invalidCsrfTokenError.jsp" />
                </bean>
            </entry>
            <!-- ### Setting for detecting a invalid session(if can not load a CSRF token from HttpSession) ### -->
            <entry
                key="org.springframework.security.web.csrf.MissingCsrfTokenException">
                <bean
                    class="org.springframework.security.web.access.AccessDeniedHandlerImpl">
                    <property name="errorPage"
                        value="/WEB-INF/views/common/error/missingCsrfTokenError.jsp" />
                </bean>
            </entry>
        </map>
    </constructor-arg>
    <!-- ### Setting for detect a invalid access to protected page ### -->
    <constructor-arg index="1">
        <bean
            class="org.springframework.security.web.access.AccessDeniedHandlerImpl">
            <property name="errorPage"
                value="/WEB-INF/views/common/error/accessDeniedError.jsp" />
        </bean>
    </constructor-arg>
</bean>

Note

上記の設定は、5.0.0用のblank projectの設定と同じになります。

詳細はガイドラインのCSRF対策を参照してください。(English または Japanese).

[参考]

この方法は従来のスタイルになります。（例：1.0.1用のblank projectの設定）

<sec:http auto-config="true" use-expressions="true">
    <sec:custom-filter ref="csrfFilter" before="LOGOUT_FILTER"/>
    <!-- ... -->
    <sec:session-management session-authentication-strategy-ref="sessionAuthenticationStrategy" />
</sec:http>

<bean id="csrfTokenRepository"
    class="org.springframework.security.web.csrf.HttpSessionCsrfTokenRepository" />

<bean id="csrfFilter" class="org.springframework.security.web.csrf.CsrfFilter">
    <constructor-arg index="0" ref="csrfTokenRepository" />
    <property name="accessDeniedHandler">
        <bean
            class="org.springframework.security.web.access.AccessDeniedHandlerImpl">
            <property name="errorPage" value="/WEB-INF/views/common/error/csrfTokenError.jsp" />
        </bean>
    </property>
</bean>

<bean id="sessionAuthenticationStrategy"
    class="org.springframework.security.web.authentication.session.CompositeSessionAuthenticationStrategy">
    <constructor-arg index="0">
        <list>
            <bean
                class="org.springframework.security.web.authentication.session.SessionFixationProtectionStrategy" />
            <bean
                class="org.springframework.security.web.csrf.CsrfAuthenticationStrategy">
                <constructor-arg index="0"
                    ref="csrfTokenRepository" />
            </bean>
        </list>
    </constructor-arg>
</bean>

5.0.0から(From Spring Security 3.2)、ログアウトリクエストの仕様が変更されました。 具体的には、ログアウトリクエストで POST メソッドを使用する必要があります。

[手順の必要なケース]

以下のケースと一致する場合、次の修正を行ってください。

• Spring SecurityのCSRF対策を使用している場合
• ログアウトリクエストで GET メソッドを使用している場合

[変更方法]

ログアウトリクエストを送信するHTMLやJSPファイルを POST メソッドに修正してください。

5.0.0から、Concurrent Session Control(<sec:concurrency-control>)のためのXML namespaceの使用を推奨します。

[手順の必要なケース]

この手順はオプションですが、適用することを推奨します。 以下のケースとすべて一致し、かつ必要な場合、次の修正を行ってください。

• Spring SecurityのConcurrent Session Controlを使用している場合
• <sec:concurrency-control> タグを使用せずに、Concurrent Session Controlのコンポーネントを定義する場合

[変更方法]

<sec:concurrency-control> タグを使用するように変更してください。 <sec:concurrency-control> を使用している場合、Concurrent Session Controlのためのコンポーネントが自動的に有効になります。

• ConcurrentSessionFilter
• SessionRegistryImpl
• ConcurrentSessionControlAuthenticationStrategy
• RegisterSessionAuthenticationStrategy
• (SessionFixationProtectionStrategy または ChangeSessionIdAuthenticationStrategy)

Note

ConcurrentSessionControlStrategy はSpring Security 3.2から非推奨になりました。 ConcurrentSessionControlStrategy は ConcurrentSessionControlAuthenticationStrategy と RegisterSessionAuthenticationStrategy に分離されます。

<sec:http auto-config="true" >
    <sec:session-management>
        <sec:concurrency-control error-if-maximum-exceeded="true" />
    </sec:session-management>
</sec:http>

[参考]

この設定は、従来のスタイルと非推奨のスタイル（例：1.0.1の開発ガイドラインに記述されている構成法）になります。

Warning

ConcurrentSessionControlStrategy はSpring Security 3.2から非推奨になりました。 移行後に <sec:concurrency-control> タグを使用せずにConcurrent Session Controlのためのコンポーネントを定義する場合は、"[ステップ8] Spring Securityの推奨されないAPIを置換"が必要になります。

<sec:http auto-config="true" >
    <!-- omitted -->
    <sec:custom-filter
        position="CONCURRENT_SESSION_FILTER" ref="concurrencyFilter" />
    <sec:session-management
        session-authentication-strategy-ref="sessionAuthenticationStrategy" />
    <!-- omitted -->
</sec:http>

<bean id="sessionRegistry"
    class="org.springframework.security.core.session.SessionRegistryImpl" />

<bean id="concurrencyFilter"
   class="org.springframework.security.web.session.ConcurrentSessionFilter">
   <constructor-arg index="0" ref="sessionRegistry" />
</bean>

<bean id="sessionAuthenticationStrategy"
    class="org.springframework.security.web.authentication.session.CompositeSessionAuthenticationStrategy">
    <constructor-arg index="0">
        <list>
            <!-- omitted -->
            <bean class="org.springframework.security.web.authentication.session.ConcurrentSessionControlStrategy">
                <constructor-arg index="0" ref="sessionRegistry" />
                <property name="exceptionIfMaximumExceeded" value="true" />
            </bean>
            <!-- omitted -->
        </list>
    </constructor-arg>
</bean>

<!-- omitted -->

5.0.0から(Spring Security 3.2)、 ConcurrentSessionControlStrategy は推奨されません。

Note

ConcurrentSessionControlStrategy はスプリングセキュリティ3.2から非推奨になりました。 ConcurrentSessionControlStrategy は ConcurrentSessionControlAuthenticationStrategy と RegisterSessionAuthenticationStrategy に分離されます。

Note

"[Step 7] Concurrent Session Control(<sec:concurrency-control>)のXML namespaceを使用する設定に修正"の手順を適用した場合、この手順をスキップしてください。

[手順の必要なケース]

以下のケースと一致する場合、次の修正を行ってください。

• Spring SecurityのConcurrent Session Controlを使用している場合
• 移行後に <sec:concurrency-control> タグを使用せずにConcurrent Session Controlのためのコンポーネントを定義する場合

[変更方法]

ConcurrentSessionControlStrategy の代わりに ConcurrentSessionControlAuthenticationStrategy と RegisterSessionAuthenticationStrategy を使用するように変更してください。

Note

ConcurrentSessionControlAuthenticationStrategy と RegisterSessionAuthenticationStrategy の間に SessionFixationProtectionStrategy を定義してください。

<!-- omitted -->

<bean id="sessionAuthenticationStrategy"
    class="org.springframework.security.web.authentication.session.CompositeSessionAuthenticationStrategy">
    <constructor-arg index="0">
        <list>
            <!-- omitted -->
            <bean class="org.springframework.security.web.authentication.session.ConcurrentSessionControlAuthenticationStrategy">
                <constructor-arg index="0" ref="sessionRegistry" />
                <property name="exceptionIfMaximumExceeded" value="true" />
            </bean>
            <bean class="org.springframework.security.web.authentication.session.SessionFixationProtectionStrategy" />
            <bean class="org.springframework.security.web.authentication.session.RegisterSessionAuthenticationStrategy">
                <constructor-arg index="0" ref="sessionRegistry" />
            </bean>
            <!-- omitted -->
        </list>
    </constructor-arg>
</bean>

<!-- omitted -->

[参考]

この設定は非推奨なスタイルになります（例：1.0.1の開発ガイドラインに記述されている構成法）。

<!-- omitted -->

<bean id="sessionAuthenticationStrategy"
    class="org.springframework.security.web.authentication.session.CompositeSessionAuthenticationStrategy">
    <constructor-arg index="0">
        <list>
            <!-- omitted -->
            <bean class="org.springframework.security.web.authentication.session.ConcurrentSessionControlStrategy">
                <constructor-arg index="0" ref="sessionRegistry" />
                <property name="exceptionIfMaximumExceeded" value="true" />
            </bean>
            <!-- omitted -->
        </list>
    </constructor-arg>
</bean>

<!-- omitted -->

5.0.0から(Spring Security 3.2 + Spring Framework 4.0から)、 CsrfRequestDataValueProcessor の振る舞いが改善されました。 具体的には、 <form:form method="GET"> を使用する場合に、CSRFトークン値はhiddenタグとして出力がされません。 （つまり、CSRFトークン値は、クエリ文字列に含まれません）

[手順の必要なケース]

この手順は任意になります。 以下のケースとすべて一致し、かつ必要な場合、次の修正を行ってください。

• Spring SecurityのCSRF対策を使用している場合
• HTML標準の <form> タグと GET リクエストでの <spring:nestedPath> タグの組み合わせで使用している場合

[変更手順]

GET リクエストで <form:form method="GET"> を使用するように変更してください。

<!-- ### Need to modify ### -->
<form:form method="GET" modelAttribute="xxxForm" action="...">
    <%-- ... --%>
</form:form>

Note

<form:form> タグのメソッド属性を省略した場合、 POST メソッドが適用されます。

[参考]

このコードは従来のスタイルになります。

<form method="GET" action="...">
    <spring:nestedPath path="xxxForm">
        <%-- ... --%>
    </spring:nestedPath>
</form>

または

<form action="...">
    <spring:nestedPath path="xxxForm">
        <%-- ... --%>
    </spring:nestedPath>
</form>

Note

HTML標準の <form> タグのメソッド属性を省略した場合、 GET が適用されます。

5.0.0から(Spring Security 3.2から)、 @AuthenticationPrincipal はコントローラクラスのメソッドに UserDetails を引き渡すために追加されました。 @AuthenticationPrincipal を使用することを推奨します。

[手順の必要なケース]

この手順は任意になります。必要な場合、次の変更を実行してください。

[変更方法（推奨スタイル）]

<mvc:argument-resolvers> タグに AuthenticationPrincipalArgumentResolver を追加してください。

次のいずれかのファイルを変更してください。

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-web/src/main/resources/META-INF/spring/spring-mvc.xml
• $YOUR_SINGLE_PROJECT/src/main/resources/META-INF/spring/spring-mvc.xml
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/META-INF/spring/spring-mvc.xml

<mvc:annotation-driven>
    <mvc:argument-resolvers>
        <!-- ... -->
        <!-- ### Need to add ### -->
        <bean
            class="org.springframework.security.web.bind.support.AuthenticationPrincipalArgumentResolver" />
    </mvc:argument-resolvers>
</mvc:annotation-driven>

Controllerクラスでは メソッド引数として、 org.springframework.security.core.userdetails.UserDetails クラスと @AuthenticationPrincipal アノテーションを指定してください。

@RequestMapping(method = RequestMethod.GET)
public String view(
        @AuthenticationPrincipal CustomUserDetails userDetails, // ### Need to modify ###
        Model model) {
    // ...
}

[参考]

このコードは従来のスタイルになります。

@RequestMapping(method = RequestMethod.GET)
public String view(Principal principal, Model model) {
    Authentication authentication = (Authentication) principal;
    CustomUserDetails userDetails = (CustomUserDetails) authentication.getPrincipal();
    // ...
}

5.0.0から(Spring Security 3.2から)、 <sec:csrfInput> はhiddenタグとしてCSRFトークン値を埋め込むために追加されました。

[手順の必要なケース]

この手順は任意です。以下のケースとすべて一致し、かつ必要な場合、次の修正を行ってください。

• Spring SecurityのCSRF対策を使用している場合
• JSP（ <form:form> タグを使用せずに）に、hiddenタグとしてCSRFトークン値を埋め込むロジックを実装する場合

[変更方法（推奨スタイル）]

<sec:csrfInput> を使用するように修正してください。

<form method="POST" action="...">
    <%-- ... --%>
    <sec:csrfInput />
</form>

[参考]

このコードは従来のスタイルになります。

<form method="POST" action="...">
    <%-- ... --%>
    <input type="hidden" name="${f:h(_csrf.parameterName)}" value="${f:h(_csrf.token)}"/>
</form>

5.0.0から(Spring Security 3.2から)、 <sec:csrfMetaTags> は、 <meta> タグとしてCSRFトークン値を組み込むために追加されました。

[手順の必要なケース]

この手順は任意です。次のケースをすべて満たし、かつ必要性がある場合、次の修正を行ってください。

• Spring SecurityのCSRF対策を使用している場合
• JSPに、 <meta> タグとしてCSRFトークン値を組み込むロジックを実装する場合

[変更方法(推奨スタイル)]

<sec:csrfMetaTags> を使用するように修正してください。

<head>
    <sec:csrfMetaTags />
</head>

Note

<meta>タグのname属性について

<sec:csrfMetaTags> を使用する場合、 <meta> タグのname属性に注意すること。( <sec:csrfMetaTags> で出力するタグは以下の通り)

<meta name="_csrf_parameter" content="_csrf" />
<meta name="_csrf_header" content="X-CSRF-TOKEN" />
<meta name="_csrf" content="102fbad9-7d4f-42d2-a506-6a47120b5f36" />

Javascriptで違ったnameを使用している場合、修正する必要がある。

[参考]

このコードは従来のスタイルになります。

<head>
    <meta name="_csrf_parameter" content="${f:h(_csrf.parameterName)}" />
    <meta name="_csrf_header" content="${f:h(_csrf.headerName)}"/>
    <meta name="_csrf" content="${f:h(_csrf.token)}"/>
</head>

5.0.0から(Spring Security 4.1から)、Jackson 1.xはサポートされていません。 その為、Jacksonを使用する場合、Jackson 2.4を使用する設定に修正する必要があります。

[手順の必要なケース]

以下のケースと一致する場合、次の変更を行ってください。

• <mvc:message-converters> タグに MappingJacksonHttpMessageConverter をカスタマイズする場合

[変更方法]

以下の通り、修正してください。

• HttpMessageConverter のクラス名を変更します (MappingJacksonHttpMessageConverter -> MappingJackson2HttpMessageConverter)
• JacksonのAPIのパッケージ名を変更します ("org.codehaus -> com.fasterxml)

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

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-web/src/main/resources/META-INF/spring/spring-mvc.xml
• $YOUR_SINGLE_PROJECT/src/main/resources/META-INF/spring/spring-mvc.xml
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/META-INF/spring/spring-mvc.xml

<bean id="jsonMessageConverter"
    class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"> <!-- ### Need to edit ### -->
    <property name="objectMapper">
        <bean id="objectMapper" class="com.fasterxml.jackson.databind.ObjectMapper"> <!-- ### Need to edit ### -->
            <property name="dateFormat">
                <bean class="com.fasterxml.jackson.databind.util.StdDateFormat" /> <!-- ### Need to edit ### -->
            </property>
        </bean>
    </property>
    <!-- ... -->
</bean>

<mvc:annotation-driven>
    <mvc:message-converters register-defaults="false">
        <ref bean="jsonMessageConverter" />
    </mvc:message-converters>
    <!-- ... -->
</mvc:annotation-driven>

Note

他のプロパティを定義している場合、必要に応じて修正してください。

[参考]

この設定は5.0.0から無効になります。

<bean id="jsonMessageConverter"
    class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter">
    <property name="objectMapper">
        <bean id="objectMapper" class="org.codehaus.jackson.map.ObjectMapper">
            <property name="dateFormat">
                <bean class="org.codehaus.jackson.map.util.StdDateFormat" />
            </property>
        </bean>
    </property>
    <!-- ... -->
</bean>

<mvc:annotation-driven>
    <mvc:message-converters register-defaults="false">
        <ref bean="jsonMessageConverter" />
    </mvc:message-converters>
    <!-- ... -->
</mvc:annotation-driven>

5.0.0から(Spring Security 4.1から)、Jackson 1.xのは、サポートされていません。 Jackson 1.xのを使用してのであれば、修正するアプリケーションは、Jackson 2.4のクラスを使用する必要があります。

[手順の必要なケース]

以下のいずれかのケースと一致する場合、次の変更を行ってください。

• シリアライズまたはデシリアライズをカスタマイズするJackson 1.xのアノテーションを使用している場合
• Jackson 1.xより提供されるインタフェース（または拡張クラス）を実装する場合

[変更方法]

Jackson 2.4のクラスを使用するように変更してください。

Note

Root packageは以下の通りになります。

• 1.x : org.codehaus
• 2.4 : com.fasterxml

サブパッケージ構成も色々変更されています。

For examples,

• org.codehaus.jackson.map.ObjectMapper -> com.fasterxml.jackson.databind.ObjectMapper
• org.codehaus.jackson.map.util.StdDateFormat -> com.fasterxml.jackson.databind.util.StdDateFormat
• more ...

@JsonSerialize.include ( @JsonSerialize.include は非推奨になりました)代わりに @JsonInclude 使用するように変更してください

@JsonInclude(JsonInclude.Include.NON_NULL) // ### Need to change ###
private String password;

[参考]

このコードは5.0.0から非推奨なスタイルになります。

@JsonSerialize(include = Inclusion.NON_NULL)
private String password;

5.0.0から、Spring IO Platform 1.1.0.RELEASEは依存ライブラリのバージョン管理のために適用されています。 その為、Tilesは3.0.5に更新されました。

[手順の必要なケース]

以下のケースと一致する場合、次の変更を行ってください。

• ビューを解決するためにTilesを使用している場合

[変更方法(推奨スタイル)]

Tiles 3.0ためのクラスを使用するように変更してください。 <mvc:tiles> タグと <mvc:tiles-configurer> タグを使用することを推奨します。

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

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-web/src/main/resources/META-INF/spring/spring-mvc.xml
• $YOUR_SINGLE_PROJECT/src/main/resources/META-INF/spring/spring-mvc.xml
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/META-INF/spring/spring-mvc.xml

<mvc:view-resolvers>
    <!-- ... -->
    <mvc:tiles /> <!-- ### Need to replace ### -->
    <!-- ... -->
</mvc:view-resolvers>

<!-- ### Need to replace ### -->
<mvc:tiles-configurer>
    <mvc:definitions location="/WEB-INF/tiles/tiles-definitions.xml" />
</mvc:tiles-configurer>

[別の方法(参考)]

この設定は従来のスタイルになります。

<bean
    class="org.springframework.web.servlet.view.tiles3.TilesViewResolver">
    <property name="order" value="1" />
</bean>

<bean class="org.springframework.web.servlet.view.tiles3.TilesConfigurer">
    <property name="definitions">
        <list>
            <value>/WEB-INF/tiles/tiles-definitions.xml</value>
        </list>
    </property>
</bean>

[参考]

この設定は5.0.0から無効になります。

<bean
    class="org.springframework.web.servlet.view.tiles2.TilesViewResolver">
    <property name="order" value="1" />
</bean>

<bean class="org.springframework.web.servlet.view.tiles2.TilesConfigurer">
    <property name="definitions">
        <list>
            <value>/WEB-INF/tiles/tiles-definitions.xml</value>
        </list>
    </property>
</bean>

5.0.0から、Spring IO Platform 1.1.0.RELEASEは依存ライブラリのバージョン管理のために適用されています。 その為Tilesは3.0.5に更新されたので、Tiles 3.0から、dtdファイルが更新されました。

[手順の必要なケース]

以下のケースと一致する場合、次の変更を行ってください。

• ビューを解決するためにTilesを使用している場合

[変更方法]

dtdファイルをTiles 3.0を使用するように修正してください。

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

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-web/src/main/webapp/META-INF/tiles/tiles-definitions.xml
• $YOUR_SINGLE_PROJECT/src/main/webapp/META-INF/tiles/tiles-definitions.xml
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/webapp/META-INF/tiles/tiles-definitions.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE tiles-definitions PUBLIC
   "-//Apache Software Foundation//DTD Tiles Configuration 3.0//EN"
   "http://tiles.apache.org/dtds/tiles-config_3_0.dtd"> <!-- ### Need to edit ### -->

<tiles-definitions>
    <!-- ... -->
</tiles-definitions>

[参考]

この設定は5.0.0から無効になります。

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE tiles-definitions PUBLIC
   "-//Apache Software Foundation//DTD Tiles Configuration 2.1//EN"
   "http://tiles.apache.org/dtds/tiles-config_2_1.dtd">

<tiles-definitions>
    <!-- ... -->
</tiles-definitions>

5.0.0から、Spring IO Platform 1.1.0.RELEASEは依存ライブラリのバージョン管理のために適用されています。 その為、Tilesは3.0に更新されたので、 Tiles 3.0から、 tags-tiles-extras はJSPタグライブラリとして追加されています。

[手順の必要なケース]

以下のケースと一致する場合、次の変更を行ってください。

• ビューを解決するためにTilesを使用している場合
• <tiles:useAttribute> タグを使用している場合

[変更方法]

tags-tiles-extras をtaglibに追加してください。

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

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-web/src/main/webapp/META-INF/views/common/include.jsp
• $YOUR_SINGLE_PROJECT/src/main/webapp/META-INF/views/common/include.jsp
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/webapp/META-INF/views/common/include.jsp

<%-- ... --%>
<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles"%>
<%@ taglib uri="http://tiles.apache.org/tags-tiles-extras" prefix="tilesx"%> <!-- ### Need to add ### -->
<%-- ... --%>

そして、新しいJSPタグライブラリ(<tilesx:useAttribute>)を使用するようにJSPの変更が必要になります。

<%-- ... --%>
<tilesx:useAttribute id="cssList" name="cssList" classname="java.util.List" /> <!-- ### Need to edit ### -->
<%-- ... --%>

[参考]

この設定は5.0.0から無効になります。

<%-- ... --%>
<tiles:useAttribute id="cssList" name="cssList" classname="java.util.List" />
<%-- ... --%>

5.0.0から、Spring IO Platform 1.1.0.RELEASEは依存ライブラリのバージョン管理のために適用されています。 その為、Hibernate Validatorは5.1.3に更新されました。 Tiles 5.1.3から、以下のデフォルトのメッセージの変更とバグ(HV-949)が含まれています。

• @DecimalMax メッセージ定義の変更(Expression Languageを使用するように修正)
• @DecimalMin メッセージ定義の変更(Expression Languageを使用するように修正)
• 新しいメッセージ定義を追加
• 新しいメッセージ定義のバグ(HV-949)

[手順の必要なケース]

以下のいずれかのケースと一致する場合、次の変更を行ってください。

• @javax.validation.constraints.DecimalMax を使用している場合
• @javax.validation.constraints.DecimalMin を使用している場合
• 移行後の新しいメッセージ定義を使用する場合

[変更方法]

以下を実施してください:

• 4.3と 5.1に違いを確認
• application messagesとの違いを対応
• 新しいアノテーションか @CreditCardNumber を使用している場合、メッセージ定義を修正

以下のいずれかのファイルを修正する。(ファイルがない場合は追加する)

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-web/src/main/resources/ValidationMessages.properties
• $YOUR_SINGLE_PROJECT/src/main/resources/ValidationMessages.properties
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/ValidationMessages.properties

5.0.0から、Spring IO Platform 1.1.0.RELEASEは依存ライブラリのバージョン管理のために適用されています。 その為、Bean Validationは1.1に更新された。 Bean Validation 1.1から、一部のAPIは非推奨になりました。

[手順の必要なケース]

以下のいずれかのケースと一致する場合、次の変更を行ってください。

• javax.validation.ConstraintValidatorContext.ConstraintViolationBuilder.addNode(String) を使用している場合
• javax.validation.ConstraintValidatorContext.ConstraintViolationBuilder.NodeBuilderDefinedContext.addNode(String) を使用している場合
• javax.validation.ConstraintValidatorContext.ConstraintViolationBuilder.NodeBuilderCustomizableContext.addNode(String) を使用している場合
• javax.validation.ConstraintValidatorContext.ConstraintViolationBuilder.NodeContextBuilder.addNode(String) を使用している場合

[変更方法]

Bean Validation 1.1から追加されたAPI(addPropertyNode, addBeanNode, addParameterNode)に置き換えてください。 非推奨となったAPIの詳細は こちら を参照してください。

5.0.0から、Spring IO Platform 1.1.0.RELEASEは依存ライブラリのバージョン管理のために適用されています。 その為、Joda Timeは2.5に更新されました。 Bean Validation 1.1から、一部のAPIは非推奨になりました。

[手順の必要なケース]

以下のケースと一致する場合、次の修正を行ってください。

• org.joda.time.DateMidnight を使用している場合

[変更方法]

タイムゾーンを必要としない場合は、 org.joda.time.LocalDate を使用してください。

LocalDate currentLocalDate  = new LocalDate();

または

タイムゾーンが必要な場合は、 org.joda.time.DateTime.withTimeAtStartOfDay() を使用して、一日の開始時に設定されている org.joda.time.DateTime を使用してください。

DateTime currentDateTimeAtStartOfDay = new DateTime().withTimeAtStartOfDay();

[参考]

この設定は5.0.0から非推奨なスタイルになります。

DateMidnight currentDateMidnight = new DateMidnight();

5.0.0から、Spring IO Platform 1.1.0.RELEASEは依存ライブラリのバージョン管理のために適用されています。 その為、Apache Commons DBCPは2.0に更新されました。

[手順の必要なケース]

以下のケースと一致する場合、次の修正を行ってください。

• org.apache.commons.dbcp.BasicDataSource を使用している場合

[変更方法]

以下の通り、修正してください。

• BasicDataSource のパッケージ名を org.apache.commons.dbcp から org.apache.commons.dbcp2 に修正
• idle状態とactive状態の同時接続数を設定するプロパティ名を maxActive から maxTotal に変更
• connection poolからexceptionをスローするまでの最大wait時間(ミリ秒)を設定するプロパティ名を maxWait から maxWaitMillis に変更

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

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

<bean id="realDataSource" class="org.apache.commons.dbcp2.BasicDataSource"
    destroy-method="close"> <!-- ### Need to edit ### -->
    <property name="driverClassName" value="${database.driverClassName}" />
    <property name="url" value="${database.url}" />
    <property name="username" value="${database.username}" />
    <property name="password" value="${database.password}" />
    <property name="defaultAutoCommit" value="false" />
    <property name="maxTotal" value="${cp.maxActive}" /> <!-- ### Need to edit ### -->
    <property name="maxIdle" value="${cp.maxIdle}" />
    <property name="minIdle" value="${cp.minIdle}" />
    <property name="maxWaitMillis" value="${cp.maxWait}" /> <!-- ### Need to edit ### -->
</bean>

Note

以下のプロパティを使用した場合、必要に応じて修正してください。

• removeAbandoned を使用している場合、 removeAbandonedOnBorrow または removeAbandonedOnMaintenance または両方を使用してください。

[参考]

<bean id="realDataSource" class="org.apache.commons.dbcp.BasicDataSource"
    destroy-method="close">
    <property name="driverClassName" value="${database.driverClassName}" />
    <property name="url" value="${database.url}" />
    <property name="username" value="${database.username}" />
    <property name="password" value="${database.password}" />
    <property name="defaultAutoCommit" value="false" />
    <property name="maxActive" value="${cp.maxActive}" />
    <property name="maxIdle" value="${cp.maxIdle}" />
    <property name="minIdle" value="${cp.minIdle}" />
    <property name="maxWait" value="${cp.maxWait}" />
</bean>

5.0.0から、 @ExistInCodeList のメッセージキーの仕様は、バグ修正のために変更されました。 バグ情報について GitHub issues#16 参照してください。

[手順の必要なケース]

以下のケースと一致する場合、次の修正を行ってください。

• @ExistInCodeList のデフォルトのメッセージをオーバーライドする場合。

[変更方法]

@ExistInCodeList のメッセージキーに .message を追加してください。

次のいずれかのファイルを変更してください。

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-web/src/main/resources/ValidationMessages.properties
• $YOUR_SINGLE_PROJECT/src/main/resources/ValidationMessages.properties
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/ValidationMessages.properties

org.terasoluna.gfw.common.codelist.ExistInCodeList.message = Custom message for your application

[参考]

この設定は5.0.0から非推奨なスタイルになります。

org.terasoluna.gfw.common.codelist.ExistInCodeList = Custom message for your application

5.0.0から、 QueryEscapeUtils のメソッドの仕様は、バグ修正のために変更されました。 バグ情報について GitHub issues#148 を参照してください。 この仕様変更により、SQL(またはJPQL)でLIKE句のワイルドカード文字での誤ったエスケープ問題が解決されます。

Note

ワイルドカード文字について(エスケープ対象文字)

1.0.1までは、ワイルドカード文字は、以下のとおりです:

• % , _ , ％ , ＿

5.0.0以降、デフォルトのワイルドカード文字は、以下のとおりです:

• % , _

[手順の必要なケース]

以下のケースとすべて一致する場合、次の修正を行ってください。

• ワイルドカード文字をエスケープするために QueryEscapeUtils のメソッドを使用している場合。
• '％' と '＿' をワイルドカード文字(全角ワイルドカード文字)としてサポートするデータベースを使用している場合。例:Oracle 11g。

[変更方法]

オプション(1.0.1との互換性オプション)を使用するように変更してください。

• QueryEscapeUtils.withFullWidth() メソッドを使用して全角ワイルドカード文字をエスケープするため、 LikeConditionEscape インスタンスを取得。
• QueryEscapeUtils と同じシグネチャのメソッドを呼び出。

変更されたコードは以下のようになります:

String escapedWord = QueryEscapeUtils.withFullWidth().toLikeCondition(query);

5.0.0から、 f:u() の仕様は、バグ修正のため変更されました。 バグの詳細について GitHub issues#149 を参照してください。 この仕様変更により、クエリ文字列のパラメータ値での誤ったURLエンコードの問題が解決されます。

Note

エンコード対象について

• 1.0.1まで f:u() はURIをエンコードするEL関数でした(例: http://localhost:8080/path?param=value#fragment)。
• 5.0.0（および1.0.2）以降、 f:u() はリクエストパラメータ値をエンコードするためのEL関数になります。

[手順の必要なケース]

以下のケースと一致する場合、次の修正を行ってください。

• URIのエンコードを使用している場合(例: http://localhost:8080/path?param=value#fragment)。

[変更方法]

以下のJSPタグライブラリを使うように修正してください。

• <c:url>
• <spring:url>

<a href="<c:url value="${url}" />">Link Name</a>

5.0.0から、 CompositeRequestDataValueProcessor#getExtraHiddenFields のメソッドの仕様は、バグ修正のため変更されました。 バグの詳細について GitHub issues#167 を参照してください。

Note

RequestDataValueProcessor によって生成された隠されたタグの出力順について

この仕様変更により、 RequestDataValueProcessor (CSRFトークン、トランザクショントークン、等...)によって生成されたhiddenタグの出力順序は変更される可能性があります。

[手順の必要なケース]

以下のいずれかのケースと一致する場合、次の変更を行ってください。

• RequestDataValueProcessor によって生成されたhiddenタグに、JavaScriptを使用してアクセスしている場合。
• RequestDataValueProcessor によって生成されたhiddenタグに、自動化されたE2Eテストケース（Seleniumなど...）でアクセスしている場合。

[変更方法]

hiddenタグの出力順序に関連して発生した問題の場合、

RequestDataValueProcessor によって生成されたhiddenタグへのアクセス方法に変更してください。

5.0.0から、 ValidationMessages.properties は、terasoluna-gfw-commonのJARファイルからバグ修正のため除外されています。 バグの詳細について GitHub issues#256 を参照してください。

関連する問題は [multi#99], [single#75].

Note

表示されるメッセージについて

この変更により、 @ExistInCodeList のデフォルトメッセージは表示されていない(代わりに、メッセージキーが表示されている)可能性があります。

[手順の必要なケース]

以下のケースとすべて一致する場合、次の修正を行ってください。

• Beanの検証として、 @ExistInCodeList のアノテーションを使用している場合。
• terasoluna-gfw-commonのJARファイル内の ValidationMessages.properties の @ExistInCodeList のデフォルトのメッセージを使用している場合。

[変更方法]

以下のいずれかのファイルに @ExistInCodeList のメッセージ定義を追加してください。(プロジェクト内のファイルが存在しない場合は、プロジェクトにファイルを追加してください)

• YOUR_MULTIPLE_PROJECT_ROOT/xxx-web/src/main/resources/ValidationMessages.properties
• $YOUR_SINGLE_PROJECT/src/main/resources/ValidationMessages.properties
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/ValidationMessages.properties

org.terasoluna.gfw.common.codelist.ExistInCodeList.message = Does not exist in {codeListId}

5.0.0から、 <pagination> タグの改善のためアクティブなページのリンク（現在のページのリンク）の仕様が変更されました。 バグの詳細について GitHub issues#13 を参照してください。

Note

アクティブなページのリンクのについて仕様

1.0.1までは, 以下のような仕様:

• アクティブリンクが有効になっていました。これは、アクティブページリンクをクリックすると、現在のページを再読み込みするのためのリクエストしたことを意味します。

5.0.0以降, 以下のような仕様:

• アクティブリンクが無効になります。これは、アクティブページリンクをクリックすると、現在のページを再読み込みするのためのリクエストがされないことを意味します。

[手順の必要なケース]

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

• アクティブなページのリンクがクリックされたときに、現在のページをリロードする必要がある場合。

[変更方法]

アクティブなページのリンクを有効にするには <pagination> タグに enableLinkOfCurrentPage="true" を設定してください

<t:pagination
    page="${page}"
    enableLinkOfCurrentPage="true" /> <!-- ### Need to set the 'enableLinkOfCurrentPage' attribute ### -->

5.0.0から、 <pagination> タグの改善のため、無効なページリンクの仕様が変更されました。 バグの詳細について GitHub issues#14 を参照してください。

Note

無効なページリンクについての仕様

1.0.1までは, 以下のような仕様:

• 無効リンクのhrefに "#" を設定していました。これは、無効なページのリンクをクリックすると、ページ位置が現在のページの先頭に移動していたことを意味します。

5.0.0以降, 以下のような仕様:

• 無効リンクのhrefに "javascript:void(0)" を設定します。これは、無効なページのリンクをクリックすると、ページ位置が現在のページの先頭に移動しないことを意味します。

[手順の必要なケース]

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

• この動作(例:JavaScriptを使用して)がアプリケーションですでに適用されてしまい解決したい場合。

[変更方法]

1.0.1と同じ動作を適用するには <pagination> タグに disabledHref="#" を設定してください。

<t:pagination
    page="${page}"
    disabledHref="#" /> <!-- ### Need to set the 'disabledHref' attribute ### -->

Note

アプリケーションの措置が5.0.0と同じである場合( <pagination> タグに disabledHref="javascript:void(0)" を設定していた場合)、アプリケーションの措置は削除することを推奨します。

5.0.0から、 the alert component of the Bootstrap との互換性をサポートするための ResultMessages.warn() メソッドの代わりに ResultMessages.warning() メソッドが追加されています。 この変更により、 ResultMessages.warn() は非推奨なメソッドとなりました。

[手順の必要なケース]

この手順は任意です。必要な場合、次の修正を行ってください。

Note

アプリケーションが本番環境にリリースされていない場合、次の変更が推奨されます。

[変更方法]

ResultMessages.warn() の代わりに ResultMessages.warning() を使用するようにアプリケーションを変更してください。それと必要に応じて、CSSファイルを変更してください。

5.0.0から、terasoluna-gfw-jodatimeはJoda Timeに依存するコンポーネントを提供するための代わりに追加されています。(terasoluna-gfw-commonからJoda Timeに依存するコンポーネントを分離するため)

[手順の必要なケース]

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

• DateFactory を使用している場合

[変更方法]

以下のファイルの依存関係の定義に、terasoluna-gfw-jodatimeアーティファクトを追加してください。

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-domain/pom.xml
• $YOUR_SINGLE_PROJECT/pom.xml
• $YOUR_ECLIPSE_WTP_PROJECT/.classpath
• $YOUR_ECLIPSE_WTP_PROJECT/build.xml

pom.xml (Mavenプロジェクトのみ)

<!-- ### Need to add ### -->
<dependency>
    <groupId>org.terasoluna.gfw</groupId>
    <artifactId>terasoluna-gfw-jodatime</artifactId>
</dependency>

.classpath (WTPプロジェクトのみ)

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/terasoluna-gfw-jodatime-5.0.0.RELEASE.jar"
    sourcepath="libsrc/terasoluna-gfw-jodatime-5.0.0.RELEASE-sources.jar" /> <!-- ### Need to add ### -->

build.xml (WTPプロジェクトのみ)

<path id="build.classpath">
    <!-- ... -->
    <pathelement location="${lib.dir}/terasoluna-gfw-jodatime-5.0.0.RELEASE.jar"/> <!-- ### Need to add ### -->
    <!-- ... -->
</path>

5.0.0から、terasoluna-gfw-commonからJoda Timeに依存するコンポーネントを分離するため DateFactory の代わりに JodaTimeDateFactory が追加されています。 この変更により、 DateFactory は非推奨なメソッドとなりました。

Note

これらの変更は、将来的にJava 8から追加されたDate/Time API(JSR-310)をサポートできるようになります。

[手順の必要なケース]

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

• DateFactory を使用している場合

Note

非推奨の DataFactory クラスは、今後のリリースで除去されます。

Note

アプリケーションが本番環境にリリースされていない場合、次の変更が推奨されます。

[変更方法]

DateFactory の代わりに JodaTimeDateFactory を追加して使用するようにアプリケーションを変更してください。

Java file :

public class XxxServiceImpl implements XxxService {
    @Inject
    JodaTimeDateFactory dateFactory; // ### Need to edit###
    // ...
}

Bean定義ファイル :

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

<bean id="dateFactory"
    class="org.terasoluna.gfw.common.date.jodatime.DefaultJodaTimeDateFactory" /> <!-- ### Need to edit ### -->

.. tabularcolumns:: |p{0.50\linewidth}|p{0.50\linewidth}|

5.0.0から、 BeanNameViewResolver が TilesViewResolver と BeanNameViewResolver と同じこと回避するために変更されました。 バグの詳細について GitHub multi/issues#50 を参照してください。

Note

"[Step 2] ViewResolver のXML namespaceを使用する設定に修正"の手順を適用させている場合, この手順をスキップしてください。

定義の順序は以下の通りになります:

<mvc:view-resolvers>
    <mvc:bean-name />
    <mvc:tiles />
    <mvc:jsp prefix="/WEB-INF/views/" />
</mvc:view-resolvers>

[手順の必要なケース]

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

• レイアウトエンジンとしてApacheのTileを使用している場合
• BeanNameViewResolver を使用している場合
• TilesViewResolver と BeanNameViewResolver 同じ順序で設定している場合(そのままblank projectを使用している場合)

[変更方法]

以下のファイルで、 BeanNameViewResolver の順序を TilesViewResolver の順序より低く変更してください。

• YOUR_MULTIPLE_PROJECT_ROOT/xxx-web/src/main/resources/META-INF/spring/spring-mvc.xml

<bean class="org.springframework.web.servlet.view.BeanNameViewResolver">
    <property name="order" value="0" /> <!-- ### Need to edit value attribute ### -->
</bean>

5.0.0から、 ResultMessagesLoggingInterceptor は xxx-domain.xml に追加されました。 バグの詳細について GitHub single/issues#39 を参照してください。 この変更により、 ResultMessages を保持する例外が記録されます。

[手順の必要なケース]

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

• JPAのための単一のblank projectから生成されたプロジェクトを使用している場合

[変更方法]

以下のいずれかのファイルに ResultMessagesLoggingInterceptor 定義を追加してください。

• $YOUR_SINGLE_PROJECT/src/main/resources/META-INF/spring/xxx-domain.xml
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/META-INF/spring/xxx-domain.xml

<bean id="resultMessagesLoggingInterceptor"
    class="org.terasoluna.gfw.common.exception.ResultMessagesLoggingInterceptor">
    <property name="exceptionLogger" ref="exceptionLogger" />
</bean>
<aop:config>
    <aop:advisor advice-ref="resultMessagesLoggingInterceptor"
        pointcut="@within(org.springframework.stereotype.Service)" />
</aop:config>

5.0.0から、 spring-security.xml の UserIdMDCPutFilter の設定を変更しました。 バグの詳細について GitHub single/issues#45 を参照してください。 この変更により、 それはSpring Securityの処理を終えた後のログに、ログインユーザ名を含めることが可能となります。

[手順の必要なケース]

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

• 認証と承認の処理などでSpring Securityを使用している場合

[変更方法]

以下のいずれかのファイルから UserIdMDCPutFilter の removeValue プロパティを削除してください。

• $YOUR_SINGLE_PROJECT/src/main/resources/META-INF/spring/spring-security.xml
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/META-INF/spring/spring-security.xml

<bean id="userIdMDCPutFilter" class="org.terasoluna.gfw.security.web.logging.UserIdMDCPutFilter">
    <!-- ### Need to remove the 'removeValue' property ### -->
</bean>

1.0.2から、 pom.xml から <distributionManagement> の設定が削除されます。 バグの詳細について GitHub multi/issues#8 を参照してください。

[手順の必要なケース]

この手順はオプションですが、次の修正を適用することを推奨します。

[変更方法]

以下のファイルから、 <distributionManagement> の設定を削除するか、 <distributionManagement> の設定からterasolunaorgリポジトリ(terasoluna-gfw-releases, terasoluna-gfw-snapshots)を削除してください。

• $YOUR_MULTIPLE_PROJECT_ROOT/pom.xml

<distributionManagement>
    <!-- ### Need to remove terasolunaorg repositories ### -->
    <!--
    <repository>
        <id>terasoluna-gfw-releases</id>
        <url>http://repo.terasoluna.org/nexus/content/repositories/terasoluna-gfw-releases/</url>
    </repository>
    <snapshotRepository>
        <id>terasoluna-gfw-snapshots</id>
        <url>http://repo.terasoluna.org/nexus/content/repositories/terasoluna-gfw-snapshots/</url>
    </snapshotRepository>
    -->
</distributionManagement>

5.0.0から、 <relativePath /> は pom.xml に追加されました。 バグの詳細について GitHub multi/issues#36 と GitHub single/issues#46 を参照してください。 この変更により、 STSの最初のインポートとのトラブルを避けることができるようになりました。

[手順の必要なケース]

この手順はオプションですが、次の修正を適用することを推奨します。

[変更方法]

以下のいずれかのファイルに、 <parent> の子要素として <relativePath /> 要素を追加してください。

• $YOUR_MULTIPLE_PROJECT_ROOT/pom.xml
• $YOUR_SINGLE_PROJECT/pom.xml

<parent>
    <groupId>org.terasoluna.gfw</groupId>
    <artifactId>terasoluna-gfw-parent</artifactId>
    <version>5.0.0.RELEASE</version>
    <relativePath /> <!-- ### Need to add ### -->
</parent>

5.0.0から、 JdbcCodeList のための jdbcTemplate のBean定義は xxx-codelist.xml に追加されています。 バグの詳細について GitHub multi/issues#39 を参照してください。 この変更により、 select文にフェッチサイズを指定することが可能となりました。

[手順の必要なケース]

以下のケースと一致する場合、次の修正を適用することを推奨します。

• JdbcCodeList として大量のレコードを使用している場合

[変更方法]

以下のファイルに JdbcCodeList の抽象Bean & jdbcTemplate のBean定義を追加してください。

• $YOUR_MULTIPLE_PROJECT_ROOT/src/main/resources/META-INF/spring/xxx-domain.xml
• $YOUR_SINGLE_PROJECT/src/main/resources/META-INF/spring/xxx-domain.xml
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/META-INF/spring/xxx-domain.xml

<bean id="jdbcTemplateForCodeList" class="org.springframework.jdbc.core.JdbcTemplate">
    <property name="dataSource" ref="dataSource" />
    <property name="fetchSize" value="${codelist.jdbc.fetchSize:1000}" />
</bean>

<bean id="AbstractJdbcCodeList"
      class="org.terasoluna.gfw.common.codelist.JdbcCodeList" abstract="true">
    <property name="jdbcTemplate" ref="jdbcTemplateForCodeList" />
</bean>

それと JdbcCodeList Bean定義に抽象Beanを適用するための手順を実行してください。

• class 属性の代わりに parent 属性に抽象Bean IDを指定
• dataSource プロパティを削除。

<bean id="CL_SAMPLE" parent="AbstractJdbcCodeList"> <!-- ### Need to edit ### -->
    <property name="querySql" value="SELECT code, code_name FROM t_sample_codes ORDER BY code" />
    <property name="valueColumn" value="code" />
    <property name="labelColumn" value="code_name" />
    <!-- ### Need to remove the 'dataSource' property ### -->
</bean>

5.0.0から、 ワイルドカードインポートは xxx-domain.xml に複数のコードリストの定義ファイルをインポートするために使用されています。 バグの詳細について GitHub multi/issues#66 と GitHub single/issues#71 を参照してください。 この変更により、 ネストされたディレクトリから複数のファイルをインポートすることが可能となる。

[手順の必要なケース]

この手順は任意です。必要な場合、次の修正を行ってください。

[変更方法]

以下のいずれかのファイルにワイルドカードのインポートを使用するように変更してください。

• $YOUR_MULTIPLE_PROJECT_ROOT/src/main/resources/META-INF/spring/xxx-domain.xml
• $YOUR_SINGLE_PROJECT/src/main/resources/META-INF/spring/xxx-domain.xml
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/META-INF/spring/xxx-domain.xml

<import resource="classpath*:META-INF/spring/**/*-codelist.xml" /> <!-- ### Need to edit ### -->

1.0.2から、 CodeListInterceptor は spring-mvc.xml に追加されました。 バグの詳細について GitHub multi/issues#77 と GitHub single/issues#62 を参照してください。 この変更により、 CodeList はビューコンポーネント（例:JSP）からアクセスすることができます。

[手順の必要なケース]

この手順は任意です。必要な場合、次の修正を行ってください。

[変更方法]

以下のいずれかのファイルに CodeListInterceptor 定義を追加してください。

• $YOUR_MULTIPLE_PROJECT_ROOT/src/main/resources/META-INF/spring/spring-mvc.xml
• $YOUR_SINGLE_PROJECT/src/main/resources/META-INF/spring/spring-mvc.xml
• $YOUR_ECLIPSE_WTP_PROJECT/src/main/resources/META-INF/spring/spring-mvc.xml

<mvc:interceptors>

    <!-- omit -->

    <mvc:interceptor>
        <mvc:mapping path="/**" />
        <mvc:exclude-mapping path="/resources/**" />
        <mvc:exclude-mapping path="/**/*.html" />
        <bean class="org.terasoluna.gfw.web.codelist.CodeListInterceptor">
            <property name="codeListIdPattern" value="CL_.+" />
        </bean>
    </mvc:interceptor>

    <!-- omit -->

</mvc:interceptors>

5.0.0から、Spring IO Platform 1.1.1.RELEASEは依存ライブラリのバージョン管理のため適用されています。 この変更により、ビルド設定はblank projectに変更されました。

[手順の必要なケース]

この手順の一部は必要になります。

[変更方法]

blank projectの変更を適用してください。

Note

変更内容の詳細は comparing page with 1.0.1.RELEASE and 5.0.0.RELEASE を参照してください。

• "Files changed" のタブを選択
• "32 changed files" のリンクをクリック (ファイルの一覧を開く)
• "pom.xml" のリンクをクリック (ファイルの差分に移動)

不要な場合は、 <build>/<extensions>/<extension> を削除してください。 （推奨手順）

• org.apache.maven.archetype:archetype-packaging
• org.apache.maven.wagon:wagon-ssh
• org.apache.maven.archetype:archetype-packaging

不要な場合は、 <build>/<pluginManagement> を削除してください。 （推奨手順）

• org.apache.maven.plugins:maven-compiler-plugin

不要な場合は、 <reporting> を削除してください。 (推奨手順）

• org.apache.maven.plugins:maven-checkstyle-plugin
• org.apache.maven.plugins:maven-javadoc-plugin
• org.apache.maven.plugins:maven-project-info-reports-plugin
• org.apache.maven.plugins:maven-resources-plugin
• org.apache.maven.plugins:maven-site-plugin
• org.apache.maven.plugins:maven-surefire-report-plugin
• org.apache.maven.plugins:maven-jxr-plugin
• org.codehaus.mojo:emma-maven-plugin
• org.codehaus.mojo:findbugs-maven-plugin

<dependencyManagement> から dependencies managed by the Spring IO Platform を削除してください。 (推奨手順)

• org.apache.tomcat:tomcat-servlet-api
• org.apache.tomcat:tomcat-jsp-api
• etc ...

<properties> 設定から不必要なプロパティを削除してください。 (推奨手順)

Note

変更内容の詳細は comparing page with 1.0.1.RELEASE and 5.0.0.RELEASE を参照してください。

• "Files changed" のタブを選択
• "32 changed files" のリンクをクリック (ファイルの一覧を開く)
• "projectName-domain/pom.xml" のリンクをクリック (ファイルの差分に移動)

org.mockito:mockito-core を使用するように変更してください (必須手順)

• org.mockito:mockito-all -> org.mockito:mockito-core

<dependencies> 設定にユニットテストのための新しいライブラリを追加してください。 (条件付き必須手順)

• org.apache.tomcat.embed:tomcat-embed-el:test (Bean検証をテストする場合は、このライブラリが必要です)

<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-el</artifactId>
    <scope>test</scope>
</dependency>

依存関係の設定にスコープを指定してください。 (条件付き必須手順)

• ユニットテストでライブラリを使用している場合のみ、 test スコープが必要です。
• アプリケーションサーバが提供するライブラリを使用している場合は、 provided スコープが必要です。
• アプリケーション実行時にライブラリを使用している場合は、 runtime スコープが必要です。

Note

変更内容の詳細は comparing page with 1.0.1.RELEASE and 5.0.0.RELEASE を参照してください。

• "Files changed" のタブを選択
• "32 changed files" のリンクをクリック (ファイルの一覧を開く)
• "projectName-env/pom.xml" のリンクをクリック (ファイルの差分に移動)

不要な場合は、 <build>/<plugins> の設定を削除してください。

• org.apache.maven.plugins:maven-eclipse-plugin

Note

変更内容の詳細は comparing page with 1.0.1.RELEASE and 5.0.0.RELEASE を参照してください。

• "Files changed" のタブを選択
• "32 changed files" のリンクをクリック (ファイルの一覧を開く)
• "projectName-web/pom.xml" のリンクをクリック (ファイルの差分に移動)

<dependencies> 設定にユニットテストのための新しいライブラリを追加してください。 (条件付き必須手順)

• org.apache.tomcat.embed:tomcat-embed-el:test (Bean検証をテストする場合は、このライブラリが必要です)

<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-el</artifactId>
    <scope>test</scope>
</dependency>

依存関係の設定にスコープを指定してください。 (条件付き必須手順)

• ユニットテストでライブラリを使用している場合のみ、 test スコープが必要です。
• アプリケーションサーバが提供するライブラリを使用している場合は、 provided スコープが必要です。
• アプリケーション実行時にライブラリを使用している場合は、 runtime スコープが必要です。

5.0.0からは、JDBCドライバの設定は pom.xml で改善されました。 バグ情報について GitHub multi/issues#92 を参照してください。

改善は以下の通りになります。

• ローカルプロファイルでのみH2 Databaseを使用することができるように改善 (つまり、製造やテストのためにwarファイルにH2 Databaseのjarファイルを除外するように改善)
• WebプロジェクトからJDBCドライバを削除する改善

[手順の必要なケース]

この手順は任意です。必要な場合、次の修正を行ってください。

[変更方法]

以下のファイルのすべてに改善を適用してください。

• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-domain/pom.xml
• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-env/pom.xml
• $YOUR_MULTIPLE_PROJECT_ROOT/xxx-web/pom.xml

まず、 xxx-domain/pom.xml からH2 Databaseの依存関係の定義を削除してください。

<!-- ### Need to remove the H2 Database ###
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>
-->

xxx-env/pom.xml のローカルプロファイルにH2 Databaseの依存関係の定義を追加してください。

<profile>
    <id>local</id>
    <activation>
        <activeByDefault>true</activeByDefault>
    </activation>
    <properties>
        <resource.directory>src/main/resources</resource.directory>
        <buildFinalName>${project.artifactId}-${project.version}</buildFinalName>
    </properties>
    <!-- ### Need to add H2 Database dependency ### -->
    <dependencies>
        <dependency>
            <groupId>com.h2database</groupId>
            <artifactId>h2</artifactId>
            <scope>runtime</scope>
        </dependency>
    </dependencies>
</profile>

xxx-web/pom.xml の default のプロファイル設定を変更してください。

• default から default へプロファイルIDを変更
• XXX-env.jarを含むwarファイルを生成するために、warpack-with-env プロファイルを追加 (Note: H2 databaseは除外)

<profiles>
    <profile>
        <id>local</id> <!-- ### Need to edit ### -->
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <dependencies>
            <dependency>
                <groupId>com.example</groupId>
                <artifactId>xxx-env</artifactId>
            </dependency>
        </dependencies>
    </profile>
    <profile>
        <id>warpack</id>
        <dependencies>
        </dependencies>
    </profile>
    <!-- ### Need to add warpack-with-env ### -->
    <profile>
        <id>warpack-with-env</id>
        <dependencies>
            <dependency>
                <groupId>${project.groupId}</groupId>
                <artifactId>xxx-env</artifactId>
                <exclusions>
                    <exclusion>
                        <groupId>com.h2database</groupId>
                        <artifactId>h2</artifactId>
                    </exclusion>
                </exclusions>
            </dependency>
        </dependencies>
    </profile>
</profiles>

Note

<groupId> や <artifactId> の値を設定することについて

プロジェクト設定によって、 <groupId> と <artifactId> の値を設定してください。

最後に、 xxx-web/pom.xml からJDBCドライバの依存関係を削除してください。

5.0.0から、Spring IO Platform 1.1.1.RELEASEは、依存ライブラリのバージョン管理のために適用います。 この変更により、ビルド設定はblank projectで変更されました。

[手順の必要なケース]

この手順は任意です。必要な場合、次の修正を行ってください。

[変更方法]

以下のファイルから dependency managed by the Spring IO Platform のバージョンタグを削除してください。

• $YOUR_SINGLE_PROJECT/pom.xml

例:)

<dependency>
    <!-- omit -->

    <groupId>org.apache.tomcat</groupId>
    <artifactId>tomcat-jsp-api</artifactId>
    <!-- ### Remove version tag ### -->
    <scope>provided</scope>

    <!-- omit -->
</dependency>

5.0.0から、 pom.xml にユニットテストのための依存関係が追加されました。 バグ情報について GitHub single/issues#6 を参照してください。

[手順の必要なケース]

この手順は任意です。必要な場合、次の修正を行ってください。

[変更方法]

以下のファイルのようにユニットテストの依存関係を追加してください。

• $YOUR_SINGLE_PROJECT/pom.xml

</dependencies>

    <!-- omit -->

    <!-- ### Need to add dependencies for unit testing ### -->
    <!-- Unit Test -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.mockito</groupId>
        <artifactId>mockito-core</artifactId>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-test</artifactId>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.apache.tomcat.embed</groupId>
        <artifactId>tomcat-embed-el</artifactId>
        <scope>test</scope>
    </dependency>

</dependencies>

• $YOUR_ECLIPSE_WTP_PROJECT/.classpath

<!-- ### Need to add dependencies for unit testing ### -->
<classpathentry kind="lib"
    path="testlib/hamcrest-core-1.3.jar"
    sourcepath="libsrc/hamcrest-core-1.3-sources.jar" />
<classpathentry kind="lib"
    path="testlib/junit-4.11.jar"
    sourcepath="libsrc/junit-4.11-sources.jar" />
<classpathentry kind="lib"
    path="testlib/mockito-core-1.10.8.jar"
    sourcepath="libsrc/mockito-core-1.10.8-sources.jar" />
<classpathentry kind="lib"
    path="testlib/objenesis-2.1.jar"
    sourcepath="libsrc/objenesis-2.1-sources.jar" />
<classpathentry kind="lib"
    path="testlib/spring-test-4.1.4.RELEASE.jar"
    sourcepath="libsrc/spring-test-4.1.4.RELEASE-sources.jar" />
<classpathentry kind="lib"
    path="testlib/tomcat-embed-el-7.0.57.jar"
    sourcepath="libsrc/tomcat-embed-el-7.0.57-sources.jar" />

Note

jarファイルは Eclipse WTP Project of 5.0.0.RELEASE からダウンロードしたzipファイルに含まれています。

• $YOUR_ECLIPSE_WTP_PROJECT/build.xml

<path id="build.test.classpath">
    <path refid="build.classpath" />
    <pathelement location="${testlib.dir}/hamcrest-core-1.3.jar"/>
    <pathelement location="${testlib.dir}/junit-4.11.jar"/>
    <pathelement location="${testlib.dir}/mockito-core-1.10.8.jar"/>
    <pathelement location="${testlib.dir}/objenesis-2.1.jar"/>
    <pathelement location="${testlib.dir}/spring-test-4.1.4.RELEASE.jar"/>
    <pathelement location="${testlib.dir}/tomcat-embed-el-7.0.57.jar"/>
</path>

5.0.0から、pom.xml のJDBCドライバの依存スコープは変更されました。 バグ情報について GitHub single/issues#60 を参照してください。

[手順の必要なケース]

この手順は任意です。必要な場合、次の修正を行ってください。

[変更方法]

以下のファイルのようにJDBCドライバの依存関係のスコープを compile から runtime へ変更してください。

• $YOUR_SINGLE_PROJECT/pom.xml

</dependencies>

    <!-- omit -->

    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope> <!-- ### Need to edit ### -->
    </dependency>

    <!-- omit -->

</dependencies>

release site から ダウンロードされたEclipse WTP プロジェクトの更新手順は以下の通り。

Note

O / RマッパーとしてMyBatis3を使用している場合は、Eclipse WTPのためのblank projectsを使用して、新しい開発プロジェクトを生成してください。 (つまり、MyBatis3の移行手順が提供されていない)

• https://github.com/terasolunaorg/terasoluna-gfw-web-blank/releases/tag/5.0.0.RELEASE

Note

Legend

[Table Header]

Non : Blank project for none O/R Mapper

MB3 : Blank project for MyBatis 3

JPA : Blank project for JPA

[Marks]

* : 対応対象

Eclipse WTP Project of 5.0.0.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 のsource 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}|

[全てのblank projectが対象]

.classpath

<!-- ### Need to delete following classpath entries ### -->

<!-- omitted -->

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/jackson-core-asl-1.9.7.jar"
    sourcepath="libsrc/jackson-core-asl-1.9.7-sources.jar" />

<!-- omitted -->

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/jackson-mapper-asl-1.9.7.jar"
    sourcepath="libsrc/jackson-mapper-asl-1.9.7-sources.jar" />

<!-- omitted -->

build.xml

<!-- ### Need to delete following classpath entries ### -->

<path id="build.classpath">
    <!-- ... -->
    <pathelement location="${lib.dir}/jackson-core-asl-1.9.7.jar"/>
    <pathelement location="${lib.dir}/jackson-mapper-asl-1.9.7.jar"/>
    <!-- ... -->
</path>

[JPA blank projectのみ対象]

.classpath

<!-- ### Need to delete following classpath entries ### -->

<!-- omitted -->

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/hibernate-jpa-2.0-api-1.0.1.Final.jar"
    sourcepath="libsrc/hibernate-jpa-2.0-api-1.0.1.Final-sources.jar" />

<!-- omitted -->

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/jboss-transaction-api_1.1_spec-1.0.1.Final.jar"
    sourcepath="libsrc/jboss-transaction-api_1.1_spec-1.0.1.Final-sources.jar" />

<!-- omitted -->

build.xml

<!-- ### Need to delete following classpath entries ### -->

<path id="build.classpath">
    <!-- ... -->
    <pathelement location="${lib.dir}/hibernate-jpa-2.0-api-1.0.1.Final.jar"/>
    <!-- ... -->
    <pathelement location="${lib.dir}/jboss-transaction-api_1.1_spec-1.0.1.Final.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}|

[全てのblank projectが対象]

.classpath

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/terasoluna-gfw-jodatime-5.0.0.RELEASE.jar"
    sourcepath="libsrc/terasoluna-gfw-jodatime-5.0.0.RELEASE-sources.jar" />

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

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

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

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/jackson-datatype-joda-2.4.4.jar"
    sourcepath="libsrc/jackson-datatype-joda-2.4.4-sources.jar" />

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

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/tiles-autotag-core-runtime-1.1.0.jar"
    sourcepath="libsrc/tiles-autotag-core-runtime-1.1.0-sources.jar" />

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/tiles-request-servlet-1.0.6.jar"
    sourcepath="libsrc/tiles-request-servlet-1.0.6-sources.jar" />

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/tiles-request-api-1.0.6.jar"
    sourcepath="libsrc/tiles-request-api-1.0.6-sources.jar" />

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/tiles-request-jsp-1.0.6.jar"
    sourcepath="libsrc/tiles-request-jsp-1.0.6-sources.jar" />

build.xml

<!-- ### Need to delete following classpath entries ### -->

<path id="build.classpath">
    <!-- ... -->
    <pathelement location="${lib.dir}/terasoluna-gfw-jodatime-5.0.0.RELEASE.jar"/>
    <pathelement location="${lib.dir}/jackson-annotations-2.4.4.jar"/>
    <pathelement location="${lib.dir}/jackson-core-2.4.4.jar"/>
    <pathelement location="${lib.dir}/jackson-databind-2.4.4.jar"/>
    <pathelement location="${lib.dir}/jackson-datatype-joda-2.4.4.jar"/>
    <pathelement location="${lib.dir}/dozer-spring-5.5.1.jar"/>
    <pathelement location="${lib.dir}/tiles-autotag-core-runtime-1.1.0.jar"/>
    <pathelement location="${lib.dir}/tiles-request-servlet-1.0.6.jar"/>
    <pathelement location="${lib.dir}/tiles-request-api-1.0.6.jar"/>
    <pathelement location="${lib.dir}/tiles-request-jsp-1.0.6.jar"/>
    <!-- ... -->
</path>

[JPA blank projectのみ対象]

.classpath

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/hibernate-jpa-2.1-api-1.0.0.Final.jar"
    sourcepath="libsrc/hibernate-jpa-2.1-api-1.0.0.Final-sources.jar" />

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

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/jboss-logging-annotations-1.2.0.Final.jar"
    sourcepath="libsrc/jboss-logging-annotations-1.2.0.Final-sources.jar" />

<classpathentry kind="lib"
    path="src/main/webapp/WEB-INF/lib/jboss-transaction-api_1.2_spec-1.0.0.Final.jar"
    sourcepath="libsrc/jboss-transaction-api_1.2_spec-1.0.0.Final-sources.jar" />

build.xml

<!-- ### Need to delete following classpath entries ### -->

<path id="build.classpath">
    <!-- ... -->
    <pathelement location="${lib.dir}/hibernate-jpa-2.1-api-1.0.0.Final.jar"/>
    <pathelement location="${lib.dir}/jandex-1.1.0.Final.jar"/>
    <pathelement location="${lib.dir}/jboss-logging-annotations-1.2.0.Final.jar"/>
    <pathelement location="${lib.dir}/jboss-transaction-api_1.2_spec-1.0.0.Final.jar"/>
    <!-- ... -->
</path>