Package com.evolveum.midpoint.prism.lazy

Class FlyweightClonedItem<V extends PrismValue,D extends ItemDefinition<?>>

java.lang.Object

com.evolveum.midpoint.prism.lazy.FlyweightClonedItem<V,D>

Type Parameters:

V -

D -

All Implemented Interfaces:

ComplexCopyable<Item<V,D>>, ItemDelegator<V,D>, Freezable, Item<V,D>, Itemable, ParentVisitable, PathVisitable, PrismVisitable, Revivable, Visitable, DebugDumpable, Serializable, Cloneable

public abstract class FlyweightClonedItem<V extends PrismValue,D extends ItemDefinition<?>>
extends Object
implements ItemDelegator<V,D>

Flyweight immutable item backed by delegate. Flyweight immutable item is special implementation of item, which is semantically clone of another item, almost fully immutable, but allows this clone to be used in different place (setParent is mutable - eg. deltas) without need to do deep clone of all children. When value is accessed a temporary flyweight clone with proper PrismValue.getParent() is created. This lightweight clones are not cached and are created each time to simplify state tracking and to prevent creation of full clone.

See Also:

• Serialized Form

Field Summary

Fields inherited from interface com.evolveum.midpoint.util.DebugDumpable

INDENT_STRING

Fields inherited from interface com.evolveum.midpoint.prism.Item

KEY_NAMESPACE_CONTEXT

Constructor Summary

Constructors

Constructor	Description
FlyweightClonedItem()

Method Summary

Modifier and Type	Method	Description
Item<V,D>	clone()	Literal clone.
static Item<?,?>	copyOf(Item<?,?> item)	Deprecated.
protected abstract V	createWrapped(V value)
static @NotNull Item<?,?>	from(@NotNull Item<?,?> item)
static <C extends Containerable> @NotNull PrismContainer<C>	from(@NotNull PrismContainer<C> container)
static <O extends Objectable> @NotNull PrismObject<O>	from(@NotNull PrismObject<O> object)
static <T> @NotNull PrismProperty<T>	from(@NotNull PrismProperty<T> property)
static @NotNull PrismReference	from(@NotNull PrismReference reference)
V	getAnyValue()	Returns any of the values.
V	getAnyValue(@NotNull ValueSelector<V> selector)	Returns a value matching given selector (or null if none exists).
@Nullable PrismContainerValue<?>	getParent()	Returns the parent of this item (if exists).
V	getValue()	Returns the value, if there is only one.
@NotNull List<V>	getValues()	Returns the values for this item.
void	setParent(@Nullable PrismContainerValue<?> parentValue)	Sets the parent of this item.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.evolveum.midpoint.prism.Item

copy, equals, hashCode, immutableCopy, mutableCopy

Methods inherited from interface com.evolveum.midpoint.prism.deleg.ItemDelegator

accept, accept, acceptParentVisitor, acceptVisitor, add, add, addAll, addAll, addIgnoringEquivalents, addRespectingMetadataAndCloning, applyDefinition, applyDefinition, applyDefinitionIfMissing, assertDefinitions, assertDefinitions, assertDefinitions, checkConsistence, checkConsistence, checkConsistence, checkConsistence, checkConsistence, checkConsistenceInternal, checkImmutable, checkMutable, clear, cloneComplex, contains, contains, createDelta, createDelta, createImmutableClone, debugDump, debugDump, debugDumpLazily, debugDumpLazily, delegate, diff, diff, equals, equals, filterValues, filterYields, find, findPartial, findValue, findValue, freeze, getAllItems, getAllValues, getClonedValues, getDefinition, getDisplayName, getElementName, getHelp, getHighestId, getNamespaceContext, getPath, getRealValue, getRealValue, getRealValues, getRealValues, getRealValuesArray, getRealValuesOrRawTypes, getUserData, getUserData, hasAnyValue, hasCompleteDefinition, hashCode, hashCode, hasNoValues, hasRaw, isEmpty, isImmutable, isIncomplete, isOperational, isRaw, isSingleValue, isSingleValueByDefinition, merge, normalize, recomputeAllValues, remove, remove, removeAll, removeIf, removeRespectingMetadata, replace, replaceAll, revive, setDefinition, setElementName, setIncomplete, setUserData, size, valuesStream

Constructor Details

FlyweightClonedItem

public FlyweightClonedItem()

Method Details

from

@NotNull
public static @NotNull Item<?,?> from(@NotNull
 @NotNull Item<?,?> item)

from

@NotNull
public static <T> @NotNull PrismProperty<T> from(@NotNull
 @NotNull PrismProperty<T> property)

from

@NotNull
public static <C extends Containerable>
@NotNull PrismContainer<C> from(@NotNull
 @NotNull PrismContainer<C> container)

from

@NotNull
public static <O extends Objectable>
@NotNull PrismObject<O> from(@NotNull
 @NotNull PrismObject<O> object)

from

@NotNull
public static @NotNull PrismReference from(@NotNull
 @NotNull PrismReference reference)

copyOf

@Deprecated
public static Item<?,?> copyOf(Item<?,?> item)

Deprecated.

getParent

@Nullable
public @Nullable PrismContainerValue<?> getParent()

Description copied from interface: Item

Returns the parent of this item (if exists). Currently this has to be a PrismContainerValue.

Specified by:

getParent in interface Item<V extends PrismValue,D extends ItemDefinition<?>>

Specified by:

getParent in interface ItemDelegator<V extends PrismValue,D extends ItemDefinition<?>>

Returns:

The parent if exists

setParent

public void setParent(@Nullable
 @Nullable PrismContainerValue<?> parentValue)

Description copied from interface: Item

Sets the parent of this item.

Specified by:

setParent in interface Item<V extends PrismValue,D extends ItemDefinition<?>>

Specified by:

setParent in interface ItemDelegator<V extends PrismValue,D extends ItemDefinition<?>>

Parameters:

parentValue - The new parent

createWrapped

protected abstract V createWrapped(V value)

getValues

@NotNull
public @NotNull List<V> getValues()

Description copied from interface: Item

Returns the values for this item. Although the ordering of this values is not important, and each value should be present at most once, we currently return them as a list instead of a set. TODO reconsider this FIXME we should return immutable list, to avoid manipulating the values directly FIXME and maybe we should return List<? extends V> to avoid specializing the values, see ShadowAssociationValue in midPoint

Specified by:

getValues in interface Item<V extends PrismValue,D extends ItemDefinition<?>>

Specified by:

getValues in interface ItemDelegator<V extends PrismValue,D extends ItemDefinition<?>>

getAnyValue

public V getAnyValue(@NotNull
 @NotNull ValueSelector<V> selector)

Description copied from interface: Item

Returns a value matching given selector (or null if none exists).

Specified by:

getAnyValue in interface Item<V extends PrismValue,D extends ItemDefinition<?>>

Specified by:

getAnyValue in interface ItemDelegator<V extends PrismValue,D extends ItemDefinition<?>>

getValue

public V getValue()

Description copied from interface: Item

Returns the value, if there is only one. Throws exception if there are more values. If there is no value, this method either: - returns null (for properties) - throws an exception (for items that can hold multiple values) - creates an empty value (for containers and references). TODO think again whether getOrCreateValue would not be better

Specified by:

getValue in interface Item<V extends PrismValue,D extends ItemDefinition<?>>

Specified by:

getValue in interface ItemDelegator<V extends PrismValue,D extends ItemDefinition<?>>

getAnyValue

public V getAnyValue()

Description copied from interface: Item

Returns any of the values. Usually called when we are quite confident that there is only a single value; or we don't care which of the values we get. Does not create values if there are none.

Specified by:

getAnyValue in interface Item<V extends PrismValue,D extends ItemDefinition<?>>

Specified by:

getAnyValue in interface ItemDelegator<V extends PrismValue,D extends ItemDefinition<?>>

clone

public Item<V,D> clone()

Description copied from interface: Item

Literal clone.

Specified by:

clone in interface Item<V extends PrismValue,D extends ItemDefinition<?>>

Overrides:

clone in class Object