com.evolveum.midpoint.prism

Interface Definition

All Superinterfaces:

DebugDumpable, Revivable, Serializable

All Known Subinterfaces:

ComplexTypeDefinition, CompositeRefinedObjectClassDefinition, ItemDefinition<I>, LayerRefinedAttributeDefinition<T>, LayerRefinedObjectClassDefinition, ObjectClassComplexTypeDefinition, PrismContainerDefinition<C>, PrismObjectDefinition<O>, PrismPropertyDefinition<T>, PrismReferenceDefinition, RefinedAttributeDefinition<T>, RefinedObjectClassDefinition, ResourceAttributeContainerDefinition, ResourceAttributeDefinition<T>, SimpleTypeDefinition, TypeDefinition

All Known Implementing Classes:

ComplexTypeDefinitionImpl, CompositeRefinedObjectClassDefinitionImpl, DefinitionImpl, ItemDefinitionImpl, LayerRefinedAttributeDefinitionImpl, LayerRefinedObjectClassDefinitionImpl, ObjectClassComplexTypeDefinitionImpl, PrismContainerDefinitionImpl, PrismObjectDefinitionImpl, PrismPropertyDefinitionImpl, PrismReferenceDefinitionImpl, RefinedAttributeDefinitionImpl, RefinedObjectClassDefinitionImpl, ResourceAttributeContainerDefinitionImpl, ResourceAttributeDefinitionImpl, SimpleTypeDefinitionImpl, TypeDefinitionImpl

public interface Definition
extends Serializable, DebugDumpable, Revivable

Author:

mederly

Field Summary

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

INDENT_STRING

Method Summary

Modifier and Type	Method and Description
Definition	clone()
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.
String	getHelp() Returns help string.
PrismContext	getPrismContext()
default SchemaRegistry	getSchemaRegistry()
Class	getTypeClass()
Class	getTypeClassIfKnown()
QName	getTypeName() Returns a name of the type for this definition.
boolean	isAbstract()
boolean	isDeprecated()
boolean	isEmphasized() True for definitions that are more important than others and that should be emphasized during presentation.
boolean	isIgnored() Item definition that has this flag set should be ignored by any processing.
boolean	isRuntimeSchema() This means that the entities described by this schema (items, complex types) or their content is not defined by fixed (compile-time) schema.

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

debugDump, debugDump

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

revive

Method Detail

getTypeName

@NotNull
QName getTypeName()

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)

Returns:

the type name

isRuntimeSchema

boolean isRuntimeSchema()

This means that the entities described by this schema (items, complex types) or their content is not defined by fixed (compile-time) schema. I.e. it is known only at run time. Some examples for "false" value: - c:user, c:UserType - statically defined type with statically defined content. Some examples for "true" value: - c:extension, c:ExtensionType - although the entity itself (item, type) are defined in the static schema, their content is not known at compile time; - c:attributes, c:ShadowAttributeType - the same as extension/ExtensionType; - ext:weapon (of type xsd:string) - even if the content is statically defined, the definition of the item itself is not known at compile time; - ri:inetOrgPerson, ext:LocationsType, ext:locations - both the entity and their content are known at run time only. TODO clarify the third point; provide some tests for the 3rd and 4th point

isIgnored

boolean isIgnored()

Item definition that has this flag set should be ignored by any processing. The ignored item is still part of the schema. Item instances may appear in the serialized data formats (e.g. XML) or data store and the parser should not raise an error if it encounters them. But any high-level processing code should ignore presence of this item. E.g. it should not be displayed to the user, should not be present in transformed data structures, etc. Note that the same item can be ignored at higher layer (e.g. presentation) but not ignored at lower layer (e.g. model). This works by presenting different item definitions for these layers (see LayerRefinedAttributeDefinition). Semantics of this flag for complex type definitions is to be defined yet.

isAbstract

boolean isAbstract()

isDeprecated

boolean isDeprecated()

isEmphasized

boolean isEmphasized()

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.

getDisplayName

String getDisplayName()

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.

Returns:

display name string or catalog key

getDisplayOrder

Integer getDisplayOrder()

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.

getHelp

String getHelp()

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.

Returns:

help string or catalog key

getDocumentation

String getDocumentation()

getDocumentationPreview

String getDocumentationPreview()

Returns only a first sentence of documentation.

getPrismContext

PrismContext getPrismContext()

getSchemaRegistry

default SchemaRegistry getSchemaRegistry()

getTypeClassIfKnown

Class getTypeClassIfKnown()

getTypeClass

Class getTypeClass()

clone

@NotNull
Definition clone()