|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.jboss.dna.graph.property.basic.AbstractPath org.jboss.dna.graph.property.basic.RootPath
@Immutable public class RootPath
Optimized implementation of Path
that serves as the root path.
Nested Class Summary |
---|
Nested classes/interfaces inherited from interface org.jboss.dna.graph.property.Path |
---|
Path.Segment |
Field Summary | |
---|---|
static Path |
INSTANCE
|
Fields inherited from class org.jboss.dna.graph.property.basic.AbstractPath |
---|
SELF_PATH |
Fields inherited from interface org.jboss.dna.graph.property.Path |
---|
DEFAULT_DECODER, DEFAULT_ENCODER, DEFAULT_INDEX, DELIMITER, DELIMITER_STR, JSR283_DECODER, JSR283_ENCODER, NO_OP_DECODER, NO_OP_ENCODER, PARENT, PARENT_NAME, PARENT_SEGMENT, SELF, SELF_NAME, SELF_SEGMENT, URL_DECODER, URL_ENCODER |
Method Summary | |
---|---|
int |
compareTo(Path other)
|
boolean |
endsWith(Name nameOfLastSegment)
Determine if the path's Path.getLastSegment() has the supplied name and no SNS index . |
boolean |
endsWith(Name nameOfLastSegment,
int snsIndex)
Determine if the path's Path.getLastSegment() has the supplied name and SNS index . |
boolean |
equals(Object obj)
|
Path |
getAncestor(int degree)
Return the path to the ancestor of the supplied degree. |
Path |
getCanonicalPath()
Get the canonical form of this path. |
Path |
getCommonAncestor(Path that)
Find the lowest common ancestor of this path and the supplied path. |
Path.Segment |
getLastSegment()
Get the last segment in this path. |
Path |
getNormalizedPath()
Get a normalized path with as many ".." segments and all "." resolved. |
Path |
getParent()
Return the path to the parent, or this path if it is the root . |
Path.Segment |
getSegment(int index)
Get the segment at the supplied index. |
Path.Segment[] |
getSegmentsArray()
Obtain a copy of the segments in this path. |
List<Path.Segment> |
getSegmentsList()
Get an unmodifiable list of the path segments. |
String |
getString()
Get the string form of the object. |
String |
getString(NamespaceRegistry namespaceRegistry)
Get the string form of the object, using the supplied namespace registry to convert any namespace URIs to prefixes. |
String |
getString(NamespaceRegistry namespaceRegistry,
TextEncoder encoder)
Get the encoded string form of the object, using the supplied namespace registry to convert the any namespace URIs to prefixes. |
String |
getString(NamespaceRegistry namespaceRegistry,
TextEncoder encoder,
TextEncoder delimiterEncoder)
Get the encoded string form of the object, using the supplied namespace registry to convert the names' namespace URIs to prefixes and the supplied encoder to encode characters, and using the second delimiter to encode (or convert) the delimiter used between the namespace prefix and the local part of any names. |
String |
getString(TextEncoder encoder)
Get the encoded string form of the object, using the supplied encoder to encode characters. |
boolean |
hasSameAncestor(Path that)
Determine whether this path and the supplied path have the same immediate ancestor. |
boolean |
isAbsolute()
Return whether this path is an absolute path. |
boolean |
isAncestorOf(Path decendant)
Determine whether this path is an ancestor of the supplied path. |
boolean |
isAtOrAbove(Path other)
Determine whether this path is the same as to or a ancestor of the
supplied path. |
boolean |
isAtOrBelow(Path other)
Determine whether this path is the same as to or a decendant of the
supplied path. |
boolean |
isDecendantOf(Path ancestor)
Determine whether this path is an decendant of the supplied path. |
boolean |
isNormalized()
Return whether this path is normalized and contains no unnecessary "." segments and as few ".." segments as possible. |
boolean |
isRoot()
Return whether this path represents the root path. |
boolean |
isSameAs(Path other)
Determine whether this path represents the same as the supplied path. |
Iterator<Path.Segment> |
iterator()
|
Iterator<Path> |
pathsFromRoot()
Return an iterator that walks the paths from the root path down to this path. |
Path |
relativeToRoot()
Obtain a path that is relative to the root node. |
Path |
resolve(Path relativePath)
Get the absolute path by resolving the supplied relative (non-absolute) path against this absolute path. |
int |
size()
Return the number of segments in this path. |
Path |
subpath(int beginIndex)
Return a new path consisting of the segments starting at beginIndex index (inclusive). |
Path |
subpath(int beginIndex,
int endIndex)
Return a new path consisting of the segments between the beginIndex index (inclusive) and the endIndex
index (exclusive). |
Methods inherited from class org.jboss.dna.graph.property.basic.AbstractPath |
---|
hashCode, relativeTo, resolveAgainst, toString |
Methods inherited from class java.lang.Object |
---|
getClass, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final Path INSTANCE
Method Detail |
---|
public Path getAncestor(int degree)
x
is the path that is x
levels up along the path. For example, degree = 0
returns this path, while degree = 1
returns the parent of this path, degree = 2
returns the grandparent of this path, and so on. Note that the
result may be unexpected if this path is not normalized
, as a non-normalized path contains ".." and
"." segments.
Path.getAncestor(int)
public Path getCanonicalPath()
absolute
and Path.isNormalized()
.
getCanonicalPath
in interface Path
getCanonicalPath
in class AbstractPath
Path.getCanonicalPath()
public Path getCommonAncestor(Path that)
getCommonAncestor
in interface Path
getCommonAncestor
in class AbstractPath
that
- the other path
Path.getCommonAncestor(org.jboss.dna.graph.property.Path)
public Path.Segment getLastSegment()
getLastSegment
in interface Path
getLastSegment
in class AbstractPath
Path.getLastSegment()
public boolean endsWith(Name nameOfLastSegment)
Path.getLastSegment()
has the supplied name and no SNS index
.
endsWith
in interface Path
endsWith
in class AbstractPath
nameOfLastSegment
- the name
AbstractPath.endsWith(org.jboss.dna.graph.property.Name)
public boolean endsWith(Name nameOfLastSegment, int snsIndex)
Path.getLastSegment()
has the supplied name and SNS index
.
endsWith
in interface Path
endsWith
in class AbstractPath
nameOfLastSegment
- the namesnsIndex
- the SNS index
AbstractPath.endsWith(org.jboss.dna.graph.property.Name, int)
public Path getNormalizedPath()
getNormalizedPath
in interface Path
getNormalizedPath
in class AbstractPath
Path.getNormalizedPath()
public Path relativeToRoot()
Path.relativeTo(Path)
with the root
path.
relativeToRoot
in interface Path
relativeToRoot
in class AbstractPath
AbstractPath.relativeToRoot()
public Path resolve(Path relativePath)
resolve
in interface Path
resolve
in class AbstractPath
relativePath
- the relative path that is to be resolved against this path
AbstractPath.resolve(org.jboss.dna.graph.property.Path)
public Path getParent()
root
. This is an efficient operation that does
not require copying any data.
getParent
in interface Path
getParent
in class AbstractPath
Path.getParent()
public Path.Segment getSegment(int index)
getSegment
in interface Path
getSegment
in class AbstractPath
index
- the index
Path.getSegment(int)
public Path.Segment[] getSegmentsArray()
getSegmentsArray
in interface Path
getSegmentsArray
in class AbstractPath
Path.getSegmentsArray()
public List<Path.Segment> getSegmentsList()
Path.getSegmentsList()
public String getString()
default encoder
is used to encode characters.
getString
in interface Readable
getString
in class AbstractPath
Readable.getString()
public String getString(TextEncoder encoder)
getString
in interface Readable
getString
in class AbstractPath
encoder
- the encoder to use, or null if the default encoder
should be used
Readable.getString(org.jboss.dna.common.text.TextEncoder)
public String getString(NamespaceRegistry namespaceRegistry)
default encoder
is used to encode characters.
getString
in interface Readable
getString
in class AbstractPath
namespaceRegistry
- the namespace registry that should be used to obtain the prefix for any namespace URIs
Readable.getString(org.jboss.dna.graph.property.NamespaceRegistry)
public String getString(NamespaceRegistry namespaceRegistry, TextEncoder encoder)
getString
in interface Readable
getString
in class AbstractPath
namespaceRegistry
- the namespace registry that should be used to obtain the prefix for the namespace URIsencoder
- the encoder to use, or null if the default encoder
should be used
Readable.getString(org.jboss.dna.graph.property.NamespaceRegistry,
org.jboss.dna.common.text.TextEncoder)
public String getString(NamespaceRegistry namespaceRegistry, TextEncoder encoder, TextEncoder delimiterEncoder)
getString
in interface Readable
getString
in class AbstractPath
namespaceRegistry
- the namespace registry that should be used to obtain the prefix for the namespace URIs in the
segment names
encoder
- the encoder to use for encoding the local part and namespace prefix of any names, or null if the
default encoder
should be useddelimiterEncoder
- the encoder to use for encoding the delimiter between the local part and namespace prefix of any
names, or null if the standard delimiter should be used
Readable.getString(org.jboss.dna.graph.property.NamespaceRegistry,
org.jboss.dna.common.text.TextEncoder, org.jboss.dna.common.text.TextEncoder)
public boolean hasSameAncestor(Path that)
hasSameAncestor
in interface Path
hasSameAncestor
in class AbstractPath
that
- the other path
Path.hasSameAncestor(org.jboss.dna.graph.property.Path)
public boolean isAbsolute()
absolute
. An absolute path
starts with a "/".
Path.isAbsolute()
public boolean isAncestorOf(Path decendant)
isAncestorOf
in interface Path
isAncestorOf
in class AbstractPath
decendant
- the path that may be the decendant; may be null
Path.isAncestorOf(org.jboss.dna.graph.property.Path)
public boolean isAtOrAbove(Path other)
same as
to or a ancestor of
the
supplied path. This method is equivalent to (but may be more efficient than) calling isSame(other) ||
isAncestor(other)
, and is a convenience method that is identical to calling other.isAtOrBelow(this)
.
isAtOrAbove
in interface Path
isAtOrAbove
in class AbstractPath
other
- the other path to compare with this path; may be null
Path.isAtOrAbove(org.jboss.dna.graph.property.Path)
public boolean isAtOrBelow(Path other)
same as
to or a decendant of
the
supplied path. This method is equivalent to (but may be more efficient than) calling isSame(other) ||
isAncestor(other)
.
isAtOrBelow
in interface Path
isAtOrBelow
in class AbstractPath
other
- the other path to compare with this path; may be null
Path.isAtOrBelow(org.jboss.dna.graph.property.Path)
public boolean isDecendantOf(Path ancestor)
isDecendantOf
in interface Path
isDecendantOf
in class AbstractPath
ancestor
- the path that may be the ancestor; may be null
Path.isDecendantOf(org.jboss.dna.graph.property.Path)
public boolean isNormalized()
Path.isNormalized()
public boolean isRoot()
Path.isRoot()
public boolean isSameAs(Path other)
this.compareTo(other) == 0
.
isSameAs
in interface Path
isSameAs
in class AbstractPath
other
- the other path to compare with this path; may be null
Path.isSameAs(org.jboss.dna.graph.property.Path)
public Iterator<Path.Segment> iterator()
iterator
in interface Iterable<Path.Segment>
iterator
in interface Path
iterator
in class AbstractPath
Path.iterator()
public Iterator<Path> pathsFromRoot()
pathsFromRoot
in interface Path
pathsFromRoot
in class AbstractPath
Path.pathsFromRoot()
public int size()
Path.size()
public Path subpath(int beginIndex)
beginIndex
index (inclusive). This is equivalent to
calling path.subpath(beginIndex,path.size()-1)
.
subpath
in interface Path
subpath
in class AbstractPath
beginIndex
- the beginning index, inclusive.
Path.subpath(int)
public Path subpath(int beginIndex, int endIndex)
beginIndex
index (inclusive) and the endIndex
index (exclusive).
subpath
in interface Path
subpath
in class AbstractPath
beginIndex
- the beginning index, inclusive.endIndex
- the ending index, exclusive.
Path.subpath(int, int)
public int compareTo(Path other)
compareTo
in interface Comparable<Path>
compareTo
in class AbstractPath
Comparable.compareTo(java.lang.Object)
public boolean equals(Object obj)
equals
in class AbstractPath
Object.equals(java.lang.Object)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |