Package com.evolveum.midpoint.model.impl.schema.transform

Class TransformableItemDefinition<I extends Item<?,?>,D extends ItemDefinition<I>>

java.lang.Object

com.evolveum.midpoint.model.impl.schema.transform.TransformableDefinition

com.evolveum.midpoint.model.impl.schema.transform.TransformableItemDefinition<I,D>

All Implemented Interfaces:

PartiallyMutableItemDefinition<I>, Definition, DefinitionDelegator, ItemDefinitionDelegator<I>, Freezable, ItemDefinition<I>, MutableDefinition, MutableItemDefinition<I>, PrismContextSensitive, PrismItemAccessDefinition, PrismItemAccessDefinition.Mutable, Revivable, SmartVisitable<Definition>, Visitable<Definition>, DebugDumpable, Serializable, Cloneable

Direct Known Subclasses:

TransformableContainerDefinition, TransformablePropertyDefinition, TransformableReferenceDefinition

public abstract class TransformableItemDefinition<I extends Item<?,?>,D extends ItemDefinition<I>>
extends TransformableDefinition
implements ItemDefinitionDelegator<I>, PrismItemAccessDefinition.Mutable, PartiallyMutableItemDefinition<I>

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.evolveum.midpoint.model.impl.schema.transform.PartiallyMutableItemDefinition

PartiallyMutableItemDefinition.Attribute<T>, PartiallyMutableItemDefinition.Container<C extends Containerable>, PartiallyMutableItemDefinition.Property<T>, PartiallyMutableItemDefinition.Reference

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

Modifier	Constructor	Description
protected	TransformableItemDefinition(D delegate)

Method Summary

Modifier and Type	Method	Description
static TransformableItemDefinition<?,?>	access(ItemDefinition<?> itemDef)
void	applyTemplate(ObjectTemplateItemDefinitionType apply)
boolean	canAdd()	Returns true if this item can be added: it can be part of an object that is created.
boolean	canModify()	Returns true if this item can be modified (updated).
boolean	canRead()	Returns true if this item can be read (displayed).
@NotNull ItemDefinition<I>	clone()
protected abstract TransformableItemDefinition<I,D>	copy()
ItemDefinition<I>	deepClone(@NotNull DeepCloneOperation operation)	TODO document
D	delegate()
protected void	delegatedItem(DelegatedItem<D> deleg)
void	freeze()
static <ID extends ItemDefinition<?>> TransformableItemDefinition<?,ID>	from(ID originalItem)
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	getHelp()	Returns help string.
int	getMaxOccurs()	Return the number of maximal value occurrences.
int	getMinOccurs()	Return the number of minimal value occurrences.
ItemProcessing	getProcessing()	Level of processing (ignore, minimal, auto, full) for this item/type.
PrismReferenceValue	getValueEnumerationRef()	Reference to an object that directly or indirectly represents possible values for this item.
I	instantiate(QName name)	Create an item instance.
boolean	isDeprecated()
boolean	isEmphasized()	True for definitions that are more important than others and that should be emphasized during presentation.
boolean	isExperimental()	Experimental functionality is not stable and it may be changed in any future release without any warning.
boolean	isImmutable()
static <ID extends ItemDefinition<?>> ID	publicFrom(ID definition)
protected abstract D	publicView()
void	revive(PrismContext prismContext)	TODO: Is revive necessary if prism context is static?
void	setCanAdd(boolean val)
void	setCanModify(boolean val)
void	setCanRead(boolean val)
void	setDeprecated(boolean deprecated)
void	setDisplayName(String displayName)
void	setDisplayOrder(Integer displayOrder)
void	setEmphasized(boolean emphasized)
void	setExperimental(boolean experimental)
void	setHelp(String help)
void	setMaxOccurs(int value)
void	setMinOccurs(int value)
void	setProcessing(ItemProcessing itemProcessing)
void	setValueEnumerationRef(PrismReferenceValue valueEnumerationRVal)
MutableItemDefinition<I>	toMutable()	Returns an interface to mutate this definition.
String	toString()

Methods inherited from class com.evolveum.midpoint.model.impl.schema.transform.TransformableDefinition

annotationsOverrides, getAnnotation, setAnnotation

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.evolveum.midpoint.prism.deleg.DefinitionDelegator

accept, accept, debugDump, debugDump, debugDump, debugDumpLazily, debugDumpLazily, getAnnotation, getAnnotations, getDeprecatedSince, getDocumentation, getDocumentationPreview, getMutabilityFlag, getPlannedRemoval, getPrismContext, getRemovedSince, getSchemaMigrations, getSchemaRegistry, getTypeClass, getTypeName, isAbstract, isElaborate, isIgnored, isRemoved, isRuntimeSchema, setAnnotation

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

checkImmutable, checkMutable

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

isMandatory, isMultiValue, isOptional, isSingleValue

Methods inherited from interface com.evolveum.midpoint.prism.deleg.ItemDefinitionDelegator

adoptElementDefinitionFrom, canBeDefinitionOf, canBeDefinitionOf, createEmptyDelta, debugDumpShortToString, findItemDefinition, getDiagrams, getItemName, getSubstitutionHead, instantiate, isDynamic, isHeterogeneousListItem, isIndexOnly, isInherited, isOperational, isSearchable, isValidFor, structuredType

Methods inherited from interface com.evolveum.midpoint.model.impl.schema.transform.PartiallyMutableItemDefinition

addDiagram, addSchemaMigration, setDeprecatedSince, setDocumentation, setDynamic, setElaborate, setHeterogeneousListItem, setIndexOnly, setInherited, setItemName, setOperational, setPlannedRemoval, setReadOnly, setRemoved, setRemovedSince, setRuntimeSchema, setSearchable, setSubstitutionHead, setTypeName

Constructor Details

TransformableItemDefinition

protected TransformableItemDefinition(D delegate)

Method Details

from

public static <ID extends ItemDefinition<?>>
TransformableItemDefinition<?,ID> from(ID originalItem)

publicFrom

public static <ID extends ItemDefinition<?>> ID publicFrom(ID definition)

delegate

public D delegate()

Specified by:

delegate in interface DefinitionDelegator

Specified by:

delegate in interface ItemDefinitionDelegator<I extends Item<?,?>>

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 ItemDefinitionDelegator<I extends Item<?,?>>

Specified by:

canAdd 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 ItemDefinitionDelegator<I extends Item<?,?>>

Specified by:

canModify in interface PrismItemAccessDefinition

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 ItemDefinitionDelegator<I extends Item<?,?>>

Specified by:

canRead in interface PrismItemAccessDefinition

getMinOccurs

public int getMinOccurs()

Description copied from interface: ItemDefinition

Return the number of minimal value occurrences.

Specified by:

getMinOccurs in interface ItemDefinition<I extends Item<?,?>>

Specified by:

getMinOccurs in interface ItemDefinitionDelegator<I extends Item<?,?>>

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<I extends Item<?,?>>

Specified by:

getMaxOccurs in interface ItemDefinitionDelegator<I extends Item<?,?>>

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

Specified by:

getProcessing in interface DefinitionDelegator

setCanAdd

public void setCanAdd(boolean val)

Specified by:

setCanAdd in interface MutableItemDefinition<I extends Item<?,?>>

Specified by:

setCanAdd in interface PartiallyMutableItemDefinition<I extends Item<?,?>>

Specified by:

setCanAdd in interface PrismItemAccessDefinition.Mutable

setCanModify

public void setCanModify(boolean val)

Specified by:

setCanModify in interface MutableItemDefinition<I extends Item<?,?>>

Specified by:

setCanModify in interface PartiallyMutableItemDefinition<I extends Item<?,?>>

Specified by:

setCanModify in interface PrismItemAccessDefinition.Mutable

setCanRead

public void setCanRead(boolean val)

Specified by:

setCanRead in interface MutableItemDefinition<I extends Item<?,?>>

Specified by:

setCanRead in interface PartiallyMutableItemDefinition<I extends Item<?,?>>

Specified by:

setCanRead in interface PrismItemAccessDefinition.Mutable

publicView

protected abstract D publicView()

clone

@NotNull
public @NotNull ItemDefinition<I> clone()

Specified by:

clone in interface Definition

Specified by:

clone in interface ItemDefinition<I extends Item<?,?>>

Overrides:

clone in class TransformableDefinition

freeze

public void freeze()

Specified by:

freeze in interface Freezable

isImmutable

public boolean isImmutable()

Specified by:

isImmutable in interface Freezable

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

access

public static TransformableItemDefinition<?,?> access(ItemDefinition<?> itemDef)

applyTemplate

public void applyTemplate(ObjectTemplateItemDefinitionType apply)

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

Specified by:

getDisplayName in interface DefinitionDelegator

Returns:

display name string or catalog key

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

Specified by:

getHelp in interface DefinitionDelegator

Returns:

help 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

Specified by:

getDisplayOrder in interface DefinitionDelegator

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

Specified by:

isEmphasized in interface DefinitionDelegator

isDeprecated

public boolean isDeprecated()

Specified by:

isDeprecated in interface Definition

Specified by:

isDeprecated in interface DefinitionDelegator

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

Specified by:

isExperimental in interface DefinitionDelegator

setMinOccurs

public void setMinOccurs(int value)

Specified by:

setMinOccurs in interface MutableItemDefinition<I extends Item<?,?>>

Specified by:

setMinOccurs in interface PartiallyMutableItemDefinition<I extends Item<?,?>>

setMaxOccurs

public void setMaxOccurs(int value)

Specified by:

setMaxOccurs in interface MutableItemDefinition<I extends Item<?,?>>

Specified by:

setMaxOccurs in interface PartiallyMutableItemDefinition<I extends Item<?,?>>

setValueEnumerationRef

public void setValueEnumerationRef(PrismReferenceValue valueEnumerationRVal)

Specified by:

setValueEnumerationRef in interface MutableItemDefinition<I extends Item<?,?>>

Specified by:

setValueEnumerationRef in interface PartiallyMutableItemDefinition<I extends Item<?,?>>

setDisplayName

public void setDisplayName(String displayName)

Specified by:

setDisplayName in interface MutableDefinition

Specified by:

setDisplayName in interface PartiallyMutableItemDefinition<I extends Item<?,?>>

setHelp

public void setHelp(String help)

Specified by:

setHelp in interface MutableDefinition

Specified by:

setHelp in interface PartiallyMutableItemDefinition<I extends Item<?,?>>

setDisplayOrder

public void setDisplayOrder(Integer displayOrder)

Specified by:

setDisplayOrder in interface MutableDefinition

Specified by:

setDisplayOrder in interface PartiallyMutableItemDefinition<I extends Item<?,?>>

setEmphasized

public void setEmphasized(boolean emphasized)

Specified by:

setEmphasized in interface MutableDefinition

Specified by:

setEmphasized in interface PartiallyMutableItemDefinition<I extends Item<?,?>>

setDeprecated

public void setDeprecated(boolean deprecated)

Specified by:

setDeprecated in interface MutableDefinition

Specified by:

setDeprecated in interface PartiallyMutableItemDefinition<I extends Item<?,?>>

setExperimental

public void setExperimental(boolean experimental)

Specified by:

setExperimental in interface MutableDefinition

Specified by:

setExperimental in interface PartiallyMutableItemDefinition<I extends Item<?,?>>

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<I extends Item<?,?>>

Specified by:

getValueEnumerationRef in interface ItemDefinitionDelegator<I extends Item<?,?>>

setProcessing

public void setProcessing(ItemProcessing itemProcessing)

Specified by:

setProcessing in interface MutableDefinition

Specified by:

setProcessing in interface PartiallyMutableItemDefinition<I extends Item<?,?>>

toMutable

public MutableItemDefinition<I> 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<I extends Item<?,?>>

deepClone

public ItemDefinition<I> deepClone(@NotNull
 @NotNull DeepCloneOperation operation)

Description copied from interface: ItemDefinition

TODO document

Specified by:

deepClone in interface ItemDefinition<I extends Item<?,?>>

Specified by:

deepClone in interface ItemDefinitionDelegator<I extends Item<?,?>>

copy

protected abstract TransformableItemDefinition<I,D> copy()

toString

public String toString()

Overrides:

toString in class Object

instantiate

@NotNull
public I 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<I extends Item<?,?>>

Specified by:

instantiate in interface ItemDefinitionDelegator<I extends Item<?,?>>

Throws:

SchemaException

delegatedItem

protected void delegatedItem(DelegatedItem<D> deleg)