org.eclipse.webdav.internal.kernel
Class LocatorFactory

java.lang.Object
  extended by org.eclipse.webdav.internal.kernel.LocatorFactory
All Implemented Interfaces:
ILocatorFactory

public class LocatorFactory
extends Object
implements ILocatorFactory


Constructor Summary
LocatorFactory()
           
 
Method Summary
 ILocator newLocator(String resourceURL)
          Returns a locator with the given resource URL that (implicitly) uses the standard way of resolving resource URLs.
 ILocator newLocator(String resourceURL, String label)
          Deprecated. -- not really deprecated, just a warning the second argument used to be the workspace URL but is now a version label!
 ILocator newStableLocator(String resourceURL)
          Returns a locator given a stable resource URL.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

LocatorFactory

public LocatorFactory()
Method Detail

newLocator

public ILocator newLocator(String resourceURL)
Description copied from interface: ILocatorFactory
Returns a locator with the given resource URL that (implicitly) uses the standard way of resolving resource URLs.

Version-unaware clients use this kind of locator exclusively.

Specified by:
newLocator in interface ILocatorFactory
Parameters:
resourceURL - the URL identifier of the resource as a String.

newLocator

public ILocator newLocator(String resourceURL,
                           String label)
Deprecated. -- not really deprecated, just a warning the second argument used to be the workspace URL but is now a version label!

Description copied from interface: ILocatorFactory
Returns a locator with the given resource URL and label.

This kind of locator is used only by version-aware clients. It allows a versioning client to specify a version-controlled resource URL and the label of a version in the corresponding history. The resulting locator identifies the version.

The resource URL MUST NOT be a stable URL.

Specified by:
newLocator in interface ILocatorFactory
Parameters:
resourceURL - the String representation of the version-controlled resource URL.
label - the label of the version to select from the corresponding history.

newStableLocator

public ILocator newStableLocator(String resourceURL)
Description copied from interface: ILocatorFactory
Returns a locator given a stable resource URL.

This kind of locator is used only by version-aware clients. The stable URL is generated by the server. Clients may reliably store the URL and use it to identify the same resource in subsequent operations. Resources identified by a stable URL cannot be moved but they may be deleted. The stable URL cannot be bound to a different resource by the client or server).

Note that locators with stable URLs cannot have also have a label.

Specified by:
newStableLocator in interface ILocatorFactory
Parameters:
resourceURL - the stable URL to a versioning resource as a String.


Copyright © 2001-2014 JBoss by Red Hat. All Rights Reserved.