Class LockService

خدمةالقفل

يمنع الوصول المتزامن إلى أقسام من الرمز. يمكن أن يكون ذلك مفيدًا عندما يكون لديك عدة مستخدمين أو عمليات تعدِّل موردًا مشترَكًا وتريد منع حدوث تعارضات.

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getDocumentLock()Lockتحصل على قفل يمنع أي مستخدم للمستند الحالي من تشغيل قسم من الرمز البرمجي بشكل متزامن.
getScriptLock()Lockتحصل على قفل يمنع أي مستخدم من تشغيل قسم من الرمز البرمجي بشكل متزامن.
getUserLock()Lockتحصل على قفل يمنع المستخدم الحالي من تشغيل قسم من الرمز البرمجي بشكل متزامن.

مستندات تفصيلية

getDocumentLock()

تحصل على قفل يمنع أي مستخدم للمستند الحالي من تشغيل قسم من الرمز البرمجي بشكل متزامن. يمكن تنفيذ قسم رمز يحرسه قفل مستند في الوقت نفسه من خلال مثيلات النصوص البرمجية التي تعمل في سياق مستندات مختلفة، ولكن لا يزيد عن تنفيذ واحد لأي مستند معيّن. يُرجى العِلم أنّه لا يتم الحصول على القفل فعليًا إلى أن يتم استدعاء Lock.tryLock(timeoutInMillis) أو Lock.waitLock(timeoutInMillis). إذا تمّ استدعاء هذه الطريقة خارج سياق مستند يحتوي على عنصر (مثل نص برمجي مستقل أو تطبيق ويب)، يتمّ عرض null.

الإرجاع

‫Lock: قفل على مستوى النص البرمجي والمستند الحالي، أو null إذا تمّت الدعوة من نص برمجي مستقل أو تطبيق ويب

getScriptLock()

تحصل على قفل يمنع أي مستخدم من تشغيل قسم من الرمز البرمجي بشكل متزامن. لا يمكن تنفيذ قسم رمز برمجي يحرسه قفل نص برمجي في الوقت نفسه بغض النظر عن هوية المستخدم. يُرجى العِلم أنّه لا يتم الحصول على القفل فعليًا إلى أن يتم استدعاء Lock.tryLock(timeoutInMillis) أو Lock.waitLock(timeoutInMillis).

الإرجاع

Lock - قفل على مستوى النص البرمجي

getUserLock()

تحصل على قفل يمنع المستخدم الحالي من تشغيل قسم من الرمز البرمجي بشكل متزامن. يمكن لمستخدمين مختلفين تنفيذ قسم رمز مُراقَب بقفل مستخدم في الوقت نفسه، ولكن لا يمكن تنفيذه أكثر من مرة لأي مستخدم معيّن. يكون القفل "خاصًا" بالمستخدم. يُرجى العِلم أنّه لا يتم الحصول على القفل فعليًا إلى أن يتم استدعاء Lock.tryLock(timeoutInMillis) أو Lock.waitLock(timeoutInMillis).

الإرجاع

Lock - قفل على مستوى النص البرمجي والمستخدم الحالي