io.takari.builder.internal.pathmatcher

Class PathNormalizer

java.lang.Object

io.takari.builder.internal.pathmatcher.PathNormalizer

public class PathNormalizer
extends Object

Filesystem path normalizer. Normalized paths use '/' separator on all platforms and are absolute, i.e. start with '/'.

Method Summary

Modifier and Type	Method and Description
static PathNormalizer	createNormalizer() Creates PathNormalizer that uses filesystem I/O calls (i.e.
static PathNormalizer	createNormalizer(Path basedir) Creates PathNormalizer optimized for use with PathMatcher.
static PathNormalizer	createNormalizer(String memento) Creates PathNormalizer using value returned by getMemento()
static Path	getCanonicalPath(Path file)
String	getMemento() Returns memento string which can be passed to createNormalizer(String).
String	normalize(Path path) File path normalization implementation optimized for use with PathMatcher.
String	normalize(String file) File path normalization implementation optimized for use with PathMatcher.
static String	normalize0(Path file) Returns canonical normalized file path, which on all platforms means: the path is resolved similarly to File.getCanonicalPath() the path starts with '/' the path uses '/' file separator char
static String	normalize0(String file)
static Path	toPath(String file)

Methods inherited from class java.lang.Object

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

Method Detail

createNormalizer

public static PathNormalizer createNormalizer(Path basedir)

Creates PathNormalizer optimized for use with PathMatcher. Paths under the provided basedir are not normalized using filesystem I/O calls (i.e. File.getCanonicalFile() or similar) and may contain '../' and './' special directories after normalization.

createNormalizer

public static PathNormalizer createNormalizer(String memento)

Creates PathNormalizer using value returned by getMemento()

createNormalizer

public static PathNormalizer createNormalizer()

Creates PathNormalizer that uses filesystem I/O calls (i.e. File.getCanonicalFile() or similar) to normalize all paths.

getMemento

public String getMemento()

Returns memento string which can be passed to createNormalizer(String). The main usecase is to recreate PathNormalizer in another JVM running on the same system.

normalize

public String normalize(String file)

File path normalization implementation optimized for use with PathMatcher. Normalized path may include '../' and './' special directory names, which are resolved by PathMatcher.

normalize

public String normalize(Path path)

File path normalization implementation optimized for use with PathMatcher. Normalized path may include '../' and './' special directory names, which are resolved by PathMatcher.

normalize0

public static String normalize0(Path file)

Returns canonical normalized file path, which on all platforms means:

• the path is resolved similarly to File.getCanonicalPath()
• the path starts with '/'
• the path uses '/' file separator char

getCanonicalPath

public static Path getCanonicalPath(Path file)

normalize0

public static String normalize0(String file)

See Also:

#normalize0(File)

toPath

public static Path toPath(String file)