entity.unlock( )

4D v18

entity.unlock( )

説明

entity.unlock( ) メソッドはデータクラスにリレートされたテーブル内のエンティティに合致するレコードのペシミスティック・ロック(*) を解除します。

(*)詳細な情報については、エンティティロッキングのページを参照してください。

レコードは、ロックしているプロセス内のどのエンティティからもレコードが参照されなくなったとき、自動的にロックが解除されます(例: 例えば、エンティティのローカル参照に対してのみロックがかかっていた場合、プロセスが終了すればエンティティおよびレコードのロックは解除されます)。

注: レコードがロックされている時、ロックしているプロセスから、ロックしているエンティティ参照に対してロックを解除する必要があります:

 $e1:=dataClass.all()[0]

 $e2:=dataClass.all()[0]

 $e1.lock() // このとき、ロック解除は$e1 に対して行われなければならない。$e2 のロック解除は失敗する

結果オブジェクト

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

プロパティ		型	詳細
success		ブール	ロック解除のアクションが成功した場合にはtrue、それ以外の場合にはfalse。ドロップされたエンティティや、ロックされてないレコード、あるいは他のプロセスや他のエンティティによってロックされたレコードに対してロック解除を実行した場合、success にはfalse が返されます。

例題

 C_OBJECT($employee;$status)

 

 $employee:=ds.Employee.get(725)

 $status:=$employee.lock()

 ... //処理を実行

 $status:=$employee.unlock()

 If($status.success)

    ALERT("The entity is now unlocked")

 End if

参照

entity.lock( )