מניעת גישה בו-זמנית לקטעי קוד. זו אפשרות שימושית כשיש מספר משתמשים או תהליכים שמשנים משאב משותף, ואתם רוצים למנוע התנגשויות בלו"ז.
שיטות
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
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 – מנעול בהיקף ההרשאות של הסקריפט ושל המשתמש הנוכחי