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:

ComplexTypeDefinition, Definition, Freezable, LocalItemDefinitionStore, PrismContextSensitive, Revivable, SmartVisitable<Definition>, TypeDefinition, Visitable<Definition>, AssociationDefinitionStore, AttributeDefinitionStore, IdentifiersDefinitionStore, LayeredDefinition, ResourceObjectDefinition, DebugDumpable, Serializable, Cloneable

Direct Known Subclasses:

ResourceObjectClassDefinitionImpl, ResourceObjectTypeDefinitionImpl

public abstract class AbstractResourceObjectDefinitionImpl
extends AbstractFreezable
implements ResourceObjectDefinition

Common implementation for both ResourceObjectClassDefinition and ResourceObjectTypeDefinition. Note about not inheriting from ComplexTypeDefinitionImpl: As we do not inherit from that class, we have to provide our own implementation of various methods like getExtensionForType(), isContainerMarker(), and so on. This is basically no problem, as this information is not available from a resource connector, so we are OK with the default values. Should this change, we would need to reconsider this design. The current implementation is more straightforward, less entangled with a hierarchy of ancestor implementations.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected @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)
boolean	canRepresent(QName typeName)
abstract @NotNull AbstractResourceObjectDefinitionImpl	clone()	Does a shallow clone of this definition (i.e.
protected abstract AbstractResourceObjectDefinitionImpl	cloneInLayer(@NotNull LayerType layer)
protected void	copyDefinitionDataFrom(@NotNull LayerType layer, @NotNull ResourceObjectDefinition source)
PrismObject<ShadowType>	createBlankShadow(String resourceOid, String tag)	Creates a blank ShadowType object, with the attributes container having appropriate definition.
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).
ResourceObjectDefinition	forLayer(@NotNull LayerType layer)	Creates a layer-specific 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 Collection<ResourceAssociationDefinition>	getAssociationDefinitions()	Returns definitions of all associations as an unmodifiable collection.
@NotNull List<? extends ResourceAttributeDefinition<?>>	getAttributeDefinitions()	Returns all attribute definitions as an unmodifiable collection.
@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).
@Nullable Class<?>	getCompileTimeClass()	Returns compile-time class, if this type has any.
Collection<QName>	getConfiguredAuxiliaryObjectClassNames()	Returns the names of auxiliary object classes that are "statically" defined for this object type (or object class, in the future).
@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.
@Nullable String	getDefaultNamespace()	When resolving unqualified names for items contained in this CTD, what should be the default namespace to look into at first.
@NotNull ResourceObjectTypeDefinitionType	getDefinitionBean()	Returns the "raw" configuration bean for this object type.
@NotNull List<? extends ItemDefinition<?>>	getDefinitions()	Returns definitions for all inner items.
@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()
@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()
String	getDocumentationPreview()	Returns only a first sentence of documentation.
<T extends CapabilityType> T	getEnabledCapability(@NotNull Class<T> capabilityClass, ResourceType resource)	Checks the presence of capability in: 1.
@Nullable QName	getExtensionForType()	If not null, indicates that this type defines the structure of `extension` element of a given type.
String	getHelp()	Returns help string.
@NotNull List<String>	getIgnoredNamespaces()	When resolving unqualified names for items contained in this CTD, what namespace(s) should be ignored.
Integer	getInstantiationOrder()
@Nullable String	getLifecycleState()	What lifecycle state is the (refined) object class or object type definition? Raw object class definition should always return `null` here.
ResourceObjectMultiplicityType	getObjectMultiplicity()
ResourcePasswordDefinitionType	getPasswordDefinition()	See ResourceObjectTypeDefinitionType.getCredentials()
String	getPlannedRemoval()	Version of data model in which the item is likely to be removed.
@NotNull Collection<ResourceAttributeDefinition<?>>	getPrimaryIdentifiers()	Returns the definition of primary identifier attributes of a resource object.
@NotNull List<QName>	getPrimaryIdentifiersNames()	Names of primary identifiers.
PrismContext	getPrismContext()
PrismObjectDefinition<ShadowType>	getPrismObjectDefinition()	Returns a prism definition for the prism object/objects carrying the resource object/objects.
ItemProcessing	getProcessing()	Level of processing (ignore, minimal, auto, full) for this item/type.
ProjectionPolicyType	getProjectionPolicy()
@NotNull Collection<ResourceObjectPattern>	getProtectedObjectPatterns()	Returns compiled patterns denoting protected objects.
List<SchemaMigration>	getSchemaMigrations()
SearchHierarchyScope	getSearchHierarchyScope()	Definition of search hierarchy scope.
@NotNull Collection<ResourceAttributeDefinition<?>>	getSecondaryIdentifiers()	Returns the definition of secondary identifier attributes of a resource object.
@NotNull List<QName>	getSecondaryIdentifiersNames()	Names of secondary identifiers.
ObjectReferenceType	getSecurityPolicyRef()
@NotNull Collection<TypeDefinition>	getStaticSubTypes()	Subtypes - but only these that are a part of the static schema.
@Nullable QName	getSuperType()	Name of super type of this complex type definition.
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	isContainerMarker()	Flag indicating whether this type was marked as "container" in the original schema.
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	isEmpty()	Returns true if there are no item definitions.
boolean	isExperimental()	Experimental functionality is not stable and it may be changed in any future release without any warning.
boolean	isListMarker()	True if the complex type definition is a type dedicated to hold so-called https://docs.evolveum.com/midpoint/devel/design/xml-json-yaml-vs-xnode-vs-internal-data/heterogeneous-lists/[heterogeneous lists].
boolean	isObjectMarker()	Flag indicating whether this type was marked as "object" in the original schema.
boolean	isReferenceMarker()	Flag indicating whether this type was marked as "objectReference" in the original schema.
boolean	isRuntimeSchema()	This means that this particular definition (of an item or of a type) is part of the runtime schema, e.g.
boolean	isXsdAnyMarker()	True if the complex type definition contains xsd:any (directly or indirectly).
void	merge(ComplexTypeDefinition otherComplexTypeDef)	Copies cloned definitions from the other type definition into this one.
protected void	performFreeze()
void	replaceDefinition(@NotNull QName itemName, @Nullable ItemDefinition<?> newDefinition)	Replaces a definition for given item name with a provided one.
void	revive(PrismContext prismContext)	TODO: Is revive necessary if prism context is static? TODO document (if it's found to be necessary)
<A> void	setAnnotation(QName qname, A value)
void	setDisplayNameAttributeName(QName name)
void	trimTo(@NotNull Collection<ItemPath> paths)	Trims the definition (and any definitions it refers to) to contain only items related to given 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

findAssociationDefinition, findAssociationDefinitionRequired, getAssociationDefinitions, getNamesOfAssociations, getNamesOfAssociationsWithInboundExpressions, getNamesOfAssociationsWithOutboundExpressions

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

containsAttributeDefinition, findAttributeDefinition, findAttributeDefinition, findAttributeDefinition, findAttributeDefinitionRequired, findAttributeDefinitionRequired, findAttributeDefinitionStrictlyRequired, findAttributeDefinitionStrictlyRequired, getAttributeDefinitions, getNamesOfAttributesWithInboundExpressions, getNamesOfAttributesWithOutboundExpressions, hasIndexOnlyAttributes

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

getXmlAttributeDefinitions, hasOperationalOnlyItems, hasSubstitutions, hasSubstitutions, isItemDefinitionRemoved, isStrictAnyMarker, itemOrSubstitution, substitution, toMutable

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

debugDump, debugDumpLazily, debugDumpLazily

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

debugDump, getMutabilityFlag, getSchemaRegistry, isIgnored

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

checkImmutable, checkMutable, freeze, isImmutable

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

getAllIdentifiers, getPrimaryIdentifierRequired, 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

createShadowSearchQuery, deepClone, getActivationBidirectionalMappingType, getActivationFetchStrategy, getDebugDumpClassName, getDescriptionAttribute, getDescriptionAttributeName, getDisplayNameAttribute, getDisplayNameAttributeName, getHumanReadableName, getNamingAttribute, getNamingAttributeName, getObjectClassDefinition, getObjectClassName, getPasswordFetchStrategy, getPasswordInbound, getPasswordOutbound, getRawObjectClassDefinition, getResourceOid, getTypeDefinition, getTypeIdentification, instantiate, isDefaultFor, matchesObjectClassName, replaceDefinition, toResourceAttributeContainerDefinition, toResourceAttributeContainerDefinition

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

isAssignableFrom

Field Detail

delineation

@NotNull
protected final @NotNull DeeplyFreezableReference<ResourceObjectTypeDelineation> delineation

"Compiled" object set delineation.

Method Detail

getAttributeDefinitions

@NotNull
public @NotNull List<? extends ResourceAttributeDefinition<?>> 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

getAssociationDefinitions

@NotNull
public @NotNull Collection<ResourceAssociationDefinition> getAssociationDefinitions()

Description copied from interface: AssociationDefinitionStore

Returns definitions of all associations as an unmodifiable collection. Note: these items are _not_ included in getDefinitions. (BTW, ResourceAssociationDefinition is not a subtype of ItemDefinition, not even of Definition.)

Specified by:

getAssociationDefinitions in interface AssociationDefinitionStore

getPrimaryIdentifiers

@NotNull
public @NotNull Collection<ResourceAttributeDefinition<?>> 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<ResourceAttributeDefinition<?>> 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: Definition

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 Definition

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

Specified by:

getDocumentation in interface Definition

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

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

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

createBlankShadow

public PrismObject<ShadowType> createBlankShadow(String resourceOid,
                                                 String tag)

Description copied from interface: ResourceObjectDefinition

Creates a blank ShadowType object, with the attributes container having appropriate definition.

Specified by:

createBlankShadow 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: ComplexTypeDefinition

Does a shallow clone of this definition (i.e. item definitions themselves are NOT cloned).

Specified by:

clone in interface ComplexTypeDefinition

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)

getPrismContext

public PrismContext getPrismContext()

Specified by:

getPrismContext in interface PrismContextSensitive

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

getCompileTimeClass

@Nullable
public @Nullable Class<?> getCompileTimeClass()

Description copied from interface: TypeDefinition

Returns compile-time class, if this type has any. For example, UserType.class, ObjectType.class, ExtensionType.class.

Specified by:

getCompileTimeClass in interface TypeDefinition

getSuperType

@Nullable
public @Nullable QName getSuperType()

Description copied from interface: TypeDefinition

Name of super type of this complex type definition. E.g. c:ObjectType is a super type for c:FocusType which is a super type for c:UserType. Or (more complex example) ri:ShadowAttributesType is a super type of ri:AccountObjectClass. (TODO is this really true?)

Specified by:

getSuperType in interface TypeDefinition

getStaticSubTypes

@NotNull
public @NotNull Collection<TypeDefinition> getStaticSubTypes()

Description copied from interface: TypeDefinition

Subtypes - but only these that are a part of the static schema. A little bit experimental. :)

Specified by:

getStaticSubTypes in interface TypeDefinition

getInstantiationOrder

public Integer getInstantiationOrder()

Specified by:

getInstantiationOrder in interface TypeDefinition

canRepresent

public boolean canRepresent(QName typeName)

Specified by:

canRepresent in interface TypeDefinition

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: ComplexTypeDefinition

Returns definitions for all inner items. These are of type ItemDefinition. However, very often subtypes of this type are used, e.g. ResourceAttributeDefinition, RefinedAttributeDefinition, LayerRefinedAttributeDefinition, and so on. The returned structure is a List because the ordering is significant, e.g. for serialization purposes. The list is unmodifiable.

Specified by:

getDefinitions in interface ComplexTypeDefinition

Specified by:

getDefinitions in interface LocalItemDefinitionStore

getExtensionForType

@Nullable
public @Nullable QName getExtensionForType()

Description copied from interface: ComplexTypeDefinition

If not null, indicates that this type defines the structure of `extension` element of a given type. E.g. `getExtensionForType()` == `c:UserType` means that this complex type defines structure of `extension` elements of `UserType` objects.

Specified by:

getExtensionForType in interface ComplexTypeDefinition

isReferenceMarker

public boolean isReferenceMarker()

Description copied from interface: ComplexTypeDefinition

Flag indicating whether this type was marked as "objectReference" in the original schema.

Specified by:

isReferenceMarker in interface ComplexTypeDefinition

isContainerMarker

public boolean isContainerMarker()

Description copied from interface: ComplexTypeDefinition

Flag indicating whether this type was marked as "container" in the original schema. Does not provide any information to schema processing logic, just conveys the marker from original schema so we can serialize and deserialize the schema without loss of information.

Specified by:

isContainerMarker in interface ComplexTypeDefinition

isObjectMarker

public boolean isObjectMarker()

Description copied from interface: ComplexTypeDefinition

Flag indicating whether this type was marked as "object" in the original schema. Does not provide any information to schema processing logic, just conveys the marker from original schema so we can serialized and deserialize the schema without loss of information.

Specified by:

isObjectMarker in interface ComplexTypeDefinition

isXsdAnyMarker

public boolean isXsdAnyMarker()

Description copied from interface: ComplexTypeDefinition

True if the complex type definition contains xsd:any (directly or indirectly).

Specified by:

isXsdAnyMarker in interface ComplexTypeDefinition

isListMarker

public boolean isListMarker()

Description copied from interface: ComplexTypeDefinition

True if the complex type definition is a type dedicated to hold so-called https://docs.evolveum.com/midpoint/devel/design/xml-json-yaml-vs-xnode-vs-internal-data/heterogeneous-lists/[heterogeneous lists]. See also DOMUtil.IS_LIST_ATTRIBUTE_NAME and ItemDefinition.isHeterogeneousListItem().

Specified by:

isListMarker in interface ComplexTypeDefinition

getDefaultNamespace

@Nullable
public @Nullable String getDefaultNamespace()

Description copied from interface: ComplexTypeDefinition

When resolving unqualified names for items contained in this CTD, what should be the default namespace to look into at first. Currently does NOT apply recursively (to inner CTDs). Set by parsing `defaultNamespace` XSD annotation.

Specified by:

getDefaultNamespace in interface ComplexTypeDefinition

getIgnoredNamespaces

@NotNull
public @NotNull List<String> getIgnoredNamespaces()

Description copied from interface: ComplexTypeDefinition

When resolving unqualified names for items contained in this CTD, what namespace(s) should be ignored. Names in this list are interpreted as a namespace prefixes. Currently does NOT apply recursively (to inner CTDs). Set by parsing `ignoredNamespace` XSD annotations.

Specified by:

getIgnoredNamespaces in interface ComplexTypeDefinition

merge

public void merge(ComplexTypeDefinition otherComplexTypeDef)

Description copied from interface: ComplexTypeDefinition

Copies cloned definitions from the other type definition into this one. (TODO remove from the interface?)

Specified by:

merge in interface ComplexTypeDefinition

isEmpty

public boolean isEmpty()

Description copied from interface: ComplexTypeDefinition

Returns true if there are no item definitions.

Specified by:

isEmpty in interface ComplexTypeDefinition

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 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 Definition

isExperimental

public boolean isExperimental()

Description copied from interface: Definition

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 Definition

getPlannedRemoval

public String getPlannedRemoval()

Description copied from interface: Definition

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 Definition

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 Definition

isEmphasized

public boolean isEmphasized()

Description copied from interface: Definition

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.

Specified by:

isEmphasized in interface Definition

getDisplayOrder

public Integer getDisplayOrder()

Description copied from interface: Definition

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 Definition

getHelp

public String getHelp()

Description copied from interface: Definition

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 Definition

Returns:

help string or catalog key

getDocumentationPreview

public String getDocumentationPreview()

Description copied from interface: Definition

Returns only a first sentence of documentation.

Specified by:

getDocumentationPreview in interface Definition

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

setAnnotation

public <A> void setAnnotation(QName qname,
                              A value)

Specified by:

setAnnotation 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 Definition

getDiagrams

public List<ItemDiagramSpecification> getDiagrams()

Specified by:

getDiagrams in interface Definition

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

forLayer

public ResourceObjectDefinition forLayer(@NotNull
                                         @NotNull LayerType layer)

Description copied from interface: ResourceObjectDefinition

Creates a layer-specific version of this definition.

Specified by:

forLayer in interface ResourceObjectDefinition

cloneInLayer

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

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)

getProcessing

public ItemProcessing getProcessing()

Description copied from interface: Definition

Level of processing (ignore, minimal, auto, full) for this item/type.

Specified by:

getProcessing in interface Definition

getConfiguredAuxiliaryObjectClassNames

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

Description copied from interface: ComplexTypeDefinition

Trims the definition (and any definitions it refers to) to contain only items related to given paths. USE WITH CARE. Be sure no shared definitions would be affected by this operation!

Specified by:

trimTo in interface ComplexTypeDefinition

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 "raw" configuration bean for this object type. BEWARE: In the case of inherited object types, this is only the partial information. (Parts inherited from the parents are not returned.)

Specified by:

getDefinitionBean in interface ResourceObjectDefinition

setDisplayNameAttributeName

public void setDisplayNameAttributeName(QName name)