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 - قفل على نطاق النص البرمجي والمستخدم الحالي