Verhindert gleichzeitigen Zugriff auf Codeabschnitte. Das kann nützlich sein, wenn mehrere Nutzer oder Prozesse eine freigegebene Ressource ändern und Kollisionen verhindern möchten.
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
getDocumentLock() | Lock | Ruft eine Sperre ab, die verhindert, dass ein Nutzer des aktuellen Dokuments Codeabschnitte gleichzeitig ausführt. |
getScriptLock() | Lock | Ruft eine Sperre ab, die verhindert, dass ein Nutzer einen Codeabschnitt gleichzeitig ausführt. |
getUserLock() | Lock | Ruft eine Sperre ab, die verhindert, dass der aktuelle Nutzer einen Codeabschnitt gleichzeitig ausführt. |
Detaillierte Dokumentation
getDocumentLock()
Ruft eine Sperre ab, die verhindert, dass ein Nutzer des aktuellen Dokuments Codeabschnitte gleichzeitig ausführt. Ein Codeabschnitt, der durch eine Dokumentsperre geschützt ist, kann gleichzeitig von Skriptinstanzen ausgeführt werden, die im Zusammenhang mit verschiedenen Dokumenten ausgeführt werden, jedoch nur für eine Ausführung pro Dokument. Beachten Sie, dass die Sperre erst nach dem Aufruf von Lock.tryLock(timeoutInMillis) oder Lock.waitLock(timeoutInMillis) erworben wird. Wenn diese Methode außerhalb des Kontexts eines zugehörigen Dokuments aufgerufen wird, z. B. von einem eigenständigen Skript oder einer Web-App, wird null zurückgegeben.
Zurücksenden
Lock: Eine Sperre für das Skript und das aktuelle Dokument oder null, wenn von einem eigenständigen Skript oder einer Web-App aufgerufen
getScriptLock()
Ruft eine Sperre ab, die verhindert, dass ein Nutzer einen Codeabschnitt gleichzeitig ausführt. Ein Codeabschnitt, der durch eine Skriptsperre geschützt ist, kann unabhängig von der Identität des Nutzers nicht gleichzeitig ausgeführt werden. Die Sperre wird erst dann aktiviert, wenn Lock.tryLock(timeoutInMillis) oder Lock.waitLock(timeoutInMillis) aufgerufen wird.
Zurücksenden
Lock: Eine auf das Skript beschränkte Sperre
getUserLock()
Ruft eine Sperre ab, die verhindert, dass der aktuelle Nutzer einen Codeabschnitt gleichzeitig ausführt. Ein Codeabschnitt, der durch eine Nutzersperre geschützt ist, kann gleichzeitig von verschiedenen Nutzern ausgeführt werden, von einem Nutzer jedoch nur einmal. Die Sperre ist für den Nutzer privat. Beachten Sie, dass die Sperre erst nach dem Aufruf von Lock.tryLock(timeoutInMillis) oder Lock.waitLock(timeoutInMillis) erworben wird.
Zurücksenden
Lock: Eine Sperre für das Skript und den aktuellen Nutzer