Package com.evolveum.midpoint.prism.path

Interface UniformItemPath

All Superinterfaces:

Cloneable, ItemPath, Serializable, ShortDumpable

All Known Implementing Classes:

UniformItemPathImpl

public interface UniformItemPath
extends Serializable, Cloneable, ShortDumpable, ItemPath

Author:

semancik

Nested Class Summary

Nested classes/interfaces inherited from interface com.evolveum.midpoint.prism.path.ItemPath

ItemPath.CompareResult

Field Summary

Fields inherited from interface com.evolveum.midpoint.prism.path.ItemPath

EMPTY_PATH

Method Summary

Modifier and Type	Method	Description
UniformItemPath	allExceptLast()	Returns a path containing all segments except the last one.
UniformItemPath	allUpToIncluding(int i)	Returns all segments up to the specified one (including it).
UniformItemPath	allUpToLastName()	Returns a path containing all segments up to (and not including) the last one.
UniformItemPath	append(Object... components)	Returns a newly created path containing all the segments of this path with added components.
Object	asItemPathType()
UniformItemPath	clone()
boolean	equals(Object obj)	More strict version of ItemPath comparison.
ItemPathSegment	first()	Returns the first segment or null if the path is empty.
UniformItemPath	firstAsPath()	Returns first segment in a form of path.
Map<String,String>	getNamespaceMap()
ItemPathSegment	getSegment(int i)	Returns the given path segment.
List<ItemPathSegment>	getSegments()	Returns the path segments.
ItemPathSegment	last()	Returns the last segment (or null if the path is empty).
UniformItemPath	namedSegmentsOnly()	Returns the path containing only the regular named segments.
UniformItemPath	normalize()	Makes the path "normal" by inserting null Id segments where they were omitted.
UniformItemPath	remainder(ItemPath prefix)	Returns the remainder of "this" path after passing all segments from the other path.
UniformItemPath	removeIds()	Returns the path with no Id segments.
default UniformItemPath	rest()	Returns the rest of the path (the tail).
UniformItemPath	rest(int n)	Returns the rest of the path (the tail), starting at position "n".
void	setNamespaceMap(Map<String,String> namespaceMap)
UniformItemPath	stripVariableSegment()	Removes the leading variable segment, if present.

Methods inherited from interface com.evolveum.midpoint.prism.path.ItemPath

asSingleName, asSingleNameOrFail, compareComplex, containsNameExactly, containsSpecialSymbols, containsSpecialSymbolsExceptParent, equals, equivalent, firstName, firstNameIndex, firstNameOrFail, firstToId, firstToIdOrNull, firstToName, firstToNameOrNull, firstToVariableNameOrNull, isEmpty, isSingleName, isSubPath, isSubPathOrEquivalent, isSuperPath, isSuperPathOrEquivalent, lastName, lastNameIndex, shortDump, size, startsWith, startsWithId, startsWithIdentifier, startsWithName, startsWithName, startsWithNullId, startsWithObjectReference, startsWithParent, startsWithVariable, subPath

Methods inherited from interface com.evolveum.midpoint.util.ShortDumpable

shortDump, shortDumpLazily

Method Detail

getSegments

@NotNull
List<ItemPathSegment> getSegments()

Description copied from interface: ItemPath

Returns the path segments. Avoid using this method and access segments directly. Instead try to find suitable method in ItemPath interface. NEVER change path content using this method. TODO consider returning unmodifiable collection here (beware of performance implications)

Specified by:

getSegments in interface ItemPath

first

ItemPathSegment first()

Description copied from interface: ItemPath

Returns the first segment or null if the path is empty.

Specified by:

first in interface ItemPath

rest

@NotNull
default UniformItemPath rest()

Description copied from interface: ItemPath

Returns the rest of the path (the tail).

Specified by:

rest in interface ItemPath

last

@Nullable
ItemPathSegment last()

Description copied from interface: ItemPath

Returns the last segment (or null if the path is empty).

Specified by:

last in interface ItemPath

firstAsPath

UniformItemPath firstAsPath()

Returns first segment in a form of path.

Specified by:

firstAsPath in interface ItemPath

rest

@NotNull
UniformItemPath rest(int n)

Description copied from interface: ItemPath

Returns the rest of the path (the tail), starting at position "n".

Specified by:

rest in interface ItemPath

allExceptLast

@NotNull
UniformItemPath allExceptLast()

Returns a path containing all segments except the last one.

Specified by:

allExceptLast in interface ItemPath

allUpToLastName

@NotNull
UniformItemPath allUpToLastName()

Returns a path containing all segments up to (and not including) the last one.

Specified by:

allUpToLastName in interface ItemPath

allUpToIncluding

UniformItemPath allUpToIncluding(int i)

Description copied from interface: ItemPath

Returns all segments up to the specified one (including it).

Specified by:

allUpToIncluding in interface ItemPath

normalize

UniformItemPath normalize()

Makes the path "normal" by inserting null Id segments where they were omitted.

removeIds

@NotNull
UniformItemPath removeIds()

Description copied from interface: ItemPath

Returns the path with no Id segments.

Specified by:

removeIds in interface ItemPath

namedSegmentsOnly

@NotNull
UniformItemPath namedSegmentsOnly()

Description copied from interface: ItemPath

Returns the path containing only the regular named segments.

Specified by:

namedSegmentsOnly in interface ItemPath

stripVariableSegment

@NotNull
UniformItemPath stripVariableSegment()

Description copied from interface: ItemPath

Removes the leading variable segment, if present.

Specified by:

stripVariableSegment in interface ItemPath

append

@NotNull
UniformItemPath append(Object... components)

Description copied from interface: ItemPath

Returns a newly created path containing all the segments of this path with added components.

Specified by:

append in interface ItemPath

remainder

UniformItemPath remainder(ItemPath prefix)

Description copied from interface: ItemPath

Returns the remainder of "this" path after passing all segments from the other path. (I.e. this path must begin with the content of the other path. Throws an exception when it is not the case.)

Specified by:

remainder in interface ItemPath

equals

boolean equals(Object obj)

More strict version of ItemPath comparison. Does not use any normalization nor approximate matching QNames via QNameUtil.match. For semantic-level comparison, please use equivalent(..) method.

Overrides:

equals in class Object

clone

UniformItemPath clone()

asItemPathType

Object asItemPathType()

getSegment

ItemPathSegment getSegment(int i)

Description copied from interface: ItemPath

Returns the given path segment.

Specified by:

getSegment in interface ItemPath

setNamespaceMap

void setNamespaceMap(Map<String,String> namespaceMap)

getNamespaceMap

Map<String,String> getNamespaceMap()