Uniemożliwia równoczesny dostęp do sekcji kodu. Jest to przydatne, gdy masz wielu użytkowników lub procesy modyfikujące udostępniony zasób i chcesz uniknąć kolizji.
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
getDocumentLock() | Lock | Pobiera blokadę, która uniemożliwia dowolnemu użytkownikowi bieżącego dokumentu jednoczesne uruchamianie sekcji kodu. |
getScriptLock() | Lock | Generuje blokadę, która uniemożliwia dowolnemu użytkownikowi jednoczesne uruchamianie sekcji kodu. |
getUserLock() | Lock | Pobiera blokadę, która uniemożliwia bieżącemu użytkownikowi jednoczesne uruchamianie sekcji kodu. |
Szczegółowa dokumentacja
getDocumentLock()
Pobiera blokadę, która uniemożliwia dowolnemu użytkownikowi bieżącego dokumentu jednoczesne uruchamianie sekcji kodu. Sekcja kodu chroniona blokadą dokumentu może być wykonywane jednocześnie przez instancje skryptów działające w kontekście różnych dokumentów, ale nie więcej niż jedno wykonanie w przypadku danego dokumentu. Pamiętaj, że blokada jest pobierana dopiero po wywołaniu funkcji Lock.tryLock(timeoutInMillis) lub Lock.waitLock(timeoutInMillis). Jeśli ta metoda zostanie wywołana poza kontekstem dokumentu (np. z samodzielnego skryptu lub aplikacji internetowej), zwracany jest null.
Powroty
Lock – blokada ograniczona do skryptu i bieżącego dokumentu lub null w przypadku wywołania z autonomicznego skryptu lub aplikacji internetowej
getScriptLock()
Generuje blokadę, która uniemożliwia dowolnemu użytkownikowi jednoczesne uruchamianie sekcji kodu. Sekcja kodu chroniona blokadą skryptu nie może być uruchomiona jednocześnie niezależnie od tożsamości użytkownika. Pamiętaj, że blokada jest pobierana dopiero po wywołaniu funkcji Lock.tryLock(timeoutInMillis) lub Lock.waitLock(timeoutInMillis).
Powroty
Lock – blokada ograniczona do skryptu.
getUserLock()
Pobiera blokadę, która uniemożliwia bieżącemu użytkownikowi jednoczesne uruchamianie sekcji kodu. Sekcja kodu chroniona blokadą użytkownika może zostać wykonana jednocześnie przez różnych użytkowników, ale nie więcej niż 1 uruchomienie dla danego użytkownika. Blokada jest „prywatna” dla użytkownika. Pamiętaj, że blokada jest używana dopiero po wywołaniu Lock.tryLock(timeoutInMillis) lub Lock.waitLock(timeoutInMillis).
Powroty
Lock – blokada ograniczona do skryptu i bieżącego użytkownika.