Class LockService

LockService

Zapobiega jednoczesnemu dostępowi do fragmentów kodu. Może to być przydatne, gdy wielu użytkowników lub procesów modyfikuje zasób współdzielony i chcesz zapobiec konfliktom.

Metody

MetodaZwracany typKrótki opis
getDocumentLock()Lock|nullPobiera blokadę, która uniemożliwia wszystkim użytkownikom bieżącego dokumentu jednoczesne uruchamianie fragmentu kodu.
getScriptLock()LockPobiera blokadę, która uniemożliwia jednoczesne uruchamianie fragmentu kodu przez różnych użytkowników.
getUserLock()LockPobiera blokadę, która uniemożliwia bieżącemu użytkownikowi jednoczesne uruchamianie fragmentu kodu.

Szczegółowa dokumentacja

getDocumentLock()

Pobiera blokadę, która uniemożliwia wszystkim użytkownikom bieżącego dokumentu jednoczesne uruchamianie fragmentu kodu. Sekcja kodu chroniona przez blokadę dokumentu może być wykonywana jednocześnie przez instancje skryptu działające w kontekście różnych dokumentów, ale w przypadku każdego dokumentu może być wykonywana tylko raz. Pamiętaj, że blokada nie jest faktycznie uzyskiwana, dopóki nie zostanie wywołana funkcja Lock.tryLock(timeoutInMillis) lub Lock.waitLock(timeoutInMillis). Jeśli ta metoda jest wywoływana poza kontekstem dokumentu zawierającego (np. ze skryptu autonomicznego lub aplikacji internetowej), zwracana jest wartość null.

Powrót

Lock|null – blokada ograniczona do skryptu i bieżącego dokumentu lub null, jeśli wywołano ją ze skryptu lub aplikacji internetowej


getScriptLock()

Pobiera blokadę, która uniemożliwia jednoczesne uruchamianie fragmentu kodu przez różnych użytkowników. Sekcja kodu chroniona przez blokadę skryptu nie może być wykonywana jednocześnie niezależnie od tożsamości użytkownika. Pamiętaj, że blokada nie jest faktycznie uzyskiwana, dopóki nie zostanie wywołana funkcja Lock.tryLock(timeoutInMillis) lub Lock.waitLock(timeoutInMillis).

Powrót

Lock – blokada ograniczona do skryptu.


getUserLock()

Pobiera blokadę, która uniemożliwia bieżącemu użytkownikowi jednoczesne uruchamianie fragmentu kodu. Sekcja kodu chroniona blokadą użytkownika może być wykonywana jednocześnie przez różnych użytkowników, ale nie więcej niż raz w przypadku danego użytkownika. Blokada jest „prywatna” dla użytkownika. Pamiętaj, że blokada nie jest faktycznie uzyskiwana, dopóki nie zostanie wywołana funkcja Lock.tryLock(timeoutInMillis) lub Lock.waitLock(timeoutInMillis).

Powrót

Lock – blokada ograniczona do skryptu i bieżącego użytkownika.