Class LockService
Stay organized with collections
Save and categorize content based on your preferences.
LockService
Prevents concurrent access to sections of code. This can be useful when you have multiple users
or processes modifying a shared resource and want to prevent collisions.
Methods
Method
| Return type
| Brief description
|
getDocumentLock()
| Lock
| Gets a lock that prevents any user of the current document from concurrently running a section
of code.
|
getScriptLock()
| Lock
| Gets a lock that prevents any user from concurrently running a section of code.
|
getUserLock()
| Lock
| Gets a lock that prevents the current user from concurrently running a section of code.
|
Detailed documentation
getDocumentLock()
Gets a lock that prevents any user of the current document from concurrently running a section
of code. A code section guarded by a document lock can be executed simultaneously by script
instances running in the context of different documents, but by no more than one execution for
any given document. Note that the lock is not actually acquired until
Lock.tryLock(timeoutInMillis)
or
Lock.waitLock(timeoutInMillis)
is called. If this method is called outside of the context of a
containing document (such as from a standalone script or webapp),
null
is returned.
Return
Lock
— a lock scoped to the script and current document, or
null
if called from a
standalone script or webapp
getScriptLock()
Gets a lock that prevents any user from concurrently running a section of code. A code section
guarded by a script lock cannot be executed simultaneously regardless of the identity of the
user. Note that the lock is not actually acquired until
Lock.tryLock(timeoutInMillis)
or
Lock.waitLock(timeoutInMillis)
is called.
Return
Lock
— a lock scoped to the script
getUserLock()
Gets a lock that prevents the current user from concurrently running a section of code. A code
section guarded by a user lock can be executed simultaneously by different users, but by no
more than one execution for any given user. The lock is "private" to the user. Note that the
lock is not actually acquired until
Lock.tryLock(timeoutInMillis)
or
Lock.waitLock(timeoutInMillis)
is
called.
Return
Lock
— a lock scoped to the script and current user
Except as otherwise noted, the content of this page is licensed under the
Creative Commons Attribution 4.0 License
, and code samples are licensed under the
Apache 2.0 License
. For details, see the
Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2018-06-26 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Missing the information I need"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Too complicated / too many steps"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Out of date"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Samples / code issue"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]