com.bradmcevoy.http
Interface LockingCollectionResource

All Superinterfaces:

CollectionResource, LockableResource, Resource

public interface LockingCollectionResource
extends CollectionResource, LockableResource

A collection which allows locking "unmapped resources". This means that a LOCK method can effectively create an empty resource which is immediately locked. Implement this in conjunction with LockableResource on child resources to fully support locking.

Note that this interface now extends LockableResource because collection resources need to implement both in most cases.

If, however, you don't want your collection resources to be lockable, just implement ConditionalCompatibleResource.

See http://www.ettrema.com:8080/browse/MIL-14.

Author:

brad

Method Summary

LockToken

createAndLock(java.lang.String name, LockTimeout timeout, LockInfo lockInfo) Create an empty non-collection resource of the given name and immediately lock it.

Methods inherited from interface com.bradmcevoy.http.CollectionResource

child, getChildren

Methods inherited from interface com.bradmcevoy.http.LockableResource

getCurrentLock, lock, refreshLock, unlock

Methods inherited from interface com.bradmcevoy.http.Resource

authenticate, authorise, checkRedirect, getModifiedDate, getName, getRealm, getUniqueId

Method Detail

createAndLock

LockToken createAndLock(java.lang.String name,
                        LockTimeout timeout,
                        LockInfo lockInfo)
                        throws NotAuthorizedException

Create an empty non-collection resource of the given name and immediately lock it.

It is suggested that the implementor have a specific Resource class to act as the lock null resource. You should consider using the LockNullResource interface.

Parameters:

name - - the name of the resource to create

timeout - - in seconds

lockInfo -

Returns:

Throws:

NotAuthorizedException

See Also:

LockNullResource