org.ops4j.pax.web.service.spi.util

Class Path

java.lang.Object

org.ops4j.pax.web.service.spi.util.Path

public class Path
extends Object

Divers utilities related to request paths.

Since:

0.2.1

Author:

Alin Dreghiciu

Method Summary

Modifier and Type	Method and Description
static String	normalizeAlias(String alias) Alias should always be "exact" path
static String	normalizePattern(String pattern) Normalizes a pattern = prepends the path with slash (/) if the path does not start with a slash.
static String[]	normalizePatterns(String[] urlPatterns) Normalize an array of patterns.
static String	normalizeResourcePath(String path) Normalize the path for accesing a resource, meaning that will replace consecutive slashes and will remove a leading slash if present.
static String	replaceSlashes(String target) Replaces multiple subsequent slashes with one slash.
static String	securePath(String path) Make passed path securely appendable to some resource base path.

Methods inherited from class java.lang.Object

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

Method Detail

normalizeResourcePath

public static String normalizeResourcePath(String path)

Normalize the path for accesing a resource, meaning that will replace consecutive slashes and will remove a leading slash if present.

Parameters:

path - path to normalize

Returns:

normalized path or the original path if there is nothing to be replaced.

securePath

public static String securePath(String path)

Make passed path securely appendable to some resource base path. Resource base path may (but doesn't have to) be a String with trailing slash - the only requirement is that it should mean a base directory or chroot that can't be escaped.

The returned path may, but doesn't have to end with "/" which could be treated as file vs. directory distinction.

If null is returned, it means that path is invalid and/or it goes out of the chroot.

Parameters:

path -

Returns:

replaceSlashes

public static String replaceSlashes(String target)

Replaces multiple subsequent slashes with one slash. E.g. ////a//path// will become /a/path/

Parameters:

target - target sring to be replaced

Returns:

a string where the subsequent slashes are replaced with one slash

normalizePatterns

public static String[] normalizePatterns(String[] urlPatterns)

Normalize an array of patterns.

Parameters:

urlPatterns - to mormalize

Returns:

array of nomalized patterns

normalizePattern

public static String normalizePattern(String pattern)

Normalizes a pattern = prepends the path with slash (/) if the path does not start with a slash.

Parameters:

pattern - to normalize

Returns:

normalized pattern

normalizeAlias

public static String normalizeAlias(String alias)

Alias should always be "exact" path

Parameters:

alias -

Returns: