Note that unlocking is never anonymous, so any server implementing this function will have to "pull" a username from the client, if it hasn't done so already.
Each path to be unlocked is handled with the provided handler. If a path was successfully unlocked, the handler's {@link ISVNLockHandler#handleUnlock(String,SVNLock,SVNErrorMessage) handleUnlock()}is called that receives the path and either a lock object (representing the lock that was removed from the path) or an error exception, if unlocking failed for that path.
If the username doesn't match the lock's owner and force is false, this method call fails with throwing an SVNException. But if the force flag is true, the lock will be "broken" by the current user.
Also if the lock token is incorrect or null and force is false, the method fails with throwing a SVNException. However, if force is true the lock will be removed anyway.
Paths can be both relative to the location of this driver and absolute to the repository root (starting with "/").
@param pathToTokens a map which keys are file paths and values are file locktokens (both keys and values are strings)
@param force true to remove the lock in any case - i.e. to "break" the lock
@param handler if not null, the lockhandler is invoked on each path to be unlocked
@throws SVNException in the following cases:
force is false and the name of the user who tries to unlock a path does not match the lock owner | |