Class LockService

LockService

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

Methoden

MethodeRückgabetypKurzbeschreibung
getDocumentLock()Lock|nullRuft eine Sperre ab, die verhindert, dass ein Nutzer des aktuellen Dokuments gleichzeitig einen Codeabschnitt ausführt.
getScriptLock()LockRuft eine Sperre ab, die verhindert, dass ein Nutzer gleichzeitig einen Codeabschnitt ausführt.
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 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, jedoch nur einmal für ein bestimmtes Dokument. Das Schloss wird erst verriegelt, wenn Lock.tryLock(timeoutInMillis) oder Lock.waitLock(timeoutInMillis) aufgerufen wird. Wenn diese Methode außerhalb des Kontexts eines enthaltenden Dokuments aufgerufen wird (z. B. über ein eigenständiges Skript oder eine Web-App), wird null zurückgegeben.

Rückflug

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 Web-App aufgerufen wird.

getScriptLock()

Ruft eine Sperre ab, die verhindert, dass ein Nutzer gleichzeitig einen Codeabschnitt 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. Das Schloss wird erst gesperrt, wenn Lock.tryLock(timeoutInMillis) oder Lock.waitLock(timeoutInMillis) aufgerufen wird.

Rückflug

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 gleichzeitig von verschiedenen Nutzern 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 abgerufen, 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