Package com.evolveum.midpoint.prism.impl

Class PrismContainerValueImpl<C extends Containerable>

java.lang.Object

com.evolveum.midpoint.prism.AbstractFreezable

com.evolveum.midpoint.prism.impl.PrismValueImpl

com.evolveum.midpoint.prism.impl.PrismContainerValueImpl<C>

All Implemented Interfaces:

Freezable, ItemDefinitionTransformer.TransformableValue, MidpointOriginMetadata, ParentVisitable, PathVisitable, PrismContainerValue<C>, PrismValue, Revivable, Visitable, DebugDumpable, Serializable

Direct Known Subclasses:

PrismObjectValueImpl, ShadowAssociationValue

public class PrismContainerValueImpl<C extends Containerable>
extends PrismValueImpl
implements PrismContainerValue<C>

Author:

semancik

See Also:

• Serialized Form

Nested Class Summary

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

PrismContainerValue.RemovedItemDefinitionException

Field Summary

Fields

Modifier and Type	Field	Description
protected ComplexTypeDefinition	complexTypeDefinition
static final RuntimeException	DIFFERENT_ITEMS_EXCEPTION
protected final LinkedHashMap<QName,Item<?,?>>	items
protected final Set<String>	unqualifiedItemNames

Fields inherited from class com.evolveum.midpoint.prism.impl.PrismValueImpl

defaultEquivalenceStrategy

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

INDENT_STRING

Constructor Summary

Constructors

Constructor	Description
PrismContainerValueImpl()
PrismContainerValueImpl(C containerable)
PrismContainerValueImpl(OriginType type, Objectable source, PrismContainerable container, Long id, ComplexTypeDefinition complexTypeDefinition)

Method Summary

Modifier and Type	Method	Description
void	accept(Visitor visitor)
void	accept(Visitor visitor, ItemPath path, boolean recursive)
void	acceptParentVisitor(Visitor visitor)
<IV extends PrismValue, ID extends ItemDefinition<?>> void	add(Item<IV,ID> item)
<IV extends PrismValue, ID extends ItemDefinition<?>> void	add(Item<IV,ID> item, boolean checkUniqueness)	Adds an item to a property container.
void	addAll(Collection<? extends Item<?,?>> itemsToAdd)	Adds a collection of items to a property container.
void	addAllReplaceExisting(Collection<? extends Item<?,?>> itemsToAdd)	Adds a collection of items to a property container.
boolean	addRawElement(Object element)
<IV extends PrismValue, ID extends ItemDefinition<?>> void	addReplaceExisting(Item<IV,ID> item)	Adds an item to a property container.
protected boolean	appendExtraHeaderDump(StringBuilder sb, int indent, boolean wasIndent)
PrismContainerValue<C>	applyDefinition(@NotNull ItemDefinition<?> definition)	Definition application MAY change the value (currently only for container values).
PrismContainerValue<C>	applyDefinition(@NotNull ItemDefinition<?> definition, boolean force)	Definition application MAY change the value (currently only for container values).
PrismContainerValue<C>	applyDefinition(@NotNull PrismContainerDefinition<C> containerDef, boolean force)
C	asContainerable()
static <T extends Containerable> T	asContainerable(PrismContainerValue<T> value)
C	asContainerable(Class<C> requiredClass)
static <C extends Containerable> Collection<C>	asContainerables(Collection<PrismContainerValue<C>> pcvs)
static <C extends Containerable> List<C>	asContainerables(List<PrismContainerValue<C>> pcvs)
static <C extends Containerable> List<PrismContainerValue<C>>	asPrismContainerValues(List<C> containerables)
void	assertDefinitions(boolean tolerateRaw, Supplier<String> sourceDescriptionSupplier)
void	assertDefinitions(Supplier<String> sourceDescriptionSupplier)
PrismContainer<C>	asSingleValuedContainer(@NotNull QName itemName)	Returns a single-valued container (with a single-valued definition) holding just this value.
boolean	canRepresent(Class<?> clazz)
void	checkConsistenceInternal(Itemable rootItem, boolean requireDefinitions, boolean prohibitRaw, ConsistencyCheckScope scope)
void	clear()
PrismContainerValue<C>	clone()	Literal clone.
PrismContainerValueImpl<C>	cloneComplex(CloneStrategy strategy)	Complex clone with different cloning strategies.
boolean	contains(Item item)
boolean	contains(ItemName itemName)
boolean	containsItem(ItemPath path, boolean acceptEmptyItem)
static <C extends Containerable> boolean	containsRealValue(Collection<PrismContainerValue<C>> cvalCollection, PrismContainerValue<C> cval)
protected void	copyValues(CloneStrategy strategy, PrismContainerValueImpl<C> clone)
<IV extends PrismValue, ID extends ItemDefinition<?>, I extends Item<IV, ID>> I	createDetachedSubItem(QName name, Class<I> type, ID itemDefinition, boolean immutable)
PrismContainerValue<C>	createImmutableClone()
<X> PrismProperty<X>	createProperty(PrismPropertyDefinition<X> propertyDefinition)
<X> PrismProperty<X>	createProperty(QName propertyName)
String	debugDump(int indent)
protected void	debugDumpIdentifiers(StringBuilder sb)
boolean	deleteRawElement(Object element)
protected void	detailedDebugDumpStart(StringBuilder sb)
boolean	diffMatchingRepresentation(PrismValue otherValue, Collection<? extends ItemDelta> deltas, ParameterizedEquivalenceStrategy strategy, boolean exitOnDiff)
boolean	equals(PrismValue other, @NotNull ParameterizedEquivalenceStrategy strategy)
boolean	equivalent(PrismContainerValue<?> other)
Object	find(ItemPath path)
<X extends Containerable> PrismContainer<X>	findContainer(QName containerName)
<IV extends PrismValue, ID extends ItemDefinition<?>, I extends Item<IV, ID>> I	findItem(ItemDefinition itemDefinition, Class<I> type)
<IV extends PrismValue, ID extends ItemDefinition<?>, I extends Item<IV, ID>> I	findItem(ItemPath itemPath, Class<I> type)
<T extends Containerable> PrismContainer<T>	findOrCreateContainer(QName containerName)
<IV extends PrismValue, ID extends ItemDefinition<?>, I extends Item<IV, ID>> I	findOrCreateItem(ItemPath path, Class<I> type, ID definition)
<IV extends PrismValue, ID extends ItemDefinition<?>> Item<IV,ID>	findOrCreateItem(QName containerName)
<IV extends PrismValue, ID extends ItemDefinition<?>, I extends Item<IV, ID>> I	findOrCreateItem(QName containerName, Class<I> type)
<X> PrismProperty<X>	findOrCreateProperty(ItemPath propertyPath)
<X> PrismProperty<X>	findOrCreateProperty(PrismPropertyDefinition propertyDef)
PrismReference	findOrCreateReference(QName referenceName)
<IV extends PrismValue, ID extends ItemDefinition<?>> PartiallyResolvedItem<IV,ID>	findPartial(ItemPath path)
<X> PrismProperty<X>	findProperty(ItemPath propertyPath)
<X> PrismProperty<X>	findProperty(PrismPropertyDefinition<X> propertyDefinition)	Finds a specific property in the container by definition.
PrismReference	findReference(QName elementName)
@NotNull Collection<Item<?,?>>	getAllItems(@NotNull ItemPath path)	See Item.getAllItems(ItemPath).
@NotNull Collection<PrismValue>	getAllValues(ItemPath path)	See Item.getAllValues(ItemPath).
Class<C>	getCompileTimeClass()
@Nullable ComplexTypeDefinition	getComplexTypeDefinition()
PrismContainer<C>	getContainer()
PrismContainerDefinition<C>	getDefinition()
Long	getId()
Object	getIdentifier()	Returns the value of identifier corresponding to the '#' path: container id or object oid.
@NotNull Collection<QName>	getItemNames()
@NotNull Collection<Item<?,?>>	getItems()	Returns a set of items that the property container contains.
<I extends Item<?, ?>> List<I>	getItems(Class<I> type)
PrismContainerable<C>	getParent()
@NotNull ItemPath	getPath()
protected Object	getPathComponent()
@NotNull Set<PrismProperty<?>>	getProperties()	Returns a set of properties that the property container contains.
<T> T	getPropertyRealValue(QName propertyName, Class<T> type)
Class<?>	getRealClass()
<T> T	getRealValue()	Returns the statically-typed "real value".
@NotNull PrismContainerValue<?>	getRootValue()
QName	getTypeName()
C	getValue()
boolean	hasCompleteDefinition()	Returns true if all contained items have complete definitions.
int	hashCode(@NotNull ParameterizedEquivalenceStrategy strategy)
boolean	hasNoItems()	Like isEmpty but ignores presence of container value ID.
boolean	isEmpty()
boolean	isIdOnly()
boolean	isRaw()
void	keepPaths(List<? extends ItemPath> keep)
<IV extends PrismValue, ID extends ItemDefinition<?>> boolean	merge(Item<IV,ID> item)	Merges the provided item into this item.
void	mergeContent(@NotNull PrismContainerValue<?> other, @NotNull List<QName> overwrite)
void	normalize()	Currently doing nothing.
void	performFreeze()
void	recompute(PrismContext prismContext)
<IV extends PrismValue, ID extends ItemDefinition<?>> void	remove(@NotNull Item<IV,ID> item)
void	removeAll()
void	removeContainer(ItemPath path)
void	removeItems(List<? extends ItemPath> itemsToRemove)
void	removeOperationalItems()
void	removePaths(List<? extends ItemPath> remove)
void	removeProperty(ItemPath path)
boolean	removeRawElement(Object element)
void	removeReference(ItemPath path)
<IV extends PrismValue, ID extends ItemDefinition<?>> void	replace(Item<IV,ID> oldItem, Item<IV,ID> newItem)
boolean	representsSameValue(PrismValue other, EquivalenceStrategy strategy, boolean lax)	Returns true if this and other value represent the same value.
void	revive(PrismContext prismContext)	TODO: Is revive necessary if prism context is static? TODO document (if it's found to be necessary)
void	setId(Long id)
void	setOriginTypeRecursive(OriginType originType)	Set origin type to all values and subvalues
<T> void	setPropertyRealValue(QName propertyName, T realValue)
protected <IV extends PrismValue, ID extends ItemDefinition<?>> void	simpleAdd(Item<IV,ID> item)
int	size()
<IV extends PrismValue, ID extends ItemDefinition<?>> boolean	subtract(Item<IV,ID> item)	Subtract the provided item from this item.
String	toHumanReadableString()
static <T extends Containerable> List<PrismContainerValue<T>>	toPcvList(List<T> beans)
String	toString()
void	transformDefinition(ComplexTypeDefinition parentDef, ItemDefinition<?> itemDef, ItemDefinitionTransformer transformation)

Methods inherited from class com.evolveum.midpoint.prism.impl.PrismValueImpl

appendOriginDump, clearParent, copyValues, diff, diffMatchingRepresentation, equals, equals, getOriginObject, getOriginType, getParentContainerValue, getUserData, getUserData, getValueMetadata, hashCode, hashCode, hasValueMetadata, isTransient, recompute, setOriginObject, setOriginType, setParent, setTransient, setUserData, setValueMetadata, setValueMetadata, setValueMetadata

Methods inherited from class com.evolveum.midpoint.prism.AbstractFreezable

freeze, freeze, freezeAll, freezeNullableList, isImmutable, isMutable

Methods inherited from class java.lang.Object

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

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

debugDump, debugDumpLazily, debugDumpLazily

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

checkImmutable, checkMutable, freeze, isImmutable

Methods inherited from interface com.evolveum.midpoint.prism.metadata.MidpointOriginMetadata

getOriginObject, getOriginType, setOriginObject, setOriginType

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

checkNothingExceptFor, findItem, getItemRealValue

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

applyDefinitionLegacy, applyDefinitionLegacy, clearParent, cloneIfImmutable, diff, equals, getNearestValueOfType, getParentContainerValue, getRealValueIfExists, getRealValueOrRawType, getRootObjectable, getUserData, getUserData, getValueMetadata, getValueMetadataAsContainer, hashCode, hasRealClass, hasValueMetadata, isObjectable, isOfType, isTransient, recompute, setParent, setTransient, setUserData, setValueMetadata, setValueMetadata, setValueMetadata, valueMetadata

Field Details

DIFFERENT_ITEMS_EXCEPTION

public static final RuntimeException DIFFERENT_ITEMS_EXCEPTION

items

protected final LinkedHashMap<QName,Item<?,?>> items

unqualifiedItemNames

protected final Set<String> unqualifiedItemNames

complexTypeDefinition

protected ComplexTypeDefinition complexTypeDefinition

Constructor Details

PrismContainerValueImpl

public PrismContainerValueImpl()

PrismContainerValueImpl

public PrismContainerValueImpl(C containerable)

PrismContainerValueImpl

public PrismContainerValueImpl(OriginType type,
 Objectable source,
 PrismContainerable container,
 Long id,
 ComplexTypeDefinition complexTypeDefinition)

Method Details

asContainerable

public static <T extends Containerable> T asContainerable(PrismContainerValue<T> value)

getItems

@NotNull
public @NotNull Collection<Item<?,?>> getItems()

Returns a set of items that the property container contains. The items may be properties or inner property containers.

The set may be null. In case there are no properties an empty set is returned.

Returned set is mutable. Live object is returned.

Specified by:

getItems in interface PrismContainerValue<C extends Containerable>

Returns:

set of items that the property container contains.

getItems

public <I extends Item<?,
?>> List<I> getItems(Class<I> type)

size

public int size()

Specified by:

size in interface PrismContainerValue<C extends Containerable>

getProperties

@NotNull
public @NotNull Set<PrismProperty<?>> getProperties()

Returns a set of properties that the property container contains.

The set must not be null. In case there are no properties an empty set is returned.

Returned set is immutable! Any change to it will be ignored.

Specified by:

getProperties in interface PrismContainerValue<C extends Containerable>

Returns:

set of properties that the property container contains.

getId

public Long getId()

Specified by:

getId in interface PrismContainerValue<C extends Containerable>

setId

public void setId(Long id)

Specified by:

setId in interface PrismContainerValue<C extends Containerable>

getParent

public PrismContainerable<C> getParent()

Specified by:

getParent in interface PrismContainerValue<C extends Containerable>

Specified by:

getParent in interface PrismValue

Overrides:

getParent in class PrismValueImpl

getContainer

public PrismContainer<C> getContainer()

Specified by:

getContainer in interface PrismContainerValue<C extends Containerable>

getPath

@NotNull
public @NotNull ItemPath getPath()

Specified by:

getPath in interface PrismValue

Overrides:

getPath in class PrismValueImpl

getPathComponent

protected Object getPathComponent()

Overrides:

getPathComponent in class PrismValueImpl

getValue

public C getValue()

Specified by:

getValue in interface PrismContainerValue<C extends Containerable>

asContainerable

@NotNull
public C asContainerable()

Specified by:

asContainerable in interface PrismContainerValue<C extends Containerable>

getCompileTimeClass

public Class<C> getCompileTimeClass()

Specified by:

getCompileTimeClass in interface PrismContainerValue<C extends Containerable>

canRepresent

public boolean canRepresent(Class<?> clazz)

Specified by:

canRepresent in interface PrismContainerValue<C extends Containerable>

asContainerable

public C asContainerable(Class<C> requiredClass)

Specified by:

asContainerable in interface PrismContainerValue<C extends Containerable>

getItemNames

@NotNull
public @NotNull Collection<QName> getItemNames()

Specified by:

getItemNames in interface PrismContainerValue<C extends Containerable>

add

public <IV extends PrismValue,
ID extends ItemDefinition<?>>
void add(Item<IV,ID> item)
  throws SchemaException

Specified by:

add in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

add

public <IV extends PrismValue,
ID extends ItemDefinition<?>>
void add(Item<IV,ID> item,
 boolean checkUniqueness)
  throws SchemaException

Adds an item to a property container.

Specified by:

add in interface PrismContainerValue<C extends Containerable>

Parameters:

item - item to add.

Throws:

IllegalArgumentException - an attempt to add value that already exists

SchemaException

simpleAdd

protected <IV extends PrismValue,
ID extends ItemDefinition<?>>
void simpleAdd(Item<IV,ID> item)

merge

public <IV extends PrismValue,
ID extends ItemDefinition<?>>
boolean merge(Item<IV,ID> item)
       throws SchemaException

Merges the provided item into this item. The values are joined together. Returns true if new item or value was added.

Specified by:

merge in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

subtract

public <IV extends PrismValue,
ID extends ItemDefinition<?>>
boolean subtract(Item<IV,ID> item)
          throws SchemaException

Subtract the provided item from this item. The values of the provided item are deleted from this item. Returns true if this item was changed.

Specified by:

subtract in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

addReplaceExisting

public <IV extends PrismValue,
ID extends ItemDefinition<?>>
void addReplaceExisting(Item<IV,ID> item)
                 throws SchemaException

Adds an item to a property container. Existing value will be replaced.

Specified by:

addReplaceExisting in interface PrismContainerValue<C extends Containerable>

Parameters:

item - item to add.

Throws:

SchemaException

remove

public <IV extends PrismValue,
ID extends ItemDefinition<?>>
void remove(@NotNull
 @NotNull Item<IV,ID> item)

Specified by:

remove in interface PrismContainerValue<C extends Containerable>

removeAll

public void removeAll()

Specified by:

removeAll in interface PrismContainerValue<C extends Containerable>

addAll

public void addAll(Collection<? extends Item<?,?>> itemsToAdd)
            throws SchemaException

Adds a collection of items to a property container.

Specified by:

addAll in interface PrismContainerValue<C extends Containerable>

Parameters:

itemsToAdd - items to add

Throws:

IllegalArgumentException - an attempt to add value that already exists

SchemaException

addAllReplaceExisting

public void addAllReplaceExisting(Collection<? extends Item<?,?>> itemsToAdd)
                           throws SchemaException

Adds a collection of items to a property container. Existing values will be replaced.

Specified by:

addAllReplaceExisting in interface PrismContainerValue<C extends Containerable>

Parameters:

itemsToAdd - items to add

Throws:

SchemaException

replace

public <IV extends PrismValue,
ID extends ItemDefinition<?>>
void replace(Item<IV,ID> oldItem,
 Item<IV,ID> newItem)
      throws SchemaException

Specified by:

replace in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

clear

public void clear()

Specified by:

clear in interface PrismContainerValue<C extends Containerable>

contains

public boolean contains(Item item)

Specified by:

contains in interface PrismContainerValue<C extends Containerable>

contains

public boolean contains(ItemName itemName)

Specified by:

contains in interface PrismContainerValue<C extends Containerable>

containsRealValue

public static <C extends Containerable> boolean containsRealValue(Collection<PrismContainerValue<C>> cvalCollection,
 PrismContainerValue<C> cval)

find

public Object find(ItemPath path)

Specified by:

find in interface PrismValue

findPartial

public <IV extends PrismValue,
ID extends ItemDefinition<?>>
PartiallyResolvedItem<IV,ID> findPartial(ItemPath path)

Specified by:

findPartial in interface PrismContainerValue<C extends Containerable>

findProperty

public <X> PrismProperty<X> findProperty(ItemPath propertyPath)

Specified by:

findProperty in interface PrismContainerValue<C extends Containerable>

findProperty

public <X> PrismProperty<X> findProperty(PrismPropertyDefinition<X> propertyDefinition)

Finds a specific property in the container by definition.

Returns null if nothing is found.

Specified by:

findProperty in interface PrismContainerValue<C extends Containerable>

Parameters:

propertyDefinition - property definition to find.

Returns:

found property or null

findContainer

public <X extends Containerable> PrismContainer<X> findContainer(QName containerName)

Specified by:

findContainer in interface PrismContainerValue<C extends Containerable>

findReference

public PrismReference findReference(QName elementName)

Specified by:

findReference in interface PrismContainerValue<C extends Containerable>

findItem

public <IV extends PrismValue,
ID extends ItemDefinition<?>,
I extends Item<IV,
ID>>
I findItem(ItemPath itemPath,
 Class<I> type)

Specified by:

findItem in interface PrismContainerValue<C extends Containerable>

findItem

public <IV extends PrismValue,
ID extends ItemDefinition<?>,
I extends Item<IV,
ID>>
I findItem(ItemDefinition itemDefinition,
 Class<I> type)

Specified by:

findItem in interface PrismContainerValue<C extends Containerable>

containsItem

public boolean containsItem(ItemPath path,
 boolean acceptEmptyItem)
                     throws SchemaException

Specified by:

containsItem in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

createDetachedSubItem

public <IV extends PrismValue,
ID extends ItemDefinition<?>,
I extends Item<IV,
ID>>
I createDetachedSubItem(QName name,
 Class<I> type,
 ID itemDefinition,
 boolean immutable)
                 throws SchemaException,
PrismContainerValue.RemovedItemDefinitionException

Specified by:

createDetachedSubItem in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

PrismContainerValue.RemovedItemDefinitionException

findOrCreateContainer

public <T extends Containerable> PrismContainer<T> findOrCreateContainer(QName containerName)
                                                                  throws SchemaException

Specified by:

findOrCreateContainer in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

findOrCreateReference

public PrismReference findOrCreateReference(QName referenceName)
                                     throws SchemaException

Specified by:

findOrCreateReference in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

findOrCreateItem

public <IV extends PrismValue,
ID extends ItemDefinition<?>>
Item<IV,ID> findOrCreateItem(QName containerName)
                      throws SchemaException

Specified by:

findOrCreateItem in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

findOrCreateItem

public <IV extends PrismValue,
ID extends ItemDefinition<?>,
I extends Item<IV,
ID>>
I findOrCreateItem(QName containerName,
 Class<I> type)
            throws SchemaException

Specified by:

findOrCreateItem in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

findOrCreateItem

public <IV extends PrismValue,
ID extends ItemDefinition<?>,
I extends Item<IV,
ID>>
I findOrCreateItem(ItemPath path,
 Class<I> type,
 ID definition)
            throws SchemaException

Specified by:

findOrCreateItem in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

findOrCreateProperty

public <X> PrismProperty<X> findOrCreateProperty(ItemPath propertyPath)
                                          throws SchemaException

Specified by:

findOrCreateProperty in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

findOrCreateProperty

public <X> PrismProperty<X> findOrCreateProperty(PrismPropertyDefinition propertyDef)
                                          throws SchemaException

Specified by:

findOrCreateProperty in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

createProperty

public <X> PrismProperty<X> createProperty(QName propertyName)
                                    throws SchemaException

Specified by:

createProperty in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

createProperty

public <X> PrismProperty<X> createProperty(PrismPropertyDefinition<X> propertyDefinition)
                                    throws SchemaException

Specified by:

createProperty in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

removeProperty

public void removeProperty(ItemPath path)

Specified by:

removeProperty in interface PrismContainerValue<C extends Containerable>

removeContainer

public void removeContainer(ItemPath path)

Specified by:

removeContainer in interface PrismContainerValue<C extends Containerable>

removeReference

public void removeReference(ItemPath path)

Specified by:

removeReference in interface PrismContainerValue<C extends Containerable>

setPropertyRealValue

public <T> void setPropertyRealValue(QName propertyName,
 T realValue)
                              throws SchemaException

Specified by:

setPropertyRealValue in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

getPropertyRealValue

public <T> T getPropertyRealValue(QName propertyName,
 Class<T> type)

Specified by:

getPropertyRealValue in interface PrismContainerValue<C extends Containerable>

recompute

public void recompute(PrismContext prismContext)

Specified by:

recompute in interface PrismContainerValue<C extends Containerable>

Specified by:

recompute in interface PrismValue

Specified by:

recompute in class PrismValueImpl

accept

public void accept(Visitor visitor)

Specified by:

accept in interface PrismContainerValue<C extends Containerable>

Specified by:

accept in interface PrismValue

Specified by:

accept in interface Visitable<C extends Containerable>

Overrides:

accept in class PrismValueImpl

accept

public void accept(Visitor visitor,
 ItemPath path,
 boolean recursive)

Specified by:

accept in interface PathVisitable

Specified by:

accept in interface PrismContainerValue<C extends Containerable>

Specified by:

accept in interface PrismValue

Overrides:

accept in class PrismValueImpl

acceptParentVisitor

public void acceptParentVisitor(Visitor visitor)

Specified by:

acceptParentVisitor in interface ParentVisitable

Specified by:

acceptParentVisitor in interface PrismContainerValue<C extends Containerable>

hasCompleteDefinition

public boolean hasCompleteDefinition()

Description copied from interface: PrismContainerValue

Returns true if all contained items have complete definitions. (Currently does not check the definition of this value itself.)

Specified by:

hasCompleteDefinition in interface PrismContainerValue<C extends Containerable>

representsSameValue

public boolean representsSameValue(PrismValue other,
 EquivalenceStrategy strategy,
 boolean lax)

Description copied from interface: PrismValue

Returns true if this and other value represent the same value. E.g. if they have the same IDs, OIDs or it is otherwise know that they "belong together" without a deep examination of the values.

Specified by:

representsSameValue in interface PrismValue

Overrides:

representsSameValue in class PrismValueImpl

lax - If we can reasonably assume that the two values belong together even if they don't have the same ID, e.g. if they both belong to single-valued parent items. This is useful e.g. when comparing multi-valued containers. But can cause problems when we want to be sure we are removing the correct value.

diffMatchingRepresentation

public boolean diffMatchingRepresentation(PrismValue otherValue,
 Collection<? extends ItemDelta> deltas,
 ParameterizedEquivalenceStrategy strategy,
 boolean exitOnDiff)

Overrides:

diffMatchingRepresentation in class PrismValueImpl

isRaw

public boolean isRaw()

Specified by:

isRaw in interface PrismValue

addRawElement

public boolean addRawElement(Object element)
                      throws SchemaException

Specified by:

addRawElement in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

deleteRawElement

public boolean deleteRawElement(Object element)
                         throws SchemaException

Specified by:

deleteRawElement in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

removeRawElement

public boolean removeRawElement(Object element)

Specified by:

removeRawElement in interface PrismContainerValue<C extends Containerable>

getDefinition

public PrismContainerDefinition<C> getDefinition()

Specified by:

getDefinition in interface PrismContainerValue<C extends Containerable>

Overrides:

getDefinition in class PrismValueImpl

applyDefinition

public PrismContainerValue<C> applyDefinition(@NotNull
 @NotNull ItemDefinition<?> definition)
                                       throws SchemaException

Description copied from interface: PrismValue

Definition application MAY change the value (currently only for container values). The caller must deal with that. To be seen if this is a good idea. But probably so, because there are various situations when the definition application changes the nature of a prism value (midPoint shadow associations are currently the only places) but of prism items (midPoint attributes and associations need this; and it must be worked around for now).

Specified by:

applyDefinition in interface PrismContainerValue<C extends Containerable>

Specified by:

applyDefinition in interface PrismValue

Throws:

SchemaException

applyDefinition

public PrismContainerValue<C> applyDefinition(@NotNull
 @NotNull ItemDefinition<?> definition,
 boolean force)
                                       throws SchemaException

Description copied from interface: PrismValue

Definition application MAY change the value (currently only for container values). The caller must deal with that.

Specified by:

applyDefinition in interface PrismContainerValue<C extends Containerable>

Specified by:

applyDefinition in interface PrismValue

Throws:

SchemaException

applyDefinition

public PrismContainerValue<C> applyDefinition(@NotNull
 @NotNull PrismContainerDefinition<C> containerDef,
 boolean force)
                                       throws SchemaException

Specified by:

applyDefinition in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

revive

public void revive(PrismContext prismContext)

Description copied from interface: Revivable

TODO: Is revive necessary if prism context is static? TODO document (if it's found to be necessary)

Specified by:

revive in interface Revivable

Overrides:

revive in class PrismValueImpl

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface PrismValue

hasNoItems

public boolean hasNoItems()

Description copied from interface: PrismContainerValue

Like isEmpty but ignores presence of container value ID.

Specified by:

hasNoItems in interface PrismContainerValue<C extends Containerable>

isIdOnly

public boolean isIdOnly()

Specified by:

isIdOnly in interface PrismContainerValue<C extends Containerable>

normalize

public void normalize()

Description copied from interface: PrismValue

Currently doing nothing.

Specified by:

normalize in interface PrismValue

Overrides:

normalize in class PrismValueImpl

checkConsistenceInternal

public void checkConsistenceInternal(Itemable rootItem,
 boolean requireDefinitions,
 boolean prohibitRaw,
 ConsistencyCheckScope scope)

Specified by:

checkConsistenceInternal in interface PrismValue

Specified by:

checkConsistenceInternal in class PrismValueImpl

assertDefinitions

public void assertDefinitions(Supplier<String> sourceDescriptionSupplier)
                       throws SchemaException

Specified by:

assertDefinitions in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

assertDefinitions

public void assertDefinitions(boolean tolerateRaw,
 Supplier<String> sourceDescriptionSupplier)
                       throws SchemaException

Specified by:

assertDefinitions in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

clone

public PrismContainerValue<C> clone()

Description copied from class: PrismValueImpl

Literal clone.

Specified by:

clone in interface PrismContainerValue<C extends Containerable>

Specified by:

clone in interface PrismValue

Specified by:

clone in class PrismValueImpl

createImmutableClone

public PrismContainerValue<C> createImmutableClone()

Specified by:

createImmutableClone in interface PrismContainerValue<C extends Containerable>

Specified by:

createImmutableClone in interface PrismValue

Overrides:

createImmutableClone in class PrismValueImpl

cloneComplex

public PrismContainerValueImpl<C> cloneComplex(CloneStrategy strategy)

Description copied from class: PrismValueImpl

Complex clone with different cloning strategies.

Specified by:

cloneComplex in interface PrismContainerValue<C extends Containerable>

Specified by:

cloneComplex in interface PrismValue

Specified by:

cloneComplex in class PrismValueImpl

See Also:

• CloneStrategy

copyValues

protected void copyValues(CloneStrategy strategy,
 PrismContainerValueImpl<C> clone)

equals

public boolean equals(PrismValue other,
 @NotNull
 @NotNull ParameterizedEquivalenceStrategy strategy)

Specified by:

equals in interface PrismValue

Overrides:

equals in class PrismValueImpl

equivalent

public boolean equivalent(PrismContainerValue<?> other)

Specified by:

equivalent in interface PrismContainerValue<C extends Containerable>

hashCode

public int hashCode(@NotNull
 @NotNull ParameterizedEquivalenceStrategy strategy)

Specified by:

hashCode in interface PrismValue

Overrides:

hashCode in class PrismValueImpl

toString

public String toString()

Overrides:

toString in class Object

debugDump

public String debugDump(int indent)

Specified by:

debugDump in interface DebugDumpable

appendExtraHeaderDump

protected boolean appendExtraHeaderDump(StringBuilder sb,
 int indent,
 boolean wasIndent)

debugDumpIdentifiers

protected void debugDumpIdentifiers(StringBuilder sb)

detailedDebugDumpStart

protected void detailedDebugDumpStart(StringBuilder sb)

toHumanReadableString

public String toHumanReadableString()

Specified by:

toHumanReadableString in interface PrismValue

Specified by:

toHumanReadableString in class PrismValueImpl

getTypeName

public QName getTypeName()

Specified by:

getTypeName in interface PrismValue

Overrides:

getTypeName in class PrismValueImpl

getComplexTypeDefinition

@Nullable
public @Nullable ComplexTypeDefinition getComplexTypeDefinition()

Specified by:

getComplexTypeDefinition in interface PrismContainerValue<C extends Containerable>

toPcvList

public static <T extends Containerable>
List<PrismContainerValue<T>> toPcvList(List<T> beans)

performFreeze

public void performFreeze()

Overrides:

performFreeze in class PrismValueImpl

getRealClass

public Class<?> getRealClass()

Specified by:

getRealClass in interface PrismValue

Specified by:

getRealClass in class PrismValueImpl

getRealValue

@NotNull
public <T> T getRealValue()

Description copied from interface: PrismValue

Returns the statically-typed "real value". TODO specify when exactly the returned value can be null. TODO decide for containers: they throw an exception if the value is not statically typed.

Specified by:

getRealValue in interface PrismValue

Specified by:

getRealValue in class PrismValueImpl

asSingleValuedContainer

public PrismContainer<C> asSingleValuedContainer(@NotNull
 @NotNull QName itemName)
                                          throws SchemaException

Returns a single-valued container (with a single-valued definition) holding just this value. *TODO* Consider moving this into some "util" class; it is not really in the spirit of prism.

Specified by:

asSingleValuedContainer in interface PrismContainerValue<C extends Containerable>

Parameters:

itemName - Item name for newly-created container.

Throws:

SchemaException

mergeContent

@Experimental
public void mergeContent(@NotNull
 @NotNull PrismContainerValue<?> other,
 @NotNull
 @NotNull List<QName> overwrite)
                  throws SchemaException

Specified by:

mergeContent in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

getRootValue

@NotNull
public @NotNull PrismContainerValue<?> getRootValue()

Specified by:

getRootValue in interface PrismContainerValue<C extends Containerable>

Specified by:

getRootValue in interface PrismValue

Overrides:

getRootValue in class PrismValueImpl

asPrismContainerValues

public static <C extends Containerable>
List<PrismContainerValue<C>> asPrismContainerValues(List<C> containerables)

asContainerables

public static <C extends Containerable> List<C> asContainerables(List<PrismContainerValue<C>> pcvs)

asContainerables

public static <C extends Containerable>
Collection<C> asContainerables(Collection<PrismContainerValue<C>> pcvs)

setOriginTypeRecursive

public void setOriginTypeRecursive(OriginType originType)

Set origin type to all values and subvalues

Specified by:

setOriginTypeRecursive in interface PrismContainerValue<C extends Containerable>

keepPaths

public void keepPaths(List<? extends ItemPath> keep)
               throws SchemaException

Specified by:

keepPaths in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

removePaths

public void removePaths(List<? extends ItemPath> remove)
                 throws SchemaException

Specified by:

removePaths in interface PrismContainerValue<C extends Containerable>

Throws:

SchemaException

getAllValues

@NotNull
public @NotNull Collection<PrismValue> getAllValues(ItemPath path)

Description copied from interface: PrismValue

See Item.getAllValues(ItemPath).

Specified by:

getAllValues in interface PrismValue

Overrides:

getAllValues in class PrismValueImpl

getAllItems

@NotNull
public @NotNull Collection<Item<?,?>> getAllItems(@NotNull
 @NotNull ItemPath path)

Description copied from interface: PrismValue

See Item.getAllItems(ItemPath). Here the path is never empty.

Specified by:

getAllItems in interface PrismValue

Overrides:

getAllItems in class PrismValueImpl

getIdentifier

public Object getIdentifier()

Returns the value of identifier corresponding to the '#' path: container id or object oid.

removeItems

public void removeItems(List<? extends ItemPath> itemsToRemove)

Specified by:

removeItems in interface PrismContainerValue<C extends Containerable>

removeOperationalItems

public void removeOperationalItems()

Specified by:

removeOperationalItems in interface PrismContainerValue<C extends Containerable>

transformDefinition

public void transformDefinition(ComplexTypeDefinition parentDef,
 ItemDefinition<?> itemDef,
 ItemDefinitionTransformer transformation)

Specified by:

transformDefinition in interface ItemDefinitionTransformer.TransformableValue