Package com.evolveum.midpoint.schema.processor

Interface ShadowAttributeDefinition<SA extends ShadowAttribute<?,?>,R>

Type Parameters:

SA - item that is created by the instantiation of this definition

R - real value stored in SA

All Superinterfaces:

Cloneable, DebugDumpable, Definition, Freezable, LayeredDefinition, PrismItemAccessDefinition, PrismItemBasicDefinition, PrismItemMiscDefinition, PrismLifecycleDefinition, PrismPresentationDefinition, ResourceObjectInboundDefinition.ItemInboundDefinition, Revivable, Serializable, ShadowItemLayeredDefinition, ShadowItemUcfDefinition, ShortDumpable, SmartVisitable<Definition>, Visitable<Definition>

All Known Subinterfaces:

ResourceAttributeDefinitionDelegator<T>, ResourceAttributeWrapper<T>, ShadowReferenceAttributeDefinition, ShadowSimpleAttributeDefinition<T>

All Known Implementing Classes:

ResourceAttributeWrapperImpl, ShadowAttributeDefinitionImpl, ShadowReferenceAttributeDefinitionImpl, ShadowSimpleAttributeDefinitionImpl

public interface ShadowAttributeDefinition<SA extends ShadowAttribute<?,?>,R>
extends PrismItemBasicDefinition, PrismItemAccessDefinition, PrismItemMiscDefinition, PrismPresentationDefinition, ShadowItemUcfDefinition, ShadowItemLayeredDefinition, LayeredDefinition, ResourceObjectInboundDefinition.ItemInboundDefinition, Definition

Information about a resource attribute. . It is based on a "native" part, available from the connector (or from simulated associations capability definition); see NativeShadowAttributeDefinition. . This part is then optionally refined by the configuration in resource `schemaHandling` section. For the time being, it does not extend ItemDefinition because of typing complications: ShadowAttribute cannot extend Item.

See Also:

• ShadowSimpleAttributeDefinition
• ShadowReferenceAttributeDefinition

Nested Class Summary

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

Definition.DefinitionBuilder, Definition.DefinitionMutator

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

PrismItemAccessDefinition.Data, PrismItemAccessDefinition.Delegable, PrismItemAccessDefinition.Info, PrismItemAccessDefinition.Mutable

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

PrismItemBasicDefinition.Data, PrismItemBasicDefinition.Delegable, PrismItemBasicDefinition.Mutable

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

PrismItemMiscDefinition.Data, PrismItemMiscDefinition.Delegable, PrismItemMiscDefinition.Mutable

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

PrismLifecycleDefinition.Data, PrismLifecycleDefinition.Delegable, PrismLifecycleDefinition.Mutable

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

PrismPresentationDefinition.Data, PrismPresentationDefinition.Delegable, PrismPresentationDefinition.Mutable

Nested classes/interfaces inherited from interface com.evolveum.midpoint.schema.processor.ShadowItemUcfDefinition

ShadowItemUcfDefinition.Data, ShadowItemUcfDefinition.Delegable, ShadowItemUcfDefinition.Mutable

Field Summary

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

INDENT_STRING

Method Summary

Modifier and Type	Method	Description
@NotNull ShadowAttributeDefinition<SA,R>	clone()
String	debugDump(int indent, LayerType layer)	Provides a debug dump respective to the given layer.
@NotNull ShadowAttributeDefinition<SA,R>	forLayer(@NotNull LayerType layer)	Creates a view of the current definition for a given layer.
@Nullable ItemChangeApplicationModeType	getChangeApplicationMode()	TODO
String	getDescription()	Gets the (configured) attribute description.
@NotNull AttributeFetchStrategyType	getFetchStrategy()	Returns configured fetch strategy.
String	getHumanReadableDescription()
@NotNull List<InboundMappingType>	getInboundMappingBeans()	Gets the inbound mappings (if any).
@NotNull List<String>	getIntolerantValuePatterns()	Gets patterns for values that are not "tolerated" on the resource.
@Nullable String	getLifecycleState()	TODO
Integer	getModificationPriority()	Determines the order in which this attribute should be modified (in very special cases).
@Nullable MappingType	getOutboundMappingBean()	Gets the outbound mapping, if defined.
Boolean	getReadReplaceMode()	Should be this attribute modified solely in "replace" mode?
@NotNull Collection<ResourceObjectInboundDefinition>	getRelevantInboundDefinitions()
ItemPath	getStandardPath()
@NotNull AttributeStorageStrategyType	getStorageStrategy()	Returns configured storage strategy.
@NotNull List<String>	getTolerantValuePatterns()	Gets patterns for values that are "tolerated" on the resource.
@NotNull Class<R>	getTypeClass()	Note that attributes must always have static Java type.
default boolean	hasInboundMapping()
default boolean	hasOutboundMapping()
boolean	hasRefinements()	Returns `true` if there are any refinements (like in `schemaHandling`).
SA	instantiate()
SA	instantiate(QName itemName)
Boolean	isCached()	If present, it overrides the inclusion/exclusion of this item in/from the shadow caching.
default boolean	isEffectivelyCached(@NotNull ResourceObjectDefinition objectDefinition)	Returns `true` if this attribute is effectively cached, given provided object type/class definition.
boolean	isExclusiveStrong()	Drives behavior of strong and normal mappings for this attribute.
default boolean	isIgnored(LayerType layer)	Is the attribute ignored (at specified layer)?
boolean	isIndexOnly()
default boolean	isReturnedByDefault()	Is this attribute returned by default? (I.e.
boolean	isSimulated()	If `true`, the item does not exist on the resource, but is simulated by midPoint.
boolean	isTolerant()	When set to true, allows to preserve attribute values that are set outside midPoint.
default boolean	isVisible(@NotNull ExecutionModeProvider executionModeProvider)
default boolean	isVisible(@NotNull TaskExecutionMode taskExecutionMode)	TODO
boolean	isVolatilityTrigger()	Is this attribute so-called volatility trigger, i.e.
void	setOverrideCanAdd(Boolean value)	Provides a value that will override ShadowItemLayeredDefinition.canAdd(LayerType) return values (for all layers).
void	setOverrideCanModify(Boolean value)	Provides a value that will override ShadowItemLayeredDefinition.canModify(LayerType) return values (for all layers).
void	setOverrideCanRead(Boolean value)	Provides a value that will override ShadowItemLayeredDefinition.canRead(LayerType) return values (for all layers).

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

debugDump, debugDump, debugDumpLazily, debugDumpLazily

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

checkMutableOnExposing, debugDump, getAnnotation, getAnnotations, getMergerIdentifier, getMergerInstance, getMutabilityFlag, getNaturalKeyConstituents, getNaturalKeyInstance, getSchemaContextDefinition, getTypeName, isAbstract, isElaborate, isOptionalCleanup, isRuntimeSchema, mutator

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

checkImmutable, checkMutable, freeze, isImmutable

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

getCurrentLayer

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

canAdd, canModify, canRead, getInfo

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

getItemName, getMaxOccurs, getMinOccurs, getTypeName, isMandatory, isMultiValue, isOptional, isSingleValue

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

getProcessing

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

getDeprecatedSince, getPlannedRemoval, getRemovedSince, getSchemaMigrations, isDeprecated, isExperimental, isRemoved

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

getDiagrams, getDisplayHint, getDisplayName, getDisplayOrder, getDocumentation, getDocumentationPreview, getHelp, isEmphasized

Methods inherited from interface com.evolveum.midpoint.schema.processor.ResourceObjectInboundDefinition.ItemInboundDefinition

getCorrelatorDefinition

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

revive

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

canAdd, canModify, canRead, getLimitations, getMaxOccurs, getMinOccurs, getProcessing, isMandatory, isMultiValue, isOptional, isSingleValue

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

getFrameworkAttributeName, getNativeAttributeName, getReturnedByDefault

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

shortDump, shortDump, shortDumpLazily

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

accept

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

accept

Method Details

isTolerant

boolean isTolerant()

When set to true, allows to preserve attribute values that are set outside midPoint.

See Also:

• ItemRefinedDefinitionType.isTolerant()

getFetchStrategy

@NotNull
@NotNull AttributeFetchStrategyType getFetchStrategy()

Returns configured fetch strategy.

See Also:

• ResourceItemDefinitionType.getFetchStrategy()

getStorageStrategy

@NotNull
@NotNull AttributeStorageStrategyType getStorageStrategy()

Returns configured storage strategy.

See Also:

• ResourceItemDefinitionType.getStorageStrategy()

isCached

Boolean isCached()

If present, it overrides the inclusion/exclusion of this item in/from the shadow caching. Please use the isEffectivelyCached(ResourceObjectDefinition) method to determine the effective caching status.

isEffectivelyCached

default boolean isEffectivelyCached(@NotNull
 @NotNull ResourceObjectDefinition objectDefinition)

Returns `true` if this attribute is effectively cached, given provided object type/class definition. Precondition: the definition must be attached to a resource. NOTE: Ignores the default caching turned on by read capability with `cachingOnly` = `true`.

isVolatilityTrigger

boolean isVolatilityTrigger()

Is this attribute so-called volatility trigger, i.e. may its changes cause changes in other attributes?

See Also:

• ResourceItemDefinitionType.isVolatilityTrigger()

getModificationPriority

Integer getModificationPriority()

Determines the order in which this attribute should be modified (in very special cases).

See Also:

• ResourceItemDefinitionType.getModificationPriority()

getReadReplaceMode

Boolean getReadReplaceMode()

Should be this attribute modified solely in "replace" mode?

See Also:

• ResourceItemDefinitionType.isReadReplaceMode()

forLayer

@NotNull
@NotNull ShadowAttributeDefinition<SA,R> forLayer(@NotNull
 @NotNull LayerType layer)

Creates a view of the current definition for a given layer. (May return even the original object e.g. if the layer matches the current one.)

setOverrideCanRead

void setOverrideCanRead(Boolean value)

Provides a value that will override ShadowItemLayeredDefinition.canRead(LayerType) return values (for all layers). Used e.g. when applying authorizations on the definition.

setOverrideCanAdd

void setOverrideCanAdd(Boolean value)

Provides a value that will override ShadowItemLayeredDefinition.canAdd(LayerType) return values (for all layers). Used e.g. when applying authorizations on the definition.

setOverrideCanModify

void setOverrideCanModify(Boolean value)

Provides a value that will override ShadowItemLayeredDefinition.canModify(LayerType) return values (for all layers). Used e.g. when applying authorizations on the definition.

getDescription

String getDescription()

Gets the (configured) attribute description.

See Also:

• ItemRefinedDefinitionType.getDescription()

getOutboundMappingBean

@Nullable
@Nullable MappingType getOutboundMappingBean()

Gets the outbound mapping, if defined.

See Also:

• ResourceItemDefinitionType.getOutbound()

hasOutboundMapping

default boolean hasOutboundMapping()

getInboundMappingBeans

@NotNull
@NotNull List<InboundMappingType> getInboundMappingBeans()

Gets the inbound mappings (if any).

Specified by:

getInboundMappingBeans in interface ResourceObjectInboundDefinition.ItemInboundDefinition

See Also:

• ResourceItemDefinitionType.getInbound()

hasInboundMapping

default boolean hasInboundMapping()

getRelevantInboundDefinitions

@NotNull
@NotNull Collection<ResourceObjectInboundDefinition> getRelevantInboundDefinitions()

isExclusiveStrong

boolean isExclusiveStrong()

Drives behavior of strong and normal mappings for this attribute.

See Also:

• ResourceItemDefinitionType.isExclusiveStrong()

getTolerantValuePatterns

@NotNull
@NotNull List<String> getTolerantValuePatterns()

Gets patterns for values that are "tolerated" on the resource.

See Also:

• isTolerant()
• ItemRefinedDefinitionType.getTolerantValuePattern()

getIntolerantValuePatterns

@NotNull
@NotNull List<String> getIntolerantValuePatterns()

Gets patterns for values that are not "tolerated" on the resource.

See Also:

• isTolerant()
• ItemRefinedDefinitionType.getIntolerantValuePattern()

getChangeApplicationMode

@Nullable
@Nullable ItemChangeApplicationModeType getChangeApplicationMode()

TODO

getLifecycleState

@Nullable
@Nullable String getLifecycleState()

TODO

isIgnored

default boolean isIgnored(LayerType layer)

Description copied from interface: ShadowItemLayeredDefinition

Is the attribute ignored (at specified layer)?

Specified by:

isIgnored in interface ShadowItemLayeredDefinition

isVisible

default boolean isVisible(@NotNull
 @NotNull TaskExecutionMode taskExecutionMode)

TODO

isVisible

default boolean isVisible(@NotNull
 @NotNull ExecutionModeProvider executionModeProvider)

getTypeClass

@NotNull
@NotNull Class<R> getTypeClass()

Note that attributes must always have static Java type.

Specified by:

getTypeClass in interface Definition

isReturnedByDefault

default boolean isReturnedByDefault()

Is this attribute returned by default? (I.e. if no specific options are sent to the connector?)

hasRefinements

boolean hasRefinements()

Returns `true` if there are any refinements (like in `schemaHandling`).

isIndexOnly

boolean isIndexOnly()

instantiate

@NotNull
SA instantiate()
        throws SchemaException

Throws:

SchemaException

instantiate

@NotNull
SA instantiate(QName itemName)
        throws SchemaException

Throws:

SchemaException

getHumanReadableDescription

String getHumanReadableDescription()

getStandardPath

ItemPath getStandardPath()

isSimulated

boolean isSimulated()

If `true`, the item does not exist on the resource, but is simulated by midPoint.

clone

@NotNull
@NotNull ShadowAttributeDefinition<SA,R> clone()

Specified by:

clone in interface Definition

debugDump

String debugDump(int indent,
 LayerType layer)

Provides a debug dump respective to the given layer. TODO reconsider this method