org.eclipse.webdav.internal.kernel
Class LocatorFactory

java.lang.Object
  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.