entity.touched( )

4D v19

entity.touched( )

説明

entity.touched( ) メソッドは、エンティティがメモリに読み込まれてから、あるいは保存されてから、エンティティ属性が変更されたかどうかをテストします。

属性が変更あるいは計算されていた場合、メソッドはtrue を返し、それ以外の場合にはfalse を返します。このメソッドを使用することで、エンティティを保存する必要があるかどうかを決めることができます。

このメソッドは(dataClass.new( )で作成された)新規エンティティに対しては常に false を返します。ただし、エンティティの属性を計算するメソッドを使用した場合には、entity.touched( ) メソッドは true を返します。例えば、プライマリーキーを計算するためにentity.getKey( ) を呼び出した場合、entity.touched( ) メソッドは true を返します。

例題

以下の例題では、エンティティを保存する必要があるかどうかをチェックします:

 C_OBJECT($emp)

 $emp:=ds.Employee.get(672)

 $emp.firstName:=$emp.firstName // 同じ値で更新されたとしても、属性は触れられた、と判定されます

 

 If($emp.touched()) // 少なくとも一つの属性が変更されていた場合

    $emp.save()

 End if // そうでない場合はエンティティを保存する必要なし

参照

entity.diff( )
entity.touchedAttributes( )