entity.reload( )

4D v17.4

entity.reload( )

説明

entity.reload( ) メソッドはデータストア内のデータクラスにリレートされたテーブルに保存されている情報に応じて、エンティティの中身をメモリ内にリロードします。リロードはエンティティが同じプライマリーキーで存在している場合にのみ実行されます。

結果オブジェクト

entity.reload( ) によって返されたオブジェクトには以下のプロパティが格納されます:

プロパティ	型	詳細
success	ブール	リロードが成功した場合にはtrue、それ以外の場合にはfalse
		*エラーの場合にのみ利用可能:*
status(*)	数値	エラーコード、以下参照
statusText(*)	テキスト	エラーの詳細、以下参照

(*) エラー時にはResult オブジェクトのstatus あるいは statusText プロパティに以下のいずれかの値が返されます:

定数

値

dk status entity does not exist anymore

エンティティはもうデータ内に存在していません。このエラーは以下のような場合に起き得ます:

エンティティがドロップされている(スタンプは変更されていて、メモリ空間は解放されている)
エンテイィ亭はドロップされていて、他のプライマリーキー値を持っているもので置き換えられている(スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。entity.drop( )を使用している場合、このエラーはdk force drop if stamp changed オプションを使用した場合に返される場合があります。entity.lock( )を使用している場合、このエラーはdk reload if stamp changed オプションを使用した場合に返される場合があります。

割り当てられたstatusText: "エンティティはもう存在しません"

dk status serious error

深刻なエラーとは低レベルのデータベースエラー(例:重複キーなど)、ハードウェアエラーなどです。
割り当てられたstatusText: "その他のエラー"

例題

 C_OBJECT($employee;$employees;$result)

 

 $employees:=ds.Employee.query("lastName=:1";"Hollis")

 $employee:=$employees[0]

 $employee.firstName:="Mary"

 $result:=$employee.reload()

 Case of

    :($result.success)

       ALERT("Reload has been done")

    :($result.status=dk status entity does not exist anymore)

       ALERT("The entity has been dropped")

 End case

参照

entitySelection[index]