移行 1.1.0 to 1.1.0-sp4
お約束の注意点
- 古いバージョンの削除
- 古いバージョンのDBFluteランタイム(JAR)が[WEB-INF/lib]の下などに残らないように
- タスクを実行し忘れないように
- generateタスクだけでなく、(外だしSQLがある場合は)Sql2Entityタスクも実行
環境上の注意点
なんとかDefinitionMap.dfprop の Definition
まず、互換性は保たれているので、無理に移行する必要はありません。
幾つかのdfpropファイルの名前が変わりました。
- documentDefinitionMap.dfprop to documentMap.dfprop
- includeQueryMap.dfprop to conditionBeanMap.dfprop
- optimisticLockDefinitionMap.dfprop to optimisticLockMap.dfprop
- outsideSqlDefinitionMap.dfprop to outsideSqlMap.dfprop
- refreshDefinitionMap.dfprop to refreshMap.dfprop
- replaceSchemaDefinitionMap.dfprop to replaceSchemaMap.dfprop
- sequenceDefinitionMap.dfprop to sequenceMap.dfprop
sp4以降では、ファイルをrenameしてもそのまま動作しますので、よければ試してみてください。
いくつか littleAdjustment に
refreshMap.dfprop や optimisticLockMap は、同じ内容を littleAdjustmentMap.dfprop で指定できるようになっています。dfprop配下をスッキリさせるため、小さなdfpropは統合しています。
e.g. refreshMap と optimisticLockMap @littleAdjustmentMap.dfprop
# /- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# o refreshMap: (NotRequired - Default map:{projectName=$$AutoDetect$$ ; requestUrl=http://localhost:8386/})
# If you use synchronizer and specify this property, no need to refresh(F5) your eclipse project.
# The projectName can be set plural names by slash '/'. e.g. sea/land
#
#; refreshMap = map:{
# ; projectName = $$AutoDetect$$
# ; requestUrl = http://localhost:8386/
#}
# - - - - - - - - - -/
# /- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# o optimisticLockMap: (NotRequired - Default map:{})
# The definition for optimistic lock of DBFlute.
#
#; optimisticLockMap = map:{
# # o updateDateFieldName: (NotRequired - Default '')
# ; updateDateFieldName = UPDATE_DATE
#
# # o versionNoFieldName: (NotRequired - Default 'VERSION_NO')
# # The column name of version no for optimistic lock.
# # Basically you don't need this if your tables have the column 'VERSION_NO'.
# # because the default value is 'VERSION_NO'.
# ; versionNoFieldName = VERSION_NO
#}
# - - - - - - - - - -/
互換モード、LambdaのselectEntity()の戻り値
1.0.x から 1.1.x に互換モードで移行した人だけが対象です。
isAvailableSelectEntityPlainReturn を true にすることで、selectEntity()の戻り値が Optional ではなくそのままのEntityが戻るようになりますが、同時に isMakeCallbackConditionBeanSetup を true にして、Lambda引数のselectEntity()も生成しているとき、そちらだけは Optional になるようになっています。 (sp3までは、両方とも Plain な Entity だった)
これにより、古い方のselectEntity()だけは完全に今まで通りで、新しいLambda引数のselectEntity()はOptionalで完全に新しいやり方で実装していくことができます。
もし、Lambda引数のselectEntity()も Plain な Entity にしたいときは、isAvailableLambdaSelectEntityForcedlyOptional を false にします。
実装上の注意点
特になし