Package com.evolveum.midpoint.gui.impl.prism.wrapper

Class ValueMetadataWrapperImpl

java.lang.Object

com.evolveum.midpoint.gui.impl.prism.wrapper.ValueMetadataWrapperImpl

All Implemented Interfaces:

ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>, PrismContainerWrapper<ValueMetadataType>, Definition, Freezable, ItemDefinition<PrismContainer<ValueMetadataType>>, LocalItemDefinitionStore, PrismContainerDefinition<ValueMetadataType>, PrismContextSensitive, PrismItemAccessDefinition, Revivable, SmartVisitable<Definition>, Visitable<Definition>, DebugDumpable, Serializable, Cloneable

public class ValueMetadataWrapperImpl
extends Object
implements PrismContainerWrapper<ValueMetadataType>

See Also:

• Serialized Form

Nested Class Summary

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

PrismItemAccessDefinition.Mutable

Field Summary

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

INDENT_STRING

Constructor Summary

Constructors

Constructor	Description
ValueMetadataWrapperImpl(PrismContainerWrapper<ValueMetadataType> metadataValueWrapper)

Method Summary

Modifier and Type	Method	Description
void	accept(Visitor<Definition> visitor)
boolean	accept(Visitor<Definition> visitor, SmartVisitation<Definition> visitation)
<PV extends PrismValue> void	add(PV newValueWrapper, ModelServiceLocator locator)
void	adoptElementDefinitionFrom(ItemDefinition<?> otherDef)	Transfers selected parts of the definition (currently item name, min/max occurs) from another definition.
boolean	canAdd()	Returns true if this item can be added: it can be part of an object that is created.
boolean	canBeDefinitionOf(PrismContainer<ValueMetadataType> item)	TODO document
boolean	canBeDefinitionOf(PrismValue pvalue)	TODO document
boolean	canModify()	Returns true if this item can be modified (updated).
boolean	canRead()	Returns true if this item can be read (displayed).
boolean	canRepresent(@NotNull QName type)	TODO
boolean	checkRequired()
@NotNull PrismContainerDefinition<ValueMetadataType>	clone()
PrismContainerDefinition<ValueMetadataType>	cloneWithReplacedDefinition(QName itemName, ItemDefinition<?> newDefinition)	TODO
@NotNull ContainerDelta<ValueMetadataType>	createEmptyDelta(ItemPath path)	Creates an empty delta (with appropriate implementation class), pointing to this item definition, with a given path.
PrismContainerValue<ValueMetadataType>	createValue()	TODO
String	debugDump(int indent)
void	debugDumpShortToString(StringBuilder sb)	Used in debugDumping items.
ItemDefinition<PrismContainer<ValueMetadataType>>	deepClone(@NotNull DeepCloneOperation operation)	TODO document
<T extends Containerable> PrismContainerWrapper<T>	findContainer(ItemPath path)
<T extends Containerable> PrismContainerWrapper<T>	findContainer(String identifier)
<T extends Containerable> PrismContainerValueWrapper<T>	findContainerValue(ItemPath path)
<IW extends ItemWrapper> IW	findItem(ItemPath path, Class<IW> type)
<T extends ItemDefinition<?>> T	findItemDefinition(@NotNull ItemPath path, @NotNull Class<T> clazz)	Used to find a matching item definition _within_ this definition.
ItemStatus	findObjectStatus()
<OW extends PrismObjectWrapper<O>, O extends ObjectType> OW	findObjectWrapper()
<X> PrismPropertyWrapper<X>	findProperty(ItemPath propertyPath)
<R extends Referencable> PrismReferenceWrapper<R>	findReference(ItemPath path)
void	freeze()
<A> A	getAnnotation(QName qname)	Returns generic definition annotation.
@Nullable Map<QName,Object>	getAnnotations()	Returns all annotations, as unmodifiable map.
List<PrismContainerDefinition<? extends Containerable>>	getChildContainers()
List<? extends ItemDefinition>	getChildNonContainers()
Class<ValueMetadataType>	getCompileTimeClass()	Static (compile-time) class holding the container values.
ComplexTypeDefinition	getComplexTypeDefinition()	Definition of the container values.
@NotNull List<? extends ItemDefinition<?>>	getDefinitions()	Returns a list of item definitions in this container.
<D extends ItemDelta<? extends PrismValue, ? extends ItemDefinition>> Collection<D>	getDelta()
String	getDeprecatedSince()
List<ItemDiagramSpecification>	getDiagrams()
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.
ExpressionType	getFormComponentValidator()
String	getHelp()	Returns help string.
String	getIdentifier()
PrismContainer<ValueMetadataType>	getItem()
@NotNull ItemName	getItemName()	Gets the "canonical" name of the item for the definition.
int	getMaxOccurs()	Return the number of maximal value occurrences.
int	getMinOccurs()	Return the number of minimal value occurrences.
PrismContainerValueWrapper<?>	getParent()
<C extends Containerable> PrismContainerValueWrapper<C>	getParentContainerValue(Class<? extends C> parentClass)
ItemPath	getPath()
String	getPlannedRemoval()	Version of data model in which the item is likely to be removed.
PrismContext	getPrismContext()
ItemProcessing	getProcessing()	Level of processing (ignore, minimal, auto, full) for this item/type.
List<PrismPropertyDefinition<?>>	getPropertyDefinitions()	Returns set of property definitions.
String	getRemovedSince()
List<SchemaMigration>	getSchemaMigrations()
PrismContainerWrapper<? extends Containerable>	getSelectedChild()
ItemStatus	getStatus()
QName	getSubstitutionHead()	Returns the name of an element this one can be substituted for (e.g.
Class<ValueMetadataType>	getTypeClass()	Returns a compile-time class that is used to represent items.
@NotNull QName	getTypeName()	Returns a name of the type for this definition.
PrismContainerValueWrapper<ValueMetadataType>	getValue()
PrismReferenceValue	getValueEnumerationRef()	Reference to an object that directly or indirectly represents possible values for this item.
List<PrismContainerValueWrapper<ValueMetadataType>>	getValues()
UserInterfaceElementVisibilityType	getVisibleOverwrite()
@NotNull PrismContainer<ValueMetadataType>	instantiate()	Create an item instance.
@NotNull PrismContainer<ValueMetadataType>	instantiate(QName name)	Create an item instance.
boolean	isAbstract()	For types: is the type abstract so that it should not be instantiated directly? For items: TODO
boolean	isColumn()
boolean	isDeprecated()
boolean	isDynamic()	Returns true if definition was created during the runtime based on a dynamic information such as xsi:type attributes in XML.
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()	TODO
boolean	isExpanded()
boolean	isExperimental()	Experimental functionality is not stable and it may be changed in any future release without any warning.
boolean	isHeterogeneousListItem()	Can be used in heterogeneous lists as a list item.
boolean	isIgnored()	Item definition that has this flag set should be ignored by any processing.
boolean	isImmutable()
boolean	isIndexOnly()	If true, this item is not stored in XML representation in repo.
boolean	isInherited()	Whether the item is inherited from a supertype.
boolean	isMetadata()
boolean	isOperational()	Marks operational item.
boolean	isProcessProvenanceMetadata()
boolean	isReadOnly()
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	isShowEmpty()
boolean	isShowInVirtualContainer()
boolean	isShowMetadataDetails()
boolean	isValidated()
boolean	isValidFor(@NotNull QName elementQName, @NotNull Class<? extends ItemDefinition<?>> clazz, boolean caseInsensitive)	Returns true if this definition is valid for given element name and definition class, in either case-sensitive (the default) or case-insensitive way.
boolean	isVirtual()
boolean	isVisible(PrismContainerValueWrapper<?> parentContainer, ItemVisibilityHandler visibilityHandler)
void	remove(PrismContainerValueWrapper<ValueMetadataType> valueWrapper, ModelServiceLocator locator)
void	removeAll(ModelServiceLocator locator)
void	replaceDefinition(QName itemName, ItemDefinition<?> newDefinition)	TODO
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	setColumn(boolean column)
void	setExpanded(boolean expanded)
void	setIdentifier(String identifier)
void	setMetadata(boolean metadata)
void	setProcessProvenanceMetadata(boolean processProvenanceMetadata)
void	setReadOnly(boolean readOnly)
void	setShowEmpty(boolean isShowEmpty, boolean recursive)
void	setShowInVirtualContainer(boolean showInVirtualContainer)
void	setShowMetadataDetails(boolean showMetadataDetails)
void	setValidated(boolean validated)
void	setVirtual(boolean virtual)
void	setVisibleOverwrite(UserInterfaceElementVisibilityType visible)
MutablePrismContainerDefinition<ValueMetadataType>	toMutable()	Returns an interface to mutate this definition.
void	unselect()

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

debugDump, debugDumpLazily, debugDumpLazily

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

debugDump, getMutabilityFlag, getSchemaRegistry

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

checkImmutable, checkMutable

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

isMandatory, isMultiValue, isOptional, isSearchable, isSingleValue

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

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

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

getAlwaysUseForEquals, getItemNames, isAlwaysUseForEquals, isCompletelyDefined, structuredType

Methods inherited from interface com.evolveum.midpoint.gui.api.prism.wrapper.PrismContainerWrapper

cloneVirtualContainerWithNewValue

Constructor Details

ValueMetadataWrapperImpl

public ValueMetadataWrapperImpl(PrismContainerWrapper<ValueMetadataType> metadataValueWrapper)

Method Details

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

isIgnored

public boolean isIgnored()

Description copied from interface: Definition

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.

Specified by:

isIgnored in interface 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

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

isRemoved

public boolean isRemoved()

Specified by:

isRemoved in interface Definition

getRemovedSince

public String getRemovedSince()

Specified by:

getRemovedSince 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

getDisplayName

public 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

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

getDocumentation

public String getDocumentation()

Specified by:

getDocumentation in interface Definition

getDocumentationPreview

public String getDocumentationPreview()

Description copied from interface: Definition

Returns only a first sentence of documentation.

Specified by:

getDocumentationPreview in interface Definition

isExpanded

public boolean isExpanded()

Specified by:

isExpanded in interface PrismContainerWrapper<ValueMetadataType>

getStatus

public ItemStatus getStatus()

Specified by:

getStatus in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

Specified by:

getStatus in interface PrismContainerWrapper<ValueMetadataType>

getCompileTimeClass

public Class<ValueMetadataType> getCompileTimeClass()

Description copied from interface: PrismContainerDefinition

Static (compile-time) class holding the container values. May be null. (Let's not mark it as @Nullable to avoid lots of warnings.)

Specified by:

getCompileTimeClass in interface PrismContainerDefinition<ValueMetadataType>

getComplexTypeDefinition

public ComplexTypeDefinition getComplexTypeDefinition()

Description copied from interface: PrismContainerDefinition

Definition of the container values. May be null. (Let's not mark it as @Nullable to avoid lots of warnings.) Note that individual values can hold their own (more specific) complex type definitions.

Specified by:

getComplexTypeDefinition in interface PrismContainerDefinition<ValueMetadataType>

getDefinitions

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

Description copied from interface: PrismContainerDefinition

Returns a list of item definitions in this container. It is intentionally a List because it is ordered. (To provide standard format for serialization.) Usually obtained from ComplexTypeDefinition. So please do not modify the content of the list!

Specified by:

getDefinitions in interface LocalItemDefinitionStore

Specified by:

getDefinitions in interface PrismContainerDefinition<ValueMetadataType>

getPropertyDefinitions

public List<PrismPropertyDefinition<?>> getPropertyDefinitions()

Description copied from interface: PrismContainerDefinition

Returns set of property definitions. The set contains all property definitions of all types that were parsed. Order of definitions is insignificant. The returned set is immutable! All changes may be lost.

Specified by:

getPropertyDefinitions in interface PrismContainerDefinition<ValueMetadataType>

Returns:

set of definitions

getItemName

@NotNull
public @NotNull ItemName getItemName()

Description copied from interface: ItemDefinition

Gets the "canonical" name of the item for the definition. Should be qualified, if at all possible.

Specified by:

getItemName in interface ItemDefinition<PrismContainer<ValueMetadataType>>

getMinOccurs

public int getMinOccurs()

Description copied from interface: ItemDefinition

Return the number of minimal value occurrences.

Specified by:

getMinOccurs in interface ItemDefinition<PrismContainer<ValueMetadataType>>

getMaxOccurs

public int getMaxOccurs()

Description copied from interface: ItemDefinition

Return the number of maximal value occurrences. Any negative number means "unbounded".

Specified by:

getMaxOccurs in interface ItemDefinition<PrismContainer<ValueMetadataType>>

isOperational

public boolean isOperational()

Description copied from interface: ItemDefinition

Marks operational item. Operational properties are auxiliary data (or meta-data) that are usually not modifiable by the end user. They are generated and maintained by the system. Operational items are also not usually displayed unless it is explicitly requested. The example of operational items are modification timestamps, create timestamps, user that made the last change, etc. They are also treated in a special way when comparing values. See ParameterizedEquivalenceStrategy.

Specified by:

isOperational in interface ItemDefinition<PrismContainer<ValueMetadataType>>

isIndexOnly

public boolean isIndexOnly()

Description copied from interface: ItemDefinition

If true, this item is not stored in XML representation in repo. TODO better name

Specified by:

isIndexOnly in interface ItemDefinition<PrismContainer<ValueMetadataType>>

isInherited

public boolean isInherited()

Description copied from interface: ItemDefinition

Whether the item is inherited from a supertype.

Specified by:

isInherited in interface ItemDefinition<PrismContainer<ValueMetadataType>>

isDynamic

public boolean isDynamic()

Description copied from interface: ItemDefinition

Returns true if definition was created during the runtime based on a dynamic information such as xsi:type attributes in XML. This means that the definition needs to be stored alongside the data to have a successful serialization "roundtrip". The definition is not part of any schema and therefore cannot be determined. It may even be different for every instance of the associated item (element name).

Specified by:

isDynamic in interface ItemDefinition<PrismContainer<ValueMetadataType>>

canRead

public boolean canRead()

Description copied from interface: PrismItemAccessDefinition

Returns true if this item can be read (displayed). In case of containers this flag is, strictly speaking, not applicable. Container is an empty shell. What matters is access to individual sub-item. However, for containers this value has a "hint" meaning. It means that the container itself contains something that is readable. Which can be used as a hint by the presentation to display container label or block. This usually happens if the container contains at least one readable item. This does NOT mean that also all the container items can be displayed. The sub-item permissions are controlled by similar properties on the items. This property only applies to the container itself: the "shell" of the container.

Note: It was considered to use a different meaning for this flag - a meaning that would allow canRead()=false containers to have readable items. However, this was found not to be very useful. Therefore the "something readable inside" meaning was confirmed instead.

Specified by:

canRead in interface PrismItemAccessDefinition

canModify

public boolean canModify()

Description copied from interface: PrismItemAccessDefinition

Returns true if this item can be modified (updated). In case of containers this means that the container itself should be displayed in modification forms E.g. that the container label or block should be displayed. This usually happens if the container contains at least one modifiable item. This does NOT mean that also all the container items can be modified. The sub-item permissions are controlled by similar properties on the items. This property only applies to the container itself: the "shell" of the container.

Specified by:

canModify in interface PrismItemAccessDefinition

canAdd

public boolean canAdd()

Description copied from interface: PrismItemAccessDefinition

Returns true if this item can be added: it can be part of an object that is created. In case of containers this means that the container itself should be displayed in creation forms E.g. that the container label or block should be displayed. This usually happens if the container contains at least one createable item. This does NOT mean that also all the container items can be created. The sub-item permissions are controlled by similar properties on the items. This property only applies to the container itself: the "shell" of the container.

Specified by:

canAdd in interface PrismItemAccessDefinition

getSubstitutionHead

public QName getSubstitutionHead()

Description copied from interface: ItemDefinition

Returns the name of an element this one can be substituted for (e.g. c:user -> c:object, s:pipeline -> s:expression, etc). EXPERIMENTAL

Specified by:

getSubstitutionHead in interface ItemDefinition<PrismContainer<ValueMetadataType>>

isHeterogeneousListItem

public boolean isHeterogeneousListItem()

Description copied from interface: ItemDefinition

Can be used in heterogeneous lists as a list item. EXPERIMENTAL.

Specified by:

isHeterogeneousListItem in interface ItemDefinition<PrismContainer<ValueMetadataType>>

getValueEnumerationRef

public PrismReferenceValue getValueEnumerationRef()

Description copied from interface: ItemDefinition

Reference to an object that directly or indirectly represents possible values for this item. We do not define here what exactly the object has to be. It can be a lookup table, script that dynamically produces the values or anything similar. The object must produce the values of the correct type for this item otherwise an error occurs.

Specified by:

getValueEnumerationRef in interface ItemDefinition<PrismContainer<ValueMetadataType>>

isValidFor

public boolean isValidFor(@NotNull
 @NotNull QName elementQName,
 @NotNull
 @NotNull Class<? extends ItemDefinition<?>> clazz,
 boolean caseInsensitive)

Description copied from interface: ItemDefinition

Returns true if this definition is valid for given element name and definition class, in either case-sensitive (the default) or case-insensitive way. Used e.g. for "slow" path lookup where we iterate over all definitions in a complex type.

Specified by:

isValidFor in interface ItemDefinition<PrismContainer<ValueMetadataType>>

adoptElementDefinitionFrom

public void adoptElementDefinitionFrom(ItemDefinition<?> otherDef)

Description copied from interface: ItemDefinition

Transfers selected parts of the definition (currently item name, min/max occurs) from another definition. TODO used only on few places, consider removing

Specified by:

adoptElementDefinitionFrom in interface ItemDefinition<PrismContainer<ValueMetadataType>>

instantiate

@NotNull
public @NotNull PrismContainer<ValueMetadataType> instantiate()
                                                       throws SchemaException

Description copied from interface: ItemDefinition

Create an item instance. Definition name or default name will be used as an element name for the instance. The instance will otherwise be empty.

Specified by:

instantiate in interface ItemDefinition<PrismContainer<ValueMetadataType>>

Throws:

SchemaException

instantiate

@NotNull
public @NotNull PrismContainer<ValueMetadataType> instantiate(QName name)
                                                       throws SchemaException

Description copied from interface: ItemDefinition

Create an item instance. Definition name will use provided name. for the instance. The instance will otherwise be empty.

Specified by:

instantiate in interface ItemDefinition<PrismContainer<ValueMetadataType>>

Throws:

SchemaException

findItemDefinition

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

Description copied from interface: ItemDefinition

Used to find a matching item definition _within_ this definition. Treats e.g. de-referencing in prism references.

Specified by:

findItemDefinition in interface ItemDefinition<PrismContainer<ValueMetadataType>>

Specified by:

findItemDefinition in interface LocalItemDefinitionStore

createEmptyDelta

@NotNull
public @NotNull ContainerDelta<ValueMetadataType> createEmptyDelta(ItemPath path)

Description copied from interface: ItemDefinition

Creates an empty delta (with appropriate implementation class), pointing to this item definition, with a given path.

Specified by:

createEmptyDelta in interface ItemDefinition<PrismContainer<ValueMetadataType>>

Specified by:

createEmptyDelta in interface PrismContainerDefinition<ValueMetadataType>

clone

@NotNull
public @NotNull PrismContainerDefinition<ValueMetadataType> clone()

Specified by:

clone in interface Definition

Specified by:

clone in interface ItemDefinition<PrismContainer<ValueMetadataType>>

Specified by:

clone in interface PrismContainerDefinition<ValueMetadataType>

Overrides:

clone in class Object

deepClone

public ItemDefinition<PrismContainer<ValueMetadataType>> deepClone(@NotNull
 @NotNull DeepCloneOperation operation)

Description copied from interface: ItemDefinition

TODO document

Specified by:

deepClone in interface ItemDefinition<PrismContainer<ValueMetadataType>>

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

debugDumpShortToString

public void debugDumpShortToString(StringBuilder sb)

Description copied from interface: ItemDefinition

Used in debugDumping items. Does not need to have name in it as item already has it. Does not need to have class as that is just too much info that is almost anytime pretty obvious anyway.

Specified by:

debugDumpShortToString in interface ItemDefinition<PrismContainer<ValueMetadataType>>

canBeDefinitionOf

public boolean canBeDefinitionOf(PrismContainer<ValueMetadataType> item)

Description copied from interface: ItemDefinition

TODO document

Specified by:

canBeDefinitionOf in interface ItemDefinition<PrismContainer<ValueMetadataType>>

canBeDefinitionOf

public boolean canBeDefinitionOf(PrismValue pvalue)

Description copied from interface: ItemDefinition

TODO document

Specified by:

canBeDefinitionOf in interface ItemDefinition<PrismContainer<ValueMetadataType>>

cloneWithReplacedDefinition

public PrismContainerDefinition<ValueMetadataType> cloneWithReplacedDefinition(QName itemName,
 ItemDefinition<?> newDefinition)

Description copied from interface: PrismContainerDefinition

TODO

Specified by:

cloneWithReplacedDefinition in interface PrismContainerDefinition<ValueMetadataType>

replaceDefinition

public void replaceDefinition(QName itemName,
 ItemDefinition<?> newDefinition)

Description copied from interface: PrismContainerDefinition

TODO

Specified by:

replaceDefinition in interface PrismContainerDefinition<ValueMetadataType>

createValue

public PrismContainerValue<ValueMetadataType> createValue()

Description copied from interface: PrismContainerDefinition

TODO

Specified by:

createValue in interface PrismContainerDefinition<ValueMetadataType>

isEmpty

public boolean isEmpty()

Description copied from interface: PrismContainerDefinition

TODO

Specified by:

isEmpty in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

Specified by:

isEmpty in interface PrismContainerDefinition<ValueMetadataType>

canRepresent

public boolean canRepresent(@NotNull
 @NotNull QName type)

Description copied from interface: PrismContainerDefinition

TODO

Specified by:

canRepresent in interface PrismContainerDefinition<ValueMetadataType>

toMutable

public MutablePrismContainerDefinition<ValueMetadataType> toMutable()

Description copied from interface: Definition

Returns an interface to mutate this definition.

Specified by:

toMutable in interface Definition

Specified by:

toMutable in interface ItemDefinition<PrismContainer<ValueMetadataType>>

Specified by:

toMutable in interface PrismContainerDefinition<ValueMetadataType>

getTypeClass

public Class<ValueMetadataType> 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

Specified by:

getTypeClass in interface PrismContainerDefinition<ValueMetadataType>

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

remove

public void remove(PrismContainerValueWrapper<ValueMetadataType> valueWrapper,
 ModelServiceLocator locator)
            throws SchemaException

Specified by:

remove in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

Throws:

SchemaException

removeAll

public void removeAll(ModelServiceLocator locator)
               throws SchemaException

Specified by:

removeAll in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

Throws:

SchemaException

add

public <PV extends PrismValue> void add(PV newValueWrapper,
 ModelServiceLocator locator)
                                 throws SchemaException

Specified by:

add in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

Throws:

SchemaException

setVirtual

public void setVirtual(boolean virtual)

Specified by:

setVirtual in interface PrismContainerWrapper<ValueMetadataType>

setExpanded

public void setExpanded(boolean expanded)

Specified by:

setExpanded in interface PrismContainerWrapper<ValueMetadataType>

findContainer

public <T extends Containerable>
PrismContainerWrapper<T> findContainer(ItemPath path)
                                throws SchemaException

Specified by:

findContainer in interface PrismContainerWrapper<ValueMetadataType>

Throws:

SchemaException

findContainer

public <T extends Containerable>
PrismContainerWrapper<T> findContainer(String identifier)

Specified by:

findContainer in interface PrismContainerWrapper<ValueMetadataType>

findProperty

public <X> PrismPropertyWrapper<X> findProperty(ItemPath propertyPath)
                                         throws SchemaException

Specified by:

findProperty in interface PrismContainerWrapper<ValueMetadataType>

Throws:

SchemaException

findReference

public <R extends Referencable>
PrismReferenceWrapper<R> findReference(ItemPath path)
                                throws SchemaException

Specified by:

findReference in interface PrismContainerWrapper<ValueMetadataType>

Throws:

SchemaException

findContainerValue

public <T extends Containerable>
PrismContainerValueWrapper<T> findContainerValue(ItemPath path)
                                          throws SchemaException

Specified by:

findContainerValue in interface PrismContainerWrapper<ValueMetadataType>

Throws:

SchemaException

findItem

public <IW extends ItemWrapper> IW findItem(ItemPath path,
 Class<IW> type)
                                     throws SchemaException

Specified by:

findItem in interface PrismContainerWrapper<ValueMetadataType>

Throws:

SchemaException

getSelectedChild

public PrismContainerWrapper<? extends Containerable> getSelectedChild()

Specified by:

getSelectedChild in interface PrismContainerWrapper<ValueMetadataType>

setIdentifier

public void setIdentifier(String identifier)

Specified by:

setIdentifier in interface PrismContainerWrapper<ValueMetadataType>

getIdentifier

public String getIdentifier()

Specified by:

getIdentifier in interface PrismContainerWrapper<ValueMetadataType>

getPath

public ItemPath getPath()

Specified by:

getPath in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

isReadOnly

public boolean isReadOnly()

Specified by:

isReadOnly in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

setReadOnly

public void setReadOnly(boolean readOnly)

Specified by:

setReadOnly in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

getFormComponentValidator

public ExpressionType getFormComponentValidator()

Specified by:

getFormComponentValidator in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

getValues

public List<PrismContainerValueWrapper<ValueMetadataType>> getValues()

Specified by:

getValues in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

getValue

public PrismContainerValueWrapper<ValueMetadataType> getValue()
                                                       throws SchemaException

Specified by:

getValue in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

Throws:

SchemaException

getItem

public PrismContainer<ValueMetadataType> getItem()

Specified by:

getItem in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

isColumn

public boolean isColumn()

Specified by:

isColumn in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

setColumn

public void setColumn(boolean column)

Specified by:

setColumn in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

getDelta

public <D extends ItemDelta<? extends PrismValue,
? extends ItemDefinition>>
Collection<D> getDelta()
                throws SchemaException

Specified by:

getDelta in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

Throws:

SchemaException

findObjectStatus

public ItemStatus findObjectStatus()

Specified by:

findObjectStatus in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

findObjectWrapper

public <OW extends PrismObjectWrapper<O>,
O extends ObjectType>
OW findObjectWrapper()

Specified by:

findObjectWrapper in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

isShowEmpty

public boolean isShowEmpty()

Specified by:

isShowEmpty in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

setShowEmpty

public void setShowEmpty(boolean isShowEmpty,
 boolean recursive)

Specified by:

setShowEmpty in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

isShowInVirtualContainer

public boolean isShowInVirtualContainer()

Specified by:

isShowInVirtualContainer in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

setShowInVirtualContainer

public void setShowInVirtualContainer(boolean showInVirtualContainer)

Specified by:

setShowInVirtualContainer in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

isVirtual

public boolean isVirtual()

Specified by:

isVirtual in interface PrismContainerWrapper<ValueMetadataType>

isMetadata

public boolean isMetadata()

Specified by:

isMetadata in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

setMetadata

public void setMetadata(boolean metadata)

Specified by:

setMetadata in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

setShowMetadataDetails

public void setShowMetadataDetails(boolean showMetadataDetails)

Specified by:

setShowMetadataDetails in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

isShowMetadataDetails

public boolean isShowMetadataDetails()

Specified by:

isShowMetadataDetails in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

isProcessProvenanceMetadata

public boolean isProcessProvenanceMetadata()

Specified by:

isProcessProvenanceMetadata in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

setProcessProvenanceMetadata

public void setProcessProvenanceMetadata(boolean processProvenanceMetadata)

Specified by:

setProcessProvenanceMetadata in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

getParentContainerValue

public <C extends Containerable>
PrismContainerValueWrapper<C> getParentContainerValue(Class<? extends C> parentClass)

Specified by:

getParentContainerValue in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

debugDump

public String debugDump(int indent)

Specified by:

debugDump in interface DebugDumpable

Specified by:

debugDump in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

setVisibleOverwrite

public void setVisibleOverwrite(UserInterfaceElementVisibilityType visible)

Specified by:

setVisibleOverwrite in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

getVisibleOverwrite

public UserInterfaceElementVisibilityType getVisibleOverwrite()

Specified by:

getVisibleOverwrite in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

isVisible

public boolean isVisible(PrismContainerValueWrapper<?> parentContainer,
 ItemVisibilityHandler visibilityHandler)

Specified by:

isVisible in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

checkRequired

public boolean checkRequired()

Specified by:

checkRequired in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

getParent

public PrismContainerValueWrapper<?> getParent()

Specified by:

getParent in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

isImmutable

public boolean isImmutable()

Specified by:

isImmutable in interface Freezable

freeze

public void freeze()

Specified by:

freeze in interface Freezable

getPrismContext

public PrismContext getPrismContext()

Specified by:

getPrismContext in interface PrismContextSensitive

accept

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

Specified by:

accept in interface SmartVisitable<Definition>

Returns:

false if we already was here

accept

public void accept(Visitor<Definition> visitor)

Specified by:

accept in interface Visitable<Definition>

getChildContainers

public List<PrismContainerDefinition<? extends Containerable>> getChildContainers()
                                                                           throws SchemaException

Throws:

SchemaException

getChildNonContainers

public List<? extends ItemDefinition> getChildNonContainers()

unselect

public void unselect()

isValidated

public boolean isValidated()

Specified by:

isValidated in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>

setValidated

public void setValidated(boolean validated)

Specified by:

setValidated in interface ItemWrapper<PrismContainer<ValueMetadataType>,PrismContainerValueWrapper<ValueMetadataType>>