com.cloudbees.plugins.deployer.sources

Class FilePathValidator

java.lang.Object

com.cloudbees.plugins.deployer.sources.FilePathValidator

public class FilePathValidator
extends Object

Method Summary

Modifier and Type	Method and Description
static boolean	isDescendant(FilePath child, FilePath parent) Checks whether a given child path is a descendant of a given parent path using File.getCanonicalFile().

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

isDescendant

public static boolean isDescendant(FilePath child,
                                   FilePath parent)
                            throws IOException

Checks whether a given child path is a descendant of a given parent path using File.getCanonicalFile(). If the child path does not exist, this method will canonicalize path elements such as /../ and /./ before comparing it to the parent path, and it will not throw an exception. If the child path does exist, symlinks will be resolved before checking whether the child is a descendant of the parent path.

Parameters:

child - FilePath

parent - FilePath

Returns:

boolean value of whether child path is a descendant of parent path

Throws:

IllegalStateException - when child or parent FilePath represent remote file

IOException - when File.getCanonicalFile() throws