Package com.evolveum.midpoint.prism

Interface ItemDefinition<I extends Item>

All Superinterfaces:
Cloneable, DebugDumpable, Definition, Freezable, PrismContextSensitive, PrismItemAccessDefinition, Revivable, Serializable, SmartVisitable<Definition>, Visitable<Definition>
All Known Subinterfaces:
AttributeContainerDefinitionDelegator, AttributeDefinitionDelegator<T>, ContainerDefinitionDelegator<C>, ItemDefinitionDelegator<I>, ItemWrapper<I,VW>, MutableItemDefinition<I>, MutablePrismContainerDefinition<C>, MutablePrismObjectDefinition<O>, MutablePrismPropertyDefinition<T>, MutablePrismReferenceDefinition, MutableRawResourceAttributeDefinition<T>, ObjectDefinitionDelegator<O>, PrismContainerDefinition<C>, PrismContainerWrapper<C>, PrismObjectDefinition<O>, PrismObjectWrapper<O>, PrismPropertyDefinition<T>, PrismPropertyWrapper<T>, PrismReferenceDefinition, PrismReferenceWrapper<R>, PropertyDefinitionDelegator<T>, RawResourceAttributeDefinition<T>, ReferenceDefinitionDelegator, RefinedAttributeDefinitionDelegator<T>, ResourceAttributeContainerDefinition, ResourceAttributeDefinition<T>, ResourceAttributeWrapper<T>, ShadowWrapper
All Known Implementing Classes:
AssignmentHolderWrapper, CaseWorkItemTypeWrapper, ExpressionWrapper, com.evolveum.midpoint.prism.impl.ItemDefinitionImpl, ItemWrapperImpl, com.evolveum.midpoint.prism.impl.PrismContainerDefinitionImpl, PrismContainerWrapperImpl, PrismObjectWrapperImpl, com.evolveum.midpoint.prism.impl.PrismPropertyDefinitionImpl, PrismPropertyWrapperImpl, PrismReferenceWrapperImpl, ProfilingClassLoggerContainerWrapperImpl, ProtectedStringTypeWrapperImpl, RawResourceAttributeDefinitionImpl, ResourceAttributeContainerDefinitionImpl, ResourceAttributeDefinitionImpl, ResourceAttributeMappingWrapper, ResourceAttributeWrapperImpl, ResourceWrapper, ShadowAssociationWrapperImpl, ShadowWrapperImpl, ValueMetadataWrapperImpl
public interface ItemDefinition<I extends Item> extends Definition, PrismItemAccessDefinition
A definition of a specific item (as opposed to a type).
See Also:

  • Method Details

    • getItemName

      @NotNull @NotNull ItemName getItemName()
      Gets the "canonical" name of the item for the definition. Should be qualified, if at all possible.

    • getMinOccurs

      int getMinOccurs()
      Return the number of minimal value occurrences.

    • getMaxOccurs

      int getMaxOccurs()
      Return the number of maximal value occurrences. Any negative number means "unbounded".

    • isSingleValue

      default boolean isSingleValue()

    • isMultiValue

      default boolean isMultiValue()

    • isMandatory

      default boolean isMandatory()

    • isOptional

      default boolean isOptional()

    • isOperational

      boolean isOperational()
      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.

    • isIndexOnly

      @Experimental boolean isIndexOnly()
      If true, this item is not stored in XML representation in repo. TODO better name

    • isInherited

      boolean isInherited()
      Whether the item is inherited from a supertype.

    • isDynamic

      boolean isDynamic()
      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).

    • getSubstitutionHead

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

    • isHeterogeneousListItem

      @Experimental boolean isHeterogeneousListItem()
      Can be used in heterogeneous lists as a list item. EXPERIMENTAL.

    • getValueEnumerationRef

      PrismReferenceValue getValueEnumerationRef()
      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.

    • isValidFor

      boolean isValidFor(@NotNull @NotNull QName elementQName, @NotNull @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. Used e.g. for "slow" path lookup where we iterate over all definitions in a complex type.

    • findItemDefinition

      <T extends ItemDefinition<?>> T findItemDefinition(@NotNull @NotNull ItemPath path, @NotNull @NotNull Class<T> clazz)
      Used to find a matching item definition _within_ this definition. Treats e.g. de-referencing in prism references.

    • adoptElementDefinitionFrom

      void adoptElementDefinitionFrom(ItemDefinition<?> otherDef)
      Transfers selected parts of the definition (currently item name, min/max occurs) from another definition. TODO used only on few places, consider removing

    • instantiate

      @NotNull I instantiate() throws SchemaException
      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.
      Throws:
      SchemaException

    • instantiate

      @NotNull I instantiate(QName name) throws SchemaException
      Create an item instance. Definition name will use provided name. for the instance. The instance will otherwise be empty.
      Throws:
      SchemaException

    • createEmptyDelta

      @NotNull @NotNull ItemDelta<?,?> createEmptyDelta(ItemPath path)
      Creates an empty delta (with appropriate implementation class), pointing to this item definition, with a given path.

    • clone

      @NotNull @NotNull ItemDefinition<I> clone()
      Specified by:
      clone in interface Definition

    • deepClone

      ItemDefinition<I> deepClone(@NotNull @NotNull DeepCloneOperation operation)
      TODO document

    • debugDumpShortToString

      void debugDumpShortToString(StringBuilder sb)
      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.

    • canBeDefinitionOf

      boolean canBeDefinitionOf(I item)
      TODO document

    • canBeDefinitionOf

      boolean canBeDefinitionOf(PrismValue pvalue)
      TODO document

    • toMutable

      MutableItemDefinition<I> toMutable()
      Description copied from interface: Definition
      Returns an interface to mutate this definition.
      Specified by:
      toMutable in interface Definition

    • structuredType

      @Experimental Optional<ComplexTypeDefinition> structuredType()
      Returns complex type definition of item, if underlying value is possible structured. NOTE: This seems weird, since properties and references are simple values, but actually object reference is serialized as structured value and some of properties are also.

    • isSearchable

      @Experimental default boolean isSearchable()
      Returns true if item definition is searchable.
      Returns: