Class LockService

LockService

Verhindert den gleichzeitigen Zugriff auf Codeabschnitte. Das kann nützlich sein, wenn mehrere Nutzer oder Prozesse eine freigegebene Ressource ändern und Kollisionen verhindern möchten.

Methoden

MethodeRückgabetypKurzbeschreibung
getDocumentLock()LockErwirbt eine Sperre, die verhindert, dass andere Nutzer des aktuellen Dokuments einen Codeabschnitt gleichzeitig ausführen.
getScriptLock()LockErwirbt eine Sperre, die verhindert, dass ein Nutzer einen Codeabschnitt gleichzeitig ausführt.
getUserLock()LockErwirbt eine Sperre, die verhindert, dass der aktuelle Nutzer einen Codeabschnitt gleichzeitig ausführt.

Detaillierte Dokumentation

getDocumentLock()

Erwirbt eine Sperre, die verhindert, dass andere Nutzer des aktuellen Dokuments einen Codeabschnitt gleichzeitig ausführen. Ein Codeabschnitt, der durch eine Dokumentsperre geschützt ist, kann gleichzeitig von Scriptinstanzen ausgeführt werden, die im Kontext verschiedener Dokumente ausgeführt werden, aber nicht mehr als einmal für ein bestimmtes Dokument. Das Schloss wird erst dann tatsächlich erworben, 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 Script oder einer Webanwendung), wird null zurückgegeben.

Rückflug

Lock – eine Sperre, die auf das Script und das aktuelle Dokument beschränkt ist, oder null, wenn das Script aus einem eigenständigen Script oder einer Webanwendung aufgerufen wird


getScriptLock()

Erwirbt eine Sperre, die verhindert, dass ein Nutzer einen Codeabschnitt gleichzeitig ausführt. Ein Codeabschnitt, der durch eine Scriptsperre geschützt ist, kann unabhängig von der Identität des Nutzers nicht gleichzeitig ausgeführt werden. Das Schloss wird erst dann tatsächlich erworben, wenn Lock.tryLock(timeoutInMillis) oder Lock.waitLock(timeoutInMillis) aufgerufen wird.

Rückflug

Lock – Sperre auf Scriptebene


getUserLock()

Erwirbt eine Sperre, die verhindert, dass der aktuelle Nutzer einen Codeabschnitt gleichzeitig ausführt. Ein Codeabschnitt, der durch eine Nutzersperre geschützt ist, kann von verschiedenen Nutzern gleichzeitig ausgeführt werden, aber nicht mehr als einmal für einen bestimmten Nutzer. Das Schloss ist für den Nutzer „privat“. Die Sperre wird erst erworben, wenn Lock.tryLock(timeoutInMillis) oder Lock.waitLock(timeoutInMillis) aufgerufen wird.

Rückflug

Lock – eine Sperre, die auf das Script und den aktuellen Nutzer beschränkt ist