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 و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-12-02 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-12-02 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The Lock service in Apps Script helps prevent conflicts when multiple users or processes access shared resources."],["It provides different types of locks: Document Lock, Script Lock, and User Lock, each controlling access at various levels."],["Locks can be acquired, released, and checked for status using methods like `tryLock`, `releaseLock`, and `hasLock`."],["Timeouts can be set while acquiring locks to avoid indefinite waiting using methods like `tryLock` and `waitLock`."]]],[]]