org.apache.sling.api.resource.path

Class Path

java.lang.Object

org.apache.sling.api.resource.path.Path

All Implemented Interfaces:

Comparable<Path>

public class Path
extends Object
implements Comparable<Path>

Simple helper class for path matching.

Since:

1.0.0 (Sling API Bundle 2.11.0)

Field Summary

Fields

Modifier and Type	Field and Description
static String	GLOB_PREFIX The prefix to be used for glob patterns

Constructor Summary

Constructors

Constructor and Description
Path(String path) Create a new path object either from a concrete path or from a glob pattern.

Method Summary

Modifier and Type	Method and Description
int	compareTo(Path o)
boolean	equals(Object obj)
String	getPath() Return the path if this Path object holds a path, returns the pattern otherwise.
int	hashCode()
boolean	isPattern() Returns {code true} if this Path object is holding a pattern
boolean	matches(String otherPath) If this Path object holds a path (and not a pattern), this method checks whether the provided path is equal to this path or a sub path of it.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

GLOB_PREFIX

public static final String GLOB_PREFIX

The prefix to be used for glob patterns

Since:

1.2.0 (Sling API Bundle 2.15.0)

See Also:

Constant Field Values

Constructor Detail

Path

public Path(@Nonnull
            String path)

Create a new path object either from a concrete path or from a glob pattern.

A glob pattern must start with the glob: prefix (e.g. glob:**/*.html). The following rules are used to interpret glob patterns:

• The * character matches zero or more characters of a name component without crossing directory boundaries.
• The ** characters match zero or more characters crossing directory boundaries.

Parameters:

path - The resource path or a glob pattern.

Throws:

NullPointerException - If otherPath is null

IllegalArgumentException - If the provided path is not absolute, or if the glob pattern does not start with a slash.

Method Detail

matches

public boolean matches(String otherPath)

If this Path object holds a path (and not a pattern), this method checks whether the provided path is equal to this path or a sub path of it. If a glob pattern is provided as the argument, it performs the same check and respects the provided pattern. This means it returns true if this path is a parent to any potential path matching the provided pattern. For example if this path is /apps/foo and the provided pattern is glob:/apps/foo/bar/*.jsp this method will return true. Same if the provided pattern is glob:/apps/**/hello.html. If this Path object holds a pattern, it checks whether the provided path matches the pattern. If this path object holds a pattern and a pattern is provided as the argument, it returns only true if the pattern is the same. If the provided argument is not an absolute path (e.g. if it is a relative path or a pattern), this method returns false.

Parameters:

otherPath - Absolute path to check.

Returns:

true If other path is within the sub tree of this path or matches the pattern.

Throws:

NullPointerException - If otherPath is null

IllegalArgumentException - If the provided path is not absolute, or if the glob pattern does not start with a slash.

See Also:

isPattern()

getPath

public String getPath()

Return the path if this Path object holds a path, returns the pattern otherwise.

Returns:

The path or pattern.

See Also:

isPattern()

isPattern

public boolean isPattern()

Returns {code true} if this Path object is holding a pattern

Returns:

{code true} for a pattern, false for a path.

Since:

1.2.0 (Sling API Bundle 2.15.0)

compareTo

public int compareTo(@Nonnull
                     Path o)

Specified by:

compareTo in interface Comparable<Path>

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object