Package com.evolveum.midpoint.schema.processor

Class ResourceAttributeContainerImpl

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.ResourceAttributeContainerImpl

All Implemented Interfaces:

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

public final class ResourceAttributeContainerImpl
extends com.evolveum.midpoint.prism.impl.PrismContainerImpl<ShadowAttributesType>
implements ResourceAttributeContainer

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

Method Summary

Modifier and Type	Method	Description
void	add(ResourceAttribute<?> attribute)
void	applyDefinition(PrismContainerDefinition<ShadowAttributesType> definition, boolean force)
void	checkConsistenceInternal(Itemable rootItem, boolean requireDefinitions, boolean prohibitRaw, ConsistencyCheckScope scope)
ResourceAttributeContainer	clone()	Literal clone.
ResourceAttributeContainerImpl	cloneComplex(CloneStrategy strategy)	Complex clone with different cloning strategies.
<T> boolean	contains(ResourceAttribute<T> attr)
protected void	copyValues(CloneStrategy strategy, ResourceAttributeContainerImpl clone)
@NotNull Collection<ResourceAttribute<?>>	extractAttributesByDefinitions(Collection<? extends ResourceAttributeDefinition> definitions)
<X> ResourceAttribute<X>	findAttribute(ResourceAttributeDefinition attributeDefinition)	Finds a specific attribute in the resource object by definition.
<X> ResourceAttribute<X>	findAttribute(QName attributeQName)	Finds a specific attribute in the resource object by name.
<X> ResourceAttribute<X>	findOrCreateAttribute(ResourceAttributeDefinition attributeDefinition)
<X> ResourceAttribute<X>	findOrCreateAttribute(QName attributeName)
Collection<ResourceAttribute<?>>	getAllIdentifiers()
@NotNull Collection<ResourceAttribute<?>>	getAttributes()	TODO review docs Returns set of resource object attributes.
protected String	getDebugDumpClassName()
ResourceAttributeContainerDefinition	getDefinition()	Returns applicable definition.
ResourceAttribute<String>	getDescriptionAttribute()	TODO review docs Returns description attribute of a resource object.
ResourceAttribute	getDisplayNameAttribute()	TODO review docs Returns display name attribute of a resource object.
ResourceAttribute<String>	getNamingAttribute()	TODO review docs Specifies which resource attribute should be used as a "technical" name for the account.
String	getNativeObjectClass()	TODO review docs Returns the native object class string for the resource object.
PrismProperty<?>	getPrimaryIdentifier()	Returns a (single) primary identifier.
Collection<ResourceAttribute<?>>	getPrimaryIdentifiers()	TODO review docs Returns primary identifiers.
<T> PrismProperty<T>	getSecondaryIdentifier()	TODO review docs Returns a (single) secondary identifier.
Collection<ResourceAttribute<?>>	getSecondaryIdentifiers()	TODO review docs Returns secondary identifiers.
boolean	isDefaultInAKind()	TODO review docs TODO consider removal Indicates whether definition is should be used as default account type.

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

accept, add, addInternal, addInternalExecution, applyDefinition, assertDefinitions, canRepresent, canRepresent, checkDefinition, containsItem, copyValues, createDelta, createDelta, createImmutableClone, createNewValue, 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, setPropertyRealValue, setPropertyRealValues, setRealValue, setValue, toString, trim, trimDefinitionTree

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

accept, acceptParentVisitor, add, addAll, addForced, addIgnoringEquivalents, addRespectingMetadataAndCloning, appendDebugDumpSuffix, assertDefinitions, assertDefinitions, checkConsistence, checkConsistence, checkConsistence, checkConsistence, checkConsistence, clear, copyValues, diff, equals, equals, equals, fixupDelta, getElementName, getHighestId, getParent, getPath, getPathComponent, getPrismContext, getPrismContextLocal, getRealValue, getRealValuesArray, getUserData, getUserData, getValues, hashCode, hashCode, hashCode, isIncomplete, merge, normalize, performFreeze, recomputeAllValues, remove, remove, removeAll, removeRespectingMetadata, replace, replaceAll, revive, setElementName, setIncomplete, setParent, setPrismContext, 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, add, add, addAll, addAll, addIgnoringEquivalents, addRespectingMetadataAndCloning, 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, getParent, getPath, getPrismContextLocal, getRealValue, getRealValuesArray, getRealValuesOrRawTypes, getUserData, getUserData, getValues, hasAnyValue, hasCompleteDefinition, hashCode, hashCode, hashCode, hasNoValues, hasRaw, isEmpty, isIncomplete, isOperational, isRaw, isSingleValue, isSingleValueByDefinition, merge, normalize, recomputeAllValues, remove, remove, removeAll, removeIf, removeRespectingMetadata, replace, replaceAll, setElementName, setIncomplete, setParent, setPrismContext, setUserData, size, valuesStream

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

accept, add, applyDefinition, 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, mergeValue, mergeValues, mergeValues, remove, removeContainer, removeItem, removeProperty, removeReference, setContainerRealValue, setDefinition, setPropertyRealValue, setPropertyRealValues, setRealValue, setValue, trim, trimDefinitionTree

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

getComplexTypeDefinition

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

getPrismContext

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

revive

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

accept

Method Detail

getDefinition

public ResourceAttributeContainerDefinition getDefinition()

Description copied from interface: Item

Returns applicable definition.

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

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 ResourceAttributeContainer

Overrides:

getDefinition in class com.evolveum.midpoint.prism.impl.PrismContainerImpl<ShadowAttributesType>

Returns:

applicable definition

getAttributes

@NotNull
public @NotNull Collection<ResourceAttribute<?>> getAttributes()

Description copied from interface: ResourceAttributeContainer

TODO review docs Returns set of resource object attributes. The order of attributes is insignificant. The returned set is imutable! Any change to it will be ignored.

Specified by:

getAttributes in interface ResourceAttributeContainer

Returns:

set of resource object attributes.

add

public void add(ResourceAttribute<?> attribute)
         throws SchemaException

Specified by:

add in interface ResourceAttributeContainer

Throws:

SchemaException

getPrimaryIdentifier

public PrismProperty<?> getPrimaryIdentifier()

Description copied from interface: ResourceAttributeContainer

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 ResourceAttributeContainer

Returns:

identifier property

getPrimaryIdentifiers

public Collection<ResourceAttribute<?>> getPrimaryIdentifiers()

Description copied from interface: ResourceAttributeContainer

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 ResourceAttributeContainer

Returns:

set of identifier properties

getSecondaryIdentifier

public <T> PrismProperty<T> getSecondaryIdentifier()

Description copied from interface: ResourceAttributeContainer

TODO review docs Returns a (single) secondary identifier. This method returns a property that acts as an secondary identifier for the resource object. Secondary identifiers are used to confirm primary identification of resource object. Returns null if no secondary 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:

getSecondaryIdentifier in interface ResourceAttributeContainer

Returns:

secondary identifier property

getSecondaryIdentifiers

public Collection<ResourceAttribute<?>> getSecondaryIdentifiers()

Description copied from interface: ResourceAttributeContainer

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 ResourceAttributeContainer

Returns:

set of secondary identifier properties

getAllIdentifiers

public Collection<ResourceAttribute<?>> getAllIdentifiers()

Specified by:

getAllIdentifiers in interface ResourceAttributeContainer

extractAttributesByDefinitions

@NotNull
public @NotNull Collection<ResourceAttribute<?>> extractAttributesByDefinitions(Collection<? extends ResourceAttributeDefinition> definitions)

Specified by:

extractAttributesByDefinitions in interface ResourceAttributeContainer

getDescriptionAttribute

public ResourceAttribute<String> getDescriptionAttribute()

Description copied from interface: ResourceAttributeContainer

TODO review docs Returns description attribute of a resource object. Returns null if there is no description attribute or the attribute is not known. The exception should be never thrown unless there is some bug in the code. The validation of model consistency should be done at the time of schema parsing.

Specified by:

getDescriptionAttribute in interface ResourceAttributeContainer

Returns:

description attribute of a resource object.

getNamingAttribute

public ResourceAttribute<String> getNamingAttribute()

Description copied from interface: ResourceAttributeContainer

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 ResourceAttributeContainer

Returns:

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

getDisplayNameAttribute

public ResourceAttribute getDisplayNameAttribute()

Description copied from interface: ResourceAttributeContainer

TODO review docs Returns display name attribute of a resource object. Returns null if there is no display name attribute or the attribute is not known. The exception should be never thrown unless there is some bug in the code. The validation of model consistency should be done at the time of schema parsing.

Specified by:

getDisplayNameAttribute in interface ResourceAttributeContainer

Returns:

display name attribute of a resource object.

getNativeObjectClass

public String getNativeObjectClass()

Description copied from interface: ResourceAttributeContainer

TODO review docs Returns the native object class string for the resource object. Native object class is the name of the Resource Object Definition (Object Class) as it is seen by the resource itself. The name of the Resource Object Definition may be constrained by XSD or other syntax and therefore may be "mangled" to conform to such syntax. The native object class value will contain unmangled name (if available). Returns null if there is no native object class or the native object class is not known. The exception should be never thrown unless there is some bug in the code. The validation of model consistency should be done at the time of schema parsing.

Specified by:

getNativeObjectClass in interface ResourceAttributeContainer

Returns:

native object class

isDefaultInAKind

public boolean isDefaultInAKind()

Description copied from interface: ResourceAttributeContainer

TODO review docs TODO consider removal Indicates whether definition is should be used as default account type. If true value is returned then the definition should be used as a default account type definition. This is a way how a resource connector may suggest applicable object classes (resource object definitions) for accounts. If no information about account type is present, false should be returned. This method must return true only if isAccountType() returns true. The exception should be never thrown unless there is some bug in the code. The validation of at-most-one value should be done at the time of schema parsing. The exception may not even be thrown at all if the implementation is not able to determine duplicity.

Specified by:

isDefaultInAKind in interface ResourceAttributeContainer

Returns:

true if the definition should be used as account type.

findAttribute

public <X> ResourceAttribute<X> findAttribute(QName attributeQName)

Description copied from interface: ResourceAttributeContainer

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

Specified by:

findAttribute in interface ResourceAttributeContainer

Parameters:

attributeQName - attribute name to find.

Returns:

found attribute or null

findAttribute

public <X> ResourceAttribute<X> findAttribute(ResourceAttributeDefinition attributeDefinition)

Description copied from interface: ResourceAttributeContainer

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

Specified by:

findAttribute in interface ResourceAttributeContainer

Parameters:

attributeDefinition - attribute definition to find.

Returns:

found attribute or null

findOrCreateAttribute

public <X> ResourceAttribute<X> findOrCreateAttribute(ResourceAttributeDefinition attributeDefinition)
                                               throws SchemaException

Specified by:

findOrCreateAttribute in interface ResourceAttributeContainer

Throws:

SchemaException

findOrCreateAttribute

public <X> ResourceAttribute<X> findOrCreateAttribute(QName attributeName)
                                               throws SchemaException

Specified by:

findOrCreateAttribute in interface ResourceAttributeContainer

Throws:

SchemaException

contains

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

Specified by:

contains in interface ResourceAttributeContainer

clone

public ResourceAttributeContainer 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 ResourceAttributeContainer

Overrides:

clone in class com.evolveum.midpoint.prism.impl.PrismContainerImpl<ShadowAttributesType>

cloneComplex

public ResourceAttributeContainerImpl 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 com.evolveum.midpoint.prism.impl.PrismContainerImpl<ShadowAttributesType>

See Also:

CloneStrategy

copyValues

protected void copyValues(CloneStrategy strategy,
                          ResourceAttributeContainerImpl clone)

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 com.evolveum.midpoint.prism.impl.PrismContainerImpl<ShadowAttributesType>

applyDefinition

public void applyDefinition(PrismContainerDefinition<ShadowAttributesType> definition,
                            boolean force)
                     throws SchemaException

Specified by:

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

Overrides:

applyDefinition in class com.evolveum.midpoint.prism.impl.ItemImpl<PrismContainerValue<ShadowAttributesType>,PrismContainerDefinition<ShadowAttributesType>>

Throws:

SchemaException

getDebugDumpClassName

protected String getDebugDumpClassName()

Overrides:

getDebugDumpClassName in class com.evolveum.midpoint.prism.impl.PrismContainerImpl<ShadowAttributesType>