Examples of org.eclipse.core.resources.IWorkspace.validateLinkLocation()

Validates the given path as the location of the given resource on disk. The path must be either an absolute file system path, or a relative path whose first segment is the name of a defined workspace path variable. In addition to the restrictions for paths in general (see IPath. isValidPath), a link location must also obey the following rules:

must not overlap with the platform's metadata directory
must not be the same as or a parent of the root directory of the project the linked resource is contained in

This method also checks that the given resource can legally become a linked resource. This includes the following restrictions:

must have a project as its immediate parent
project natures and the team hook may disallow linked resources on projects they are associated with
the global workspace preference to disable linking, ResourcesPlugin.PREF_DISABLE_LINKING must not be set to "true"

This method will return a status with severity IStatus.ERROR if the location does not obey the above rules. Also, this method will return a status with severity IStatus.WARNING if the location overlaps the location of any existing resource in the workspace.

Note: this method does not consider whether files or directories exist in the file system at the specified path. @param resource the resource to validate the location for @param location the location of the linked resource contents on disk @return a status object with code IStatus.OK if the givenlocation is valid as the linked resource location, otherwise a status object with severity IStatus.WARNING or IStatus.ERROR indicating what is wrong with the location @see IStatus#OK @see ResourcesPlugin#PREF_DISABLE_LINKING @since 2.1