org.opencms.lock

Class CmsLockUtil

java.lang.Object

org.opencms.lock.CmsLockUtil

public final class CmsLockUtil
extends java.lang.Object

Locking utility class.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CmsLockUtil.LockedFile Helper to handle the lock reports together with the files.

Method Summary

Modifier and Type	Method and Description
static CmsLockActionRecord	ensureLock(CmsObject cms, CmsResource resource) Static helper method to lock a resource.
static java.io.Closeable	withLockedResources(CmsObject cms, CmsResource... resources) Utility method for locking and unlocking a set of resources conveniently with the try-with syntax from Java 1.7.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

ensureLock

public static CmsLockActionRecord ensureLock(CmsObject cms,
                                             CmsResource resource)
                                      throws CmsException

Static helper method to lock a resource.

Parameters:

cms - the CMS context to use

resource - the resource to lock

Returns:

the action that was taken

Throws:

CmsException - if something goes wrong

withLockedResources

public static java.io.Closeable withLockedResources(CmsObject cms,
                                                    CmsResource... resources)
                                             throws java.lang.Exception

Utility method for locking and unlocking a set of resources conveniently with the try-with syntax from Java 1.7.

This method locks a set of resources and returns a Closeable instance that will unlock the locked resources when its close() method is called.

Parameters:

cms - the CMS context

resources - the resources to lock

Returns:

the Closeable used to unlock the resources

Throws:

java.lang.Exception - if something goes wrong