Verhindert den gleichzeitigen Zugriff auf Codeabschnitte. Dies kann nützlich sein, wenn mehrere Nutzer oder Prozesse eine gemeinsam genutzte Ressource ändern und Konflikte vermeiden möchten.
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
getDocumentLock() | Lock | Ruft eine Sperre ab, die verhindert, dass ein Nutzer des aktuellen Dokuments gleichzeitig einen Codeabschnitt ausführt. |
getScriptLock() | Lock | Ruft eine Sperre ab, die verhindert, dass ein Benutzer gleichzeitig einen Codeabschnitt ausführt. |
getUserLock() | Lock | Ruft eine Sperre ab, die verhindert, dass der aktuelle Nutzer gleichzeitig einen Codeabschnitt ausführt. |
Detaillierte Dokumentation
getDocumentLock()
Ruft eine Sperre ab, die verhindert, dass ein Nutzer des aktuellen Dokuments gleichzeitig einen Codeabschnitt ausführt. Ein durch eine Dokumentsperre geschützter Codeabschnitt kann gleichzeitig von Skriptinstanzen ausgeführt werden, die im Kontext verschiedener Dokumente ausgeführt werden. Für ein Dokument ist jedoch immer nur eine Ausführung möglich. Die Sperre wird erst übernommen, wenn Lock.tryLock(timeoutInMillis) oder Lock.waitLock(timeoutInMillis) aufgerufen wird. Wenn diese Methode außerhalb des Kontexts eines Dokuments aufgerufen wird (z. B. von einem eigenständigen Skript oder einer Webanwendung), wird null zurückgegeben.
Return
Lock: eine Sperre für das Skript und das aktuelle Dokument oder null, wenn sie von einem eigenständigen Skript oder einer Web-App aufgerufen wird
getScriptLock()
Ruft eine Sperre ab, die verhindert, dass ein Benutzer gleichzeitig einen Codeabschnitt ausführt. Ein durch eine Skriptsperre geschützter Codeabschnitt kann unabhängig von der Identität des Nutzers nicht gleichzeitig ausgeführt werden. Die Sperre wird erst übernommen, wenn Lock.tryLock(timeoutInMillis) oder Lock.waitLock(timeoutInMillis) aufgerufen wird.
Return
Lock: eine auf das Skript beschränkte Sperre
getUserLock()
Ruft eine Sperre ab, die verhindert, dass der aktuelle Nutzer gleichzeitig einen Codeabschnitt ausführt. Ein durch eine Nutzersperre geschützter Codeabschnitt kann gleichzeitig von verschiedenen Nutzern, jedoch nur einmal pro Nutzer ausgeführt werden. Die Sperre ist für den Nutzer „privat“. Die Sperre wird erst übernommen, wenn Lock.tryLock(timeoutInMillis) oder Lock.waitLock(timeoutInMillis) aufgerufen wird.
Return
Lock: eine auf das Skript und den aktuellen Nutzer beschränkte Sperre