Lock Service
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
قفل
تسمح هذه الخدمة للنصوص البرمجية بمنع الوصول المتزامن إلى أقسام
الرمز. يمكن أن يكون ذلك مفيدًا عندما يكون لديك مستخدمون أو عمليات متعددة تعدّل
موردًا مشترَكًا وتريد منع حدوث تعارضات.
صفوف
الاسم | وصف قصير |
Lock | تمثيل لقفل حظر متبادل |
LockService | يمنع الوصول المتزامن إلى أقسام من الرمز. |
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
hasLock() | Boolean | تعرِض القيمة true إذا تم الحصول على القفل. |
releaseLock() | void | يُطلق القفل، ما يسمح للعمليات الأخرى التي تنتظر القفل بمواصلة العمل. |
tryLock(timeoutInMillis) | Boolean | تحاول الحصول على القفل، وتنتهي مهلة الانتظار بعد عدد المللي ثانية المقدَّم. |
waitLock(timeoutInMillis) | void | تحاول الحصول على القفل، وتنتهي مهلة الاستثناء بعد العدد المقدَّم من
المللي ثانية. |
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
getDocumentLock() | Lock | تحصل على قفل يمنع أي مستخدم للمستند الحالي من تشغيل قسم
من الرمز البرمجي بشكل متزامن. |
getScriptLock() | Lock | تحصل على قفل يمنع أي مستخدم من تشغيل قسم من الرمز البرمجي بشكل متزامن. |
getUserLock() | Lock | تحصل على قفل يمنع المستخدم الحالي من تشغيل قسم من الرمز البرمجي بشكل متزامن. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],["The service provides a mechanism to prevent concurrent code access, crucial for shared resource modification. `LockService` offers methods like `getDocumentLock`, `getScriptLock`, and `getUserLock` to acquire different types of locks. The `Lock` class manages the lock itself, with methods like `hasLock` to check if a lock has been obtained, `releaseLock` to release it, and `tryLock` and `waitLock` to acquire a lock with a timeout.\n"],null,[]]