Package com.evolveum.midpoint.schema.processor

Class ShadowAttributesContainerImpl

java.lang.Object

com.evolveum.midpoint.prism.AbstractFreezable

com.evolveum.midpoint.prism.impl.ItemImpl<PrismContainerValue<C>,PrismContainerDefinition<C>>

com.evolveum.midpoint.prism.impl.PrismContainerImpl<ShadowAttributesType>

com.evolveum.midpoint.schema.processor.ShadowAttributesContainerImpl

All Implemented Interfaces:

Freezable, Item<PrismContainerValue<ShadowAttributesType>,PrismContainerDefinition<ShadowAttributesType>>, Itemable, ItemDefinitionTransformer.TransformableItem, ParentVisitable, PathVisitable, PrismContainer<ShadowAttributesType>, PrismContainerable<ShadowAttributesType>, PrismVisitable, Revivable, Visitable, ShadowAttributesContainer, ShadowItemsContainer, DebugDumpable, Serializable

public final class ShadowAttributesContainerImpl
extends PrismContainerImpl<ShadowAttributesType>
implements ShadowAttributesContainer

TODO review docs Resource Object. Resource Object understands resource-specific annotations, such as identifiers, native object class, etc. Object class can be determined by using the definition (inherited from PropertyContainer)

Author:

Radovan Semancik

See Also:

• Serialized Form

Field Summary

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

compileTimeClass

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

definition, elementName, incomplete, parent, values

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

INDENT_STRING

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

KEY_NAMESPACE_CONTEXT

Method Summary

Modifier and Type	Method	Description
void	add(ShadowAttribute<?,?,?,?> attribute)
void	checkConsistenceInternal(Itemable rootItem, boolean requireDefinitions, boolean prohibitRaw, ConsistencyCheckScope scope)
protected void	checkDefinition(@NotNull PrismContainerDefinition<ShadowAttributesType> def)	This is a separate method, as it is used at various places, e.g.
ShadowAttributesContainer	clone()	Literal clone.
ShadowAttributesContainerImpl	cloneComplex(CloneStrategy strategy)	Complex clone with different cloning strategies.
<T> boolean	contains(ShadowSimpleAttribute<T> attr)
ShadowReferenceAttribute	findOrCreateReferenceAttribute(QName attributeName)
<X> ShadowSimpleAttribute<X>	findOrCreateSimpleAttribute(ShadowSimpleAttributeDefinition attributeDefinition)
<X> ShadowSimpleAttribute<X>	findOrCreateSimpleAttribute(QName attributeName)
ShadowReferenceAttribute	findReferenceAttribute(QName attributeQName)
<X> ShadowSimpleAttribute<X>	findSimpleAttribute(ShadowSimpleAttributeDefinition attributeDefinition)	Finds a specific attribute in the resource object by definition.
<X> ShadowSimpleAttribute<X>	findSimpleAttribute(QName attributeQName)	Finds a specific attribute in the resource object by name.
@NotNull Collection<ShadowSimpleAttribute<?>>	getAllIdentifiers()
@NotNull Collection<ShadowAttribute<?,?,?,?>>	getAttributes()
protected String	getDebugDumpClassName()	Return a human readable name of this class suitable for logs.
ShadowAttributesContainerDefinition	getDefinition()	Returns applicable property container definition.
ShadowSimpleAttribute<String>	getNamingAttribute()	TODO review docs Specifies which resource attribute should be used as a "technical" name for the account.
ShadowSimpleAttribute<?>	getPrimaryIdentifier()	Returns a (single) primary identifier.
@NotNull Collection<ShadowSimpleAttribute<?>>	getPrimaryIdentifiers()	TODO review docs Returns primary identifiers.
@NotNull Collection<ShadowReferenceAttribute>	getReferenceAttributes()	Returns a detached, immutable list.
@NotNull Collection<ShadowSimpleAttribute<?>>	getSecondaryIdentifiers()	TODO review docs Returns secondary identifiers.
@NotNull Collection<ShadowSimpleAttribute<?>>	getSimpleAttributes()	TODO review docs Returns set of resource object attributes.
void	remove(ShadowAttribute<?,?,?,?> item)

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

accept, add, addInternal, addInternalExecution, applyDefinition, assertDefinitions, canRepresent, canRepresent, containsItem, copyValues, createDelta, createDelta, createImmutableClone, createNewValue, createNewValueInternal, createParentIfNeeded, debugDump, deepCloneDefinition, diff, diff, diffModifications, equivalent, find, findContainer, findContainer, findCreateItem, findCreateItem, findItem, findItem, findItem, findOrCreateContainer, findOrCreateItem, findOrCreateItem, findOrCreateProperty, findOrCreateReference, findPartial, findProperty, findReference, findValue, getAllItems, getAllValues, getCompileTimeClass, getPropertyRealValue, getRealValue, getRealValues, getValue, getValue, hasCompleteDefinition, isEmpty, mergeValue, mergeValues, mergeValues, propagateDeepCloneDefinition, remove, removeContainer, removeItem, removeProperty, removeReference, setContainerRealValue, setDefinition, setDefinitionHack, setPropertyRealValue, setPropertyRealValues, setRealValue, setValue, startStrictModifications, stopStrictModifications, toString, trim, trimDefinitionTree, useIdentifierIndex

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

accept, acceptParentVisitor, add, addAll, addForced, addIgnoringEquivalents, addRespectingMetadataAndCloning, addWithResult, appendDebugDumpSuffix, applyDefinitionToValues, assertDefinitions, assertDefinitions, checkConsistence, checkConsistence, checkConsistence, checkConsistence, checkConsistence, clear, copyValues, diff, equals, equals, equals, fixupDelta, getElementName, getHighestId, getParent, getPath, getPathComponent, getRealValue, getRealValuesArray, getUserData, getUserData, getValues, hashCode, hashCode, hashCode, isIncomplete, merge, normalize, performFreeze, recomputeAllValues, remove, remove, removeAll, removeRespectingMetadata, removeWithResult, replace, replaceAll, revive, setElementName, setIncomplete, setParent, setUserData, transformDefinition, valueRemoved

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, debugDump, debugDumpLazily, debugDumpLazily

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

checkImmutable, checkMutable, freeze, isImmutable

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

acceptParentVisitor, acceptVisitor, add, add, addAll, addAll, addIgnoringEquivalents, addRespectingMetadataAndCloning, applyDefinition, applyDefinition, applyDefinitionIfMissing, assertDefinitions, assertDefinitions, assertDefinitions, checkConsistence, checkConsistence, checkConsistence, checkConsistence, checkConsistence, clear, contains, contains, copy, diff, diff, equals, equals, equals, filterValues, filterYields, find, findValue, findValue, getAllItems, getAllValues, getAnyValue, getAnyValue, getClonedValues, getDisplayName, getElementName, getHelp, getHighestId, getNamespaceContext, getParent, getPath, getRealValue, getRealValues, getRealValuesArray, getRealValuesOrRawTypes, getUserData, getUserData, hasAnyValue, hasCompleteDefinition, hashCode, hashCode, hashCode, hasNoValues, hasRaw, isEmpty, isIncomplete, isOperational, isRaw, isSingleValue, isSingleValueByDefinition, merge, normalize, recomputeAllValues, remove, remove, removeAll, removeIf, removeRespectingMetadata, replace, replaceAll, setDefinition, setElementName, setIncomplete, setParent, setUserData, size, valuesStream

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

accept, add, canRepresent, canRepresent, containsItem, createDelta, createDelta, createImmutableClone, createNewValue, deepCloneDefinition, diff, diff, diffModifications, equivalent, findContainer, findCreateItem, findCreateItem, findItem, findItem, findItem, findOrCreateContainer, findOrCreateItem, findOrCreateItem, findOrCreateProperty, findOrCreateReference, findPartial, findProperty, findReference, findValue, getCompileTimeClass, getPropertyRealValue, getRealValue, getRealValues, getValue, getValue, getValues, mergeValue, mergeValues, mergeValues, remove, removeContainer, removeItem, removeProperty, removeReference, setContainerRealValue, setPropertyRealValue, setPropertyRealValues, setRealValue, setValue, trim, trimDefinitionTree

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

getComplexTypeDefinition

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

revive

Methods inherited from interface com.evolveum.midpoint.schema.processor.ShadowAttributesContainer

addAttribute, addReferenceAttribute, addReferenceAttribute, addSimpleAttribute, containsAttribute, getDefinitionRequired, getResourceObjectDefinitionRequired

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

accept

Method Details

getDefinition

public ShadowAttributesContainerDefinition getDefinition()

Description copied from class: PrismContainerImpl

Returns applicable property container definition.

May return null if no definition is applicable or the definition is not know.

Specified by:

getDefinition in interface Item<PrismContainerValue<ShadowAttributesType>,PrismContainerDefinition<ShadowAttributesType>>

Specified by:

getDefinition in interface Itemable

Specified by:

getDefinition in interface PrismContainer<ShadowAttributesType>

Specified by:

getDefinition in interface PrismContainerable<ShadowAttributesType>

Specified by:

getDefinition in interface ShadowAttributesContainer

Overrides:

getDefinition in class PrismContainerImpl<ShadowAttributesType>

Returns:

applicable property container definition

getAttributes

@NotNull
public @NotNull Collection<ShadowAttribute<?,?,?,?>> getAttributes()

Specified by:

getAttributes in interface ShadowAttributesContainer

getSimpleAttributes

@NotNull
public @NotNull Collection<ShadowSimpleAttribute<?>> getSimpleAttributes()

Description copied from interface: ShadowAttributesContainer

TODO review docs Returns set of resource object attributes. The order of attributes is insignificant. The returned set is immutable.

Specified by:

getSimpleAttributes in interface ShadowAttributesContainer

Returns:

set of resource object attributes.

getReferenceAttributes

@NotNull
public @NotNull Collection<ShadowReferenceAttribute> getReferenceAttributes()

Description copied from interface: ShadowAttributesContainer

Returns a detached, immutable list.

Specified by:

getReferenceAttributes in interface ShadowAttributesContainer

add

public void add(ShadowAttribute<?,?,?,?> attribute)
         throws SchemaException

Specified by:

add in interface ShadowAttributesContainer

Throws:

SchemaException

getPrimaryIdentifier

public ShadowSimpleAttribute<?> getPrimaryIdentifier()

Description copied from interface: ShadowAttributesContainer

Returns a (single) primary identifier. This method returns a property that acts as an (primary) identifier for the resource object. Primary identifiers are used to access the resource objects, retrieve them from resource, identify objects for modifications, etc. Returns null if no identifier is defined. Resource objects may have multiple (composite) identifiers, but this method assumes that there is only a single identifier. The method will throw exception if that assumption is not satisfied.

Specified by:

getPrimaryIdentifier in interface ShadowAttributesContainer

Returns:

identifier property

getPrimaryIdentifiers

@NotNull
public @NotNull Collection<ShadowSimpleAttribute<?>> getPrimaryIdentifiers()

Description copied from interface: ShadowAttributesContainer

TODO review docs Returns primary identifiers. This method returns properties that act as (primary) identifiers for the resource object. Primary identifiers are used to access the resource objects, retrieve them from resource, identify objects for modifications, etc. Returns empty set if no identifier is defined. Must not return null. Resource objects may have multiple (composite) identifiers, all of them are returned. The returned set it immutable! Any modifications will be lost.

Specified by:

getPrimaryIdentifiers in interface ShadowAttributesContainer

Returns:

set of identifier properties

getSecondaryIdentifiers

@NotNull
public @NotNull Collection<ShadowSimpleAttribute<?>> getSecondaryIdentifiers()

Description copied from interface: ShadowAttributesContainer

TODO review docs Returns secondary identifiers. This method returns properties that act as secondary identifiers for the resource object. Secondary identifiers are used to confirm primary identification of resource object. Returns empty set if no identifier is defined. Must not return null. Resource objects may have multiple (composite) identifiers, all of them are returned.

Specified by:

getSecondaryIdentifiers in interface ShadowAttributesContainer

Returns:

set of secondary identifier properties

getAllIdentifiers

@NotNull
public @NotNull Collection<ShadowSimpleAttribute<?>> getAllIdentifiers()

Specified by:

getAllIdentifiers in interface ShadowAttributesContainer

getNamingAttribute

public ShadowSimpleAttribute<String> getNamingAttribute()

Description copied from interface: ShadowAttributesContainer

TODO review docs Specifies which resource attribute should be used as a "technical" name for the account. This name will appear in log files and other troubleshooting tools. The name should be a form of unique identifier that can be used to locate the resource object for diagnostics. It should not contain white chars and special chars if that can be avoided and it should be reasonable short. It is different from a display name attribute. Display name is intended for a common user or non-technical administrator (such as role administrator). The naming attribute is intended for technical IDM administrators and developers.

Specified by:

getNamingAttribute in interface ShadowAttributesContainer

Returns:

attribute that should be used as a "technical" name for the account.

findSimpleAttribute

public <X> ShadowSimpleAttribute<X> findSimpleAttribute(QName attributeQName)

Description copied from interface: ShadowAttributesContainer

Finds a specific attribute in the resource object by name. Returns null if nothing is found.

Specified by:

findSimpleAttribute in interface ShadowAttributesContainer

Parameters:

attributeQName - attribute name to find.

Returns:

found attribute or null

findReferenceAttribute

public ShadowReferenceAttribute findReferenceAttribute(QName attributeQName)

Specified by:

findReferenceAttribute in interface ShadowAttributesContainer

findSimpleAttribute

public <X> ShadowSimpleAttribute<X> findSimpleAttribute(ShadowSimpleAttributeDefinition attributeDefinition)

Description copied from interface: ShadowAttributesContainer

Finds a specific attribute in the resource object by definition. Returns null if nothing is found.

Specified by:

findSimpleAttribute in interface ShadowAttributesContainer

Parameters:

attributeDefinition - attribute definition to find.

Returns:

found attribute or null

findOrCreateSimpleAttribute

public <X> ShadowSimpleAttribute<X> findOrCreateSimpleAttribute(ShadowSimpleAttributeDefinition attributeDefinition)
                                                         throws SchemaException

Specified by:

findOrCreateSimpleAttribute in interface ShadowAttributesContainer

Throws:

SchemaException

findOrCreateSimpleAttribute

public <X> ShadowSimpleAttribute<X> findOrCreateSimpleAttribute(QName attributeName)
                                                         throws SchemaException

Specified by:

findOrCreateSimpleAttribute in interface ShadowAttributesContainer

Throws:

SchemaException

findOrCreateReferenceAttribute

public ShadowReferenceAttribute findOrCreateReferenceAttribute(QName attributeName)
                                                        throws SchemaException

Specified by:

findOrCreateReferenceAttribute in interface ShadowAttributesContainer

Throws:

SchemaException

contains

public <T> boolean contains(ShadowSimpleAttribute<T> attr)

Specified by:

contains in interface ShadowAttributesContainer

clone

public ShadowAttributesContainer clone()

Description copied from interface: Item

Literal clone.

Specified by:

clone in interface Item<PrismContainerValue<ShadowAttributesType>,PrismContainerDefinition<ShadowAttributesType>>

Specified by:

clone in interface PrismContainer<ShadowAttributesType>

Specified by:

clone in interface ShadowAttributesContainer

Specified by:

clone in interface ShadowItemsContainer

Overrides:

clone in class PrismContainerImpl<ShadowAttributesType>

remove

public void remove(ShadowAttribute<?,?,?,?> item)

Specified by:

remove in interface ShadowAttributesContainer

cloneComplex

public ShadowAttributesContainerImpl cloneComplex(CloneStrategy strategy)

Description copied from interface: Item

Complex clone with different cloning strategies.

Specified by:

cloneComplex in interface Item<PrismContainerValue<ShadowAttributesType>,PrismContainerDefinition<ShadowAttributesType>>

Specified by:

cloneComplex in interface PrismContainer<ShadowAttributesType>

Overrides:

cloneComplex in class PrismContainerImpl<ShadowAttributesType>

See Also:

• CloneStrategy

checkConsistenceInternal

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

Specified by:

checkConsistenceInternal in interface Item<PrismContainerValue<ShadowAttributesType>,PrismContainerDefinition<ShadowAttributesType>>

Overrides:

checkConsistenceInternal in class PrismContainerImpl<ShadowAttributesType>

checkDefinition

protected void checkDefinition(@NotNull
 @NotNull PrismContainerDefinition<ShadowAttributesType> def)

Description copied from class: ItemImpl

This is a separate method, as it is used at various places, e.g. - in ItemImpl.applyDefinition(ItemDefinition, boolean) - in ItemImpl.setDefinition(ItemDefinition) - when checking the consistence

Overrides:

checkDefinition in class ItemImpl<PrismContainerValue<ShadowAttributesType>,PrismContainerDefinition<ShadowAttributesType>>

getDebugDumpClassName

protected String getDebugDumpClassName()

Description copied from class: PrismContainerImpl

Return a human readable name of this class suitable for logs.

Overrides:

getDebugDumpClassName in class PrismContainerImpl<ShadowAttributesType>