Class LockService

LockService

Verhindert den gleichzeitigen Zugriff auf Codeabschnitte. Dies kann nützlich sein, wenn mehrere Nutzer oder Prozesse eine freigegebene Ressource ändern und Sie Konflikte vermeiden möchten.

Methoden

MethodeRückgabetypKurzbeschreibung
getDocumentLock()Lock|nullRuft eine Sperre ab, die verhindert, dass Nutzer des aktuellen Dokuments gleichzeitig einen Codeabschnitt ausführen.
getScriptLock()LockRuft eine Sperre ab, die verhindert, dass Nutzer gleichzeitig einen Codeabschnitt ausführen.
getUserLock()LockRuft eine Sperre ab, die verhindert, dass der aktuelle Nutzer gleichzeitig einen Codeabschnitt ausführt.

Detaillierte Dokumentation

getDocumentLock()

Ruft eine Sperre ab, die verhindert, dass Nutzer des aktuellen Dokuments gleichzeitig einen Codeabschnitt ausführen. Ein Codeabschnitt, der durch eine Dokumentsperre geschützt ist, kann gleichzeitig von Skriptinstanzen ausgeführt werden, die im Kontext verschiedener Dokumente ausgeführt werden. Für ein bestimmtes Dokument ist jedoch nur eine Ausführung möglich. Die Sperre wird erst abgerufen, wenn Lock.tryLock(timeoutInMillis) oder Lock.waitLock(timeoutInMillis) aufgerufen wird. Wenn diese Methode außerhalb des Kontexts eines enthaltenden Dokuments aufgerufen wird (z. B. aus einem eigenständigen Skript oder einer Webanwendung), wird null zurückgegeben.

Rückgabe

Lock|null : Eine Sperre, die auf das Skript und das aktuelle Dokument beschränkt ist, oder null wenn sie von einem eigenständigen Skript oder einer Webanwendung aufgerufen wird.


getScriptLock()

Ruft eine Sperre ab, die verhindert, dass Nutzer gleichzeitig einen Codeabschnitt ausführen. 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 abgerufen, wenn Lock.tryLock(timeoutInMillis) oder Lock.waitLock(timeoutInMillis) aufgerufen wird.

Rückgabe

Lock : Eine Sperre, die auf das Skript beschränkt ist.


getUserLock()

Ruft eine Sperre ab, die verhindert, dass der aktuelle Nutzer gleichzeitig einen Codeabschnitt ausführt. Ein Codeabschnitt, der durch eine Nutzersperre geschützt ist, kann von verschiedenen Nutzern gleichzeitig ausgeführt werden. Für einen bestimmten Nutzer ist jedoch nur eine Ausführung möglich. Die Sperre ist für den Nutzer „privat“. Die Sperre wird erst abgerufen, wenn Lock.tryLock(timeoutInMillis) oder Lock.waitLock(timeoutInMillis) aufgerufen wird.

Rückgabe

Lock : Eine Sperre, die auf das Skript und den aktuellen Nutzer beschränkt ist.