Package com.evolveum.midpoint.prism

Interface ItemDefinition<I extends Item>

    • Method Detail

      • 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.

      • 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

      • 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.