17.2.3 データ操作に関する留意事項
データ操作に関する留意事項を次に示します。
-
指定したkeyがすでにキャッシュに格納されている場合,put()は無条件にvalueを更新します。無条件にvalueを更新したくない場合は,次のメソッドを使用してください。
-
create()
新規にkeyを格納する場合だけ,valueをkeyに関連づけて格納します。
-
update()
指定したkeyがすでに格納されている場合だけ,valueをkeyに関連づけて格納します。
-
replace()
指定したkeyに関連づけられているvalueを,条件として指定したvalue(comparativeValue)と比較します。valueが一致している場合だけ,valueをkeyに関連づけて格納します。
-
-
get()の実行時に指定したkeyがキャッシュに存在しない場合は,nullが返却されます。
-
replace()の実行時に指定したkeyが存在しない場合は,CacheException.EAD_ERROR_SERVER_REPLACE_METHOD_KEY_NOT_EXISTが返却されます。
-
replace()の実行時に比較結果が一致しなかった場合はCacheException.EAD_ERROR_SERVER_REPLACE_METHOD_NOT_MATCHEDが返却されます。
-
create()の実行時に指定したkeyがすでに存在している場合は,CacheException.EAD_ERROR_SERVER_CREATE_METHOD_KEY_EXISTが返却されます。
-
update()の実行時に指定したkeyが存在しない場合は,CacheException.EAD_ERROR_SERVER_UPDATE_METHOD_KEY_NOT_EXISTが返却されます。