Package com.evolveum.midpoint.schema.processor

Class AbstractResourceObjectDefinitionImpl

java.lang.Object

com.evolveum.midpoint.prism.AbstractFreezable

com.evolveum.midpoint.schema.processor.AbstractResourceObjectDefinitionImpl

All Implemented Interfaces:

AbstractTypeDefinition, Definition, Freezable, LocalItemDefinitionStore, PrismLifecycleDefinition, PrismPresentationDefinition, Revivable, SmartVisitable<Definition>, TypeDefinition, Visitable<Definition>, AssociationDefinitionStore, AttributeDefinitionStore, FrameworkNameResolver, IdentifiersDefinitionStore, LayeredDefinition, ResourceObjectDefinition, ResourceObjectInboundDefinition, DebugDumpable, Serializable, Cloneable

Direct Known Subclasses:

ResourceObjectClassDefinitionImpl, ResourceObjectTypeDefinitionImpl

public abstract class AbstractResourceObjectDefinitionImpl
extends AbstractFreezable
implements ResourceObjectDefinition

Common implementation for both ResourceObjectClassDefinition and ResourceObjectTypeDefinition.

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

ResourceObjectInboundDefinition.AssociationBasedItemImplementation, ResourceObjectInboundDefinition.AssociationProcessingImplementation, ResourceObjectInboundDefinition.BeanBasedItemImplementation, ResourceObjectInboundDefinition.ComplexProcessingImplementation, ResourceObjectInboundDefinition.EmptyImplementation, ResourceObjectInboundDefinition.FocusSpecification, ResourceObjectInboundDefinition.ItemInboundDefinition

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

TypeDefinition.TypeDefinitionLikeBuilder, TypeDefinition.TypeDefinitionMutator

Field Summary

Fields

Modifier and Type	Field	Description
protected final @NotNull DeeplyFreezableReference<ResourceObjectTypeDelineation>	delineation	"Compiled" object set delineation.

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)
void	add(ItemDefinition<?> definition)
protected void	addDebugDumpHeaderExtension(StringBuilder sb)
protected void	addDebugDumpTrailer(StringBuilder sb, int indent)
abstract @NotNull AbstractResourceObjectDefinitionImpl	clone()	Returns a mutable definition.
protected abstract @NotNull AbstractResourceObjectDefinitionImpl	cloneInLayer(@NotNull LayerType layer)	Returns mutable copy.
protected void	copyDefinitionDataFrom(@NotNull LayerType layer, @NotNull ResourceObjectDefinition source)
String	debugDump(int indent)
static String	debugDump(int indent, LayerType layer, AbstractResourceObjectDefinitionImpl _this)
boolean	equals(Object o)
<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).
<T> @Nullable ShadowSimpleAttributeDefinition<T>	findSimpleAttributeDefinition(QName name, boolean caseInsensitive)	Finds a simple attribute definition by looking at the property name.
@NotNull ResourceObjectDefinition	forLayerImmutable(@NotNull LayerType layer)	As ResourceObjectDefinition.forLayerMutable(LayerType) but returns immutable definition.
@NotNull ResourceObjectDefinition	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.
ResourceObjectInboundDefinition.ItemInboundDefinition	getAssociationInboundDefinition(ItemName itemName)
@NotNull List<? extends ShadowAttributeDefinition<?,?>>	getAttributeDefinitions()	Returns all attribute definitions as an unmodifiable collection.
ResourceObjectInboundDefinition.ItemInboundDefinition	getAttributeInboundDefinition(ItemName itemName)
@NotNull Collection<ResourceObjectDefinition>	getAuxiliaryDefinitions()	TODO define semantics (it's different for CompositeObjectDefinition and the others!
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).
@NotNull Collection<QName>	getConfiguredAuxiliaryObjectClassNames()	Returns the names of auxiliary object classes that are "statically" defined for this object type (or object class, in the future).
CorrelationDefinitionType	getCorrelation()
@NotNull LayerType	getCurrentLayer()	Gets the current point-of-view: on which layer do we look at the data?
@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.
List<ItemDiagramSpecification>	getDiagrams()
DisplayHint	getDisplayHint()	Enumeration annotation that specifies how/whether the item should be displayed.
@Nullable String	getDisplayName()	Returns display name.
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.
String	getHelp()	Returns help string.
@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 List<QName>	getNaturalKeyConstituents()
@Nullable NaturalKeyDefinition	getNaturalKeyInstance()
ResourceObjectMultiplicityType	getObjectMultiplicity()
ResourcePasswordDefinitionType	getPasswordDefinition()	See ResourceObjectTypeDefinitionType.getCredentials()
String	getPlannedRemoval()	Version of data model in which the item is likely to be removed.
@NotNull Collection<ShadowSimpleAttributeDefinition<?>>	getPrimaryIdentifiers()	Returns the definition of primary identifier attributes of a resource object.
@NotNull List<QName>	getPrimaryIdentifiersNames()	Names of primary identifiers.
PrismObjectDefinition<ShadowType>	getPrismObjectDefinition()	Returns a prism definition for the prism object/objects carrying the resource object/objects.
ProjectionPolicyType	getProjectionPolicy()
@NotNull Collection<ResourceObjectPattern>	getProtectedObjectPatterns()	Returns compiled patterns denoting protected objects.
String	getRemovedSince()
List<SchemaMigration>	getSchemaMigrations()
SearchHierarchyScope	getSearchHierarchyScope()	Definition of search hierarchy scope.
@NotNull Collection<ShadowSimpleAttributeDefinition<?>>	getSecondaryIdentifiers()	Returns the definition of secondary identifier attributes of a resource object.
@NotNull List<QName>	getSecondaryIdentifiersNames()	Names of secondary identifiers.
ObjectReferenceType	getSecurityPolicyRef()
Class<?>	getTypeClass()	Returns a compile-time class that is used to represent items.
@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	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	isRemoved()
boolean	isRuntimeSchema()	This means that this particular definition (of an item or of a type) is part of the runtime schema, e.g.
Definition.DefinitionMutator	mutator()	Returns an interface to mutate this definition.
protected void	performFreeze()
void	replaceDefinition(@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)
void	trimTo(@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, toString, 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, findAttributeDefinition, findShadowAttributeDefinitionRequired, findSimpleAttributeDefinition, findSimpleAttributeDefinition, findSimpleAttributeDefinitionRequired, findSimpleAttributeDefinitionRequired, findSimpleAttributeDefinitionRequired, findSimpleAttributeDefinitionStrictlyRequired, findSimpleAttributeDefinitionStrictlyRequired, getAllSimpleAttributesNames, getAttributeDefinitions, getSimpleAttributeDefinitions, hasIndexOnlyAttributes, instantiateAttribute

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, isPrimaryIdentifier, isSecondaryIdentifier

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

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

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

assertAttached, canRepresent, composite, createBlankShadow, createBlankShadowWithPrimaryId, createBlankShadowWithTag, createShadowSearchQuery, deepClone, findReferenceAttributeDefinition, getActivationBidirectionalMappingType, getActivationFetchStrategy, getAssociationsComplexTypeDefinition, getAttributesComplexTypeDefinition, getCompileTimeClass, getDebugDumpClassName, getDescriptionAttribute, getDescriptionAttributeName, getDisplayNameAttribute, getDisplayNameAttributeName, getHumanReadableName, getIdentification, getInstantiationOrder, getNamingAttribute, getNamingAttributeName, getNativeObjectClassDefinition, getObjectClassDefinition, getObjectClassLocalName, getObjectClassName, getPasswordFetchStrategy, getPasswordInbound, getPasswordOutbound, getReferenceAttributeDefinitions, getResourceOid, getShortIdentification, getStaticSubTypes, getSuperType, getTypeDefinition, getTypeIdentification, isDefaultFor, matchesObjectClassName, replaceDefinition, toPrismObjectDefinition, toResourceAttributeContainerDefinition, toShadowAssociationsContainerDefinition

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

getDefaultObjectRefDefinition, getFocusSpecification, getSynchronizationReactions, hasAnyInbounds

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

isAssignableFrom

Field Details

delineation

@NotNull
protected final @NotNull DeeplyFreezableReference<ResourceObjectTypeDelineation> delineation

"Compiled" object set delineation.

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

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

findSimpleAttributeDefinition

@Nullable
public <T>
@Nullable ShadowSimpleAttributeDefinition<T> findSimpleAttributeDefinition(QName name,
 boolean caseInsensitive)

Description copied from interface: AttributeDefinitionStore

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

Specified by:

findSimpleAttributeDefinition in interface AttributeDefinitionStore

Parameters:

name - property definition name

caseInsensitive - if true, ignoring the case

Returns:

found property definition or null

getPrimaryIdentifiers

@NotNull
public @NotNull Collection<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

getSecondaryIdentifiers

@NotNull
public @NotNull Collection<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

getPrimaryIdentifiersNames

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

Names of primary identifiers. The list is modifiable until the whole definition is frozen.

Specified by:

getPrimaryIdentifiersNames in interface IdentifiersDefinitionStore

See Also:

• IdentifiersDefinitionStore.getPrimaryIdentifiers()

getSecondaryIdentifiersNames

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

Names of secondary identifiers. The list is modifiable until the whole definition is frozen.

Specified by:

getSecondaryIdentifiersNames in interface IdentifiersDefinitionStore

See Also:

• ()

getDisplayName

@Nullable
public @Nullable 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()

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

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 ResourceObjectInboundDefinition

See Also:

• ResourceObjectTypeDefinitionType.getMappingsEvaluation()

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()

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

getAuxiliaryDefinitions

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

Description copied from interface: ResourceObjectDefinition

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

Specified by:

getAuxiliaryDefinitions in interface ResourceObjectDefinition

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

getAuxiliaryObjectClassMappings

public ResourceBidirectionalMappingAndDefinitionType getAuxiliaryObjectClassMappings()

Specified by:

getAuxiliaryObjectClassMappings in interface ResourceObjectDefinition

Specified by:

getAuxiliaryObjectClassMappings in interface ResourceObjectInboundDefinition

See Also:

• ResourceObjectTypeDefinitionType.getAuxiliaryObjectClassMappings()

getProtectedObjectPatterns

@NotNull
public @NotNull Collection<ResourceObjectPattern> getProtectedObjectPatterns()

Description copied from interface: ResourceObjectDefinition

Returns compiled patterns denoting protected objects.

Specified by:

getProtectedObjectPatterns in interface ResourceObjectDefinition

See Also:

• ResourceObjectTypeDefinitionType.getProtected()

getPasswordDefinition

public ResourcePasswordDefinitionType getPasswordDefinition()

Description copied from interface: ResourceObjectDefinition

See ResourceObjectTypeDefinitionType.getCredentials()

Specified by:

getPasswordDefinition in interface ResourceObjectDefinition

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

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

clone

@NotNull
public abstract @NotNull AbstractResourceObjectDefinitionImpl 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

copyDefinitionDataFrom

protected void copyDefinitionDataFrom(@NotNull
 @NotNull LayerType layer,
 @NotNull
 @NotNull ResourceObjectDefinition source)

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

performFreeze

protected void performFreeze()

Overrides:

performFreeze in class AbstractFreezable

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

debugDump

public String debugDump(int indent)

Specified by:

debugDump in interface DebugDumpable

debugDump

public static String debugDump(int indent,
 LayerType layer,
 AbstractResourceObjectDefinitionImpl _this)

addDebugDumpHeaderExtension

protected void addDebugDumpHeaderExtension(StringBuilder sb)

addDebugDumpTrailer

protected void addDebugDumpTrailer(StringBuilder sb,
 int indent)

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

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

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

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

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

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

getDeprecatedSince

public String getDeprecatedSince()

Specified by:

getDeprecatedSince in interface PrismLifecycleDefinition

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

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

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

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

getDocumentationPreview

public String getDocumentationPreview()

Description copied from interface: PrismPresentationDefinition

Returns only a first sentence of documentation.

Specified by:

getDocumentationPreview in interface PrismPresentationDefinition

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

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

getSchemaMigrations

public List<SchemaMigration> getSchemaMigrations()

Specified by:

getSchemaMigrations in interface PrismLifecycleDefinition

getDiagrams

public List<ItemDiagramSpecification> getDiagrams()

Specified by:

getDiagrams in interface PrismPresentationDefinition

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

forLayerMutable

@NotNull
public @NotNull ResourceObjectDefinition 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

cloneInLayer

@NotNull
protected abstract @NotNull AbstractResourceObjectDefinitionImpl cloneInLayer(@NotNull
 @NotNull LayerType layer)

Returns mutable copy.

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

replaceDefinition

public void replaceDefinition(@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:

replaceDefinition in interface ResourceObjectDefinition

add

public void add(ItemDefinition<?> definition)

getConfiguredAuxiliaryObjectClassNames

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

Description copied from interface: ResourceObjectDefinition

Returns the names of auxiliary object classes that are "statically" defined for this object type (or object class, in the future). For dynamically composed definitions (CompositeObjectDefinition only the statically-defined ones (i.e. those from the structural definition) are returned.

Specified by:

getConfiguredAuxiliaryObjectClassNames in interface ResourceObjectDefinition

trimTo

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

Specified by:

trimTo 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

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

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

getAttributeInboundDefinition

public ResourceObjectInboundDefinition.ItemInboundDefinition getAttributeInboundDefinition(ItemName itemName)
                                                                                    throws SchemaException

Specified by:

getAttributeInboundDefinition in interface ResourceObjectInboundDefinition

Throws:

SchemaException

getAssociationInboundDefinition

public ResourceObjectInboundDefinition.ItemInboundDefinition getAssociationInboundDefinition(ItemName itemName)
                                                                                      throws SchemaException

Specified by:

getAssociationInboundDefinition in interface ResourceObjectInboundDefinition

Throws:

SchemaException

getCorrelation

public CorrelationDefinitionType getCorrelation()

Specified by:

getCorrelation in interface ResourceObjectInboundDefinition

mutator

public Definition.DefinitionMutator mutator()

Description copied from interface: Definition

Returns an interface to mutate this definition.

Specified by:

mutator in interface Definition