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

Class TransformableContainerDefinition<C extends Containerable>

java.lang.Object

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

com.evolveum.midpoint.model.impl.schema.transform.TransformableItemDefinition<PrismContainer<C>,PrismContainerDefinition<C>>

com.evolveum.midpoint.model.impl.schema.transform.TransformableContainerDefinition<C>

All Implemented Interfaces:

PartiallyMutableItemDefinition<PrismContainer<C>>, PartiallyMutableItemDefinition.Container<C>, Definition, Definition.DefinitionMutator, ContainerDefinitionDelegator<C>, DefinitionDelegator, ItemDefinitionDelegator<PrismContainer<C>>, Freezable, ItemDefinition<PrismContainer<C>>, ItemDefinition.ItemDefinitionMutator, LivePrismItemDefinition, LocalItemDefinitionStore, PrismContainerDefinition<C>, PrismContainerDefinition.PrismContainerDefinitionMutator<C>, PrismItemAccessDefinition, PrismItemAccessDefinition.Mutable, PrismItemBasicDefinition, PrismItemBasicDefinition.Mutable, PrismItemStorageDefinition, PrismItemStorageDefinition.Mutable, PrismLifecycleDefinition, PrismLifecycleDefinition.Mutable, PrismPresentationDefinition, PrismPresentationDefinition.Mutable, Revivable, SmartVisitable<Definition>, Visitable<Definition>, DebugDumpable, Serializable, Cloneable

Direct Known Subclasses:

TransformableObjectDefinition

public class TransformableContainerDefinition<C extends Containerable>
extends TransformableItemDefinition<PrismContainer<C>,PrismContainerDefinition<C>>
implements ContainerDefinitionDelegator<C>, PartiallyMutableItemDefinition.Container<C>

See Also:

• Serialized Form

Nested Class Summary

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

Definition.DefinitionBuilder, Definition.DefinitionMutator

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

ItemDefinition.ItemDefinitionLikeBuilder, ItemDefinition.ItemDefinitionMutator

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

PrismContainerDefinition.PrismContainerDefinitionMutator<C extends Containerable>

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

PrismItemAccessDefinition.Data, PrismItemAccessDefinition.Delegable, PrismItemAccessDefinition.Info, PrismItemAccessDefinition.Mutable

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

PrismItemAccessDefinition.Mutable.Delegable

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

PrismItemBasicDefinition.Data, PrismItemBasicDefinition.Delegable, PrismItemBasicDefinition.Mutable

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

PrismItemBasicDefinition.Mutable.Delegable

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

PrismItemStorageDefinition.Mutable

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

PrismLifecycleDefinition.Data, PrismLifecycleDefinition.Delegable, PrismLifecycleDefinition.Mutable

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

PrismLifecycleDefinition.Mutable.Delegable

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

PrismPresentationDefinition.Data, PrismPresentationDefinition.Delegable, PrismPresentationDefinition.Mutable

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

PrismPresentationDefinition.Mutable.Delegable

Field Summary

Fields

Modifier and Type	Field	Description
protected final TransformableComplexTypeDefinition	complexTypeDefinition

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

INDENT_STRING

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	TransformableContainerDefinition(PrismContainerDefinition<C> delegate)
	TransformableContainerDefinition(PrismContainerDefinition<C> delegate, ComplexTypeDefinition typeDef)

Method Summary

Modifier and Type	Method	Description
@NotNull PrismContainerDefinition<C>	clone()
PrismContainerDefinition<C>	cloneWithNewDefinition(QName newItemName, ItemDefinition<?> newDefinition)	TODO
@NotNull ItemDefinition<PrismContainer<C>>	cloneWithNewName(@NotNull ItemName itemName)	Returns a clone of this definition, but with name changed to the provided one.
@NotNull PrismContainerDefinition<?>	cloneWithNewType(@NotNull QName newTypeName, @NotNull ComplexTypeDefinition newCtd)	Changes the type name and definition for this PCD.
protected TransformableContainerDefinition<C>	copy()
protected TransformableContainerDefinition<C>	copy(ComplexTypeDefinition def)
@NotNull ContainerDelta<C>	createEmptyDelta(ItemPath path)	Creates an empty delta (with appropriate implementation class), pointing to this item definition, with a given path.
ItemDefinition<PrismContainer<C>>	deepClone(@NotNull DeepCloneOperation operation)	TODO document
static void	ensureMutableType(PrismContainerValue<?> pcv)
<C2 extends Containerable> PrismContainerDefinition<C2>	findContainerDefinition(@NotNull ItemPath path)	Returns PrismContainerDefinition corresponding to given path (rooted at this store).
<T extends ItemDefinition<?>> T	findItemDefinition(@NotNull ItemPath path, @NotNull Class<T> clazz)	Used to find a matching item definition _within_ this definition.
void	freeze()
Class<C>	getCompileTimeClass()	Static (compile-time) class holding the container values.
TransformableComplexTypeDefinition	getComplexTypeDefinition()	Definition of the container values.
@NotNull List<? extends ItemDefinition<?>>	getDefinitions()	Returns a list of item definitions in this container.
List<PrismPropertyDefinition<?>>	getPropertyDefinitions()	Returns set of property definitions.
Class	getTypeClass()	Returns a compile-time class that is used to represent items.
@NotNull QName	getTypeName()	Returns a name of the type for this definition.
@NotNull PrismContainer<C>	instantiate()	Create an item instance.
@NotNull PrismContainer<C>	instantiate(QName elementName)	Create an item instance.
boolean	isEmpty()	TODO
boolean	isImmutable()
PrismContainerDefinition.PrismContainerDefinitionMutator<C>	mutator()	Returns an interface to mutate this definition.
static <C extends Containerable> TransformableContainerDefinition<C>	of(PrismContainerDefinition<C> originalItem)
protected PrismContainerDefinition<C>	publicView()
void	replaceDefinition(QName itemName, ItemDefinition<?> newDefinition)	TODO
static <C extends Containerable> TransformableContainerDefinition<C>	require(PrismContainerDefinition<C> assocContainer)

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

access, applyTemplate, canAdd, canModify, canRead, delegate, delegatedItem, from, getDisplayHint, getDisplayName, getDisplayOrder, getHelp, getMaxOccurs, getMergerIdentifier, getMergerInstance, getMinOccurs, getNaturalKeyConstituents, getNaturalKeyInstance, getProcessing, getValueEnumerationRef, isAlwaysUseForEquals, isDeprecated, isEmphasized, isExperimental, publicFrom, revive, setAlwaysUseForEquals, setCanAdd, setCanModify, setCanRead, setDeprecated, setDisplayHint, setDisplayName, setDisplayOrder, setEmphasized, setExperimental, setHelp, setMaxOccurs, setMergerIdentifier, setMinOccurs, setNaturalKeyConstituents, setProcessing, setValueEnumerationRef, 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.ContainerDefinitionDelegator

canRepresent, createValue, delegate, getDisplayName, getDisplayOrder, getItemNames, isEmphasized, structuredType

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

checkMutableOnExposing

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

setAnnotation, setMergerIdentifier, setNaturalKeyConstituents

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

accept, accept, debugDump, debugDump, debugDump, debugDumpLazily, debugDumpLazily, getAnnotation, getAnnotations, getDeprecatedSince, getDisplayHint, getDocumentation, getDocumentationPreview, getMergerIdentifier, getMergerInstance, getMutabilityFlag, getNaturalKeyConstituents, getNaturalKeyInstance, getPlannedRemoval, getRemovedSince, getSchemaMigrations, isAbstract, isDeprecated, isElaborate, isExperimental, isOptionalCleanup, isRemoved, isRuntimeSchema

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

checkImmutable, checkMutable

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

getProcessing, isAlwaysUseForEquals, isIgnored

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

setAlwaysUseForEquals, setIgnored

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

canAdd, canModify, canRead, debugDumpShortToString, getDiagrams, getHelp, getItemName, getMaxOccurs, getMinOccurs, getSubstitutionHead, getValueEnumerationRef, isDynamic, isHeterogeneousListItem, isIndexed, isIndexOnly, isInherited, isOperational, isSearchable, isValidFor

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

containsItemDefinition, findItemDefinition, findLocalItemDefinition, findLocalItemDefinition, findPropertyDefinition, findReferenceDefinition

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

addSchemaMigration, setCanAdd, setCanModify, setCanRead, setDeprecated, setDeprecatedSince, setDiagrams, setDisplayName, setDisplayOrder, setDocumentation, setDynamic, setElaborate, setEmphasized, setExperimental, setHelp, setHeterogeneousListItem, setIndexed, setIndexOnly, setInherited, setMaxOccurs, setMinOccurs, setOperational, setOptionalCleanup, setPlannedRemoval, setProcessing, setReadOnly, setRemoved, setRemovedSince, setRuntimeSchema, setSchemaMigrations, setSearchable, setSubstitutionHead, setValueEnumerationRef

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

createContainerDefinition, createContainerDefinition, createPropertyDefinition, createPropertyDefinition, createPropertyDefinition, setCompileTimeClass, setComplexTypeDefinition

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

getAlwaysUseForEquals, isAlwaysUseForEquals, isCompletelyDefined

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

setAlwaysUseForEquals

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

getInfo

Methods inherited from interface com.evolveum.midpoint.prism.PrismItemAccessDefinition.Mutable

setInfo

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

isMandatory, isMultiValue, isOptional, isSingleValue

Methods inherited from interface com.evolveum.midpoint.prism.PrismPresentationDefinition.Mutable

setDisplayHint

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

revive

Field Details

complexTypeDefinition

protected final TransformableComplexTypeDefinition complexTypeDefinition

Constructor Details

TransformableContainerDefinition

protected TransformableContainerDefinition(PrismContainerDefinition<C> delegate)

TransformableContainerDefinition

public TransformableContainerDefinition(PrismContainerDefinition<C> delegate,
 ComplexTypeDefinition typeDef)

Method Details

of

public static <C extends Containerable>
TransformableContainerDefinition<C> of(PrismContainerDefinition<C> originalItem)

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 ContainerDefinitionDelegator<C extends Containerable>

Specified by:

getTypeName in interface Definition

Specified by:

getTypeName in interface DefinitionDelegator

Specified by:

getTypeName in interface ItemDefinitionDelegator<C extends Containerable>

Specified by:

getTypeName in interface PrismItemBasicDefinition

Returns:

the type name

getTypeClass

public Class 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 ContainerDefinitionDelegator<C extends Containerable>

Specified by:

getTypeClass in interface Definition

Specified by:

getTypeClass in interface DefinitionDelegator

Specified by:

getTypeClass in interface PrismContainerDefinition<C extends Containerable>

findItemDefinition

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

Description copied from interface: LivePrismItemDefinition

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

Specified by:

findItemDefinition in interface ContainerDefinitionDelegator<C extends Containerable>

Specified by:

findItemDefinition in interface ItemDefinitionDelegator<C extends Containerable>

Specified by:

findItemDefinition in interface LivePrismItemDefinition

Specified by:

findItemDefinition in interface LocalItemDefinitionStore

findContainerDefinition

public <C2 extends Containerable>
PrismContainerDefinition<C2> findContainerDefinition(@NotNull
 @NotNull ItemPath path)

Description copied from interface: LocalItemDefinitionStore

Returns PrismContainerDefinition corresponding to given path (rooted at this store). Tries the global resolution in the case of "any" content.

Specified by:

findContainerDefinition in interface ContainerDefinitionDelegator<C extends Containerable>

Specified by:

findContainerDefinition in interface LocalItemDefinitionStore

getCompileTimeClass

public Class<C> 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 ContainerDefinitionDelegator<C extends Containerable>

Specified by:

getCompileTimeClass in interface PrismContainerDefinition<C extends Containerable>

getComplexTypeDefinition

public TransformableComplexTypeDefinition 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 ContainerDefinitionDelegator<C extends Containerable>

Specified by:

getComplexTypeDefinition in interface PrismContainerDefinition<C extends Containerable>

isEmpty

public boolean isEmpty()

Description copied from interface: PrismContainerDefinition

TODO

Specified by:

isEmpty in interface ContainerDefinitionDelegator<C extends Containerable>

Specified by:

isEmpty in interface PrismContainerDefinition<C extends Containerable>

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 ContainerDefinitionDelegator<C extends Containerable>

Specified by:

getDefinitions in interface LocalItemDefinitionStore

Specified by:

getDefinitions in interface PrismContainerDefinition<C extends Containerable>

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 collection is immutable or detached from the source. Don't try to modify it. It may fail or the changes may be lost.

Specified by:

getPropertyDefinitions in interface ContainerDefinitionDelegator<C extends Containerable>

Specified by:

getPropertyDefinitions in interface PrismContainerDefinition<C extends Containerable>

createEmptyDelta

@NotNull
public @NotNull ContainerDelta<C> 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 ContainerDefinitionDelegator<C extends Containerable>

Specified by:

createEmptyDelta in interface ItemDefinition<C extends Containerable>

Specified by:

createEmptyDelta in interface ItemDefinitionDelegator<C extends Containerable>

Specified by:

createEmptyDelta in interface PrismContainerDefinition<C extends Containerable>

clone

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

Specified by:

clone in interface Definition

Specified by:

clone in interface ItemDefinition<C extends Containerable>

Specified by:

clone in interface PrismContainerDefinition<C extends Containerable>

Overrides:

clone in class TransformableItemDefinition<PrismContainer<C extends Containerable>,PrismContainerDefinition<C extends Containerable>>

cloneWithNewType

@NotNull
public @NotNull PrismContainerDefinition<?> cloneWithNewType(@NotNull
 @NotNull QName newTypeName,
 @NotNull
 @NotNull ComplexTypeDefinition newCtd)

Description copied from interface: PrismContainerDefinition

Changes the type name and definition for this PCD. Use only in special cases.

Specified by:

cloneWithNewType in interface PrismContainerDefinition<C extends Containerable>

cloneWithNewName

@NotNull
public @NotNull ItemDefinition<PrismContainer<C>> cloneWithNewName(@NotNull
 @NotNull ItemName itemName)

Description copied from interface: ItemDefinition

Returns a clone of this definition, but with name changed to the provided one.

Specified by:

cloneWithNewName in interface ItemDefinition<C extends Containerable>

Overrides:

cloneWithNewName in class TransformableItemDefinition<PrismContainer<C extends Containerable>,PrismContainerDefinition<C extends Containerable>>

See Also:

• PrismContainerDefinition.cloneWithNewDefinition(QName, ItemDefinition)

deepClone

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

Description copied from interface: ItemDefinition

TODO document

Specified by:

deepClone in interface ItemDefinition<C extends Containerable>

Specified by:

deepClone in interface ItemDefinitionDelegator<C extends Containerable>

Overrides:

deepClone in class TransformableItemDefinition<PrismContainer<C extends Containerable>,PrismContainerDefinition<C extends Containerable>>

copy

protected TransformableContainerDefinition<C> copy(ComplexTypeDefinition def)

cloneWithNewDefinition

public PrismContainerDefinition<C> cloneWithNewDefinition(QName newItemName,
 ItemDefinition<?> newDefinition)

Description copied from interface: PrismContainerDefinition

TODO

Specified by:

cloneWithNewDefinition in interface ContainerDefinitionDelegator<C extends Containerable>

Specified by:

cloneWithNewDefinition in interface PrismContainerDefinition<C extends Containerable>

replaceDefinition

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

Description copied from interface: PrismContainerDefinition

TODO

Specified by:

replaceDefinition in interface ContainerDefinitionDelegator<C extends Containerable>

Specified by:

replaceDefinition in interface PrismContainerDefinition<C extends Containerable>

mutator

public PrismContainerDefinition.PrismContainerDefinitionMutator<C> mutator()

Description copied from interface: Definition

Returns an interface to mutate this definition.

Specified by:

mutator in interface Definition

Specified by:

mutator in interface ItemDefinition<C extends Containerable>

Specified by:

mutator in interface PrismContainerDefinition<C extends Containerable>

Overrides:

mutator in class TransformableItemDefinition<PrismContainer<C extends Containerable>,PrismContainerDefinition<C extends Containerable>>

isImmutable

public boolean isImmutable()

Specified by:

isImmutable in interface Freezable

Overrides:

isImmutable in class TransformableItemDefinition<PrismContainer<C extends Containerable>,PrismContainerDefinition<C extends Containerable>>

freeze

public void freeze()

Specified by:

freeze in interface Freezable

Overrides:

freeze in class TransformableItemDefinition<PrismContainer<C extends Containerable>,PrismContainerDefinition<C extends Containerable>>

instantiate

@NotNull
public @NotNull PrismContainer<C> 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<C extends Containerable>

Specified by:

instantiate in interface ItemDefinitionDelegator<C extends Containerable>

Throws:

SchemaException

instantiate

@NotNull
public @NotNull PrismContainer<C> instantiate(QName elementName)
                                       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<C extends Containerable>

Specified by:

instantiate in interface ItemDefinitionDelegator<C extends Containerable>

Overrides:

instantiate in class TransformableItemDefinition<PrismContainer<C extends Containerable>,PrismContainerDefinition<C extends Containerable>>

Throws:

SchemaException

publicView

protected PrismContainerDefinition<C> publicView()

Specified by:

publicView in class TransformableItemDefinition<PrismContainer<C extends Containerable>,PrismContainerDefinition<C extends Containerable>>

ensureMutableType

public static void ensureMutableType(PrismContainerValue<?> pcv)

require

public static <C extends Containerable>
TransformableContainerDefinition<C> require(PrismContainerDefinition<C> assocContainer)

copy

protected TransformableContainerDefinition<C> copy()

Specified by:

copy in class TransformableItemDefinition<PrismContainer<C extends Containerable>,PrismContainerDefinition<C extends Containerable>>