Package com.evolveum.midpoint.schema.processor

Class CompositeObjectDefinitionImpl

java.lang.Object

com.evolveum.midpoint.prism.AbstractFreezable

com.evolveum.midpoint.schema.processor.CompositeObjectDefinitionImpl

All Implemented Interfaces:

AbstractTypeDefinition, Definition, Freezable, LocalItemDefinitionStore, PrismLifecycleDefinition, PrismPresentationDefinition, Revivable, SchemaLookup.Aware, SmartVisitable<Definition>, TypeDefinition, Visitable<Definition>, AssociationDefinitionStore, AttributeDefinitionStore, CompositeObjectDefinition, FrameworkNameResolver, IdentifiersDefinitionStore, LayeredDefinition, ResourceObjectDefinition, ResourceObjectInboundProcessingDefinition, DebugDumpable, Serializable, Cloneable

public class CompositeObjectDefinitionImpl
extends AbstractFreezable
implements CompositeObjectDefinition

Represents ad-hoc combination of definitions of structural and auxiliary object classes. A specialty of this class is the caching of attribute definitions. It can be done but only if the object classes are immutable. (Which is currently the case for all parsed resource schemas, but sometimes it must be relaxed, namely when applying security constraints onto the definitions.) Not caching attribute definitions in the case of mutable definition is quite dangerous, as it can lead to silent loss of performance if the definitions are not frozen appropriately. See MID-9156.

Author:

semancik

See Also:

• Serialized Form

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

ResourceObjectInboundProcessingDefinition.AssociationBasedItemImplementation, ResourceObjectInboundProcessingDefinition.AssociationSynchronizationImplementation, ResourceObjectInboundProcessingDefinition.CompleteItemInboundDefinition, ResourceObjectInboundProcessingDefinition.FocusSpecification, ResourceObjectInboundProcessingDefinition.ItemInboundProcessingDefinition

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

TypeDefinition.TypeDefinitionLikeBuilder, TypeDefinition.TypeDefinitionMutator

Field Summary

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

INDENT_STRING

Method Summary

Modifier and Type	Method	Description
void	accept(Visitor<Definition> visitor)
boolean	accept(Visitor<Definition> visitor, SmartVisitation<Definition> visitation)
@NotNull CompositeObjectDefinitionImpl	clone()	Returns a mutable definition.
AbstractShadow	createBlankShadowWithTag(String tag)	As ResourceObjectDefinition.createBlankShadow() but having the correct resource OID, kind/intent (if applicable), and tag set.
@NotNull ObjectQuery	createShadowSearchQuery(String resourceOid)	Creates a query for obtaining shadows related to this object class or object type.
String	debugDump(int indent)
@NotNull CompositeObjectDefinitionImpl	deepClone(@NotNull DeepCloneOperation operation)	Returns a mutable definition.
boolean	equals(Object obj)
ShadowAssociationDefinition	findAssociationDefinition(QName name)
@Nullable ShadowAttributeDefinition<?,?,?,?>	findAttributeDefinition(QName name, boolean caseInsensitive)	Finds an attribute definition by looking at the property name.
<ID extends ItemDefinition<?>> ID	findItemDefinition(@NotNull ItemPath path, @NotNull Class<ID> clazz)	Returns a definition of given type corresponding to given path (rooted at this store).
<ID extends ItemDefinition<?>> ID	findLocalItemDefinition(@NotNull QName name, @NotNull Class<ID> clazz, boolean caseInsensitive)	Returns the local item definition corresponding to given item name (optionally case-insensitive) and definition class.
@NotNull ResourceObjectDefinition	forLayerImmutable(@NotNull LayerType layer)	As ResourceObjectDefinition.forLayerMutable(LayerType) but returns immutable definition.
@NotNull CompositeObjectDefinition	forLayerMutable(@NotNull LayerType layer)	Creates a layer-specific mutable version of this definition.
ResourceActivationDefinitionType	getActivationSchemaHandling()
<A> A	getAnnotation(QName qname)	Returns generic definition annotation.
@Nullable Map<QName,Object>	getAnnotations()	Returns all annotations, as unmodifiable map.
@NotNull List<? extends ShadowAssociationDefinition>	getAssociationDefinitions()
@NotNull List<? extends ShadowAttributeDefinition<?,?,?,?>>	getAttributeDefinitions()	Returns all attribute definitions as an unmodifiable collection.
@NotNull Collection<ShadowAttributeDefinition<?,?,?,?>>	getAttributesVolatileOnAddOperation()	See ShadowAttributeDefinition.isVolatileOnAddOperation().
@NotNull Collection<ShadowAttributeDefinition<?,?,?,?>>	getAttributesVolatileOnModifyOperation()	See ShadowAttributeDefinition.isVolatileOnModifyOperation().
@NotNull Collection<? extends ResourceObjectDefinition>	getAuxiliaryDefinitions()	Returns auxiliary definitions.
@NotNull List<MappingType>	getAuxiliaryObjectClassInboundMappings()	Returns inbound mappings for the auxiliary object class(es) property.
ResourceBidirectionalMappingAndDefinitionType	getAuxiliaryObjectClassMappings()
ResourceObjectReferenceType	getBaseContext()	The definition of base context (resource object container).
@NotNull BasicResourceInformation	getBasicResourceInformation()	The basic information about the resource (like name, OID, selected configuration beans).
CorrelationDefinitionType	getCorrelation()
@NotNull LayerType	getCurrentLayer()	Gets the current point-of-view: on which layer do we look at the data?
String	getDebugDumpClassName()	Return a human readable name of this class suitable for logs.
@Nullable DefaultInboundMappingEvaluationPhasesType	getDefaultInboundMappingEvaluationPhases()	Returns the phases in which inbound mappings are evaluated by default.
@NotNull ResourceObjectTypeDefinitionType	getDefinitionBean()	Returns the configuration bean for this object type or class.
@NotNull List<? extends ItemDefinition<?>>	getDefinitions()	Returns all item definitions in this store.
@NotNull ResourceObjectTypeDelineation	getDelineation()	Returns the delineation of the set of objects belonging to this object type.
String	getDeprecatedSince()
String	getDescription()	Free-form textual description of the object.
@Nullable QName	getDescriptionAttributeName()	Returns name of the description attribute.
List<ItemDiagramSpecification>	getDiagrams()
DisplayHint	getDisplayHint()	Enumeration annotation that specifies how/whether the item should be displayed.
String	getDisplayName()	Returns display name.
@Nullable QName	getDisplayNameAttributeName()	Returns name of the display name attribute.
Integer	getDisplayOrder()	Specifies an order in which the item should be displayed relative to other items at the same level.
String	getDocumentation()	Must contains tag because of html tags used in text.
String	getDocumentationPreview()	Returns only a first sentence of documentation.
@NotNull ShadowCachingPolicyType	getEffectiveShadowCachingPolicy()	Returns shadow caching policy determined by the application of resource-level definitions down to the specific object type/class definition (using bean merging).
<T extends CapabilityType> T	getEnabledCapability(@NotNull Class<T> capabilityClass, ResourceType resource)	Checks the presence of capability in: 1.
@NotNull ResourceObjectInboundProcessingDefinition.FocusSpecification	getFocusSpecification()
String	getHelp()	Returns help string.
String	getHumanReadableName()	TODO
@NotNull Collection<ResourceObjectInboundProcessingDefinition.CompleteItemInboundDefinition>	getItemInboundDefinitions()	Returns all inbound definitions for attributes and associations.
@Nullable ResourceLastLoginTimestampDefinitionType	getLastLoginTimestampDefinition()	See ResourceObjectTypeDefinitionType.getBehavior()
@Nullable String	getLifecycleState()	What lifecycle state is the (refined) object class or object type definition? Raw object class definition should always return `null` here.
@Nullable String	getMergerIdentifier()
@Nullable ItemMerger	getMergerInstance(@NotNull MergeStrategy strategy, @Nullable OriginMarker originMarker)
@Nullable QName	getNamingAttributeName()	Returns name of the naming attribute.
@NotNull NativeObjectClassDefinition	getNativeObjectClassDefinition()	Returns the [structural] native object class definition, typically obtained from the connector.
@Nullable List<QName>	getNaturalKeyConstituents()
@Nullable NaturalKeyDefinition	getNaturalKeyInstance()
@NotNull ResourceObjectClassDefinition	getObjectClassDefinition()	Returns the [structural] object class definition.
@NotNull QName	getObjectClassName()	Returns the name of the object class.
ResourceObjectMultiplicityType	getObjectMultiplicity()
@Nullable ResourcePasswordDefinitionType	getPasswordDefinition()	See ResourceObjectTypeDefinitionType.getCredentials()
String	getPlannedRemoval()	Version of data model in which the item is likely to be removed.
@NotNull Collection<? extends ShadowSimpleAttributeDefinition<?>>	getPrimaryIdentifiers()	Returns the definition of primary identifier attributes of a resource object.
@NotNull Collection<QName>	getPrimaryIdentifiersNames()	Returns names of primary identifiers.
PrismObjectDefinition<ShadowType>	getPrismObjectDefinition()	Returns a prism definition for the prism object/objects carrying the resource object/objects.
ProjectionPolicyType	getProjectionPolicy()
String	getRemovedSince()
@Nullable SchemaContextDefinition	getSchemaContextDefinition()
List<SchemaMigration>	getSchemaMigrations()
SearchHierarchyScope	getSearchHierarchyScope()	Definition of search hierarchy scope.
@NotNull Collection<? extends ShadowSimpleAttributeDefinition<?>>	getSecondaryIdentifiers()	Returns the definition of secondary identifier attributes of a resource object.
@NotNull Collection<QName>	getSecondaryIdentifiersNames()	Returns names of secondary identifiers.
ObjectReferenceType	getSecurityPolicyRef()
@NotNull ShadowMarkingRules	getShadowMarkingRules()	Returns compiled patterns denoting protected objects or other kinds of marks.
@NotNull String	getShortIdentification()	Very short identification, like the object class local name or the kind/intent pair.
@NotNull ResourceObjectDefinition	getStructuralDefinition()	Returns the structural definition that represents the "base" of this composite definition.
@NotNull Collection<? extends SynchronizationReactionDefinition>	getSynchronizationReactions()
Class<?>	getTypeClass()	Returns a compile-time class that is used to represent items.
@Nullable ResourceObjectTypeDefinition	getTypeDefinition()	Is this definition bound to a specific resource type? If yes, this method returns its definition.
@Nullable ResourceObjectTypeIdentification	getTypeIdentification()	Is this definition bound to a specific resource type? If yes, this method returns its identification.
@NotNull QName	getTypeName()	Returns a name of the type for this definition.
@NotNull ResourceObjectVolatilityType	getVolatility()	Specifies volatility of this type of resource objects, i.e.
boolean	hasAuxiliaryObjectClass(QName expectedObjectClassName)	TODO define semantics (it's different for CompositeObjectDefinition and the others!
int	hashCode()
boolean	isAbstract()	For types: is the type abstract so that it should not be instantiated directly? For items: TODO
boolean	isDefaultFor(@NotNull ShadowKindType kind)	Returns true if this definition can be considered as a default for the specified kind.
boolean	isDeprecated()
boolean	isElaborate()	Elaborate items are complicated data structure that may deviate from normal principles of the system.
boolean	isEmphasized()	True for definitions that are more important than others and that should be emphasized during presentation.
boolean	isExperimental()	Experimental functionality is not stable and it may be changed in any future release without any warning.
boolean	isOptionalCleanup()	Marks item that could be ignored by SCM tools (e.g.
boolean	isPrimaryIdentifier(QName attrName)	Returns true if the attribute with a given name is among primary identifiers.
boolean	isRemoved()
boolean	isRuntimeSchema()	This means that this particular definition (of an item or of a type) is part of the runtime schema, e.g.
boolean	isSecondaryIdentifier(QName attrName)	Returns true if the attribute with a given name is among secondary identifiers.
ResourceObjectClassDefinition.ResourceObjectClassDefinitionMutator	mutator()	Returns an interface to mutate this definition.
void	performFreeze()
void	replaceAttributeDefinition(@NotNull QName itemName, @Nullable ItemDefinition<?> newDefinition)	Replaces a definition for given item name with a provided one.
@Nullable ItemName	resolveFrameworkName(@NotNull String frameworkName)	Resolves framework-specific name (like `__NAME__`) to midPoint name (like `ri:dn`), if available.
void	revive(PrismContext prismContext)	TODO: Is revive necessary if prism context is static? TODO document (if it's found to be necessary)
String	toString()
void	trimAttributesTo(@NotNull Collection<ItemPath> paths)
void	validate()	Executes some basic checks on this object type.

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.schema.processor.AssociationDefinitionStore

findAssociationDefinitionRequired, findAssociationDefinitionRequired, getNamesOfAssociations

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

containsAttributeDefinition, findAttributeDefinition, findAttributeDefinitionRequired, findAttributeDefinitionRequired, findAttributeDefinitionStrictlyRequired, findAttributeDefinitionStrictlyRequired, findReferenceAttributeDefinitionRequired, findReferenceAttributeDefinitionRequired, findShadowAttributeDefinitionRequired, findSimpleAttributeDefinition, findSimpleAttributeDefinition, findSimpleAttributeDefinition, findSimpleAttributeDefinitionRequired, findSimpleAttributeDefinitionRequired, findSimpleAttributeDefinitionRequired, findSimpleAttributeDefinitionStrictlyRequired, findSimpleAttributeDefinitionStrictlyRequired, getAllSimpleAttributesNames, getAttributeDefinitions, getAttributeNames, getReferenceAttributesNames, getSimpleAttributeDefinitions, hasIndexOnlyAttributes, instantiateAttribute

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

getConfiguredAuxiliaryObjectClassNames

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

debugDump, debugDumpLazily, debugDumpLazily

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

checkMutableOnExposing, debugDump, getMutabilityFlag

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

checkImmutable, checkMutable, freeze, isImmutable

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

getAllIdentifiers, getAllIdentifiersNames, getPrimaryIdentifierRequired, getSecondaryIdentifierRequired, isIdentifier

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

containsItemDefinition, findContainerDefinition, findItemDefinition, findLocalItemDefinition, findLocalItemDefinitionByIteration, findPropertyDefinition, findReferenceDefinition

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

areCredentialsCached, areCredentialsCachedLegacy, assertAttached, canRepresent, composite, createBlankShadow, createBlankShadowWithPrimaryId, createPrimaryIdentification, findReferenceAttributeDefinition, getActivationBidirectionalMappingType, getActivationFetchStrategy, getActivationInboundMappings, getAssociationDefinitionsFor, getAssociationsComplexTypeDefinition, getAttributesComplexTypeDefinition, getAuxiliaryObjectClassNameForAttribute, getCompileTimeClass, getDefaultOperationPolicyOid, getDescriptionAttribute, getDisplayNameAttribute, getIdentification, getInstantiationOrder, getLastLoginTimestampFetchStrategy, getNamingAttribute, getObjectClassLocalName, getPasswordFetchStrategy, getPasswordInboundMappings, getPasswordOutboundMappings, getReferenceAttributeDefinitions, getReferenceAttributesComplexTypeDefinition, getResourceOid, getSimpleAttributesComplexTypeDefinition, getStaticSubTypes, getSuperType, isActivationCached, isAuxiliaryObjectClassPropertyCached, isCachingEnabled, isEffectivelyCached, matchesObjectClassName, queryFor, replaceAttributeDefinition, shouldUpdateCachingMetadata, toPrismObjectDefinition, toShadowAssociationsContainerDefinition, toShadowAttributesContainerDefinition

Methods inherited from interface com.evolveum.midpoint.prism.schema.SchemaLookup.Aware

schemaLookup

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

isAssignableFrom

Method Details

getBasicResourceInformation

@NotNull
public @NotNull BasicResourceInformation getBasicResourceInformation()

Description copied from interface: ResourceObjectDefinition

The basic information about the resource (like name, OID, selected configuration beans). Replaces the hard-coded resource OID; necessary also for determination of default values for some features, e.g., shadow caching, and useful for diagnostics.

Specified by:

getBasicResourceInformation in interface ResourceObjectDefinition

getAuxiliaryDefinitions

@NotNull
public @NotNull Collection<? extends ResourceObjectDefinition> getAuxiliaryDefinitions()

Description copied from interface: CompositeObjectDefinition

Returns auxiliary definitions. They enrich the structural definition e.g. by adding attribute definitions. TODO specify better

Specified by:

getAuxiliaryDefinitions in interface CompositeObjectDefinition

Specified by:

getAuxiliaryDefinitions in interface ResourceObjectDefinition

getPrismObjectDefinition

public PrismObjectDefinition<ShadowType> getPrismObjectDefinition()

Description copied from interface: ResourceObjectDefinition

Returns a prism definition for the prism object/objects carrying the resource object/objects.

Specified by:

getPrismObjectDefinition in interface ResourceObjectDefinition

isPrimaryIdentifier

public boolean isPrimaryIdentifier(QName attrName)

Description copied from interface: IdentifiersDefinitionStore

Returns true if the attribute with a given name is among primary identifiers. Matching is done using namespace-approximate method (testing only local part if no namespace is provided), so beware of incidental matching (e.g. ri:uid vs icfs:uid).

Specified by:

isPrimaryIdentifier in interface IdentifiersDefinitionStore

getSchemaMigrations

public List<SchemaMigration> getSchemaMigrations()

Specified by:

getSchemaMigrations in interface PrismLifecycleDefinition

getDiagrams

public List<ItemDiagramSpecification> getDiagrams()

Specified by:

getDiagrams in interface PrismPresentationDefinition

getDisplayHint

public DisplayHint getDisplayHint()

Description copied from interface: PrismPresentationDefinition

Enumeration annotation that specifies how/whether the item should be displayed. It is also a replacement for the old "emphasized" annotation.

Specified by:

getDisplayHint in interface PrismPresentationDefinition

getMergerIdentifier

@Nullable
public @Nullable String getMergerIdentifier()

Specified by:

getMergerIdentifier in interface Definition

getNaturalKeyConstituents

@Nullable
public @Nullable List<QName> getNaturalKeyConstituents()

Specified by:

getNaturalKeyConstituents in interface Definition

isEmphasized

public boolean isEmphasized()

Description copied from interface: PrismPresentationDefinition

True for definitions that are more important than others and that should be emphasized during presentation. E.g. the emphasized definitions will always be displayed in the user interfaces (even if they are empty), they will always be included in the dumps, etc. TODO probably deprecated, isn't it?

Specified by:

isEmphasized in interface PrismPresentationDefinition

isAbstract

public boolean isAbstract()

Description copied from interface: Definition

For types: is the type abstract so that it should not be instantiated directly? For items: TODO

Specified by:

isAbstract in interface Definition

isSecondaryIdentifier

public boolean isSecondaryIdentifier(QName attrName)

Description copied from interface: IdentifiersDefinitionStore

Returns true if the attribute with a given name is among secondary identifiers. Matching is done using namespace-approximate method (testing only local part if no namespace is provided), so beware of incidental matching (e.g. ri:uid vs icfs:uid).

Specified by:

isSecondaryIdentifier in interface IdentifiersDefinitionStore

isDeprecated

public boolean isDeprecated()

Specified by:

isDeprecated in interface PrismLifecycleDefinition

isRemoved

public boolean isRemoved()

Specified by:

isRemoved in interface PrismLifecycleDefinition

isOptionalCleanup

public boolean isOptionalCleanup()

Description copied from interface: Definition

Marks item that could be ignored by SCM tools (e.g. Git), or removed before commit.

Specified by:

isOptionalCleanup in interface Definition

getRemovedSince

public String getRemovedSince()

Specified by:

getRemovedSince in interface PrismLifecycleDefinition

getDeprecatedSince

public String getDeprecatedSince()

Specified by:

getDeprecatedSince in interface PrismLifecycleDefinition

isExperimental

public boolean isExperimental()

Description copied from interface: PrismLifecycleDefinition

Experimental functionality is not stable and it may be changed in any future release without any warning. Use at your own risk.

Specified by:

isExperimental in interface PrismLifecycleDefinition

getPlannedRemoval

public String getPlannedRemoval()

Description copied from interface: PrismLifecycleDefinition

Version of data model in which the item is likely to be removed. This annotation is used for deprecated item to indicate imminent incompatibility in future versions of data model.

Specified by:

getPlannedRemoval in interface PrismLifecycleDefinition

isElaborate

public boolean isElaborate()

Description copied from interface: Definition

Elaborate items are complicated data structure that may deviate from normal principles of the system. For example elaborate items may not be supported in user interface and may only be manageable by raw edits or a special-purpose tools. Elaborate items may be not fully supported by authorizations, schema tools and so on.

Specified by:

isElaborate in interface Definition

getDisplayOrder

public Integer getDisplayOrder()

Description copied from interface: PrismPresentationDefinition

Specifies an order in which the item should be displayed relative to other items at the same level. The items will be displayed by sorting them by the values of displayOrder annotation (ascending). Items that do not have any displayOrder annotation will be displayed last. The ordering of values with the same displayOrder is undefined and it may be arbitrary.

Specified by:

getDisplayOrder in interface PrismPresentationDefinition

getHelp

public String getHelp()

Description copied from interface: PrismPresentationDefinition

Returns help string. Specifies the help text or a key to catalog file for a help text. The help text may be displayed in any suitable way by the GUI. It should explain the meaning of an attribute or object class. Returns null if no help string is set. Corresponds to "help" XSD annotation.

Specified by:

getHelp in interface PrismPresentationDefinition

Returns:

help string or catalog key

getTypeName

@NotNull
public @NotNull QName getTypeName()

Description copied from interface: Definition

Returns a name of the type for this definition. The type can be part of the compile-time schema or it can be defined at run time. Examples of the former case are types like c:UserType, xsd:string, or even flexible ones like c:ExtensionType or c:ShadowAttributesType. Examples of the latter case are types used in - custom extensions, like ext:LocationsType (where ext = e.g. http://example.com/extension), - resource schema, like ri:inetOrgPerson (ri = http://.../resource/instance-3), - connector schema, like TODO In XML representation that corresponds to the name of the XSD type. Although beware, the run-time types do not have statically defined structure. And the resource and connector-related types may even represent different kinds of objects within different contexts (e.g. two distinct resources both with ri:AccountObjectClass types). Also note that for complex type definitions, the type name serves as a unique identifier. On the other hand, for item definitions, it is just one of its attributes; primary key is item name in that case. The type name should be fully qualified. (TODO reconsider this)

Specified by:

getTypeName in interface AbstractTypeDefinition

Specified by:

getTypeName in interface Definition

Returns:

the type name

getDocumentation

public String getDocumentation()

Description copied from interface: PrismPresentationDefinition

Must contains tag because of html tags used in text.

Specified by:

getDocumentation in interface PrismPresentationDefinition

getDocumentationPreview

public String getDocumentationPreview()

Description copied from interface: PrismPresentationDefinition

Returns only a first sentence of documentation.

Specified by:

getDocumentationPreview in interface PrismPresentationDefinition

isRuntimeSchema

public boolean isRuntimeSchema()

Description copied from interface: Definition

This means that this particular definition (of an item or of a type) is part of the runtime schema, e.g. extension schema, resource schema or connector schema or something like that. I.e. it is not defined statically.

Specified by:

isRuntimeSchema in interface Definition

getPrimaryIdentifiers

@NotNull
public @NotNull Collection<? extends ShadowSimpleAttributeDefinition<?>> getPrimaryIdentifiers()

Description copied from interface: IdentifiersDefinitionStore

Returns the definition of primary identifier attributes of a resource object. May return empty set if there are no identifier attributes. Must not return null. 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:

getPrimaryIdentifiers in interface IdentifiersDefinitionStore

Returns:

definition of identifier attributes

getPrimaryIdentifiersNames

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

Description copied from interface: IdentifiersDefinitionStore

Returns names of primary identifiers.

Specified by:

getPrimaryIdentifiersNames in interface IdentifiersDefinitionStore

See Also:

• IdentifiersDefinitionStore.getPrimaryIdentifiers()

getSecondaryIdentifiers

@NotNull
public @NotNull Collection<? extends ShadowSimpleAttributeDefinition<?>> getSecondaryIdentifiers()

Description copied from interface: IdentifiersDefinitionStore

Returns the definition of secondary identifier attributes of a resource object. May return empty set if there are no secondary identifier attributes. Must not return null. 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:

getSecondaryIdentifiers in interface IdentifiersDefinitionStore

Returns:

definition of secondary identifier attributes

getSecondaryIdentifiersNames

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

Description copied from interface: IdentifiersDefinitionStore

Returns names of secondary identifiers.

Specified by:

getSecondaryIdentifiersNames in interface IdentifiersDefinitionStore

See Also:

• ()

getShadowMarkingRules

@NotNull
public @NotNull ShadowMarkingRules getShadowMarkingRules()

Description copied from interface: ResourceObjectDefinition

Returns compiled patterns denoting protected objects or other kinds of marks. Use only in the parsed state.

Specified by:

getShadowMarkingRules in interface ResourceObjectDefinition

See Also:

• ResourceObjectTypeDefinitionType.getProtected()
• ResourceObjectTypeDefinitionType.getMarking()

getDisplayName

public String getDisplayName()

Description copied from interface: PrismPresentationDefinition

Returns display name. Specifies the printable name of the object class or attribute. It must contain a printable string. It may also contain a key to catalog file. Returns null if no display name is set. Corresponds to "displayName" XSD annotation.

Specified by:

getDisplayName in interface PrismPresentationDefinition

Returns:

display name string or catalog key

getDescription

public String getDescription()

Description copied from interface: ResourceObjectDefinition

Free-form textual description of the object. It is supposed to describe the object or a construct that it is attached to.

Specified by:

getDescription in interface ResourceObjectDefinition

See Also:

• ResourceObjectTypeDefinitionType.getDescription()

getObjectClassDefinition

@NotNull
public @NotNull ResourceObjectClassDefinition getObjectClassDefinition()

Description copied from interface: ResourceObjectDefinition

Returns the [structural] object class definition.

Specified by:

getObjectClassDefinition in interface ResourceObjectDefinition

getNativeObjectClassDefinition

@NotNull
public @NotNull NativeObjectClassDefinition getNativeObjectClassDefinition()

Description copied from interface: ResourceObjectDefinition

Returns the [structural] native object class definition, typically obtained from the connector.

Specified by:

getNativeObjectClassDefinition in interface ResourceObjectDefinition

getDelineation

@NotNull
public @NotNull ResourceObjectTypeDelineation getDelineation()

Description copied from interface: ResourceObjectDefinition

Returns the delineation of the set of objects belonging to this object type. Note that this tells only about information stored right in the definition bean, i.e. legacy configuration is not provided here. The complete picture is provided by SynchronizationPolicy.getDelineation().

Specified by:

getDelineation in interface ResourceObjectDefinition

getBaseContext

public ResourceObjectReferenceType getBaseContext()

Description copied from interface: ResourceObjectDefinition

The definition of base context (resource object container). This object will be used as a base for searches for objects of this type.

Specified by:

getBaseContext in interface ResourceObjectDefinition

See Also:

• ResourceObjectTypeDefinitionType.getBaseContext()

getSearchHierarchyScope

public SearchHierarchyScope getSearchHierarchyScope()

Description copied from interface: ResourceObjectDefinition

Definition of search hierarchy scope. It specifies how "deep" the search should go into the object hierarchy.

Specified by:

getSearchHierarchyScope in interface ResourceObjectDefinition

See Also:

• ResourceObjectTypeDefinitionType.getSearchHierarchyScope()

getVolatility

@NotNull
public @NotNull ResourceObjectVolatilityType getVolatility()

Description copied from interface: ResourceObjectDefinition

Specifies volatility of this type of resource objects, i.e. whether such an object can change when midPoint is not looking.

Specified by:

getVolatility in interface ResourceObjectDefinition

See Also:

• ResourceObjectTypeDefinitionType.getVolatility()

getDefaultInboundMappingEvaluationPhases

@Nullable
public @Nullable DefaultInboundMappingEvaluationPhasesType getDefaultInboundMappingEvaluationPhases()

Description copied from interface: ResourceObjectDefinition

Returns the phases in which inbound mappings are evaluated by default.

Specified by:

getDefaultInboundMappingEvaluationPhases in interface ResourceObjectDefinition

Specified by:

getDefaultInboundMappingEvaluationPhases in interface ResourceObjectInboundProcessingDefinition

See Also:

• ResourceObjectTypeDefinitionType.getMappingsEvaluation()

getFocusSpecification

@NotNull
public @NotNull ResourceObjectInboundProcessingDefinition.FocusSpecification getFocusSpecification()

Specified by:

getFocusSpecification in interface ResourceObjectInboundProcessingDefinition

getSynchronizationReactions

@NotNull
public @NotNull Collection<? extends SynchronizationReactionDefinition> getSynchronizationReactions()

Specified by:

getSynchronizationReactions in interface ResourceObjectInboundProcessingDefinition

getCorrelation

public CorrelationDefinitionType getCorrelation()

Specified by:

getCorrelation in interface ResourceObjectInboundProcessingDefinition

getLifecycleState

@Nullable
public @Nullable String getLifecycleState()

Description copied from interface: ResourceObjectDefinition

What lifecycle state is the (refined) object class or object type definition? Raw object class definition should always return `null` here.

Specified by:

getLifecycleState in interface ResourceObjectDefinition

See Also:

• ResourceObjectTypeDefinitionType.getLifecycleState()

getObjectMultiplicity

public ResourceObjectMultiplicityType getObjectMultiplicity()

Specified by:

getObjectMultiplicity in interface ResourceObjectDefinition

See Also:

• ResourceObjectTypeDefinitionType.getMultiplicity()

getProjectionPolicy

public ProjectionPolicyType getProjectionPolicy()

Specified by:

getProjectionPolicy in interface ResourceObjectDefinition

See Also:

• ResourceObjectTypeDefinitionType.getProjection()

getSecurityPolicyRef

public ObjectReferenceType getSecurityPolicyRef()

Specified by:

getSecurityPolicyRef in interface ResourceObjectDefinition

See Also:

• ResourceObjectTypeDefinitionType.getSecurityPolicyRef()

getActivationSchemaHandling

public ResourceActivationDefinitionType getActivationSchemaHandling()

Specified by:

getActivationSchemaHandling in interface ResourceObjectDefinition

See Also:

• ResourceObjectTypeDefinitionType.getActivation()

getEnabledCapability

public <T extends CapabilityType> T getEnabledCapability(@NotNull
 @NotNull Class<T> capabilityClass,
 ResourceType resource)

Description copied from interface: ResourceObjectDefinition

Checks the presence of capability in: 1. resource object definition (applicable only to resource object _type_ definitions), 2. additional connectors in resource (only if enabled there), 3. the main connector. Returns the present capability, but only if it's enabled.

Specified by:

getEnabledCapability in interface ResourceObjectDefinition

validate

public void validate()
              throws SchemaException

Description copied from interface: ResourceObjectDefinition

Executes some basic checks on this object type. Moved from `validateObjectClassDefinition()` method in ResourceTypeUtil. TODO review this method

Specified by:

validate in interface ResourceObjectDefinition

Throws:

SchemaException

getAttributeDefinitions

@NotNull
public @NotNull List<? extends ShadowAttributeDefinition<?,?,?,?>> getAttributeDefinitions()

Description copied from interface: AttributeDefinitionStore

Returns all attribute definitions as an unmodifiable collection. Should be the same content as returned by `getDefinitions`. The returned value is a List because of the contract of ComplexTypeDefinition.getDefinitions().

Specified by:

getAttributeDefinitions in interface AttributeDefinitionStore

getDefinitions

@NotNull
public @NotNull List<? extends ItemDefinition<?>> getDefinitions()

Description copied from interface: LocalItemDefinitionStore

Returns all item definitions in this store.

Specified by:

getDefinitions in interface LocalItemDefinitionStore

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

getItemInboundDefinitions

@NotNull
public @NotNull Collection<ResourceObjectInboundProcessingDefinition.CompleteItemInboundDefinition> getItemInboundDefinitions()

Description copied from interface: ResourceObjectInboundProcessingDefinition

Returns all inbound definitions for attributes and associations.

Specified by:

getItemInboundDefinitions in interface ResourceObjectInboundProcessingDefinition

getAuxiliaryObjectClassMappings

public ResourceBidirectionalMappingAndDefinitionType getAuxiliaryObjectClassMappings()

Specified by:

getAuxiliaryObjectClassMappings in interface ResourceObjectDefinition

See Also:

• ResourceObjectTypeDefinitionType.getAuxiliaryObjectClassMappings()

getAuxiliaryObjectClassInboundMappings

@NotNull
public @NotNull List<MappingType> getAuxiliaryObjectClassInboundMappings()

Description copied from interface: ResourceObjectInboundProcessingDefinition

Returns inbound mappings for the auxiliary object class(es) property.

Specified by:

getAuxiliaryObjectClassInboundMappings in interface ResourceObjectInboundProcessingDefinition

hasAuxiliaryObjectClass

public boolean hasAuxiliaryObjectClass(QName expectedObjectClassName)

Description copied from interface: ResourceObjectDefinition

TODO define semantics (it's different for CompositeObjectDefinition and the others!

Specified by:

hasAuxiliaryObjectClass in interface ResourceObjectDefinition

findItemDefinition

public <ID extends ItemDefinition<?>> ID findItemDefinition(@NotNull
 @NotNull ItemPath path,
 @NotNull
 @NotNull Class<ID> clazz)

Description copied from interface: LocalItemDefinitionStore

Returns a definition of given type corresponding to given path (rooted at this store). Tries the global resolution in the case of "any" content.

Specified by:

findItemDefinition in interface LocalItemDefinitionStore

findAttributeDefinition

@Nullable
public @Nullable ShadowAttributeDefinition<?,?,?,?> findAttributeDefinition(QName name,
 boolean caseInsensitive)

Description copied from interface: AttributeDefinitionStore

Finds an attribute definition by looking at the property name. Returns null if nothing is found.

Specified by:

findAttributeDefinition in interface AttributeDefinitionStore

Parameters:

name - property definition name

caseInsensitive - if true, ignoring the case

Returns:

found property definition or null

findLocalItemDefinition

public <ID extends ItemDefinition<?>> ID findLocalItemDefinition(@NotNull
 @NotNull QName name,
 @NotNull
 @NotNull Class<ID> clazz,
 boolean caseInsensitive)

Description copied from interface: LocalItemDefinitionStore

Returns the local item definition corresponding to given item name (optionally case-insensitive) and definition class. Does not try to resolve items globally (in the case of "any" content). BEWARE: In the case of ambiguities, returns any suitable definition. (This may change.)

Specified by:

findLocalItemDefinition in interface LocalItemDefinitionStore

getTypeClass

public Class<?> getTypeClass()

Description copied from interface: Definition

Returns a compile-time class that is used to represent items. E.g. returns String, Integer, subclasses of Objectable and Containerable and so on.

Specified by:

getTypeClass in interface Definition

createBlankShadowWithTag

public AbstractShadow createBlankShadowWithTag(String tag)

Description copied from interface: ResourceObjectDefinition

As ResourceObjectDefinition.createBlankShadow() but having the correct resource OID, kind/intent (if applicable), and tag set.

Specified by:

createBlankShadowWithTag in interface ResourceObjectDefinition

getPasswordDefinition

@Nullable
public @Nullable ResourcePasswordDefinitionType getPasswordDefinition()

Description copied from interface: ResourceObjectDefinition

See ResourceObjectTypeDefinitionType.getCredentials()

Specified by:

getPasswordDefinition in interface ResourceObjectDefinition

getLastLoginTimestampDefinition

@Nullable
public @Nullable ResourceLastLoginTimestampDefinitionType getLastLoginTimestampDefinition()

Description copied from interface: ResourceObjectDefinition

See ResourceObjectTypeDefinitionType.getBehavior()

Specified by:

getLastLoginTimestampDefinition in interface ResourceObjectDefinition

accept

public void accept(Visitor<Definition> visitor)

Specified by:

accept in interface Visitable<Definition>

accept

public boolean accept(Visitor<Definition> visitor,
 SmartVisitation<Definition> visitation)

Specified by:

accept in interface SmartVisitable<Definition>

Returns:

false if we already was here

clone

@NotNull
public @NotNull CompositeObjectDefinitionImpl clone()

Description copied from interface: ResourceObjectDefinition

Returns a mutable definition. BEWARE, the mutable CompositeObjectDefinition is significantly slower than its immutable counterpart. See MID-9156.

Specified by:

clone in interface Definition

Specified by:

clone in interface ResourceObjectDefinition

Overrides:

clone in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

debugDump

public String debugDump(int indent)

Specified by:

debugDump in interface DebugDumpable

getDebugDumpClassName

public String getDebugDumpClassName()

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

Specified by:

getDebugDumpClassName in interface ResourceObjectDefinition

getHumanReadableName

public String getHumanReadableName()

Description copied from interface: ResourceObjectDefinition

TODO

Specified by:

getHumanReadableName in interface ResourceObjectDefinition

toString

public String toString()

Overrides:

toString in class Object

getShortIdentification

@NotNull
public @NotNull String getShortIdentification()

Description copied from interface: ResourceObjectDefinition

Very short identification, like the object class local name or the kind/intent pair.

Specified by:

getShortIdentification in interface ResourceObjectDefinition

deepClone

@NotNull
public @NotNull CompositeObjectDefinitionImpl deepClone(@NotNull
 @NotNull DeepCloneOperation operation)

Description copied from interface: ResourceObjectDefinition

Returns a mutable definition. BEWARE, the mutable CompositeObjectDefinition is significantly slower than its immutable counterpart. See MID-9156.

Specified by:

deepClone in interface ResourceObjectDefinition

getDefinitionBean

@NotNull
public @NotNull ResourceObjectTypeDefinitionType getDefinitionBean()

Description copied from interface: ResourceObjectDefinition

Returns the configuration bean for this object type or class.

Specified by:

getDefinitionBean in interface ResourceObjectDefinition

forLayerMutable

@NotNull
public @NotNull CompositeObjectDefinition forLayerMutable(@NotNull
 @NotNull LayerType layer)

Description copied from interface: ResourceObjectDefinition

Creates a layer-specific mutable version of this definition.

Specified by:

forLayerMutable in interface ResourceObjectDefinition

forLayerImmutable

@NotNull
public @NotNull ResourceObjectDefinition forLayerImmutable(@NotNull
 @NotNull LayerType layer)

Description copied from interface: ResourceObjectDefinition

As ResourceObjectDefinition.forLayerMutable(LayerType) but returns immutable definition.

Specified by:

forLayerImmutable in interface ResourceObjectDefinition

getCurrentLayer

@NotNull
public @NotNull LayerType getCurrentLayer()

Description copied from interface: LayeredDefinition

Gets the current point-of-view: on which layer do we look at the data?

Specified by:

getCurrentLayer in interface LayeredDefinition

replaceAttributeDefinition

public void replaceAttributeDefinition(@NotNull
 @NotNull QName itemName,
 @Nullable
 @Nullable ItemDefinition<?> newDefinition)

Description copied from interface: ResourceObjectDefinition

Replaces a definition for given item name with a provided one.

Specified by:

replaceAttributeDefinition in interface ResourceObjectDefinition

trimAttributesTo

public void trimAttributesTo(@NotNull
 @NotNull Collection<ItemPath> paths)

Specified by:

trimAttributesTo in interface ResourceObjectDefinition

mutator

public ResourceObjectClassDefinition.ResourceObjectClassDefinitionMutator mutator()

Description copied from interface: Definition

Returns an interface to mutate this definition.

Specified by:

mutator in interface Definition

getAnnotation

public <A> A getAnnotation(QName qname)

Description copied from interface: Definition

Returns generic definition annotation. Annotations are a method to extend schema definitions. This may be annotation stored in the schema definition file (e.g. XSD) or it may be a dynamic annotation determined at run-time. Annotation value should be a prism-supported object. E.g. a prims "bean" (JAXB annotated class), prism item, prism value or something like that. EXPERIMENTAL. Hic sunt leones. This may change at any moment. Note: annotations are only partially supported now (3.8). They are somehow transient. E.g. they are not serialized to XSD schema definitions (yet).

Specified by:

getAnnotation in interface Definition

getAnnotations

@Nullable
public @Nullable Map<QName,Object> getAnnotations()

Description copied from interface: Definition

Returns all annotations, as unmodifiable map. Nullable by design, to avoid creating lots of empty maps.

Specified by:

getAnnotations in interface Definition

performFreeze

public void performFreeze()

Overrides:

performFreeze in class AbstractFreezable

getObjectClassName

@NotNull
public @NotNull QName getObjectClassName()

Description copied from interface: ResourceObjectDefinition

Returns the name of the object class. Always fully qualified; currently with the SchemaConstants.NS_RI namespace.

Specified by:

getObjectClassName in interface ResourceObjectDefinition

getDescriptionAttributeName

@Nullable
public @Nullable QName getDescriptionAttributeName()

Description copied from interface: ResourceObjectDefinition

Returns name of the description attribute.

Specified by:

getDescriptionAttributeName in interface ResourceObjectDefinition

See Also:

• ResourceObjectDefinition.getDescriptionAttribute()

getNamingAttributeName

@Nullable
public @Nullable QName getNamingAttributeName()

Description copied from interface: ResourceObjectDefinition

Returns name of the naming attribute.

Specified by:

getNamingAttributeName in interface ResourceObjectDefinition

See Also:

• ResourceObjectDefinition.getNamingAttributeName()

getDisplayNameAttributeName

@Nullable
public @Nullable QName getDisplayNameAttributeName()

Description copied from interface: ResourceObjectDefinition

Returns name of the display name attribute.

Specified by:

getDisplayNameAttributeName in interface ResourceObjectDefinition

createShadowSearchQuery

@NotNull
public @NotNull ObjectQuery createShadowSearchQuery(String resourceOid)

Description copied from interface: ResourceObjectDefinition

Creates a query for obtaining shadows related to this object class or object type. The current implementations return either: - a combination of resource OID + object class name, or - a combination of resource OID + kind + intent.

Specified by:

createShadowSearchQuery in interface ResourceObjectDefinition

getStructuralDefinition

@NotNull
public @NotNull ResourceObjectDefinition getStructuralDefinition()

Description copied from interface: CompositeObjectDefinition

Returns the structural definition that represents the "base" of this composite definition.

Specified by:

getStructuralDefinition in interface CompositeObjectDefinition

getTypeIdentification

@Nullable
public @Nullable ResourceObjectTypeIdentification getTypeIdentification()

Description copied from interface: ResourceObjectDefinition

Is this definition bound to a specific resource type? If yes, this method returns its identification.

Specified by:

getTypeIdentification in interface ResourceObjectDefinition

getTypeDefinition

@Nullable
public @Nullable ResourceObjectTypeDefinition getTypeDefinition()

Description copied from interface: ResourceObjectDefinition

Is this definition bound to a specific resource type? If yes, this method returns its definition.

Specified by:

getTypeDefinition in interface ResourceObjectDefinition

isDefaultFor

public boolean isDefaultFor(@NotNull
 @NotNull ShadowKindType kind)

Description copied from interface: ResourceObjectDefinition

Returns true if this definition can be considered as a default for the specified kind. Normally, for a type definition it means that it is marked as "default for a kind" and has the specified kind. But there is a special case of ResourceObjectClassDefinition with ResourceObjectClassDefinition.isDefaultAccountDefinition() being `true`. It is considered to be the default for ShadowKindType.ACCOUNT. Use with care!

Specified by:

isDefaultFor in interface ResourceObjectDefinition

getEffectiveShadowCachingPolicy

@NotNull
public @NotNull ShadowCachingPolicyType getEffectiveShadowCachingPolicy()

Description copied from interface: ResourceObjectDefinition

Returns shadow caching policy determined by the application of resource-level definitions down to the specific object type/class definition (using bean merging). The returned value has all the defaults applied. Throws an exception for unattached raw object class definitions.

Specified by:

getEffectiveShadowCachingPolicy in interface ResourceObjectDefinition

resolveFrameworkName

@Nullable
public @Nullable ItemName resolveFrameworkName(@NotNull
 @NotNull String frameworkName)

Description copied from interface: FrameworkNameResolver

Resolves framework-specific name (like `__NAME__`) to midPoint name (like `ri:dn`), if available.

Specified by:

resolveFrameworkName in interface FrameworkNameResolver

getMergerInstance

@Nullable
public @Nullable ItemMerger getMergerInstance(@NotNull
 @NotNull MergeStrategy strategy,
 @Nullable
 @Nullable OriginMarker originMarker)

Specified by:

getMergerInstance in interface Definition

getNaturalKeyInstance

@Nullable
public @Nullable NaturalKeyDefinition getNaturalKeyInstance()

Specified by:

getNaturalKeyInstance in interface Definition

getSchemaContextDefinition

@Nullable
public @Nullable SchemaContextDefinition getSchemaContextDefinition()

Specified by:

getSchemaContextDefinition in interface Definition

findAssociationDefinition

public ShadowAssociationDefinition findAssociationDefinition(QName name)

Specified by:

findAssociationDefinition in interface AssociationDefinitionStore

getAssociationDefinitions

@NotNull
public @NotNull List<? extends ShadowAssociationDefinition> getAssociationDefinitions()

Specified by:

getAssociationDefinitions in interface AssociationDefinitionStore

getAttributesVolatileOnAddOperation

@NotNull
public @NotNull Collection<ShadowAttributeDefinition<?,?,?,?>> getAttributesVolatileOnAddOperation()

Description copied from interface: ResourceObjectDefinition

See ShadowAttributeDefinition.isVolatileOnAddOperation().

Specified by:

getAttributesVolatileOnAddOperation in interface ResourceObjectDefinition

getAttributesVolatileOnModifyOperation

@NotNull
public @NotNull Collection<ShadowAttributeDefinition<?,?,?,?>> getAttributesVolatileOnModifyOperation()

Description copied from interface: ResourceObjectDefinition

See ShadowAttributeDefinition.isVolatileOnModifyOperation().

Specified by:

getAttributesVolatileOnModifyOperation in interface ResourceObjectDefinition